ibm-information-center/dist/eclipse/plugins/i5OS.ic.rzaie_5.4.0.1/rzaiejklconfigssi.htm

208 lines
12 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="topic" />
<meta name="DC.Title" content="JKL Toy Company adds dynamic content with server-side includes for HTTP Server (powered by Apache)" />
<meta name="abstract" content="This scenario discusses how to add dynamic content with server-side includes." />
<meta name="description" content="This scenario discusses how to add dynamic content with server-side includes." />
<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="rzaiejklconfigssi" />
<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 adds dynamic content with server-side includes for
HTTP Server (powered by Apache)</title>
</head>
<body id="rzaiejklconfigssi"><a name="rzaiejklconfigssi"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">JKL Toy Company adds dynamic content with server-side includes for
HTTP Server (powered by Apache)</h1>
<div><p>This scenario discusses how to add dynamic content with server-side
includes.</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 add some dynamic content to their index file (or welcome page) on
their Web site. The welcome Web page is located in /www/jkltest/htdocs. The
JKL Web administrator will add the current server time to display on their
Web page. </p>
<div class="note"><span class="notetitle">Note:</span> Server-side includes (SSI) create dynamic Web pages by
adding content to a Web page before it is sent to the browser. Server performance
may be impacted when processing SSIs.</div>
</div>
<div class="section" id="rzaiejklconfigssi__prerequisites"><a name="rzaiejklconfigssi__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 installed and are familiar with <a href="../rzahg/rzahginav.htm">iSeries™ Navigator</a>.</li>
</ul>
</div>
<div class="section"><h4 class="sectiontitle">Edit the index file (or welcome page) with iSeries Navigator</h4><p>For
in-depth information on how to use the iSeries Navigator, read the iSeries
Navigator help installed with the product.</p>
<ol><li>Start <strong>iSeries Navigator</strong>.</li>
<li>Expand the iSeries the HTTP Server is installed on.<p>Example: JKL_SERVER</p>
</li>
<li>Expand <strong>File Systems &gt; Integrated File System &gt; Root &gt; www &gt; [server_name]</strong>.<p>Example:
File Systems &gt; Integrated File System &gt; Root &gt; www &gt; jkltest</p>
</li>
<li>Click <strong>htdocs</strong>.<p>The directory <strong>htdocs</strong> is the default name
of your document root provided by the Create New HTTP Server wizard.</p>
</li>
<li>Right-click <strong>index.html</strong>.</li>
<li>Click Rename.</li>
<li>Rename the file <strong>index.shtml</strong>.</li>
<li>Right-click <strong>index.shtml</strong>.</li>
<li>Click <strong>Edit</strong>.</li>
<li>Enter the following lines below the &lt;BODY&gt; tag and before the &lt;/BODY&gt;
tag:<pre>&lt;p&gt;The current server time is:
&lt;!--#config timefmt="%T" --&gt;
&lt;!--#echo var="DATE_LOCAL" --&gt;
&lt;/p&gt;</pre>
</li>
<li>Save and close the file.</li>
</ol>
<p>See <a href="rzaiessicommands.htm">Server-side include commands for HTTP Server</a> for more
information about SSI commands.</p>
</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 server-side includes for 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>Server properties</strong>.</li>
<li>Click <strong>Container Management</strong>.</li>
<li>Click the <strong>Files</strong> tab in the form.</li>
<li>Click <strong>Add</strong> under the <strong>Files/Files Match containers</strong> table.</li>
<li>Select <strong>Files Match</strong> from the list in the <strong>Type</strong> column.</li>
<li>Enter <strong>\.shtml(\..+)?$</strong> in the <strong>File name or expression</strong> column.</li>
<li>Click <strong>Continue</strong>.</li>
<li>Click <strong>OK</strong>.</li>
<li>Select <strong>Files Match \.shtml(\..+)?$</strong> from the <strong>Server area</strong> list.</li>
<li>Expand <strong>Server Properties</strong>.</li>
<li>Click <strong>Dynamic Content and CGI</strong>.</li>
<li>Click the <strong>Server Side Includes</strong> tab in the form.</li>
<li>Select <strong>Allow server side files without CGI</strong> under <strong>Server side
includes</strong>.</li>
<li>Click <strong>OK</strong>.</li>
<li>Select <strong>Global configuration</strong> from the <strong>Server area</strong> list.</li>
<li>Expand <strong>Server Properties</strong>.</li>
<li>Click <strong>General Server Configuration</strong>.</li>
<li>Click the <strong>Welcome Pages</strong> tab in the form.</li>
<li>Select <strong>index.html</strong> in the <strong>Welcome/index file names</strong> table.</li>
<li>Rename the file <strong>index.shtml</strong> in the <strong>File name</strong> column.</li>
<li>Click <strong>Continue</strong>.</li>
<li>Click <strong>OK</strong>.</li>
</ol>
</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]</strong> in the location or URL field.<p>Example:
http://jkl_server:1975</p>
</li>
</ol>
<p>The Web page now displays the current server time.</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>Listen *:1975
DocumentRoot /www/jkltest/htdocs
ServerRoot /www/jkltest
Options -ExecCGI -FollowSymLinks -SymLinksIfOwnerMatch -Includes -IncludesNoExec -Indexes -MultiViews
AccessFileName .htaccess
LogFormat "%h %l %u %t \"%r\" %|s %b \"%{Referer}i\" \"%{User-Agent}i\"" combined
LogFormat "%{Cookie}n \"%r\" %t" cookie
LogFormat "%{User-agent}i" agent
LogFormat "%{Referer}i -| %U" referer
LogFormat "%h %l %u %t \"%r\" %|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
DirectoryIndex index.shtml
&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;
&lt;FilesMatch \.shtml(\..+)?$&gt;
Options +IncludesNoExec
AddOutputFilter INCLUDES .shtml
&lt;/FilesMatch&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>