Show TOC

Procedure documentationEnabling and Setting Global Portal Search for Wiki Content Locate this document in the navigation structure

 

You can enable the global portal search (available in the portal’s masthead) to provide wiki content in its search result list. Wiki content includes the following objects:

  • Spaces

  • Pages

  • Comments

  • Versions

  • Attachments

Portal Search and Wiki Search

This document describes the settings regarding the integration of wiki objects into the global portal search function, which is available in the portal’s masthead.

It does not refer to the default search function within the wiki application.

Portal Search Settings

According to the specific use case of the wiki application and the impact of indexing on the system performance, you can choose between a number of setting possibilities as explained below (and shown in the subsequent figure):

Requirement

Portal Search Settings

Enable the global portal search function to provide the most recent wiki objects

In the settings of the wikis repository, activate TREX delta indexing. The system reacts as follows:

  • If no search index for wiki objects is available, the system automatically creates it.

  • As soon as a wiki object is created, changed or deleted, the system immediately updates the TREX index queue for wiki objects.

Lower the up-to-dateness of the search results in favor of a better system performance

In the settings of the wikis repository, deactivate TREX delta indexing.

In this case the system does not immediately refresh the index queue (in case a wiki object is created, changed or deleted).

Instead, in the Index Administration, you can schedule a cyclic – daily, weekly or monthly – update of the wikis index.

If you do not schedule a cyclic index update, the wiki objects indexed before can still be found via the global portal search, but new or changed objects cannot be found.

Recommendation Recommendation

We recommend aligning the update cycle of the TREX index with the update cycle of the TREX queue. For example, if delta indexing is performed weekly, the system should update the TREX search index (from the TREX queue) in a similar interval of time.

End of the recommendation.
Portal Search Settings for Wiki Objects

This graphic is explained in the accompanying text.

Prerequisites

The global portal search is based on the SAP Search and Classification engine (TREX). You should be acquainted with the administration of search indexes.

For more information, see Administering Indexes and TREX admin tools in the TREX documentation.

Procedure

Activating or Deactivating Delta Indexing for the Wiki Application

  1. In the portal, choose   System Administration   System Configuration   Knowledge Management   Content Management   Repository Managers   Wikis Repository  .

  2. Open the configuration object wikis for editing.

  3. To activate or deactivate delta indexing of wiki objects, set the option Enable TREX Indexing to Yes respectively No.

    Caution Caution

    In case delta indexing is activated and no search index for wiki objects is available, the system creates a new index and immediately starts indexing the existing wiki objects. In case there is a great amount of unindexed wiki objects, the system performance might be affected for a period of time. You can avoid this problem by assigning the system load to a specific cluster node.

    More information: Crawler Service

    End of the caution.

    Caution Caution

    In case delta indexing is activated again after an inactive period and the initial index is still available, you need to manually perform an incremental update of the index for wiki objects. Otherwise, wiki objects created or changed during the inactive period will remain unindexed.

    End of the caution.
Updating the Index Queue Manually

  1. In the portal, choose   System Administration   System Configuration   Knowledge Management   Index Administration  .

  2. Select the wikis index.

  3. Choose Incremental Update.

Scheduling a Cyclic Index Queue Update

  1. In the portal, choose   System Administration   System Configuration   Knowledge Management   Index Administration  .

  2. Open the wikis index for editing.

  3. Choose Data Sources.

  4. Select the data source assigned to the index (e. g. root > wikis).

  5. Make sure the crawler parameter standard is selected.

  6. Choose Define Schedule.

  7. Select the index queue update cycle (daily, weekly or monthly) and specify the required parameters.

Scheduling the Update Interval of the Search Index

  1. In the portal, choose   System Administration   System Configuration   Knowledge Management   Index Administration (   Related Links)   Indexing Monitor  .

  2. Choose the wikis index.

  3. In the left-hand navigation pane, choose Edit Queue Parameters.

  4. Adapt the value under Schedule Time.

    The default value is 30 minutes (0:30). The minimum value is 1 minute (0:01).

Disabling the Global Portal Search for Wiki Objects

To disable the global portal search for wiki objects you need to deactivate the TREX delta indexing of wiki objects and delete the TREX index.

  1. To disable the global portal search, proceed as follows:

    • Choose   System Administration   System Configuration   Knowledge Management   Content Management   Repository Managers   Wikis Repository  .

    • Open the configuration object wikis for editing.

    • Set the option Enable TREX Indexing to No.

  2. To delete the TREX index for wiki objects, proceed as follows:

    • Choose   System Administration   System Configuration   Knowledge Management   Index Administration  .

    • Select the TREX index for wiki objects.

    • Choose Delete.

Setting Remote Search Integration for Wiki Content

  1. In the portal, choose   System Administration   System Configuration   Knowledge Management   Content Management   Repository Managers   Wikis Repository  .

  2. In the Wikis JNDI Provider URL parameter enter the host and port of the provider system, as follows:

    • Enter the ICM host as specified in the provider URL.

    • Enter the P4 port as specified in the provider URL

    The value string has to contain the following: <icm_host>:<p4_port>

    For more information, see: Naming and Directory Services (JNDI).

  3. In the Wikis JNDI Password parameter, enter the password that is used for creating the initial context.

  4. In the Wikis JNDI User parameter, enter the user that is used for creating the initial context.

    For more information about user authentication, see: Creating an Initial Context.

  5. In the Wikis URL parameter, enter the host and port of the wiki system, as follows:

    • Enter the http or https protocol that is used for the access to the wiki application

    • Enter the host that is used for the access to the wiki application

    • Enter the port that is used for the access to the wiki application

    • Enter the context root of the wiki application

    The value string has to contain the following: <protocol>://<hostname>:<port>/<wiki context root>.

Note Note

Note that for the remote search integration scenario, the wiki application must be in the same domain as the KM platform.

End of the note.