Upgrading error when Notes 8.5.1 installed customized dictionary plug-in
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_126.96.36.199006221804 failed with status code 42. Attempting to continue update.
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：
——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.
——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.
——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.