Eclipse files and folders in the Notes® install kit

You can customize the Notes® install kit relative to supplied Eclipse features.

While you continue to have the ability to customize Notes® install using tuner capabilities, the addition of Eclipse features and plug-ins has broadened your Notes® install capabilities.

When customizing the Notes® install kit, you work primarily in two directories, deploy and updateSite, in the supplied Notes® install kit. The updateSite directory is supplied in zipped form.
Note: See the related topics for instructions on customizing the Notes® install kit.

You can optionally edit the install manifest (install.xml) to specify how features, such as the Composite Applications Editor, appear on the Notes® feature installation panel. For example, a feature can appear selected for install by default or not. You can also edit the install manifest to remove features from the installation panel, either to force installation or prevent that feature from being selected during install. You can also optionally remove a feature from the installation kit itself. Finally, you can customize installation to add custom or third-party features by editing the install manifest to add features for Notes® install, adding related feature and plug-in JAR files to the correct features and plugins subdirectories in a customized update site, and updating the site manifest to correctly list the features in a customized update site.

  • deploy directory

    The Notes® installation kit's deploy directory includes the following:

    • install.xml -- install manifest that lists the Eclipse features to install

      You can customize the install manifest to specify which features to install. You can use the install manifest to allow the user to choose installation of a given feature. You can also specify features to install, update, or remove after the initial Notes® installation.

      The install manifest uses Eclipse standards, but is a file unique to the Notes® installation. An installfeature attribute reflects the feature name users see on the Notes® feature installation panel. Lower-level feature statements are grouped together at a level subordinate to the higher-orderinstallfeature attribute.

    • plugin_customization.ini -- Eclipse preferences file
    • updateSite.zip -- Eclipse updateSite directory zip file

      The zipped updateSite directory includes the following:

      -- site.xml -- This is a registry of the features to expose for install. The site registry lists the Eclipse features available for install. It uses a unique Document Type Definition (DTD) or set of XML file conventions.

      -- features subdirectory -- This contains the (signed) feature JAR files. Features are used to organize plug-ins.

      -- plugins subdirectory -- This contains the (signed) plug-in JAR files. Plug-ins hold runtime code.

Eclipse features are specified for installation in the supplied install manifest. The install manifest, in conjunction with the updateSite.zip contents, determine which features are available in the Notes® installer.

By default, the following features are included on the Notes® features installation panel. You can suppress their display, and establish installation program defaults, using the install manifest and optionally the install .MSI file.

  • Notes® Client
  • Domino® Designer
  • Domino® Administrator
  • IBM® Connections (Activities)
  • Composite Applications Editor
  • Feed Reader
  • OpenSocial component
  • IBM® Sametime® (integrated)
Note: In the install manifest supplied in the Notes® install kit, do not modify features whose "required" attribute is set to "true."