Reloading the Search application

After making configuration changes to Search, you can use SearchService commands to reload the Search index and configuration, and avoid the need for restarting the Search application.

Before you begin

To use SearchService administrative commands, you must use the IBM® WebSphere® Application Server wsadmin client. See Starting the wsadmin client for details.

About this task

You can use the SearchService commands for reloading Search after running SearchCellConfig commands if it is not feasible to restart the Search application. You might want to use the commands for reloading the index as part of restoring a Search index backup if it is not feasible to stop the Search application.

Procedure

To reload the Search application, complete the following steps.
  1. Start the wsadmin client from one of the following directories on the system on which you installed the Deployment Manager:

    Linux: app_server_root\profiles\dm_profile_root\bin

    Windows: app_server_root/profiles/dm_profile_root/bin

    where app_server_root is the WebSphere Application Server installation directory and dm_profile_root is the Deployment Manager profile directory, typically dmgr01.

    You must start the client from this directory or subsequent commands that you enter do not execute correctly.

  2. After the wsadmin command environment has initialized, enter the following command to initialize the Search environment and start the Search script interpreter:
    execfile("searchAdmin.py")
    If prompted to specify a service to connect to, type 1 to pick the first node in the list. Most commands can run on any node. If the command writes or reads information to or from a file using a local file path, you must pick the node where the file is stored.
    When the command is run successfully, the following message displays:
    Search Administration initialized
  3. Use the following commands to reload the Search configuration and index:
    SearchService.reloadSearchConfiguration()
    Reloads the search-config.xml file for Search on the current node only without a restart of the Search application.
    Note: If you are making changes to the configuration of the social analytics service, you still need to restart Search to apply the changes.

    When the command runs successfully, 1 is printed to the wsadmin console. If the command does not run successfully, 0 is printed to the wsadmin console.

    SearchService.reloadSearchConfigurationAllNodes()
    Reloads the search-config.xml file for Search on all nodes in the cluster without a restart of the Search application.
    Note: If you are making changes to the configuration of the social analytics service, you still need to restart Search to apply the changes.

    When the command runs successfully, 1 is printed to the wsadmin console. If the command does not run successfully, 0 is printed to the wsadmin console.

    SearchService.reloadIndex()
    Reloads the Search index on the current node only without a restart of the Search application.
    Note: If you are making changes to the configuration of the social analytics service, you still need to restart Search to apply the changes.

    When the command runs successfully, 1 is printed to the wsadmin console. If the command does not run successfully, 0 is printed to the wsadmin console.

    SearchService.reloadIndexAllNodes()
    Reloads the Search index on all the nodes in the cluster without a restart of the Search application.
    Note: If you are making changes to the configuration of the social analytics service, you still need to restart Search to apply the changes.

    When the command runs successfully, 1 is printed to the wsadmin console. If the command does not run successfully, 0 is printed to the wsadmin console.