NOTES CLIENT INSTALLATION AND SMART UPGRADE


Customizing Notes installation for supplied Eclipse features
You can edit the 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. For Lotus 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 Lotus 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 block 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 is shown below. For supplied features such as the Composite Application Editor and IBM® Lotus® Productivity Tools, the attributes you can edit are "default," "required," and "show."

<installfeature default="false" id="Editors" name="IBM Productivity Tools" required="false" show="true" version=".20070312.0245">
Note Do not edit any "installfeature" element whose "required" attribute is set to "true."


For other information about the install manifest, see the "Install manifest" section of "Customizing provisioned components" in IBM® Lotus® Expeditor help at http://publib.boulder.ibm.com/infocenter/ledoc/v6r1/topic/com.ibm.rcp.tools.doc.admin/optionalfeatures.html.

See the Expeditor release 6.1.1 help as it becomes available.

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 Lotus 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:


Note If you delete an unwanted "installfeature" block in the install manifest, you can also use a supplied script to delete the associated feature and plug-in JAR entries in the zipped updateSite.zip\features and updateSite.zip\plugins directories to minimize install media kit size.

Removing a feature from the installer

You can remove an "installfeature" block by deleting it from the install manifest and then running a tool to generate a update site zip file consisting of only the features and associated plug-ins represented in the install manifest. This helps minimize the size of the Lotus Notes install media kit and conserves disk space on the target Lotus Notes client.

See also