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.
-
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.
- 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
- 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.