Set up a URL mapping rules file for the Webserver search engine on HTTP Server

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.

Important: 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 http://www.ibm.com/servers/eserver/iseries/software/http/services/service.htm for more information.

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.

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.

The format of the routing directive depends on the HTTP Server that is selected. If you have documents in directory /root/clothing/ but want the URL to contain just /clothing 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.

To create a URL mapping rules file, do the following:

1. Start the IBM Web Administration for i5/OS interface.
2. Click the Advanced tab.
3. Click the Search Setup subtab.
4. Expand Search Engine Setup.
5. Select your search index from the Index list.
6. Click Build URL mapping rules file.
7. Select your HTTP Server instance from the HTTP servers list.
8. Enter a prefix to use for URL addresses. For example, http://www.ibm.com.

   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 http://www.ibm.com, the URL of a document found on a search would be http://www.ibm.com/clothing/doc1.htm. If this field is left blank, then the name of the server and port would be assumed for the URL, for example, /clothing/doc1.htm. 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: http://myserver.com:8282.

9. Accept the default entry in the Mapping rules file name field.

   There are two additional options for you to choose.

   Create or replace the mapping rules file

   Select this option to overwrite the existing mapping rules file.

   Append the new list to the mapping rules file

   Select this option to add any new information to the existing mapping rules file. This option will not delete existing information.

10. Click Apply.