410 likes | 581 Views
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.
E N D
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
RBD v7.5.1 Installation Process • 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: • 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 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 e-Mail will direct you as to where to get these resources
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 >
Install Rational Business Developer (Trial Edition) – 6 of 12 • Accept the terms and conditions (in order to continue) and click: Next >
Install Rational Business Developer (Trial Edition) – 7 of 12 • Create an install directory (or accept the default) to install in to. Click Next >
Install Rational Business Developer (Trial Edition) – 8 of 12 • Specify a new (or select the default) package group directory. Click: Next >
Install Rational Business Developer (Trial Edition) – 9 of 12 • Install (do not extend) Eclipse. Click Next >
Install Rational Business Developer (Trial Edition) – 10 of 12 • Choose your installation language (the default is English). Click 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 > 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 Install
RBD Product and Course Setup UNIT Topics: • Downloading RBD software (trial edition) • Installing and configuring Tomcat Application Server • Installing and configuring WebSphere Application Server
Course Application Server Considerations IMPORTANT NOTES • 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. • 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: • 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
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.zip file into: C:\databases\ • The files in the folder should look like this after you have unzipped them *** See Slide Notes
Installing Tomcat • 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 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\ • Copy/paste this derby.jar file to • <Tomcat_Install_Directory>\common\lib
Configuring Tomcat For Use With RBD • From Windows, launch RBD. • In the workbench, click Window → Preferences. The Preferences window opens. • At the left side of the Preferences window, expand Server. • 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. • Click Add. The New Server Runtime window opens. • In the New Server Runtime window, expand Apache. • Under Apache, click Tomcat v5.5 • Click Next. • Under Tomcat installation directory, click Browse. • Locate the folder that contains the Tomcat installation files and then click OK. • Click Finish. Tomcat is added to the list of installed runtimes. The Preferences 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 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 • Click APPLY Click Apply Do not 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 Apply
Configure &* Preferences – 3 of 3 Still from within the Preferences Window • From Validation • Click Disable All • Click Apply • If prompted, do a full rebuild
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 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 • Click: Select All • Click: Finish • 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.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 Apache folder • Select“Tomcat v5.5 Server with EGL debugging support • Check: Always use this server when running this project • Click Finish
Your First Page 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” 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
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
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.zip file into: • C:\databases\ • Your files should look like this after you have unzipped them Note that the folder will appear after 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… • Expand the Other folder (at the bottom of the list) and select: Project Interchange • Click Next – this opens: Import Project Interchange Contents • From Import Project Interchange Contents: • Click the top Browse… button, next to From zip file, and browse to, and select: v7513Project_WAS.zip**** (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 • Click Select All • Click Finish • 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
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 not leave Preferences yet
Configure Preferences – 2 of 2 • Still from within the Preferences Window • Click Validation • Click Disable All • Click OK
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.jsp • Select: Run As Run on Server… • You will be prompted to choose a Server • Check: Set server as project default • Click Finish • 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!
What if My Server Doesn’t Start? • Try this solution: • From the Servers view • Right-click over the server entry • Select: Open • Select 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: • Uncheck • Apply • Check (again) • Apply (again) • Click OK
Summary • 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