® 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 Setup

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: 2. Run the Product Updater via IBM Installation Manager Start -> 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 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:  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 Next >  Select (check) Rational Business Developer, Version 7.5, click Next >

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

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

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

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

13 © 2009 IBM Corporation Install Rational Business Developer (Trial Edition) – 10 of 12 Next >  Choose your installation language (the default is English). Click 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. Next >  (Note also that if you want to use WebSphere Application Server, please select version 6.1 NOT version 7.0) Click 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 Install  Click Install

16 © 2009 IBM Corporation UNIT Downloading RBD software (trial edition)  Downloading RBD software (trial edition)  Installing and configuring Tomcat Application Server  Installing and configuring WebSphere Application Server Topics: RBD Product and Course Setup

17 © 2009 IBM Corporation IMPORTANT NOTES  IMPORTANT NOTES WebSphere Application Server Tomcat  With RBD and EGL you have a choice of a number of application servers to run web applications with, including: WebSphere Application Server and Tomcat  In order to accommodate customers with limited access to application servers, we will use Tomcat in our examples. (go to slide 39)  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)  If you wish to use Tomcat, you might first read about the software from this link:   To install and configure Tomcat on your PC follow the steps listed in the upcoming slides *** 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. EGLDerbyR7.zip  Unzip the EGLDerbyR7.zip file into:C:\databases\  The files in the folder should look like this after you have unzipped them  *** See Slide Notes

19 © 2009 IBM Corporation  In a Web browser, go to the Apache Tomcat Web page:  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 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:  \SDP70\runtimes\base_v61\derby\lib\  Copy/paste this derby.jar file to  \common\lib

21 © 2009 IBM Corporation  Configuring Tomcat For Use With RBD  From Windows, launch RBD. Window → Preferences  In the workbench, click Window → Preferences. The Preferences window opens. Server  At the left side of the Preferences window, expand Server. Installed Runtimes.  Under Server, select Installed Runtimes. The right side of the Preferences window now shows a list of all of the server runtimes installed in the workbench. Add  Click Add. The New Server Runtime window opens. Apache  In the New Server Runtime window, expand Apache. Tomcat v5.5  Under Apache, click Tomcat v5.5  Click Next. Browse  Under Tomcat installation directory, click Browse.  Locate the folder that contains the Tomcat installation files and then click OK. Finish Preferences  Click Finish. Tomcat is added to the list of installed runtimes. The Preferences 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 Window Preferences…  Pull down the Window menu, and select Preferences… EGL  Expand the EGL folder and from within the EGL folder…  Click Page Designer  Check  all three options as shown in the screen capture  Click APPLY Click Apply not Do not 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 Apply

24 © 2009 IBM Corporation  Configure &* Preferences – 3 of 3 Still from within the Preferences Window Validation  From Validation Disable All  Click Disable All Apply  Click Apply  If prompted, do a full rebuild

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 From zip file v7513Project_Tomcat.zip  Click the top Browse… button, next to From zip file, and browse to, and select v7513Project_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 Select All  Click: Select All Finish  Click: Finish  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 allcustomers.jsp  Right-click over allcustomers.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 Apache folder  Select “Tomcat v5.5 Server with EGL debugging support Always use this server when running this project  Check:  Always use this server when running this project Finish  Click Finish

30 © 2009 IBM Corporation  Your First Page You should see a web page that looks like this    Important Note! “No page to display” If (!) you happen to have run the page in the browser and you get no data, and the following “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 Server RBD Product and Course Setup

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. EGLDerbyR7.zip  Unzip the EGLDerbyR7.zip file into:  C:\databases\  Your files should look like this after you have unzipped them   Note that the folder will appear after after 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 Import…  Open the File menu, and select Import… Project Interchange  Expand the Other folder (at the bottom of the list) and select: Project Interchange Next  Click Next – this opens: Import Project Interchange Contents Import Project Interchange Contents:  From Import Project Interchange Contents: Browse  Click the top Browse… button, next to From zip file, and browse to, and select: v7513Project_WAS.zip **** WebSphere Application Server 6.1 (If you are using WebSphere 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 Select All  Click Select All Finish  Click Finish Yes  If a popup window emerges during the import that asks if you want to “Update resources?” answer: Yes  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 not  Do not leave Preferences yet

36 © 2009 IBM Corporation  Configure Preferences – 2 of 2  Still from within the Preferences Window Validation  Click Validation Disable All  Click Disable All OK  Click OK

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 allcustomers.jsp  Right-click over allcustomers.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: Servers  From the Servers view  Right-click over the server entry Open  Select: Open  SOAP  Select  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.Uncheck 2.Apply 3.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