Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0

Size: px

Start display at page:

Download "Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0"

Carmel Richard
5 years ago
Views:

1 Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 By Gilbert Herschberger ( Date Written : 6 April 2010 Goal In this exercise, we will download and install Apache Tomcat 6.0 (Tomcat) with EGL Community Edition (EGL-CE). We will start and stop the server to confirm that Tomcat can be used with EGL-CE. Once installed, a Tomcat server can be reused. One installation of Tomcat can be shared by multiple workspaces created with EGL-CE. One installation of Tomcat can be shared by multiple Eclipse-based IDEs, such as EGL-CE and Rational Business Developer (RBD). Series This document is part of an education and training series. Other exercises include: Exercise Ping EGL Web Service. In this exercise, create your first EGL web service and reduce the size of your web application by removing unused bits. This exercise features EGL Community Edition and Apache Tomcat 6.0. Target Runtime Environment For this exercise, the target runtime server is an application server. Apache Tomcat 6.0 Target Development Environment For this exercise, the following software is part of the development environment. EGL Community Edition 1.0 Apache Tomcat 6.0 Exercise overview Use the following procedures to use EGL-CE with Tomcat. 1. Start your IDE 2. Stop your IDE 3. Preparing your workspace 4. Download and install Tomcat downloading and installing Tomcat for the first time 5. Removing a server document 6. Connecting a workspace of EGL-CE to Tomcat - connecting a workspace of EGL-CE to a preexisting installation of Tomcat 7. Starting Tomcat 8. Restarting Tomcat 9. Stopping Tomcat Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 1

Prerequisites The following are prerequisites for this exercise. 1. EGL Community Edition has been installed. 2. Apache Tomcat 6 has not been downloaded; it has not been installed.

2 Prerequisites The following are prerequisites for this exercise. 1. EGL Community Edition has been installed. 2. Apache Tomcat 6 has not been downloaded; it has not been installed. Procedure 1: Start your IDE The following procedure illustrates how to start EGL-CE. 1. Start your interactive development environment (IDE). 1. For Microsoft Windows, double-click the EGL-CE 1.0 ( ) icon on your Windows desktop to start your IDE. 2. Switch to the eglws (EGL Web Services) workspace. 1. For Microsoft Windows, type C:\lab\eglws in the directory field. 2. Press the OK button. Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 2

3 Procedure 2: Stop your IDE The following procedure illustrates how to stop your IDE. 1. Switch to the EGL perspective, if necessary. 2. Switch to the Servers view. 3. Stop each server, if necessary. Caution: Unlike Tomcat, some servers, such as WebSphere, do not stop when you stop your IDE. 4. Pull down the File menu and select the Exit option. Procedure 3: Preparing your workspace 1. Start your IDE. 2. Close the Welcome view, if necessary. 1. Press the Close (X) icon on the Welcome view tab. 3. Switch to the EGL perspective, if necessary. Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 3

4 Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 4

4. By default, Tomcat listens for web service requests on port 8080. When generating a web services description language (WSDL) file, EGL in EGL-CE uses the server document.

5 4. By default, Tomcat listens for web service requests on port When generating a web services description language (WSDL) file, EGL in EGL-CE uses the server document. Caution: Unlike Rational Business Developer (RBD), EGL-CE ignores the preference called service port for WSDL generation. In RBD, this setting is important for generating SOAP web services for Tomcat. When generating a WSDL file, EGL in RBD uses workspace preferences, ignoring the server document. 1. Pull down the Window menu and select the Preferences option. 2. Expand the EGL folder. 3. Select the Service preferences. 4. Confirm the WSDL Document Style/Encoding field is Document-Literal/Wrapped. 5. Confirm the service host is localhost. 6. Type 8080 in the Port field. 7. Press the OK button. Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 5

6 5. Confirm the Build Automatically feature is enabled. Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 6

7 Procedure 4: Downloading and installing Tomcat Use this procedure when Tomcat has not been installed on a machine, or you want to create a separate installation of Tomcat server. The following procedure illustrates how to download and install Tomcat using C:\lab\tomcat6 as the target installation directory. 1. Start your IDE. 2. Switch to the EGL perspective, if necessary. 3. Switch to the Servers view. The Servers view displays a list of servers used by projects in this workspace. Note: Unlike Rational Business Developer (RBD), a workspace for EGL-CE does not automatically configure servers installed with IBM Installation Manager. 4. Right-click in the white space of the Servers view and select the New Server option. 5. Result: The New Server wizard is displayed. Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 7

8 6. Fill in the Define a New Server page of the New Server wizard. 1. Confirm the Server's host name field is localhost. 2. Expand the Apache folder. 3. Select Tomcat v6.0 Server. 4. Confirm the Server name field is Tomcat v6.0 Server at localhost. 5. Press the Next button. 6. Result: The Tomcat Server page is displayed. Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 8

9 7. Press the Download and Install button in the Tomcat Server page of the New Server wizard. 8. Result: The Download and Install wizard is displayed. Exercise 3.1 EGL-CE 1.0 and Tomcat 6.0 9

9. Fill in the Feature License page of the Download and Install wizard. 1. Review the terms of the license. 2. Select the I accept the terms of the license agreement option.

10 9. Fill in the Feature License page of the Download and Install wizard. 1. Review the terms of the license. 2. Select the I accept the terms of the license agreement option. 3. Press the Finish button. 4. Result: The Brows for Folder dialog box is displayed. 10. Fill in the Browse for Folder dialog box. Exercise 3.1 EGL-CE 1.0 and Tomcat

1. Navigate to the lab directory. 2. Press the Make New Folder button. 3. Type tomcat6 in the Folder field. 4. Select the tomcat6 folder. 5. Press the OK button. 6.

11 1. Navigate to the lab directory. 2. Press the Make New Folder button. 3. Type tomcat6 in the Folder field. 4. Select the tomcat6 folder. 5. Press the OK button. 6. Result 1: The Tomcat Server page of the New Server wizard is displayed with the following message: The Tomcat installation directory is not valid. It is missing expected file or folder lib/jasper-el.jar. 7. Result 2: The Status bar is displayed in the IDE window. (You may need to move the New Server window to see it.) 8. Result 3: Apache Tomcat 6 is downloaded from the Internet. 9. Result 4: Apache Tomcat 6 is installed. 11. Wait until the download and install process is complete. Exercise 3.1 EGL-CE 1.0 and Tomcat

12 12. Confirm the success of the Download and Install process (and remove the error message). 13. Press the Browse button in the Tomcat Server page of the New Server wizard. 1. Result: The Browse for Folder dialog box is displayed. 2. Expand the tomcat6 directory. 3. Confirm the directories exist as shown. 4. Press the OK button. 5. Result: The Tomcat Server page is displayed without an error message. Exercise 3.1 EGL-CE 1.0 and Tomcat

13 14. Fill in the Tomcat Server page of the New Server wizard. 1. Confirm the Name field is Apache Tomcat v Confirm the Tomcat installation directory field. 3. Confirm the JRE field is Workbench default JRE. 4. Press the Next button. 5. Result: The Add and Remove Projects page is displayed. Exercise 3.1 EGL-CE 1.0 and Tomcat

14 15. Fill in the Add and Remove Projects page of the New Server wizard. 1. Press the Finish button. 2. Result: The Tomcat v6.0 Server at localhost document is added to the Servers view. Exercise 3.1 EGL-CE 1.0 and Tomcat

15 16. Confirm the Servers view now shows a server document for Tomcat v6.0 Server at localhost as shown. 17. Review the server document. 1. To open the document, right-click on the Apache Tomcat v6.0 Server at localhost document and select the Open option. 2. Explore the contents. 1. For example, the HTTP/1.1 port. When generating a web service description language (WSDL) file, for example, this port setting is used. 3. Close the document. Exercise 3.1 EGL-CE 1.0 and Tomcat

Procedure 5: Removing a server document Deleting a server document does not delete the server software. Rather, it removes a connection between your workspace and a server.

16 Procedure 5: Removing a server document Deleting a server document does not delete the server software. Rather, it removes a connection between your workspace and a server. The following procedure illustrates how to delete a server document, using Apache Tomcat 6.0 Server as an example. 1. Start your IDE. 2. Switch to the EGL perspective, if necessary. 3. From the Servers view, right-click on the Tomcat v6.0 Server at localhost document and select the Delete option. 4. Result: The Delete Server dialog box is displayed. 5. Fill in the Delete Server dialog box. 1. Confirm the Delete unused server configuration(s) field is checked. 2. Press the OK button. 3. Result: The server document is deleted. 6. Confirm the Servers view does not show a server document. Exercise 3.1 EGL-CE 1.0 and Tomcat

17 Procedure 6: Connecting a workspace of EGL-CE to Tomcat Use this procedure for each workspace. The following procedure illustrates how to add a server document, using Apache Tomcat 6.0 Server as an example. 1. Start your IDE. 2. Switch to the EGL perspective, if necessary. 3. Switch to the Servers view. The Servers view displays a list of servers used by projects in this workspace. 4. Right-click in the white space of the Servers view and select the New Server option. 5. Result: The New Server wizard is displayed. Exercise 3.1 EGL-CE 1.0 and Tomcat

6. Fill in the Define a New Server page of the New Server wizard. 1. Confirm the Server's host name field is localhost. 2. Expand the Apache folder. 3. Select Tomcat v6.0 Server. 4.

18 6. Fill in the Define a New Server page of the New Server wizard. 1. Confirm the Server's host name field is localhost. 2. Expand the Apache folder. 3. Select Tomcat v6.0 Server. 4. Confirm the Server name field is Tomcat v6.0 Server at localhost. 5. Press the Next button. 6. Result: The Tomcat Server page is displayed. Exercise 3.1 EGL-CE 1.0 and Tomcat

19 7. Press the Browse button in the Tomcat Server page of the New Server wizard. 1. Result: The Browse for Folder dialog box is displayed. 2. Navigate to the lab directory. 3. Select the tomcat6 directory. 4. Press the OK button. 5. Result: The Tomcat Server page is displayed. Exercise 3.1 EGL-CE 1.0 and Tomcat

8. Fill in the Tomcat Server page of the New Server wizard. 9. Confirm the Name field is Apache Tomcat v6.0. 10. Confirm the Tomcat installation directory field. 11.

20 8. Fill in the Tomcat Server page of the New Server wizard. 9. Confirm the Name field is Apache Tomcat v Confirm the Tomcat installation directory field. 11. Confirm the JRE field is Workbench default JRE. 12. Press the Next button. 13. Result: The Add and Remove Projects page is displayed. Exercise 3.1 EGL-CE 1.0 and Tomcat

21 14. Fill in the Add and Remove Projects page of the New Server wizard. 1. Press the Finish button. 2. Result: The Tomcat v6.0 Server at localhost document is added to the Servers view. Exercise 3.1 EGL-CE 1.0 and Tomcat

22 15. Confirm the Servers view now shows a server document for Tomcat v6.0 Server at localhost as shown. 16. Review the server document. 1. To open the document, right-click on the Apache Tomcat v6.0 Server at localhost document and select the Open option. 2. Explore the contents. 3. Close the document. Procedure 7: Starting Tomcat The following procedure illustrates how to start a server, using Tomcat as an example. 1. Start your IDE. 2. Switch to the EGL perspective. 3. From the Servers view, select the server called Apache Tomcat v6.0 Server at localhost. 4. Press the Start ( )icon. 5. Result 1: The Start icon starts a launcher. 6. Result 2: In turn, the launcher starts Tomcat. 7. Result 3: The Servers view displays Started and Synchronized. Best Practice: Do not proceed with your development project until Tomcat starts. Do not import Exercise 3.1 EGL-CE 1.0 and Tomcat

23 a Tomcat-dependent project from a Project Interchange File until Tomcat starts. Note: Sometimes, removing the server document (Procedure 4) and adding it again (Procedure 5) can eliminate certain errors and allow Tomcat to start. Procedure 8: Restarting Tomcat The following procedure illustrates how to restart Tomcat. 1. Switch to the EGL perspective, if necessary. 2. From the Servers view, select the server called Tomcat v6.0 Server at localhost. 3. Press the Start ( )icon. 4. Result 1: The Start icon sends a polite request to Tomcat, asking it to stop itself. 5. Result 2: Tomcat stops. 6. Result 3: The Start icon starts a launcher. 7. Result 4: In turn, the launcher starts Tomcat. 8. Result 5: The Servers view displays Started and Synchronized. Procedure 9: Stopping Tomcat The Apache Tomcat v6.0 Server stops automatically when you close your IDE. The following procedure illustrates how to stop Tomcat using EGL-CE. Caution: Unlike Tomcat, some servers, such as WebSphere, do not stop when you stop your IDE. 1. Start your IDE 2. Switch to the EGL perspective. 3. From the Servers view, select the server called Tomcat v6.0 Server at localhost. 4. Press the Stop ( ) icon. 5. Result 1: The Stop icon sends a polite request to Tomcat, asking it to stop itself. 6. Result 2: Tomcat stops. 7. Result 3: In the Servers view, the state is Stopped. Exercise 3.1 EGL-CE 1.0 and Tomcat

24 Exercise 3.1 EGL-CE 1.0 and Tomcat

WA1547 WebSphere Portal v6 Programming. Classroom Setup Guide. Web Age Solutions Inc. Copyright Web Age Solutions Inc.

WA1547 WebSphere Portal v6 Programming Classroom Setup Guide Web Age Solutions Inc. 1 Table of Contents Classroom Requirements...3 Part 1 - Minimum Hardware Requirements...3 Part 2 - Minimum Software Requirements...3