IBM Support

Customizing Lotus Notes multi-user install kit for correct XTAF dictionary installation

Technote (troubleshooting)


When installing a Lotus Notes multi-user installation and using a customized Notes install kit to which the additional XTAF spellcheck dictionaries have been added using the supplied addToKit.exe tool, the XTAF dictionaries are not installed to the shared directory (for example with, as expected, but rather to the user's data\workspace\ directory.

For example, rather than being installed to the shared data directory of C:\Documents and Settings\All Users\Local Settings\Application Data\Lotus\Notes\Data, they are instead installed to C:\users\<user who installed>\appdata\local\lotus\notes\....

The expected behavior is that the additional XTAF-dictionaries be installed as a shared install and the installation would be an English Notes client with multiple spelling languages available.

For information about customizing the Note install kit to add the non-English language spelling dictionaries, see the Making Lotus Notes 8.5.1 and greater language spell check dictionaries available to users wiki post.

Also see Installing Lotus Notes spelling dictionaries for related information.


In a Lotus Notes multi-user installation, Lotus Notes XTAF language dictionaries are installed as a user-based concept (to a data\workspace subdirectory) rather than the expected machine-based concept (an AllUsers shared subdirectory).


An installation directory default is pre-configured. You can override the installation directory default by specifying a colocation-affinity attribute. Colocation-affinity is an attribute that can be specified for each feature in a feature.xml. For more information about the colocation-affinity attribute, see posts such as Packaging applications for deployment in the Lotus Expeditor wiki.

Resolving the problem

1. Use the addToKit tool to add the to the Notes install kit.(for example Test the customized install kit using the validation tool before continuing. See Making Lotus Notes 8.5.1 and greater language spell check dictionaries available to users for detailed instructions.

Note: See Adding new features to the Notes install kit using a supplied tool and Validating your customized Notes install kit for details.

2. In the customized Notes install kit, open the and navigate to the features\ JAR file.

3. Change the feature colocation-affinity="" to feature colocation-affinity="" for that JAR file.

Related information

Lotus Notes and Domino product documentation - Notes an
Lotus Notes and Domino Wiki
IBM Lotus Notes/Domino 8.5 Forum post
Lotus Expeditor Wiki
Notes installation directories for Windows
Packaging applications for deployment -- Expeditor wiki

Document information

More support for: IBM Notes

Software version: 8.5.1, 8.5.2

Operating system(s): Windows

Reference #: 1440976

Modified date: 05 August 2011