Reducing Notes® install kit size

You can reduce the Notes® install kit size most easily using the UpdateSiteMgr tool on Windows™ or Mac or by creating a customized rpm or deb install kit on Linux™. You can also use this manual method for supported Windows™ and Mac platforms.

Notes® contains features which increase the size of the install kits when compared to the Notes® basic configuration install kits. Some customer's infrastructures are not capable of efficiently handling distribution of the larger install kits and require a method to reduce the size of the kit and still leverage the increased capabilities of the Notes® standard configuration client.

You can optionally reduce the size of the install kit by removing certain features using the supplied UpdateSiteMgrtool or manually using the procedure described here.
Note: An easier way to add or remove features in the Notes® install kit is to use the UpdateSiteMgr tool supplied in the Notes® install kit.
Note: Only features containing the installfeature property required="false" in the Notes® install kit's install manifest (install.xml) are available for removal or other install options. These include the Composite Applications Editor, Connections (Activities), embedded IBM® Sametime®, and (for single user install) Domino® Designer and Domino® Administrator clients. All other supplied features must remain as supplied in the install kit.
Note: Domino® Designer and Domino® Administrator require the additional step of using the tuner to create a transform that disables their install completely. This transform file must be included in the Notes® install kit during install.
Approximate reductions to the size of the Notes® install kit are as follows:
  • Embedded Sametime® – 4MB
  • CAE Editor – 4MB
You can remove the following supplied features from the Notes® install kit:
  • Embedded Sametime® – represented as <installfeature default="true" description="%Sametime.description" id="SametimeUI" ..
  • CAE Editor – represented as <installfeature default="false" description="%CAE.description" id="CAE"..
Note: Installfeatures are defined in the install manifest file (install.xml). The implementation of these features is done in Java™; the code resides in the zipped Eclipse update site directory updateSite.zip in the install kit. It is possible to remove user-selectable features from the updateSite.zip file and from the install manifest (install.xml) to reduce the size of the updateSite.zip file.
To remove available features from the Notes® install kit, do the following:
  1. Copy the Notes® install kit to a local drive to a new directory. Include all subdirectories, (for example C:\NotesInstallKit\.
  2. In the locally copied Notes® install kit, rename updateSize.zip to a backup name such as UpdateSiteSave.zip.
  3. Uncompress the backup file to a new directory, preserving the directory structure.

    The contents of the updateSite directory include the features and plugins subdirectories and the site.xml file.

    To remove these installfeatures from the expanded update site directory, refer to the following list:
    Table 1. Wildcard files
    installfeature Wildcard files to remove
    Sametime®

    features\com.ibm.notes.sametime.installed.feature_*

    plugins\com.ibm.notes.sametime.installed_*
    Composite Application Editor

    features\com.ibm.rcp.aaf.feature_*

    plugins\com.ibm.rcp.aaf.*

    plugins\com.ibm.rcp.aaf_*

    features\com.ibm.notes.toolbox.ca.adapter.feature_*
  4. Remove the applicable files from the expanded update site directory.
  5. Create a new updateSite.zip file by zipping the expanded update site directory making sure to include all subdirectories; preserve the existing directory structures.
  6. Copy the install.xml file to a backup file such as installsave.xml.
  7. Open the install.xml file with a text or XML editor.
  8. Locate the ID of the feature you removed in Step 4 by searching for the feature ID using the following format:
    • Embedded Sametime® – represented as installfeature SametimeUI
    • CAE Editor – represented as installfeature CAE
  9. From the point in the file where the featureID was found, look backward in the file for the start of the feature definition which starts with installfeature ...".
  10. Insert a blank line on the line BEFORE the line that starts with installfeature ..."
  11. On the blank line, type <!- - and then press the Enter key to end the line.
  12. Insert a blank line at the end of the feature definition on the line AFTER installfeature>.
  13. On the blank line, type - - > and then press the Enter key to end the line.
  14. Save and close the file.
  15. Validate the customized install kit. See Validating your customized Notes® install kit for details.
  16. Perform a test install or upgrade to be sure that the customized Notes® install kit functions correctly.