If you are installing Notes® clients on Windows™, the UpdateSiteMgr tool allows you to customize the Notes install kit by listing components available for removal, removing components, and adding components.

Before you begin

Before adding new features to the install kit, see related topics on adding features to and customizing the kit. For example, before using the tool, you must perform the following tasks:

• Create and sign any new Eclipse features that you want to add to the Notes install kit.

  Note: Attempting to install or upgrade unsigned components will cause the Notes install executable to fail. See the related topics for instructions on signing features and plug-ins.

• Place the new features and plug-ins .jar files in the features and plugins update site subdirectories (updateSite.zip\features and updateSite.zip\plugins).
• Create and validate the new site.xml manifest file (updateSite.zip\site.xml).
• Create and validate the new install.xml install manifest in the deploy directory (deploy\install.xml).

The UpdateSiteMgr tool is supplied as UpdateSiteMgr.exe in the kit customization zip file in the deploy\Utility folder. This tool is used in command line mode only.

Note: For Windows, this tool supersedes the trimUpdateSite and addToKit tools used in earlier releases of Domino®. If using Linux™, see the related topic on customizing Notes install on that platform. If installing on Macintosh, see the related topics on the addToKit tools.

Procedure

• To display the usage information and command line parameter help, open a command prompt window and type UpdateSiteMgr.exe or UpdateSiteMgr.exe -h.

  An example of the information you see is as follows:

  Usage 1: UpdateSiteMgr.exe -[dhnVrL] kitpath

  Merges info from kitpath into the kit that is in the same folder as this executable.

  kitpath defaults to "." (current directory)

  -d Turn Debug On

  -h Print usage

  -n Do a dryrun

  -V Print version info

  Usage 2: UpdateSiteMgr.exe [-rL] componentId

  Remove info from kit that is in the same folder as this executable.

  -r Remove specified component from kit

  -L List all components that can be trimmed (removed) from kit

• To list components currently resident in and available for removal from the Notes install kit, type UpdateSiteMgr.exe -L

  For example, for a supplied Notes install kit, that list would be as follows:

  • Activities (Connections)
  • Sametime®
  • CAE (Composite Applications Editor)
  • Feedreader
  • OpenSocial component
  
  Note: If you remove or add components to the Notes install kit, and then run this command again, the UpdateSiteMgr.exe - L command output will change to reflect the current state of the Notes install kit.
• To remove a single component from the Notes install kit, use UpdateSiteMgr.exe -r and specify the component's designation.

  For example, to remove Feedreader, use the following command line statement:

  UpdateSiteMgr.exe -r feedreader

• To remove multiple components from the Notes install kit, use UpdateSiteMgr.exe -r and specify each component separated by space characters.

  For example, to remove Feedreader and the Composite Applications Editor from the Notes install kit use the following command line statement:

  UpdateSiteMgr.exe -r feedreader CAE

• To add a non-supplied or third-party signed component (feature or plug-in) to the Notes install kit, use UpdateSiteMgr.exe and specify the new updateSite in which that component resides, and that you want to merge into the Notes install kit's updateSite.zip file.

  For example, to add the signed contents of a custom updateSite use the following command line statement, where kitpath is the path to the custom updateSite.

  UpdateSiteMgr.exe kitpath

  Adding new features to the Notes install kit using addToKit (Macintosh)
  If you are installing Notes clients on Macintosh, you can use the addToKit tool to add new, signed features to the Notes install kit before installing or upgrading Notes.

Related concepts
Eclipse files and folders in the Notes install kit
Understanding the Eclipse update site
Installing a new feature using the Notes install kit

Related tasks
Signing custom or third-party features and plug-ins for install and update
Customizing Notes install for features and plug-ins on Windows and Mac
Deploying client plug-ins with widgets and the widget catalog
Customizing a Notes install kit to set certifier and trust defaults
Adding new features to the Notes install kit using addToKit (Macintosh)

Related reference
Validating your customized Notes install kit

Help on Help

All Help Contents

Help on Help