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 setupwill 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 dont 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 youve 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 youre 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 isnt 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 Its 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 didnt 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 orRAD 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 Doesnt 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 Cant 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 youre 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