215 lines
12 KiB
HTML
215 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="Manage search indexes for the Webserver search engine on HTTP Server" />
|
||
|
|
<meta name="abstract" content="This topic provides information about how to manage your search indexes with the IBM Web Administration for i5/OS interface." />
|
||
|
|
<meta name="description" content="This topic provides information about how to manage your search indexes 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="rzaiemngsrchindx" />
|
||
|
|
<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>Manage search indexes for the Webserver search engine on HTTP Server</title>
|
||
|
|
</head>
|
||
|
|
<body id="rzaiemngsrchindx"><a name="rzaiemngsrchindx"><!-- --></a>
|
||
|
|
<!-- Java sync-link --><script language="Javascript" src="../rzahg/synch.js" type="text/javascript"></script>
|
||
|
|
<h1 class="topictitle1">Manage search indexes for the Webserver search engine on HTTP Server</h1>
|
||
|
|
<div><p>This topic provides information about how to manage your search
|
||
|
|
indexes 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>This topic explains how to manage search indexes for the
|
||
|
|
Webserver search engine on HTTP Server. <a href="rzaiesetsearch.htm">Set up the Webserver search engine on HTTP Server (powered by Apache)</a> to
|
||
|
|
learn how to create a search index. </p>
|
||
|
|
<p>The following topics explain how to manage your search index.</p>
|
||
|
|
<ul><li><a href="#update">Update search index</a></li>
|
||
|
|
<li><a href="#merge">Merge search index</a></li>
|
||
|
|
<li><a href="#delete">Delete search index</a></li>
|
||
|
|
<li><a href="#view">View the status of search index</a></li>
|
||
|
|
</ul>
|
||
|
|
</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><div class="hr" id="update"><a name="update"><!-- --></a><h2 class="topictitle2">Update search index</h2>
|
||
|
|
<div><p>After creating a search index, you will want to update it when ever you
|
||
|
|
change the documents being searched. For example, if you add additional content
|
||
|
|
to some of your files, that content will not be found in using the Webserver
|
||
|
|
search engine until you update your search index. You can add new or changed
|
||
|
|
documents or delete documents from the index. If documents are added, they
|
||
|
|
will be indexed and added to the supplemental index. Use the fields to specify
|
||
|
|
information about the documents to add to the index. Once you have finished
|
||
|
|
adding the documents, you may want to merge the supplemental and main indexes.
|
||
|
|
</p>
|
||
|
|
<p>To update your search index, do the following: </p>
|
||
|
|
<ol><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>Update search index</strong>. </li>
|
||
|
|
<li>Choose one of the following:<dl><dt class="dlterm">Build a document list from this directory</dt>
|
||
|
|
<dd>Select this option to create a document list containing the set of documents
|
||
|
|
to add, update, or delete from your search index.</dd>
|
||
|
|
</dl>
|
||
|
|
<div class="p">There are two additional options that you may select.<dl><dt class="dlterm">Traverse subdirectories in this directory</dt>
|
||
|
|
<dd>Select to include any documents in subdirectories of the directory you
|
||
|
|
provided in the field above. </dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt class="dlterm">Document filter</dt>
|
||
|
|
<dd>Select this option if you want the document list to be made of specific
|
||
|
|
file types. For example, entering <em>*.htm*</em> will only build a document
|
||
|
|
list of file types <em>htm</em> and <em>html</em>. </dd>
|
||
|
|
</dl>
|
||
|
|
</div>
|
||
|
|
<dl><dt class="dlterm">Use the document list in this file</dt>
|
||
|
|
<dd>Select this option if you want to use an existing document list to add,
|
||
|
|
update, or delete document from your search index. </dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
<li>Choose an updating processing option:<dl><dt class="dlterm">Add new or changed documents to the index</dt>
|
||
|
|
<dd>Select this option to use the document list to add or update document
|
||
|
|
in your search index. </dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt class="dlterm">Delete documents from the index</dt>
|
||
|
|
<dd>Select this option to use the document list to delete documents from your
|
||
|
|
search index. </dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
<li>Choose a document content option:<dl><dt class="dlterm">Documents are HTML documents</dt>
|
||
|
|
<dd>Select this option if the documents to be searched are HTML.</dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt class="dlterm">Documents are TEXT documents</dt>
|
||
|
|
<dd>Select this option if the documents to be searched are text documents
|
||
|
|
(do not contain HTML tags). </dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
<li>Choose a processing option:<dl><dt class="dlterm">Update index immediately</dt>
|
||
|
|
<dd>Select this option if you want the search index to be updated as soon
|
||
|
|
as you complete the form.</dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt class="dlterm">Update index in a background task</dt>
|
||
|
|
<dd>Select this option if you want the search index to be updated in a background
|
||
|
|
task. This is the suggested method if there is a large number of documents
|
||
|
|
to be indexed. </dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
<li>Choose a document error processing option:<dl><dt class="dlterm">Skip documents in error</dt>
|
||
|
|
<dd>Select this option if you want the search index to continue updating if
|
||
|
|
document errors are found. The documents found with an error will not be included
|
||
|
|
in the search index.</dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt class="dlterm">Stop processing when error occurs</dt>
|
||
|
|
<dd>Select this option if you want the search index to stop updating if document
|
||
|
|
errors are found. All documents before the error will be indexed. </dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
<li>Click <strong>Apply</strong>.</li>
|
||
|
|
</ol>
|
||
|
|
<p>To update the search index using the <tt>CFGHTTPSCH *ADDDOC</tt> and <tt>CFGHTTPSCH
|
||
|
|
*MGRIDX</tt> CL commands, do the following: </p>
|
||
|
|
<pre class="block">CFGHTTPSCH OPTION(*ADDDOC) IDX(myindex) IDXDIR('/mydir') +
|
||
|
|
DOCLIST('/mydir/myindex.DOCUMENT_LIST')
|
||
|
|
CFGHTTPSCH OPTION(*MRGIDX) IDX(myindex) IDXDIR('/mydir')</pre>
|
||
|
|
<p>You can also update your index through scheduled batch jobs. For example,
|
||
|
|
to update an index on Friday of every week at 11:30 p.m., do the following:
|
||
|
|
</p>
|
||
|
|
<pre class="block">ADDJOBSCDE JOB(UPDATE) CMD( CFGHTTPSCH OPTION(*ADDDOC) IDX('myindex')
|
||
|
|
DOCLIST('/QIBM/UserData/HTTPSVR/index/myindex.DOCUMENT.LIST'))
|
||
|
|
JOB(UPDATE)
|
||
|
|
FRQ(*WEEKLY)
|
||
|
|
SCDDATE(*NONE)
|
||
|
|
SCDDAY(*FRI)
|
||
|
|
SCDTIME('23:30:00')</pre>
|
||
|
|
<p>To update an index at 11:30 p.m. on the last day of every month, do the
|
||
|
|
following:. </p>
|
||
|
|
<pre class="block">ADDJOBSCDE JOB(UPDATE) CMD(CFGHTTPSCH OPTION(*ADDDOC) IDX('myindex')
|
||
|
|
DOCLIST('/QIBM/UserData/HTTPSVR/index/myindex.DOCUMENT.LIST') )
|
||
|
|
JOB(UPDATE)
|
||
|
|
SCDDATE(*MONTHEND)
|
||
|
|
SCDTIME('23:30:00')
|
||
|
|
FRQ(*MONTHLY)</pre>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div class="hr" id="merge"><a name="merge"><!-- --></a><h2 class="topictitle2">Merge search index</h2>
|
||
|
|
<div><p>The supplemental index contains indexed documents that were added with
|
||
|
|
the <a href="#update">update search index</a> form and are not yet merged
|
||
|
|
into the main index. This merged index will include both the supplemental
|
||
|
|
index and the main index. </p>
|
||
|
|
<p>To merge your search indexes, do the following: </p>
|
||
|
|
<ol><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 supplemental search index from the <strong>Index</strong> list. </li>
|
||
|
|
<li>Click <strong>Merge search index</strong>. </li>
|
||
|
|
<li>Choose one of the two processing options:<dl><dt class="dlterm">Merge index immediately</dt>
|
||
|
|
<dd>Select this option if you want the search indexes to merge as soon as
|
||
|
|
you complete the form.</dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt class="dlterm">Merge index in a background task</dt>
|
||
|
|
<dd>Select this option if you wan the search indexes to merge in a background
|
||
|
|
task. This is the suggested method if the search indexes are large. </dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
<li>Click <strong>Apply</strong>.</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div class="hr" id="delete"><a name="delete"><!-- --></a><h2 class="topictitle2">Delete search index</h2>
|
||
|
|
<div><p>You can delete both the main and supplemental indexes or just the supplemental
|
||
|
|
index. The supplemental index contains indexed documents that were added with
|
||
|
|
the <a href="#update">update search index</a> form and are not yet merged
|
||
|
|
into the main index. </p>
|
||
|
|
<p>To delete your search indexes, do the following: </p>
|
||
|
|
<ol><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>Delete search index</strong>. </li>
|
||
|
|
<li>Choose one of the two processing options:<dl><dt class="dlterm">Delete both main and supplemental indexes</dt>
|
||
|
|
<dd>Select this option if you want to delete both the supplemental and main
|
||
|
|
search indexes from your iSeries™. </dd>
|
||
|
|
</dl>
|
||
|
|
<dl><dt class="dlterm">Delete only the supplemental index</dt>
|
||
|
|
<dd>Select this option if you want to delete the supplemental search index
|
||
|
|
from your iSeries. Your main search index will not be deleted. </dd>
|
||
|
|
</dl>
|
||
|
|
</li>
|
||
|
|
<li>Click <strong>Delete</strong>.</li>
|
||
|
|
</ol>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
<div class="hr" id="view"><a name="view"><!-- --></a><h2 class="topictitle2">View the status of search index</h2>
|
||
|
|
<div><p>The Webserver search engine can show the status of a search index allowing
|
||
|
|
you to keep track of its progress when <a href="#update">updating</a> or <a href="#merge">merging</a>. </p>
|
||
|
|
<p>To view the status of a search index, do the following: </p>
|
||
|
|
<ol><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>View status of search index</strong>. </li>
|
||
|
|
</ol>
|
||
|
|
<p>The status page displays all the current information available for the
|
||
|
|
search index. Use this page to see any file errors that occurred during indexing.</p>
|
||
|
|
</div>
|
||
|
|
</div>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|