NOTES CLIENT INSTALLATION AND UPGRADE


Customizing the Notes install manifest for supplied Eclipse features
You can optionally edit the supplied IBM® Lotus® Notes® install manifest (INSTALL.XML) to control which features are available for installation and what the user sees on the feature installation panel.

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, Lotus Symphony, Connections (Activities), embedded 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, and as of Notes 8.5.1 Lotus Symphony 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.

For Notes installation of supplied Eclipse™ features, you can do any of the following:


When customizing the INSTALL.XML file for supplied features, focus only on the "installfeature" element, not the sub-level "feature" element.

When you open the Notes INSTALL.XML file in a Web browser or XML editor, it opens in expanded form and the hierarchy is apparent. To simplify display, collapse the feature hierarchy so that only the "installfeature" elements are visible. Each "installfeature" element represents an installable feature.

You can edit the install manifest using an XML editor or text editor but be sure to validate the XML before moving to the next step in the customization process.

A sample of INSTALL.XML text (specifically an "installfeature" block) is shown below. For supplied features such as the Composite Application Editor and Lotus Symphony, the attributes you can edit are "default," "required," and "show" which are seen in the "installfeature" element snippet below:

+ <installfeature default="false" description="%Editors.description"
id="Editors" name="%Editors.name"
required="false" show="true"
version="8.0.0.20071115.0230">

Note Do not edit any "installfeature" element whose "required" attribute is set to "true."


For related information, see "Provisioning manifest DTD" in IBM® Lotus® Expeditor help at the Lotus Expeditor information center or in the Lotus Expeditor wiki.

Example: Display a feature on the features installation panel and enable the user to select or deselect the feature

To display an "installfeature" name and enable the user to select or deselect it during Notes install, set the following values:


Example: Display a feature on the features installation panel and force its installation

To display an "installfeature" name and force its installation, set the following values:


Example: Prevent a feature from appearing on the features installation panel and install

To prevent an "installfeature" name from appearing on the features installation panel and force its installation, set the following values:


Example: Prevent a feature from appearing on the features installation panel and do not install

To prevent an "installfeature" name from appearing on the features installation panel and prevent its installation, either delete that feature block, comment its "installfeature" element in the INSTALL.XML file, or set the following values:


You can remove an "installfeature" by deleting it from the install manifest to minimize the size of the Notes install. However, only the Lotus Symphony, Lotus Sametime, and the Composite Application Editor can be removed from the kit; do not remove any other "installfeature" from the install manifest.

Related topics