INSTALLING


Customizing the Notes install manifest for supplied Eclipse features
You can 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), Feed Reader, 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, Domino Administrator, and Lotus Symphony require the additional step of using the MSI tuner to create a transform file (.mst) that disables their install completely. This transform file must be used during install or upgrade.

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 install.xml snippet (specifically an "installfeature" element) 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.5.3.20121115.0230">

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


See the related topics for information on provisioning.

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:


Related concepts
Eclipse files and folders in the Notes install kit
Understanding the Eclipse update site

Related tasks
Customizing Lotus Notes install for features and plug-ins on Windows and Mac
Adding and removing components from the Notes install kit using UpdateSiteMgr

Related reference
Reducing Lotus Notes install kit size
Validating your customized Notes install kit

Related information
Provisioning manifest DTD