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

92 lines
6.0 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="Set up a URL mapping rules file for the Webserver search engine on HTTP Server" />
<meta name="abstract" content="This topic provides information about how to set up a URL mapping rules file for use with the Webserver search engine with the IBM Web Administration for i5/OS interface." />
<meta name="description" content="This topic provides information about how to set up a URL mapping rules file for use with the Webserver search engine with the IBM Web Administration for i5/OS interface." />
<meta name="DC.Relation" scheme="URI" content="rzaieparsearch.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="rzaieurlmaprulz" />
<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>Set up a URL mapping rules file for the Webserver search engine on
HTTP Server</title>
</head>
<body id="rzaieurlmaprulz"><a name="rzaieurlmaprulz"><!-- --></a>
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
<h1 class="topictitle1">Set up a URL mapping rules file for the Webserver search engine on
HTTP Server</h1>
<div><p>This topic provides information about how to set up a URL mapping
rules file for use with the Webserver search engine with the <span>IBM<sup>®</sup> Web Administration for i5/OS™ interface</span>.</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>
<p>A mapping rules file is used to set the URL for documents found on a search.
The file is built using the configuration of the selected HTTP Server and
the specified URL prefix. </p>
<p>In order to allow documents to be opened when found on a search, you will
need an HTTP Server configuration that contains at least one routing directive.
The routing directive has two purposes. It determines what URLs will be accepted,
and it optionally maps those URLs to physical file names. These routing directives
are added to the mapping rules file and are used to set the URL for the documents
found on a search. </p>
<p>The format of the routing directive depends on the HTTP Server that is
selected. If you have documents in directory <em>/root/clothing/</em> but want
the URL to contain just <em>/clothing</em> as the directory, then you need a
routing directive in the HTTP Server configuration. If there is no routing
directive that maps a URL to an actual path, an error may occur attempting
to display the document. </p>
<p>To create a URL mapping rules file, do the following: </p>
<ol><li>Start the <span>IBM Web Administration for i5/OS interface</span>.
</li>
<li>Click the <strong>Advanced</strong> tab.</li>
<li>Click the <span class="uicontrol">Search Setup</span> subtab.</li>
<li>Expand <strong>Search Engine Setup</strong>. </li>
<li>Select your search index from the <strong>Index</strong> list. </li>
<li>Click <strong>Build URL mapping rules file</strong>. </li>
<li>Select your HTTP Server instance from the HTTP servers list. </li>
<li>Enter a prefix to use for URL addresses. For example, <em>http://www.ibm.com</em>.<p>This
optional prefix is the first part of the URL that is created for a document.
For example, if you enter a prefix such as <em>http://www.ibm.com</em>, the
URL of a document found on a search would be <em>http://www.ibm.com/clothing/doc1.htm</em>.
If this field is left blank, then the name of the server and port would be
assumed for the URL, for example, <em>/clothing/doc1.htm</em>. If the server
is started on a TCP/IP port other than the default of port 80, be sure to
include the port number in the prefix as follows: <em>http://myserver.com:8282</em>. </p>
</li>
<li>Accept the default entry in the <strong>Mapping rules file name</strong> field.<p>There
are two additional options for you to choose.</p>
<dl><dt class="dlterm">Create or replace the mapping rules file</dt>
<dd>Select this option to overwrite the existing mapping rules file.</dd>
</dl>
<dl><dt class="dlterm">Append the new list to the mapping rules file</dt>
<dd>Select this option to add any new information to the existing mapping
rules file. This option will not delete existing information.</dd>
</dl>
</li>
<li>Click <strong>Apply</strong>. </li>
</ol>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="rzaieparsearch.htm" title="This topic provides step-by-step tasks for the Webserver search engine.">Search tasks</a></div>
</div>
</div>
</body>
</html>