Setting the default dictionary
Use administrative commands to set the default dictionary used for Search query strings.
Before starting
When using administrative commands, use the IBM WAS wsadmin client. See Starting the wsadmin client for details.
About this task
You use the setDefaultDictionary command to set the default dictionary used for Search queries. At indexing time, when content is analyzed, an attempt is made to guess which of the enabled IBM LanguageWare dictionaries should be used when applying the text analysis process. If the attempt is unsuccessful or if the language guessed does not have a corresponding dictionary enabled, the default dictionary is used.The default dictionary is also used at search time. Language guessing is not used at search time to determine which dictionary is used for text analysis, the language is specified as part of the HTTP request. If there is a problem loading the dictionary corresponding to the language specified or if there is no corresponding dictionary enabled, then the default dictionary is used.
Procedure
To specify a default dictionary for use with Search...
- From the dmgr host:
cd $DMGR_PROFILE/bin
./wsadmin.sh -jython
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, pick the node where the file is stored.
- Check out the Search cell-level configuration file using the following command:
SearchCellConfig.checkOutConfig("<working_dir>", "<cellName>")
where:
- <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:
print AdminControl.getCell()
For example:
SearchCellConfig.checkOutConfig("c:/search_temp", "SearchServerNode01Cell")
- To set the default dictionary, use the following command:
SearchCellConfig.setDefaultDictionary(String languageCode)
Configures the default LanguageWare dictionary used by the Search application. The default dictionary must be one of the enabled dictionaries.
This command takes a single argument:
- languageCode is the language code for the dictionary that you want to set as the default.
This language code typically comprises two letters conforming to the ISO standard 639-1:2002 that identifies the primary language of the dictionary. However, there are some codes that additionally define a country or variant, in which case these constituent parts are separated by a hyphen. For example, Portuguese has two variants, one for Portugal (pt-PT) and one for Brazil (pt-BR).
Note: A matching dictionary must exist in the list of configured dictionaries for the language that you specify as a parameter.
For example:
SearchCellConfig.setDefaultDictionary("fr")
- Check in the changed configuration property keys using the following wsadmin client command:
SearchCellConfig.checkInConfig()
- To exit the wsadmin client, type exit at the prompt.
- Stop the server or servers hosting the Search application, delete the index, and then restart the Search servers.
The next time the scheduled task runs, it recreates the index.
Parent topic
Configure dictionaries for Search
Related tasks
Enable dictionaries
Listing enabled dictionaries
Disable dictionariesRelated reference
SearchCellConfig commands
Search language dictionaries
});