Before you begin
To edit configuration files, you must use the IBM WebSphere
® Application Server wsadmin client. See Starting the wsadmin client
About this task
When you set the user profiles of employees who have left your organization to inactive, by default, those profiles are not listed in search results. Additionally, inactive users do not display in the person type-ahead on the Advanced Search page. End users can still filter search results to display inactive profiles by selecting All People
from the Show
menu on the Search Results page when the Profiles
filter is selected.
If you want inactive profiles to display in search results by default, you can run a SearchCellConfig command to update the value of the includeInactiveUsers property in the search-config.xml
file to true. When this property is set to true, the person type ahead on the Advanced Search page includes inactive users.
For more information about the user life cycle in IBM
Connections, see Managing users
To include or exclude inactive users from search results, complete the following steps.
Parent topic: Managing the Search application
- Start the wsadmin client from the following directory of the system on which you installed the Deployment Manager:
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:
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
- Check out the Search cell-level configuration file, search-config.xml, using the following command:
- working_dir is the temporary directory to which you want to check out the cell level configuration file. This directory must exist on the server where you are running the wsadmin client. Use forward slashes to separate directories in the file path, even if you are using the Microsoft Windows operating system.
Note: AIX and Linux only: The directory must grant write permissions or the command will not run successfully.
- cellName is the name of the cell that the Search node belongs to. This argument is required. It is also case-sensitive, so type it with care. If you do not know the cell name, you can determine it by typing the following command in the wsadmin command processor:
- Use the following commands:
Specifies that the documents corresponding to inactive user profiles are included in search results. In a default installation of IBM Connections, inactive user profiles are automatically excluded from search results.SearchCellConfig.excludeInactiveProfilesSearchResults()
Specifies that the documents corresponding to inactive user profiles are excluded from search results. In a default installation of IBM Connections, inactive user profiles are automatically excluded from search results.
- Check in the updated search-config.xml configuration file using the following wsadmin client command:
- To exit the wsadmin client, type exit at the prompt.