IBM Support

Upgrading error when Notes 8.5.1 installed customized dictionary plug-in

Technote (troubleshooting)


Problem

If Notes 8.5.1 install customized dictionary under rcp site, <NOTESDIR>\framework\rcp\eclipse\features\, we will meet one error when we try to upgrade Notes from current 8.5.1 to 8.5.2. From log file, we can get below error information.

CWPPR0511W: The attempt to search the update site jar:file:/D%3A/SpellCheckerInstall/updateSite.zip!/ for feature com.ibm.langware.v5.dic.ar_XX.feature_7.1.1.201006221804 failed with status code 42. Attempting to continue update.

Cause

The root cause of the issue is that installation program will try to uninstall the customized dictionary plug-ins under rcp site but can not find out the update site. The 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 published documents such as Packaging applications for deployment in the Lotus Expeditor wiki.

We can define 3 plug-in location with below 3 parameters:
1.com.ibm.rcp.site.anchor.user.feature
——The feature is always installed into the user site, such as: <NOTESDIR>\Data\workplace\applications\eclipse\features\.
This is the pre-configured value. If the dictionary plug-in is installed in this location, only current Notes user can use this feature. For multi-user Notes, we have to install the plug-in for every Notes user.

2.com.ibm.rcp.site.anchor.shared.feature
——The feature is always installed into the shared site,such as: <NOTESDIR>\framework\shared\eclipse\features\.
If the dictionary plug-in is installed in this location, the plug-in is available for all Notes user of current multi-user Notes, it will not be deleted during upgrading. After upgrading, the dictionary plug-in can be used normally as before.

3.com.ibm.rcp.platform.feature
——The feature is always installed into the rcp site, such as: <NOTESDIR>\framework\rcp\eclipse\features\.
If the dictionary plug-in is installed in this location, the plug-in is available for all Notes user of current multi-user Notes, but it will be deleted during upgrading to 8.5.2. The installation program will try to look for the 8.5.1 update site which includes the customized dictionary plug-in. if the installation program can not find out the update site, the upgrade will fail.

Resolving the problem

To avoid the problem, we can install customized dictionary plug-ins under shared site at first. We can refer to following steps to install 8.5.1 customized plug-ins under shared site.


1. Use the addToKit tool to add the XTAF dictionaries (eg. updateSite_ar.zip) to the Notes install kit.

2. In the customized Notes install kit, open the updateSite.zip and navigate to the features\com.ibm.langware.v5.dic.ar_XX.feature_dateversion.jar JAR file.

3. Change the feature colocation-affinity="com.ibm.rcp.site.anchor.user.feature" to feature colocation-affinity="com.ibm.rcp.site.anchor.shared.feature" for that JAR file.

4. Run setup.exe in customized install kit to finish the 8.5.1 Notes Client installation.


Document information

More support for: IBM Notes
Install/Setup

Software version: 8.5.1, 8.5.2

Operating system(s): Windows

Software edition: Standard

Reference #: 1497657

Modified date: 28 April 2011