267 lines
15 KiB
HTML
267 lines
15 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 user directories for HTTP Server (powered by Apache)" />
|
|
<meta name="abstract" content="This scenario discusses how to add a user directory." />
|
|
<meta name="description" content="This scenario discusses how to add a user directory." />
|
|
<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="rzaiejklconfigpersonal" />
|
|
<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 user directories for HTTP Server (powered by Apache)</title>
|
|
</head>
|
|
<body id="rzaiejklconfigpersonal"><a name="rzaiejklconfigpersonal"><!-- --></a>
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
|
<h1 class="topictitle1">JKL Toy Company adds user directories for HTTP Server (powered by Apache)</h1>
|
|
<div><p>This scenario discusses how to add a user directory.</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)
|
|
has decided to allow employees to maintain their own personal Web pages.
|
|
The JKL Web administrator wants the personal Web pages to be stored in a directory
|
|
of the root file system called <strong>/home</strong> on the <strong>JKLTEST</strong> HTTP Server
|
|
(powered by Apache). The directory <strong>/home</strong> will contain one subdirectory
|
|
for each employee.</p>
|
|
<p>To begin, the JKL Web administrator creates a user
|
|
profile and user directory for fellow employee Sharon Jones. The new user
|
|
profile will be called <strong>SJONES</strong> on the iSeries™ and the new user directory will
|
|
be located at <strong>/home/sjones</strong>. </p>
|
|
</div>
|
|
<div class="section" id="rzaiejklconfigpersonal__prerequisites"><a name="rzaiejklconfigpersonal__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 and completed <a href="rzaiejklnewdir.htm">JKL Toy Company adds a new directory to HTTP Server (powered by Apache)</a>.</li>
|
|
<li>It is assumed you have installed and are familiar with <a href="../rzahg/rzahginav.htm">iSeries
|
|
Navigator</a>.</li>
|
|
<li>It is assumed you have read <a href="rzaiesetauth.htm">User profiles and required authorities for HTTP Server</a>.</li>
|
|
</ul>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Create a new user profile 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>
|
|
<div class="note"><span class="notetitle">Note:</span> It is not necessary to
|
|
create a new user profile on your iSeries if you want to use an existing profile.
|
|
If using an existing profile, make certain the user profile has the appropriate
|
|
permissions.</div>
|
|
<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>Select <strong>Users and Groups</strong>, or click the Users and Group icon in the
|
|
toolbar.</li>
|
|
<li>Click <strong>Create a new user</strong>, or click the Create a New Use icon in
|
|
the toolbar.</li>
|
|
<li>Enter a new user name.<p>Example: SJONES</p>
|
|
</li>
|
|
<li><strong>Optional</strong>: Enter a description for this new profile.<p>Example:
|
|
This is a test profile.</p>
|
|
</li>
|
|
<li><strong>Optional</strong>: Add a password if necessary for your iSeries.</li>
|
|
<li>Click <strong>Capabilities</strong>.</li>
|
|
<li>Set the system privileges to allow the new user profile to use the HTTP
|
|
Server.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
<li>Click <strong>Add</strong>.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Create a new user directory with iSeries Navigator</h4><div class="note"><span class="notetitle">Note:</span> The <strong>/home</strong> directory
|
|
comes preinstalled on your iSeries.</div>
|
|
<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 > Integrated File System > Root</strong>.</li>
|
|
<li>Right-click directory <strong>home</strong>.</li>
|
|
<li>Click <strong>New Folder</strong>.</li>
|
|
<li>Enter the name of your new user profile.<p>Example: sjones</p>
|
|
</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Copy HTML welcome page to user directory with iSeries Navigator</h4><p>The
|
|
new user directory does not contain any files. Use the iSeries Navigator to
|
|
copy <strong>index.html</strong>, found in <strong>/www/[server_name]/htdocs</strong> directory
|
|
of your HTTP Server (powered by Apache), to your new user directory.</p>
|
|
<p>Example:
|
|
/www/jkltest/htdocs</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 > Integrated File Systems > Root > www > [server_name]
|
|
> htdocs</strong>.<p>Example: /www/jkltest/htdocs</p>
|
|
</li>
|
|
<li>Right-click file <strong>index.html</strong>.</li>
|
|
<li>Click <strong>Copy</strong>.</li>
|
|
<li>Right-click the new user directory.<p>Example: sjones</p>
|
|
</li>
|
|
<li>Click <strong>Paste</strong>.</li>
|
|
</ol>
|
|
<p><strong>Optional</strong>: Edit file index.html in any way you choose. This
|
|
is the file the HTTP Server (powered by Apache) will look for when this directory
|
|
is requested by the Web browser.</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 user directories 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>URL Mapping</strong>.</li>
|
|
<li>Click the <strong>User Directories</strong> tab in the form.</li>
|
|
<li>Select <strong>Disable all users except for the following</strong> under <strong>Enable
|
|
or Disable user directories</strong>.</li>
|
|
<li>Click <strong>Add</strong> under the <strong>Enabled users</strong> table.</li>
|
|
<li>Enter the name of your new user profile.<p>Example: sjones</p>
|
|
</li>
|
|
<li>Click <strong>Continue</strong>.</li>
|
|
<li>Click <strong>Add</strong> under the <strong>Current user directories</strong> table.</li>
|
|
<li>Enter <strong>/home</strong> in the User directories column.<div class="note"><span class="notetitle">Note:</span> The order in which
|
|
the user directories are listed determines which directory the HTTP Server
|
|
(powered by Apache) will use first. If a match is not found in the first (top)
|
|
user directory, the next user directory listed will be used. This continues
|
|
until a match is found.</div>
|
|
</li>
|
|
<li>Click <strong>Continue</strong>.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
</ol>
|
|
</div>
|
|
<div class="section"><h4 class="sectiontitle">Set up /home directory for HTTP Server (powered by Apache)</h4><p>After
|
|
creating the user directory, you must set up your HTTP Server (powered by
|
|
Apache) to provide access to directory <strong>/home</strong>.</p>
|
|
<ol><li>Click the <strong>Manage</strong> tab.</li>
|
|
<li>Click the <span class="uicontrol">HTTP Servers</span> subtab.</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>Directories</strong> tab in the form.</li>
|
|
<li>Click <strong>Add</strong> under <strong>Directory/Directory Match containers</strong> table.</li>
|
|
<li>Select <strong>Directory</strong> from the list in the <strong>Type</strong> column.</li>
|
|
<li>Enter <strong>/home</strong> in the <strong>Directory path or expression</strong> column.</li>
|
|
<li>Click <strong>Continue</strong>.</li>
|
|
<li>Click <strong>OK</strong>.</li>
|
|
<li>Select <strong>Directory /home</strong> from the <strong>Server area</strong> list.</li>
|
|
<li>Click <strong>Security</strong>.</li>
|
|
<li>Click the <strong>Control Access</strong> tab in the form.</li>
|
|
<li>Select <strong>Deny then allow</strong> from the <strong>Order for evaluating access</strong> list
|
|
under <strong>Control access based on where the request is coming from</strong>.</li>
|
|
<li>Select <strong>Allow access to all, except the following</strong> under <strong>Control
|
|
access based on where the request is coming from</strong>.<div class="note"><span class="notetitle">Note:</span> Do not add restrictions
|
|
at this time. Return to this form at the end of the scenario to add restrictions.</div>
|
|
</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>Open a new Web browser.</li>
|
|
<li>Enter <strong>http://[iSeries_hostname]:[port]/~[user_directory]</strong> in the
|
|
location or URL field .<p>Example: http://jkl_server:1975/~sjones</p>
|
|
</li>
|
|
</ol>
|
|
<p>Your new user directory will display the generic HTML file copied
|
|
from directory /htdocs.</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
|
|
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
|
|
UserDir Disable
|
|
UserDir Enable Sjones
|
|
UserDir /home
|
|
<Directory />
|
|
Order Deny,Allow
|
|
Deny From all
|
|
</Directory>
|
|
<Directory /www/jkltest/htdocs>
|
|
Order Allow,Deny
|
|
Allow From all
|
|
</Directory>
|
|
<Directory /home>
|
|
Order Deny, Allow
|
|
Allow From all
|
|
</Directory></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> |