ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzam5_5.4.0.1/rzam5apache.htm

98 lines
6.1 KiB
HTML

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html
PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
<meta name="security" content="public" />
<meta name="Robots" content="index,follow" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta name="DC.Type" content="concept" />
<meta name="DC.Title" content="Configure your ASF Jakarta Tomcat servlet engine for HTTP Server (powered by Apache)" />
<meta name="abstract" content="Create and configure the servlet engine for your wireless network." />
<meta name="description" content="Create and configure the servlet engine for your wireless network." />
<meta name="DC.Relation" scheme="URI" content="rzam5webappserver.htm" />
<meta name="DC.Relation" scheme="URI" content="rzam5configure.htm" />
<meta name="DC.Relation" scheme="URI" content="http://jakarta.apache.org/tomcat/index.html" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2005, 2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2005, 2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzam5apache" />
<meta name="DC.Language" content="en-us" />
<!-- All rights reserved. Licensed Materials Property of IBM -->
<!-- US Government Users Restricted Rights -->
<!-- Use, duplication or disclosure restricted by -->
<!-- GSA ADP Schedule Contract with IBM Corp. -->
<link rel="stylesheet" type="text/css" href="./ibmdita.css" />
<link rel="stylesheet" type="text/css" href="./ic.css" />
<title>Configure your ASF Jakarta Tomcat servlet engine for HTTP Server (powered
by Apache)</title>
</head>
<body id="rzam5apache"><a name="rzam5apache"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Configure your ASF Jakarta Tomcat servlet engine for HTTP Server (powered
by Apache)</h1>
<div><p>Create and configure the servlet engine for your wireless network.</p>
<p>The following tasks will help you set up an ASF Tomcat servlet engine for
HTTP Server (powered by Apache) to run iSeries™ Navigator for Wireless:</p>
<div class="section"><h4 class="sectiontitle">Requirements</h4><p>Before you begin, you must have QSECOFR
authority and the following installed:</p>
<ul><li>IBM<sup>®</sup> HTTP
Server (5722-DG1)</li>
</ul>
<div class="note"><span class="notetitle">Note:</span> The following instructions will create a new instance of an HTTP
Server; you cannot use the following instructions to set up iSeries Navigator
for Wireless on an existing HTTP Server.</div>
</div>
<div class="section"><h4 class="sectiontitle">Create your Web application server</h4><p>Running the following
command will add the iSeries Navigator for Wireless servlet to the Apache
Software Foundation Jakarta Tomcat servlet engine. It will also set up an IBM HTTP
server (powered by Apache) named &lt;<em>HTTPInstanceName</em>&gt; that listens
for requests on port &lt;<em>port number</em>&gt;. Items in [brackets] are optional,
and if you do not specify a value, a default value will be used. Replace items
in &lt;<em>italics</em>&gt; with your own information:</p>
<pre>CALL QSYSDIR/QYPVSETUP '-tomcat [-httpinstance &lt;<em>HTTPInstanceName</em>&gt;] [-port &lt;<em>port
number</em>&gt;][-javaversion &lt;<em>java version</em>&gt;]'</pre>
<p>The parameters
in the command above are defined as follows:</p>
<dl><dt class="dlterm">-tomcat</dt>
<dd>Specifies that ASF Tomcat is the servlet engine used to run iSeries Navigator
for Wireless.</dd>
<dt class="dlterm">-httpinstance &lt;<em>HTTPInstanceName</em>&gt;</dt>
<dd>Specifies the name of the HTTP instance used to run the ASF Tomcat servlet
engine. If you do not specify an instance name, the default is MCP. When specifying
an instance name, the name cannot include spaces and must be less than 10
characters long.</dd>
<dt class="dlterm">-port &lt;<em>port number</em>&gt;</dt>
<dd> Specifies the port for the HTTP Server to listen for requests. If the
port is not specified, the default is 8110.</dd>
<dt class="dlterm">-javaversion &lt;<em>java version</em>&gt;</dt>
<dd>Specifies the version of Java™ Developer's Kit to use. Valid values
for this parameter are 1.3 and 1.2. If you do not specify a java version,
the default is 1.3 if it is installed, otherwise 1.2 will be used.</dd>
</dl>
</div>
<div class="section"><h4 class="sectiontitle">Start your Web application server</h4><p>ASF Tomcat runs
'in process'; this means that it starts and ends when the HTTP server starts
and ends. After you run the above command and setup is complete, you need
to start the HTTP Server by running the following command:</p>
<pre>STRTCPSVR SERVER(*HTTP) HTTPSVR(&lt;<em>HTTPInstanceName</em>&gt;)</pre>
<p>Now that you have finished setting up your web application server, you
can continue to configure your wireless environment.</p>
<p>For more information
about ASF Jakarta Tomcat, go to http://jakarta.apache.org/tomcat/index.html.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzam5webappserver.htm" title="Set up iSeries Navigator for Wireless to run using an ASF Jakarta Tomcat servlet engine, or a WebSphere Application Server (WAS). You can find set up instructions here for WAS 5.0 Base Edition and WAS 5.0 Express Edition.">Choose a Web application server</a></div>
</div>
<div class="relconcepts"><strong>Related concepts</strong><br />
<div><a href="rzam5configure.htm" title="Modify your web application server and firewall configuration so that iSeries Navigator for Wireless will run properly.">Configure your wireless environment</a></div>
</div>
<div class="relinfo"><strong>Related information</strong><br />
<div><a href="http://jakarta.apache.org/tomcat/index.html" target="_blank">http://jakarta.apache.org/tomcat/index.html</a></div>
</div>
</div>
</body>
</html>