| <?xml version="1.0" encoding="utf-8"?> |
| <!--Arbortext, Inc., 1988-2005, v.4002--> |
| <!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" |
| "../../dtd/task.dtd"> |
| <task id="creatinganapachetomcatserver" xml:lang="en-us"> |
| <title>Creating an Apache Tomcat server and Web project</title> |
| <shortdesc>If you plan to create a Web service that uses Apache Jakarta Tomcat |
| as its server, Tomcat must be installed and a server created before you begin |
| creating your Web service.</shortdesc> |
| <prolog><metadata> |
| <keywords><indexterm>Web services<indexterm>creating an Apache Tomcat server</indexterm></indexterm> |
| <indexterm>Axis runtime environment<indexterm>creating an Apache Tomcat server</indexterm></indexterm> |
| <indexterm>Tomcat server<indexterm>creating a server for Web services</indexterm></indexterm> |
| </keywords> |
| </metadata></prolog> |
| <taskbody> |
| <prereq>Install Apache Jakarta Tomcat from this URL: <xref href="http://jakarta.apache.org/tomcat" |
| scope="external">http://jakarta.apache.org/tomcat</xref></prereq> |
| <context>Once you have installed the server, create a Tomcat server in the |
| workbench by doing the following: </context> |
| <steps> |
| <step><cmd>From the File menu, select <uicontrol>New > Other > Server > Server |
| > Next</uicontrol>.</cmd></step> |
| <step><cmd>Select Tomcat v 3.x, 4.x or v5.x as the server type, electing the |
| correct version of Tomcat for your install, and click <uicontrol>Next</uicontrol>.</cmd> |
| </step> |
| <step><cmd>On the Tomcat server page:</cmd> |
| <substeps> |
| <substep><cmd>Enter a server name.</cmd></substep> |
| <substep><cmd>Specify where Tomcat is installed.</cmd></substep> |
| <substep><cmd>Click <uicontrol>Installed JREs</uicontrol>, click <uicontrol>Add</uicontrol>, |
| and enter the appropriate information for the JDK you plan to use for Tomcat. |
| For example, for Tomcat v5.0 the JRE name would be jdk141 and the JRE home |
| would be the home directory for JDK 1.4.1. Click <uicontrol>OK</uicontrol> twice |
| once you have entered this information. Ensure that the newly added JDK is |
| now selected in the JRE field of the Tomcat server page. Note that if you |
| point the server at a JRE rather than a JDK the JSPs will not properly compile |
| and will not be able to run on the Tomcat server.</cmd></substep> |
| </substeps> |
| </step> |
| <step><cmd>Click <uicontrol>Finish</uicontrol>.</cmd><stepresult> To see the |
| server you have created in the workspace, from the Window menu select <uicontrol>Show |
| view > Other > Server > Servers > Ok.</uicontrol> </stepresult></step> |
| </steps> |
| <example><p>To build a dynamic Web project that points to the Tomcat server |
| that you have created:</p><ol> |
| <li>Create the service Web project by selecting <uicontrol>New > Web > Dynamic |
| Web project</uicontrol>. Enter the following information: <ul> |
| <li>Project Name: enter a project name</li> |
| <li>Target runtime: Tomcat server v3.x, 4.x or 5.x depending on the version |
| you installed. If it is not listed, click New and browse to the location where |
| it is installed.</li> |
| <li>Ensure that <uicontrol>Add project to an EAR</uicontrol> is <i>not</i> selected.</li> |
| </ul></li> |
| <li>Click <uicontrol>Finish</uicontrol>.</li> |
| <li>To associate the project with the server, right-click the Tomcat server |
| you created in the Server view and select <uicontrol>Add and remove projects</uicontrol>. |
| Select the service and client projects from the Available projects list and |
| click <uicontrol>Add</uicontrol>. </li> |
| </ol></example> |
| </taskbody> |
| </task> |