NOTES CLIENT INSTALLATION AND UPGRADE

Creating a customized add-on installer
The IBM® Lotus® Expeditor® framework enables you to create and use add-on installer as an alternative method for deploying a third-party feature to an existing Notes install. For example, rather than deploy a custom feature to users as part of the Notes install kit, or use a widget to deploy a custom feature to an existing Notes runtime, you can create and use an add-on installer.

The Notes add-on installer toolkit provides a streamlined process for creating an MSI installer to deploy a valid Eclipse feature or plug-in to an existing Notes runtime. The notes.addon.installer.toolkit.zip toolkit, containing CustomizeAddon.exe and AddonConfig.ini, is available in the Notes install kit's utility subdirectory.

The customized add-on installer tool is available with Lotus Expeditor 6.2.1 and as part of an Apps directory toolkit available with the Notes install kit.

Note While the Notes toolkit is currently only available for MSI install, documentation describing how to create an add-on installer in a Linux environment is provided in the following Lotus Expeditor wiki post.

For information, see "Creating a customized add-on installer" in the Product documentation category of the Lotus Expeditor Wiki.

To begin, review the add-on installer documentation in the Expeditor wiki as above; while referencing the supplied AddonConfig.ini file in your notes.addon.installer.toolkit.zip.

Note Section B in the Windows section of the "Creating a customized add-on installer" Expeditor wiki post describes settings in the AddonConfig.ini file generic to Expeditor and Notes. However, the AddonConfig.ini file in the supplied notes.addon.installer.toolkit.zip file has been modified to further simplify the process of creating an MSI-based add-on installer for deploying custom features to a Notes runtime.

The following AddonConfig.ini file properties have been preset in the supplied notes.addon.installer.toolkit.zip:


To create an MSI-based add-on installer, do the following:

1. Obtain the Expeditor documentation topic "Creating a customized add-on installer" in the Product documentation category of the Lotus Expeditor wiki.

2. Unzip the supplied notes.addon.installer.toolkit.zip toolkit to a local temp directory.

3. Navigate to the local temp directory and open the supplied AddonConfig.ini file.

4. Add all the properties described in the "B. Customizing the MSI using the Addon Customizer Tool" section of the Expeditor topic "Creating a customized add-on installer" except the bulleted TARGETUPGRADE and TARGETVERSIONS properties above.

5. Move the unzipped CustomizeAddon.exe tool up one directory level.

6. Run CustomizeAddon.exe as described in the Expeditor documentation.

7. Replace licenses (if needed) in the license directory in the add-on installer kit.

8. Add the deploy directory and updatesite.zip (for the signed feature(s) that the add-on installer will deploy) to the add-on installer kit as described in the Expeditor documentation.


9. Ensure you have Lotus Notes 8.0.2 or greater already installed and that Notes is not running.

10. Run the add-on install kit's setup.exe installation executable and respond to all prompts.

Related topics