Search service configuration parameters

Search service configuration parameters

+
Search Tips | Advanced Search

Values set for parameters of a portal search service apply to that search service and all its collections. They do not affect other search services of the portal or their search collections.
Some configuration parameters are available for both...

search services
Search and Browse portlet

If you configure a copy of the Search and Browse portlet for search on collections under a particular search service, then set the same value for these shared parameters.
See...

Configure the Search and Browse portlet for end users
Configuration parameters for the Search and Browse portlet

If you modify a search service parameter that affects search collections, this modification will apply only to newly created search collections created in the search service. Existing search collections will not be affected by the updated parameter value.
Portal Search provides only one default Content Model search service. You cannot modify this Content Model search service, or create additional Content Model search services, or create additional search collections for the default Content Model search service.
The search administration portlet Manage Search lists the Default Portal Search Service and its collection Portal Content or other collections in the default portal language and not in the language that the user has selected as preferred language for the portal or set in the browser. For example, if the portal default language is set to English and the user has selected German as the preferred portal language or has set the browser language to German, the Default Portal Search Service and its collections show in English.
The parameter list in both the search services panel of the Manage Search portlet and in the following table show several parameters that end with the suffix _EXAMPLE. These are not used by the portal. They serve as an example for the same parameter without the suffix _EXAMPLE. They give an example value that you might use. Deleting these parameters or modifying their value has no effect.
To set a parameter that is listed here, but not in the portlet, just add it. To do this, type the parameter and the value in the entry fields New parameter: and New value: and click the Add button.
In the following list the abbreviation pse in parameters or values stands for Portal Search Engine.
The following list is arranged in alphabetical order. Parameters might be listed in a different order in the portlet.

CLEAN_UP_TIME_OF_DAY_HOURS

Time of day at which the portal performs the maintenance process for search collections to remove outdated files and broken links. Possible values are positive integers from 0 to 24 for the full hours of the day. The default value is 0, which runs the cleanup at midnight.
If you modify the value for this parameter, the new value is applied only to newly created collections of the search service. You cannot update this parameter for existing search collections.

DebugLevel

Determine the Portal Search debug level. The default value is zero 0. Possible values are positive integer from zero (0 ) to fifty (50 ).

DefaultCollectionsDirectory

Default directory for search collections. If you use Portal Search locally, this parameter is optional. If you specify no value for this parameter, the default collection directory is...
WP_PROFILE/PortalServer/collections

If you set up a remote search service, this parameter is mandatory. Refer to Configure the default location for search collections.

EJB

If you set up a remote search service by using EJB, use this parameter to specify the EJB name in JNDI. An example value is...
ejb/com/ibm/hrl/portlets/WsPse/WebScannerLiteEJBHome

If you configure a copy of the Search and Browse portlet for this search service, use the same value for this parameter for both the search service and the Search and Browse portlet.
If you set this parameter, you also need to set the IIOP_URL parameter.

EJB_Example

Example value for the parameter EJB. The example value is...
ejb/com/ibm/hrl/portlets/WsPse/WebScannerLiteEJBHome

HTTP_MAX_BODY_SIZE_MB

Limit how much content is fetched during a crawl from application files, such as PDF, MicroSoft Word etc. The specified unit is MB. The default value is 20 MB. If a file exceeds the specified limit, the document is truncated, and Portal Search indexes the fetched portion as is possible. However, indexing might fail on truncated documents; in this case the document will not be listed under search results at all.

If you modify the value for this parameter, the new value is applied only to newly created collections of the search service. You cannot update this parameter for existing search collections.
Document Conversion Services might not be able to convert the content of truncated application files. If Document Conversion Services fails to convert a truncated application file, it logs an error to the SystemErr.log file. If tracing is enabled for the portal, Portal Search logs a warning message to the portal log file.

HTTP_MAX_SEEDLIST_SIZE_MB

Limit how much portal content is fetched during a crawl from your own portal site. It determines the amount of space that is reserved for listing portal site resources or managed Web content resources. The specified unit is MB. The default value is 4 MB. If a crawl exceeds the limit set for this parameter, the crawl fails, and Portal Search logs an error message. In this case, or if returned search results do not represent to complete extent of your portal site resources, increase this value.
If you modify the value for this parameter, the new value is applied only to newly created collections of the search service. You cannot update this parameter for existing search collections.

HTTP_NON_APPL_MAX_BODY_SIZE_MB

Limit how much content of each HTML page is fetched from Web sites of collections that belong to this search service. The specified unit is MB. The default value is 0.2 MB. This means that the amount of content sent for indexing is always the first 0.2 MB of text.
If you modify the value for this parameter, the new value is applied only to newly created collections of the search service. You cannot update this parameter for existing search collections.

IIOP_URL

If you set up a remote search service by using EJB, use this parameter to specify the IIOP URL. An example value is...
iiop://localhost:2811

If you configure a copy of the Search and Browse portlet for this search service, use the same value for this parameter for both the search service and the portlet.

MAX_BUILD_BATCH_SIZE

Maximum number of updates on the index after which a build operation is performed. A build operation updates the collection content and makes it searchable. The default value is 10000 updates. The minimum batch size is 100 updates. A smaller number will be changed to that minimum.

If you modify the value for this parameter, the new value is applied only to newly created collections of the search service. You cannot update this parameter for existing search collections.
Other events can overrule this limit. This results in a build operation before the limit specified here is reached. For example, this occurs when you add documents to the collection manually, or when the time limit specified by the parameter MAX_BUILD_INTERVAL_TIME_SECONDS runs out. In both cases the index is rebuilt immediately.

MAX_BUILD_INTERVAL_TIME_SECONDS

Interval between two index builds during a crawl. This value is specified is seconds. The default value is 3000 seconds. The minimum interval is 30 seconds. A smaller number will be changed to that minimum.

If you modify the value for this parameter, the new value is applied only to newly created collections of the search service. You cannot update this parameter for existing search collections.
Other events can overrule this limit. This results in a build operation before the limit specified here is reached. For example, this occurs when you add documents to the collection manually, or when the size limit specified by the parameter MAX_BUILD_BATCH_SIZE is reached. In both cases the index is rebuilt immediately.

IIOP_URL_Example

This is an example that gives an example value for the parameter IIOP_URL. The example value is...
iiop://localhost:2811

JURU_DEBUG_LEVEL

Determine the portal search engine debug level. Possible values are positive integer. The default value is 0.

OPEN_WCM _WINDOW

Define whether IBM Lotus WCM search results are opened in a WCM Web content viewer portlet. You can specify a URL Mapping to a portal page as follows:
portal_context_path/portal_URL_mapping_to_portal_page?WCM_GLOBAL_CONTEXT=

This URL mapping can be to a portal page that contains a WCM viewer portlet. The default value is...
portal_server_root/myportal/wcmContent?WCM_GLOBAL_CONTEXT=

OpenResultMode

Specify how results are displayed when you use the Search and Browse feature of the Manage Search portlet. Possible values are:

new Open search results in a new window. This is the default. Use this setting for searching documents on a Web site.
same Open search results in the same window. Use this setting for searching a portal site.
wcm This value is only supported for use with the Search and Browse portlet. Do not use this value when you configure the search service.

The default setting is new.

The value for this parameter does not need to match the parameter value for the search service to which you configure this Search and Browse portlet. Each search service or portlet can have its own value.
As the Search and Browse portlet relates to only one document collection, install and configure separate Search and Browse portlets for each of the content sources mentioned above.

PortalCollectionForceCreate

If you deleted the portal site default search collection, set this parameter to on to have the portal site search collection recreated. For example, this can be, if you modified the default configuration of the portal site collection. If you change the value for this parameter to on, the portal site search collection is recreated the next time you call up the Manage Search portlet. The portal then resets the value for this parameter to off. The default value is on.

PSE_TYPE

Type of search service. Possible values are localhost, ejb, and soap. The default value is localhost for local search service.
If you use Portal Search locally, this parameter is optional.
If you set up a remote search, this parameter is mandatory. In this case specify the type of remote service that you use, EJB or SOAP. If you specify ejb here, you also need to specify the values for the parameters EJB and IIOP_URL.
If you specify soap here, you also need to specify the values for the parameter SOAP_URL.
If you configure a copy of the Search and Browse portlet for this search service, use the same value for this parameter for both the search service and the Search and Browse portlet.

SOAP_URL

If you set up a remote search service by using SOAP, use this parameter to specify the SOAP URL. An example value is...
http://localhost:10000/WebScannerSOAP/servlet/rpcrouter

If you configure a copy of the Search and Browse portlet for this search service, use the same value for this parameter for both the search service and the portlet.

SOAP_URL_Example

This is an example that gives an example value for the parameter SOAP_URL. The example value is...
http://localhost:10000/WebScannerSOAP/servlet/rpcrouter

The following parameters are reserved for internal use only. Do not change their values.

CONTENT_SOURCE_TYPE_FEATURE_NAME

Reserved for internal use only. Do not change its value. The default value is ContentSourceType.

CONTENT_SOURCE_TYPE_FEATURE_VAL_PORTAL

Reserved for internal use only. Do not change its value. The default value is Portal.

CONTENT_SOURCE_TYPE_FEATURE_VAL_UPLOAD

Reserved for internal use only. Do not change its value. The default value is Upload.

CONTENT_SOURCE_TYPE_FEATURE_VAL_WEB

Reserved for internal use only. Do not change its value. The default value is Web.

PortalCollectionCreated

Reserved for internal use only. Do not change its value. The default value is true.

PortalCollectionName

Reserved for internal use only. Do not change its value. The default value is %portal.collection.name.

PortalCollectionSourceName

Reserved for internal use only. Do not change its value. The default value is %portal.content.provider.name.

SeedListPageName

Reserved for internal use only. Do not change its value. The default value is ibm.portal.Search Seedlist.

SetProperties

Reserved for internal use only. Do not change its value. Possible values are on or off. The default value is on.

startup

Reserved for internal use only. Do not change its value. The default value is false.

VALIDATE_COOKIE

Reserved for internal use only. Do not change its value. The default value is 123.

WORK_MANAGER

Work manager. Reserved for internal use only. Do not change its value. The default value is wps/searchIndexWM.

WORK_MANAGER_DEPLOY

This is an example of the deployed WORK_MANAGER parameter. The example value is wps/searchIndexWM.

WORK_MANAGER_NATIVE

This is an example of the parameter WORK_MANAGER for native threads for debug purposes only. The example value is force.hrl.work.manager.use.native.threads.

Parent topic
Administering Portal Search

Related tasks
Manage search services
Configure the Search and Browse portlet for end users
Configure the default location for search collections

Related reference
Configuration parameters for the Search and Browse portlet

new	Open search results in a new window. This is the default. Use this setting for searching documents on a Web site.
same	Open search results in the same window. Use this setting for searching a portal site.
wcm	This value is only supported for use with the Search and Browse portlet. Do not use this value when you configure the search service.