Setup Guide for the RUI EGL Distance Learning Course

®

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


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



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





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


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


Installation Snapshots – 4 of 12

Click the install link

And click Install software packages


Install Rational Business Developer (Trial Edition) – 5 of 12 Select (check) Rational Business Developer, Version 7.5, click Next >Next >


Install Rational Business Developer (Trial Edition) – 6 of 12 Accept the terms and conditions (in order to continue) and click: Next >Next >


Install Rational Business Developer (Trial Edition) – 7 of 12 Create an install directory (or accept the default) to install in to. Click Next >Next >


Install Rational Business Developer (Trial Edition) – 8 of 12 Specify a new (or select the default) package group directory. Click: Next >Next >


Install Rational Business Developer (Trial Edition) – 9 of 12 Install (do not extend) Eclipse. Click Next >Next >


Install Rational Business Developer (Trial Edition) – 10 of 12 Choose your installation language (the default is English). Click Next >Next >


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


Install Rational Business Developer (Trial Edition) – 12 of 12 Review your installation specifications/settings Click InstallInstall


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:



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

http://en.wikipedia.org/wiki/Apache_Tomcat


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


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

http://tomcat.apache.org/


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


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


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


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


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


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


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


Clean the Tutorial Project

From the RBD Workbench Open the Project menu, select Clean…

At the Clean window, press OK


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)


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


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


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



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.


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)


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


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


Configure Preferences – 2 of 2 Still from within the

Preferences Window Click ValidationValidation Click Disable AllDisable All Click OKOK


Clean the Tutorial Project

From the RBD Workbench Open the Project menu, select Clean…

At the Clean window, press OK


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


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


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


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

Documents

Setup Guide for the RUI EGL Distance Learning Course