Performing a Notes® silent install or upgrade on Windows

MSI command line arguments are available, and may be required, for running a Notes® command line install to add or remove Notes® client features during initial install, release upgrade, or within the same Notes® release.

Before you begin

You must be logged in as an administrative user or user with elevated privileges to install or upgrade Notes®.

About this task

Run the Notes® setup.exe from the directory in which it resides locally.

Previous Notes® releases supported the use of SELECTINSTALLFEATURES on the MSI command line to add and optionally remove install manifest (install.xml in Notes® install kit) features. Notes® 8.5.2 introduced support for the ADDFEATURES and REMOVEFEATURES command line arguments. Although the SELECTINSTALLFEATURES command line argument remains available for installing Notes® features, it is no longer available for removing installed Notes® features. See Tech Note 1424066 for details.

Note: ADDFEATURES and REMOVEFEATURES properties are available only as command line arguments when using a Notes® silent install. These properties can be set directly on the command line or used within an MSI Transform file during silent installation mode only. To control the feature selections in the feature panel in the UI mode, use the Notes® install manifest (install.xml) file settings or consider using the UpdateSiteMgr tool supplied with the Notes® install kit.
Note: For enabling the Notes® Preloader option use an MSI transform file; see Tech Note 1424193 for details.

The Notes® features that can be included on the MSI silent install command line are as follows:

  • DESIGNER -- Notes® single user install only (Allclient kit)
  • ADMINISTRATOR -- Notes® single user install only (Allclient kit)
  • Activities -- Connections
  • SametimeUI -- Embedded IBM® Sametime®
  • Feedreader -- Feeds sidebar panel
  • ClientSingleLogon
  • CAE -- Composite Applications Editor
  • OpenSocial -- OpenSocial component
  • ALL -- All available MSI options and all features available for install as specified in the Notes® install kit’s install manifest (install.xml)

Feature names are as shown in the following table. See Running a silent install or upgrade using optional arguments and Calling a transform file during Notes® silent install for command line options not described in the following examples.

Table 1. Using ADDFEATURES during Notes® upgrade
Scenario Currently installed Command line Result
Adding Activities when upgrading Notes® Allclient 8.5 and CAE ADDFEATURES=Activities Upgrade CAE. Install Activities/Connections.
Adding NSL (Notes® single logon) when upgrading Notes® AllClient with Designer, Activities/Connections, Feedreader ADDFEATURES= ClientSingleLogon Upgrade Designer, Activities/Connections, Feed Reader. Install Notes® Single Logon.
Upgrading with no changes Notes® Allclient with default features installed setup.exe /s /v/qb+ Upgrade all the default features that were installed with the earlier release.
Upgrading and adding ALL features Notes® client with only Notes® installed ADDFEATURES=ALL Upgrade Notes® and install ALL optional MSI features. Install ALL optional install manifest (install.xml) features.
Table 2. Using REMOVEFEATURES during Notes® upgrade
Scenario Currently installed Command line Result
Removing Activities when upgrading Notes® Allclient with CAE, Activities/Connections REMOVEFEATURES=Activities Upgrade CAE. Uninstall Activities/Connections.
Removing NSL (Notes® single logon) when upgrading Notes® AllClient with Designer, Activities/Connections, Feed Reader, NSL REMOVEFEATURES=ClientSingleLogon Upgrade Designer, Activities/Connections, Feed Reader Uninstall Notes® Single Logon
Table 3. Using ADDFEATURES within the same release
Scenario Currently installed Command line Result
Adding Activities after re-running setup.exe Notes® with CAE ADDFEATURES=Activities Install Activities/Connections.
Adding NSL (Notes® single logon) after re-running setup.exe Notes® with Designer, Activities/Connections, Feed Reader ADDFEATURES=ClientSingleLogon Install Notes® Single Logon
Modifying with no changes Notes® Allclient with default features installed setup.exe /s /v/qb+ Leave everything as is.
Modifying the install to add ALL features Notes® client with only Notes® installed ADDFEATURES=ALL Install ALL optional MSI features. Install ALL optional manifest (install.xml) features.
Table 4. Using REMOVEFEATURES within the same release
Scenario Currently installed Command line Result
Removing Activities Notes® with CAE, Activities/Connections REMOVEFEATURES=Activities Uninstall Activities/Connections.
Removing NSL (Notes® single logon) Notes® AllClient with Designer, Activities/Connections, Feed Reader, NSL REMOVEFEATURES=ClientSingleLogon Uninstall Notes® Single Logon.
Examples are as follows:
  • Using the REMOVEFEATURES argument when removing Notes® features silently
    Use the REMOVEFEATURES argument to uninstall named features during an upgrade install or on re-running an install for the same release. Sample REMOVEFEATURES command line syntax is as follows:
    setup /s /vREMOVE=Name of the feature to be uninstalled
    For example, when rerunning the Notes® command line installer to remove Activities, you would use the following command line:
    setup /s /vREMOVE=Activities /qb+
  • Using the ADDFEATURES argument when installing Notes® features silently
    Use the ADDFEATURES argument to install named features during an upgrade install or on re-running an install for the same release. Sample ADDFEATURES command line syntax is as follows:
    setup /s /vADDFEATURES=Name of the feature to be uninstalled
    For example, to add the CAE and Feedreader, use the following command line:
    setup /s/vADDFEATURES=CAE,Feedreader /qb+
    You can optionally use SELECTINSTALLFEATURES to install these named features:
    setup /s /vSELECTINSTALLFEATURES=Feedreader /qb+
  • Using the ADDFEATURES and REMOVEFEATURES arguments together
    You can use ADDFEATURES and REMOVEFEATURES arguments when upgarding to a new Notes® release and installing or removing Notes® features silently. You can add and/or remove MSI-only features, Notes® install manifest-only features, and hybrid features during a silent installation. You can combine ADDFEATURES and REMOVEFEATURES in a single command line. For example, to add Activities but remove the Feed Reader you could use the following command:
    setup /s /vADDFEATURES=Activities REMOVEFEATURES=Feedreader /qb+
    There are instances where the ADDFEATURES and REMOVEFEATURES command line arguments cannot be used on the same command line. The ADDFEATURES=ALL and REMOVEFEATURES arguments cannot be used in the same command. As well, you cannot specify the same features in both the ADDFEATURES and REMOVEFEATURES arguments in the same command. However, you can use these two arguments in the same command if they specify different features. For example, the following command is not supported:
    setup.exe /s /vSETMULTIUSER=1 ADDFEATURES=ALL REMOVEFEATURES=SametimeUI,Feedreader /L*v c:\temp\log852.log /qb+
Additional examples are as follows:
  • To perform a Notes® silent multi-user install or upgrade , use the SETMULTIUSER=1 command line statement:

    setup.exe /vSETMULTIUSER=1 /qb

  • To run the install in silent mode, using default values, without a progress bar, use the following syntax:

    setup.exe /s /v/qn

    Note: For example, this command installs Notes® to the single user default C:\Program Files\IBM\Notes directory and Notes® data folders and files to the C:\Program Files\IBM\Notes\data directory.
  • To display a message when installation is complete or if install fails, use the + parameter as follows:

    setup.exe /s /v/qn+

  • To display a progress bar during the installation, in addition to displaying the message indicating that the installation is complete or it has failed, use the following syntax:setup.exe /s /v/qb+
  • To specify a non-default destination directory, for example C:\IBM\Notes, use the following syntax:

    setup /S /VADDFEATURES=ALL PROGDIR=C:\IBM\Notes DATADIR=C:\IBM\Notes\Data /qn

    Note: Each feature in the Notes® install manifest (install.xml) for which the required attribute is set to true will be installed.
  • To specify which install manifest features to install, obtain the installfeature ID syntax from the Notes® install manifest (install.xml). To install any of these features, include the feature ID value in the ADDFEATURES property on the command line. Specify comma-separated names in quotes as follows.

    Note the placement of the quote, equals sign, and space characters.

    setup /s /vADDFEATURES=Activities,SametimeUI,CAE /qn