friedkiwi/ibm-information-center
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
master
ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaie_5.4.0.1/rzaiejkltomcatipservlets.htm

189 lines
11 KiB
HTML
Raw Permalink Blame History

<?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="topic" />
<meta name="DC.Title" content="JKL Toy Company configures an in-process servlet with ASF Tomcat on HTTP Server (powered by Apache)" />
<meta name="abstract" content="This scenario discusses how to configure ASF Tomcat to use an in-process servlet." />
<meta name="description" content="This scenario discusses how to configure ASF Tomcat to use an in-process servlet." />
<meta name="DC.Relation" scheme="URI" content="rzaiescenarios.htm" />
<meta name="copyright" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Rights.Owner" content="(C) Copyright IBM Corporation 2002,2006" />
<meta name="DC.Format" content="XHTML" />
<meta name="DC.Identifier" content="rzaiejkltomcatipservlets" />
<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>JKL Toy Company configures an in-process servlet with ASF Tomcat on
HTTP Server (powered by Apache)</title>
</head>
<body id="rzaiejkltomcatipservlets"><a name="rzaiejkltomcatipservlets"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">JKL Toy Company configures an in-process servlet with ASF Tomcat on
HTTP Server (powered by Apache)</h1>
<div><p>This scenario discusses how to configure ASF Tomcat to use an in-process
servlet.</p>
<div class="important"><span class="importanttitle">Important:</span> Information
for this topic supports the latest PTF levels for HTTP Server for i5/OS .
It is recommended that you install the latest PTFs to upgrade to the latest
level of the HTTP Server for i5/OS. Some of the topics documented here are
not available prior to this update. See <a href="http://www-03.ibm.com/servers/eserver/iseries/software/http/services/service.html" target="_blank">http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm</a> <img src="www.gif" alt="Link outside Information Center" /> for more information. </div>
<div class="section"><h4 class="sectiontitle">Scenario</h4><p>The JKL Toy Company (a fictitious company)
wants to take an existing Java™ servlet named <strong>jklservlet.class</strong> and
enable it to run, in-process, using the ASF Tomcat servlet engine with the
HTTP Server (powered by Apache). The <strong>Servlet and JSP Enablement</strong> wizard
will be used to modify the existing HTTP Server (powered by Apache), <strong>JKLTEST</strong>.</p>
</div>
<div class="section" id="rzaiejkltomcatipservlets__prerequisites"><a name="rzaiejkltomcatipservlets__prerequisites"><!-- --></a><h4 class="sectiontitle">Prerequisites</h4><ul><li>It is assumed you have read <a href="rzaiescenarios.htm">Scenarios for HTTP Server</a>.</li>
<li>It is assumed you have read and completed <a href="rzaiejklbasic.htm">JKL Toy Company creates an HTTP Server (powered by Apache)</a> or you have an existing HTTP Server (powered by Apache)
configuration.</li>
<li>It is assumed you have read <a href="rzaiesetauth.htm">User profiles and required authorities for HTTP Server</a>.</li>
<li>It is assumed you have a usable Java servlet compiled with JDK 1.2 or
later.</li>
</ul>
</div>
<div class="section"><h4 class="sectiontitle">Start the <span>IBM<sup>®</sup> Web Administration for i5/OS™ interface</span></h4><div class="note"><span class="notetitle">Note:</span> Enter
your <a href="rzaiesetauth.htm">Webmaster user profile username
and password</a> when prompted.</div>
<ol><li>Start a <a href="rzaieinstalling.htm#rzaieinstalling__web">Web
browser</a>.</li>
<li>Enter <strong>http://[iSeries_hostname]:2001</strong> in the location or URL field
.<p>Example: http://jkl_server:2001</p>
<div class="note"><span class="notetitle">Note:</span> If you have <a href="rzaiechangeport.htm">changed your port number for the <span>IBM Web Administration for i5/OS interface</span></a>,
replace port 2001 with your port number.</div>
</li>
<li>Click <strong>IBM HTTP
Server for iSeries</strong>.</li>
</ol>
<div class="note"><span class="notetitle">Note:</span> If the <span>IBM Web Administration for i5/OS interface</span> does
not start, see <a href="rzaieinstalling.htm">Install and test the HTTP Server</a>.</div>
</div>
<div class="section"><h4 class="sectiontitle">Set up ASF Tomcat for your HTTP Server (powered by Apache)</h4><ol><li>Click the <strong>Manage</strong> tab.</li>
<li>Click the <strong>HTTP Servers</strong> subtab.</li>
<li>Select your HTTP Server (powered by Apache) from the <strong>Server</strong> list.<p>Example:
JKLTEST</p>
</li>
<li>Select <strong>Global configuration</strong> from the <strong>Server area</strong> list.</li>
<li>Expand <strong>HTTP Tasks and Wizards</strong>.</li>
<li>Click <strong>Servlet and JSP Enablement</strong>.</li>
<li>Click <strong>Next</strong>.<div class="note"><span class="notetitle">Note:</span> If you have used the <strong>Servlet and JSP Enablement</strong> wizard
prior to this scenario, the wizard will reset all values to the wizard default.
Click <strong>Next</strong> to continue.</div>
</li>
<li>Select <strong>I want to use a servlet or Java Server Page (JSP), and I either
already have them or will provide them later</strong>.</li>
<li>Click <strong>Next</strong>.</li>
<li>Select <strong>I want to use a servlet. I either already have a class or jar
file containing the servlet or will provide it later</strong>.</li>
<li>Enter the name of your servlet in <strong>Servlet class name</strong> field.<p>Example:
jklservlet</p>
</li>
<li>Click <strong>Next</strong>.</li>
<li>Click <strong>Finish</strong>.</li>
</ol>
</div>
<div class="section"><h4 class="sectiontitle">Place your servlet file in the Web applications directory</h4><p>Using
a file transfer method such as iSeries™ Navigator, Netserver mapped drives,
or FTP, transfer your servlet class files to your HTTP Server (powered by
Apache) <strong>/www/[server_name]/webapps/app1/WEB-INF/classes/</strong> directory.
Place JAR files in the <strong>/www/server_name]/webapps/app1/WEB-INF/lib/</strong> directory.</p>
<p>Example:
/www/jkltest/webapps/app1/WEB-INF/classes/</p>
<p>Example: /www/jkltest/webapss/app1/WEB-INF/lib/</p>
<div class="note"><span class="notetitle">Note:</span> If
you transfer the servlet source files only, you will need to compile them
in the <strong>/classes</strong> directory. If transferring files over using a different
user profile, ensure the files have the appropriate authorities after the
transfer.</div>
</div>
<div class="section"><h4 class="sectiontitle">Restart your HTTP Server (powered by Apache)</h4><p>Select
one of the following methods below:</p>
<p><strong>Manage one server</strong></p>
<ol><li>Click the <strong>Manage</strong> tab.</li>
<li>Click the <strong>HTTP Servers</strong> subtab.</li>
<li>Select your HTTP Server from the Server list.</li>
<li>Click the <strong>Stop</strong> icon if the server is running.</li>
<li>Click the <strong>Start</strong> icon.</li>
</ol>
<p><strong>Manage all servers</strong></p>
<ol><li>Click the <strong>Manage</strong> tab.</li>
<li>Click the <strong>HTTP Servers</strong> subtab.</li>
<li>Select <strong>All Servers</strong> from the Server list.</li>
<li>Click the <span class="uicontrol">All HTTP Servers</span> tab.</li>
<li>Select your HTTP Server name in the table.<p>Example: JKLTEST</p>
</li>
<li>Click <strong>Stop</strong> if the server is running.</li>
<li>Click <strong>Start</strong>.</li>
</ol>
<div class="note"><span class="notetitle">Note:</span> If your HTTP Server (powered by Apache) does not start, see <a href="rzaietrouble.htm">Troubleshoot</a>.</div>
</div>
<div class="section"><h4 class="sectiontitle">Test your HTTP Server (powered by Apache)</h4><ol><li>Start a new Web browser.</li>
<li>Enter <strong>http://[iSeries_hostname]:[port]/app1/[servlet_name]</strong> in the
location or URL field.<p>Example: http://jkl_server:1975/app1/jklservlet</p>
<div class="note"><span class="notetitle">Note:</span> Servlet
names must be in lowercase.</div>
</li>
</ol>
<p>Your new servlet will be displayed.</p>
</div>
<div class="section"><h4 class="sectiontitle">View your HTTP Server (powered by Apache)
configuration</h4><p>Your configuration will look similar if you used the
given example in this and previous examples.</p>
<ol><li>Click the <strong>Manage</strong> tab.</li>
<li>Click the <strong>HTTP Servers</strong> subtab.</li>
<li>Select your HTTP Server (powered by Apache) from the <strong>Server</strong> list.<p>Example:
JKLTEST</p>
</li>
<li>Expand <strong>Tools</strong>.</li>
<li>Click <strong>Display Configuration File</strong>.</li>
</ol>
</div>
<div class="section"><pre>LoadModule jk_module /QSYS.LIB/QHTTPSVR.LIB/QZTCJK.SRVPGM
Listen *:1975
DocumentRoot /www/jkltest/htdocs
ServerRoot /www/jkltest
Options -ExecCGI -FollowSymLinks -SymLinksIfOwnerMatch -Includes -IncludesNoExec -Indexes -MultiViews
HotBackup Off
LogFormat "%h %l %u %t \"%r\" %&gt;s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
LogFormat "%{Cookie}n \"%r\" %t" cookie
LogFormat "%{User-agent}i" agent
LogFormat "%{Referer}i -&gt; %U" referer
LogFormat "%h %l %u %t \"%r\" %&gt;s %b" common
CustomLog logs/access_log combined
SetEnvIf "User-Agent" "Mozilla/2" nokeepalive
SetEnvIf "User-Agent" "JDK/1\.0" force-response-1.0
SetEnvIf "User-Agent" "Java/1\.0" force-response-1.0
SetEnvIf "User-Agent" "RealPlayer 4\.0" force-response-1.0
SetEnvIf "User-Agent" "MSIE 4\.0b2;" nokeepalive
SetEnvIf "User-Agent" "MSIE 4\.0b2;" force-response-1.0
JkWorkersFile /www/jkltest/conf/workers.properties
JkLogFile /www/jkltest/logs/jk.log
JkLogLevel Error
JkMount /app1/* inprocess
JkMount /servlet/* inprocess
&lt;Directory /&gt;
Order Deny,Allow
Deny From all
&lt;/Directory&gt;
&lt;Directory /www/jkltest/htdocs&gt;
Order Allow,Deny
Allow From all
&lt;/Directory&gt;</pre>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaiescenarios.htm" title="This topic provides information on how to use the IBM Web Administration for i5/OS interface to set up or manage your HTTP Server, step-by-step. Each task is specific and includes a usable HTTP Server configuration file when completed.">Scenarios for HTTP Server</a></div>
</div>
</div>
</body>
</html>
Reference in New Issue View Git Blame Copy Permalink