Upload
ramya
View
41
Download
0
Embed Size (px)
DESCRIPTION
Setup Guide for the RUI EGL Distance Learning Course. RBD v7.5.1 Workstation. RBD Product and Course Setup. UNIT. Topics:. Download and Install RBD v7.5.1(Trial Version) Installing and configuring Tomcat Application Server Installing and configuring WebSphere Application Server. - PowerPoint PPT Presentation
Citation preview
®
IBM Software Group
© 2009 IBM CorporationLast Update: 5/27/2009
Setup Guide for the RUI EGL Distance Learning Course
RBD v7.5.1 Workstation
2© 2009 IBM Corporation
UNIT
Download and Install RBD v7.5.1(Trial Version)
Installing and configuring Tomcat Application Server
Installing and configuring WebSphere Application Server
Topics:
RBD Product and Course RBD Product and Course SetupSetup
3© 2009 IBM Corporation
RBD v7.5 can be installed standalone, or can be installed into (on top of): RDz or RDi-SOA
The RBD v7.5 installation process is as follows:1. Download and install RBD v7.5.1… The link to get the trial software for RBD v7.5.1 is here:
http://www.ibm.com/developerworks/downloads/r/rbex/
2. Run the Product Updater via IBM Installation ManagerStart -> IBM Installation Manager -> IBM Installation Manager -> Update
In addition to the RBD v7.5.1 software, you will also need to download to your workstation: EGLDerbyR7.zip – the course database And either
v7513Project_Tomcat.zip – for doing this course using Tomcat…or… v7513Project_WAS.zip – for doing this course using WAS*** Note – please
contact your instructor, if you wish to use WebSphere
Your course setup e-Mail will direct you as to where to get these resources
RBD v7.5.1 Installation Process
4© 2009 IBM Corporation
Installation Snapshots – 1 of 12 Point your browser to: http://www.ibm.com/developerworks/downloads/r/rbex/
Select
Either Register (if you don’t have an IBM DeveloperWorks ID/Password), or sign in
5© 2009 IBM Corporation
Installation Snapshots – 2 of 12 Scroll to the bottom and read
the license – and if you want to continue: Check I agree Click I confirm
Select your operating system and select Download now
You will have to choose a download directory
- We recommend you select or specify a directory with an easy-to-remember name
After you finish downloading Installation Manager, you will need to return to the site and down the software itself
6© 2009 IBM Corporation
Installation Snapshots – 3 of 12 Once the download completes, you may have to unzip the files in the RBD_SETUP
folder
When you’ve finished unzipping the files, click:
And select your installation language – then click: OK
7© 2009 IBM Corporation
Installation Snapshots – 4 of 12
Click the install link
And click Install software packages
8© 2009 IBM Corporation
Install Rational Business Developer (Trial Edition) – 5 of 12 Select (check) Rational Business Developer, Version 7.5, click Next >Next >
9© 2009 IBM Corporation
Install Rational Business Developer (Trial Edition) – 6 of 12 Accept the terms and conditions (in order to continue) and click: Next >Next >
10© 2009 IBM Corporation
Install Rational Business Developer (Trial Edition) – 7 of 12 Create an install directory (or accept the default) to install in to. Click Next >Next >
11© 2009 IBM Corporation
Install Rational Business Developer (Trial Edition) – 8 of 12 Specify a new (or select the default) package group directory. Click: Next >Next >
12© 2009 IBM Corporation
Install Rational Business Developer (Trial Edition) – 9 of 12 Install (do not extend) Eclipse. Click Next >Next >
13© 2009 IBM Corporation
Install Rational Business Developer (Trial Edition) – 10 of 12 Choose your installation language (the default is English). Click Next >Next >
14© 2009 IBM Corporation
Install Rational Business Developer (Trial Edition) – 11 of 12 (Optionally but not needed for the RUI Course) Select additional features as
appropriate. (Note also that if you want to use WebSphere Application Server, please select version 6.1 NOT version
7.0) Click Next >Next >
Note that if you are System z, and plan on doing COBOL Generation and/or calling CICS applications you will need the following options
15© 2009 IBM Corporation
Install Rational Business Developer (Trial Edition) – 12 of 12 Review your installation specifications/settings Click InstallInstall
16© 2009 IBM Corporation
UNIT
Downloading RBD software (trial edition)Downloading RBD software (trial edition)
Installing and configuring Tomcat Application Installing and configuring Tomcat Application ServerServer Installing and configuring WebSphere Application Installing and configuring WebSphere Application ServerServer
Topics:
RBD Product and Course RBD Product and Course SetupSetup
17© 2009 IBM Corporation
IMPORTANT NOTESIMPORTANT NOTES With RBD and EGL you have a choice of a number of application servers to run web
applications with, including: WebSphere Application Server WebSphere Application Server and TomcatTomcat
In order to accommodate customers with limited access to In order to accommodate customers with limited access to application servers, we will use Tomcat in our examples.application servers, we will use Tomcat in our examples.
Someone may have already installed and configured the Tomcat application server for you. If this is the case, or if you’re going to use WebSphere Application Server skip ahead to the next step in this process – (go to slide 39)(go to slide 39)
If you wish to use Tomcat, you might first read about the software from this link: http://en.wikipedia.org/wiki/Apache_Tomcat
To install and configure Tomcat on your PC follow the steps listed in the upcoming slides
*** See Slide Notes*** See Slide Notes
Course Application Server Considerations
18© 2009 IBM Corporation
Installing and configuring the course database – Tomcat Server Users This course uses a pre-configured Project and an open-source (Derby) database,
which you will need to install and configure. Before installing Tomcat, you should unzip the class database on your machine.
Someone may already have installed and configured the database for you. If so, skip ahead to the next section. If not, please follow the steps below to unzip the Derby database.
Unzip the EGLDerbyR7.zipEGLDerbyR7.zip file into:C:\databases\C:\databases\
The files in the folder should look like this after you have unzipped them
*** See Slide Notes*** See Slide Notes
19© 2009 IBM Corporation
In a Web browser, go to the Apache Tomcat Web page: http://tomcat.apache.org
Click the Download link for Tomcat 5.x.
On the download page, find the most recent version of Tomcat with a version number like 5.5.x, such as 5.5.23. Several downloads are available for each version. Do not use versions marked as ″alpha″ or ″beta″.
Under the 5.5.x version of Tomcat, look under Binary Distributions and then under Core.
Download the Core version of Tomcat 5.5.x for your operating system. For Windows, select the ZIP file For Linux, select the TAR.GZ file.
Installing Tomcat
20© 2009 IBM Corporation
Installing and configuring Tomcat
Unzip the file you downloaded and place the server files in an appropriate location on your computer. It isn’t important where you put the server files as long as you can find them again later.
You must now give Tomcat the proper driver file for the database. Find a file named derby.jar located at: <Prod_Install_Directory>\SDP70\runtimes\base_v61\derby\lib\<Prod_Install_Directory>\SDP70\runtimes\base_v61\derby\lib\
Copy/paste this derby.jar file to <Tomcat_Install_Directory>\common\lib<Tomcat_Install_Directory>\common\lib
21© 2009 IBM Corporation
Configuring Tomcat For Use With RBD
From Windows, launch RBD. In the workbench, click Window → PreferencesWindow → Preferences. The Preferences window opens. At the left side of the Preferences window, expand ServerServer. Under Server, select Installed Runtimes.Installed Runtimes. The right side of the Preferences window now
shows a list of all of the server runtimes installed in the workbench. Click AddAdd. The New Server Runtime window opens. In the New Server Runtime window, expand ApacheApache. Under Apache, click Tomcat v5.5Tomcat v5.5 Click Next. Under Tomcat installation directory, click BrowseBrowse. Locate the folder that contains the Tomcat installation files and then click OK.Locate the folder that contains the Tomcat installation files and then click OK. Click FinishFinish. Tomcat is added to the list of installed runtimes. The PreferencesPreferences window looks
like this Click OK
22© 2009 IBM Corporation
Configure Preferences – 1 of 3 You need to configure a few preferences,
in order to complete the labs in this course.
From the RBD Workbench menu Pull down the WindowWindow menu, and
select Preferences…Preferences… Expand the EGLEGL folder and from within the EGL
folder… Click Page Designer Check all three options
as shown in the screen capture Click APPLY
Click ApplyClick Apply
Do notnot leave Preferences yet
23© 2009 IBM Corporation
Configure Preferences – 2 of 3 Still from within the
Preferences Window: From General
Startup and Shutdown: Uncheck all of the
options shown here in the screen capture
Click ApplyClick Apply
24© 2009 IBM Corporation
Configure &* Preferences – 3 of 3Still from within the
Preferences Window From ValidationValidation
Click Disable AllDisable All Click ApplyApply
If prompted, do a full If prompted, do a full rebuildrebuild
25© 2009 IBM Corporation
Import the Tutorial Project
From the RBD Workbench Open the File menu, and select Import…
Expand the Other folder (at the bottom of the list) and select: Project Interchange
Click Next – this opens the Import Project window
From Import Project Click the top Browse… button, next to From zip fileFrom zip file, and
browse to, and select v7513Project_Tomcat.zipv7513Project_Tomcat.zip The file you down-loaded in a previous setup step
– Selecting the zip file will open its contents in the window, and two resource folders will appear
Click: Select AllSelect All
Click: FinishFinish This will import the Project into your Workspace
26© 2009 IBM Corporation
Close the Enterprise Explorer View
From the top-left corner of your workbench, Close the view shown here
It’s full name is Enterprise Explorer, but depending on your screen resolution it might only show the partial name
Project Explorer will then become your primary file organizer and access feature
27© 2009 IBM Corporation
Clean the Tutorial Project
From the RBD Workbench Open the Project menu, select Clean…
At the Clean window, press OK
28© 2009 IBM Corporation
Run an Installation Verification Page
To run the installation verification page (from the Workbench/Project Explorer): Expand the EGLWeb folder Expand the WebContent folder Right-click over allcustomers.jspallcustomers.jsp Select:
– Run As– Run on Server…
You will also be prompted to choose a Server
– (see the next slide)
29© 2009 IBM Corporation
Installing and configuring Tomcat
When prompted to Define a New Server
Manually define a new server
Expand the Expand the ApacheApache folder folder
Select “Tomcat v5.5 Server with EGL debugging support
Check: Always use this server Always use this server when running this projectwhen running this project
Click FinishFinish
30© 2009 IBM Corporation
Your First Page
You should see a web page that looks like this You should see a web page that looks like this
Important Note!If (!) you happen to have run the page in the browser and you get no data, and the following
“No page to display”“No page to display” tab message, that simply means that your Application Server didn’t have a chance to deploy your web page.
Just click the little green triangle as shown here
31© 2009 IBM Corporation
UNIT
Topics: Download and Install RBD v7.5.1(Trial Version)
Installing and configuring Tomcat Application Server
Installing and configuring WebSphere Application Installing and configuring WebSphere Application ServerServer
RBD Product and Course RBD Product and Course SetupSetup
32© 2009 IBM Corporation
Installing and configuring the course database
This course uses a pre-configured Project and an open-source (Derby) database, which you will need to install and configure.
Someone may already have installed and configured these artifacts. If so, you may skip ahead to the next section. If not, please follow the steps below to install and configure the Derby database.
Unzip the EGLDerbyR7.zipEGLDerbyR7.zip file into: C:\databases\
Your files should look like thisafter you have unzipped them
Note that the folder will appear afterafter you begin using the database during the labs in this course.
33© 2009 IBM Corporation
Installing and configuring the course project
This course uses a pre-configured Project, which you will need to install and configure.
Someone may already have installed and configured the project for you. If so, you may skip ahead to the next section. If not, please follow the steps below to install and configure the course project:
From the Windows start menu, launch RBD …or…RAD with RBD (depending on what product you have installed on your PC)
At the Workspace Launcher window, specify the directory into which you want to organize all of your RBD Education resources. Usually something like: c:\RBDv7\ …or… d:\RBDv7\
Close the Welcome window
This opens to the RBD Workbench (next slide)
34© 2009 IBM Corporation
Import the Tutorial Project
From the RBD Workbench Open the File menu, and select Import…Import… Expand the Other folder (at the bottom of the list) and select:
Project Interchange Project Interchange Click NextNext – this opens: Import Project Interchange Contents
From Import Project Interchange Contents:Import Project Interchange Contents: Click the top BrowseBrowse… button, next to From zip file, and
browse to, and select: v7513Project_WAS.zip **** (If you are using WebSphere Application Server 6.1WebSphere Application Server 6.1)
Note that if you plan on using Apache/Tomcat, you will have completed this step in the previous section of the course
Selecting the zip file will open its contents in the window, and two resource folders will appear
Click Select AllSelect All Click FinishFinish If a popup window emerges during the import that asks if you
want to “Update resources?” answer: YesYes This will import the Tutorial Project into your Workspace
**** This file should have been down-loaded previously
35© 2009 IBM Corporation
Configure Preferences – 1 of 2 You need to configure your
preferences, in order to complete the labs in this course.
From the RBD Workbench menu Pull down the Window
menu, and select Preferences…
Expand the EGL folder and from within the EGL folder…
Click Page Designer Check all three options
as shown in the screen capture on the right
Click APPLY
Do notnot leave Preferences yet
36© 2009 IBM Corporation
Configure Preferences – 2 of 2 Still from within the
Preferences Window Click ValidationValidation Click Disable AllDisable All Click OKOK
37© 2009 IBM Corporation
Clean the Tutorial Project
From the RBD Workbench Open the Project menu, select Clean…
At the Clean window, press OK
38© 2009 IBM Corporation
You should see results similar to this
If this web page does not come up in the browser and/or if you have errors:
• Starting the server …or…• Publishing your project
…please check out the next slides, which might help!
Run an Installation Verification Page
To run the installation verification page (from the Workbench/Project Explorer): Expand the EGLWeb folder Expand the WebContent folder Right-click over allcustomers.jspallcustomers.jsp
Select: Run As Run on Server… You will be prompted to choose a Server
– Check: Set server as project default Click Finish
39© 2009 IBM Corporation
What if My Server Doesn’t Start?
Try this solution: From the ServersServers view Right-click over the
server entry Select: OpenOpen Select SOAP SOAP
Instead of RMI for the connection type
It seems to help if there are conflicts with firewalls, etc.
Right-Click
Server entry
40© 2009 IBM Corporation
What if I Can’t Publish My Project? From Project Explorer, right-click over EGLWeb and:
Select Properties Select Targeted Runtimes If WebSphere is un-checked, Check (the checkbox next to it) Click Apply, then OK
If WebSphere was already checked and you’re having this problem:1. Uncheck2. Apply3. Check (again)4. Apply (again)
5. Click OK
41© 2009 IBM Corporation
Now that you have completed this topic, you should be able to:
Launch RBD – and select a workspace
View the Education Project in eclipse
Connect to the Derby database and view data rendered in a simple EGL/JSF web page
Note this verifies that all of the software components necessary for this course are:
– Installed– Configured– Operational
Summary