Use the SearchService.deleteFeatureIndex command to purge
content for a specific application from the Search index in a single-node
environment.
Before you begin
To run administrative commands, you must use the IBM® WebSphere® Application
Server wsadmin client. See Starting
the wsadmin client for details.Note: In an environment with
multiple nodes, use the SearchService.deleteFeatureIndex command only
when you want to delete the index for an application that has been
uninstalled. After running this command, the content from the component
that has been deleted cannot be reindexed. If you want to delete content
for a specific application from the index, use the SearchService.startBackgroundIndex
command to rebuild a new index for all applications instead. For more
information about this command, see Creating a background index.
About this task
If there is a problem with indexed content from any of the IBM Connections applications, instead
of deleting and recreating the entire index, you can use the SearchService.deleteFeatureIndex
command to remove and purge all documents for a given application
from the index. The command deletes the content from the database
that is shared by all the servers in the cluster as well as from the
indexes.When you run the SearchService.deleteFeatureIndex command,
the command removes indexed content for the specified application
from the node in your deployment. Indexing tasks are automatically
disabled at the start of this process and re-enabled when the process
is complete, regardless of whether the tasks were disabled initially.
Note: When
you remove an application from the Search index, you need to rebuild
the indexes for the social analytics service. The social analytics
indexes are completely rebuilt every night by default, however, to
fully remove an application's index immediately, you must use the
SearchService.sandIndexNow command on each of the social analytics
indexes. For more information about this command, see Running
one-off social analytics scheduled tasks.
Procedure
To purge content for a specific application from the
index, complete the following steps.
- Start the wsadmin client from the following
directory of the system on which you installed the Deployment Manager:
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 command to remove and purge content from
a specified application from the Search index.
- SearchService.deleteFeatureIndex(String applicationName)
Removes and purges the content for the specified application
from the Search index.
Important: Only use this command
if you are uninstalling an application from IBM Connections. After you run the command, the
content from the application that has been deleted cannot be reindexed.
This command takes a string value, which is the name of the application whose content is to be
deleted. The following values are valid:
- activities
- blogs
- calendar
- communities
- dogear
- ecm_files
- files
- forums
- people_finder
- profiles
- status_updates
- wikis
For example:
SearchService.deleteFeatureIndex("activities")
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.