IBM Support

ADDFEATURES and REMOVEFEATURES MSI command line arguments for Notes silent install or upgrade

News


Abstract

Notes and Domino 8.5.2 introduces new MSI command line options for running a Notes command line install to add or remove Notes client features either during initial install, release upgrade, or within the same Notes release.

From Notes 8.0.x to Notes 8.5.1, Notes supported the use of SELECTINSTALLFEATURES on the MSI command line to add and optionally remove features listed in the install manifest (Notes install kit's install.xml file).

In Notes 8.5.2 two new MSI command line arguments, ADDFEATURES and REMOVEFEATURES, have been added. The SELECTINSTALLFEATURES command line argument remains available for installing Notes features. However, SELECTINSTALLFEATURES is no longer available for removing installed Notes features.

Content

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

Note: The SELECTINSTALLFEATURES command line argument available in Notes 8.5.1 and earlier has been deprecated and is no longer able to remove installed Notes features. Instead, use the REMOVEFEATURES argument and list the names of features to remove from the existing installation.

For details about changes made to SELECTINSTALLFEATURES, see Lotus Tech Note 1424486.

Note: ADDFEATURES and REMOVEFEATURES properties are only available 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 ADDTOKIT or TRIMUPDATESITE utilities supplied with the Notes install kit and documented in the Domino Administrator's guide.

Note: 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 /v"SETMULTIUSER=1 ADDFEATURES=ALL REMOVEFEATURES=SametimeUI,Feedreader /L*v c:\temp\log852.log /qb+"

Background

From Notes 8.0.x to Notes 8.5.1, Notes supported the use of SELECTINSTALLFEATURES on the MSI command line to add and optionally remove install manifest-only (install.xml in Notes install kit) features.

In Notes 8.5.2 two new MSI command line arguments, ADDFEATURES and REMOVEFEATURES, have been added. The SELECTINSTALLFEATURES command line argument remains available for installing Notes features. However, SELECTINSTALLFEATURES is no longer available for removing installed Notes features.

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

  • DominoDesigner -- Notes single user install only (Allclient kit)
  • DominoAdministrator -- Notes single user install only (Allclient kit)
  • Editors -- Lotus Symphony
  • Activities -- Activities/Connections
  • SametimeUI -- Embedded Lotus Sametime
  • Feedreader -- new in 8.5.2, was installed automatically with Notes
  • ClientSingleLogon
  • CAE -- Composite Applications Editor
  • 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.

Features names (on Features Panel) MSI command line names Installfeature names (as in install.xml file)
Notes Client N/A N/A
Client Single Logon Feature ClientSingleLogon N/A
Domino Designer DominoDesigner Notes.Designer.Install
Domino Administrator DominoAdministrator Notes.Admin.Install
IBM Lotus Symphony Editors Editors
Lotus Connections N/A Activities
Composite Application Editor N/A CAE
Feed Reader N/A Feedreader
Sametime N/A SametimeUI


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 /v"REMOVEFEATURES=<Name of the feature to be uninstalled>"

For example, when rerunning the Notes 8.5.2 command line installer to remove the Lotus Symphony Editors, you would use the following command line:

setup /s /v"REMOVEFEATURES=Editors /qb+"

Note: See "Running a silent install or upgrade using optional arguments" and "Calling a transform file during Notes silent install" in the Domino 8.5.1 Administrator's guide for details on the other (not new) command line options used in this example.

Note: This tech note impacts the information presently found in the following Domino 8.5.1 Administrator's guide topics. For release 8.5.2 and greater, use the information in this tech note rather than the earlier version equivalent information in the following help topics:

-- Performing a Notes silent install on Windows
-- Running a silent install or upgrade using optional arguments
-- Calling a transform file during Notes silent install
-- Using the install manifest "default" setting for silent feature specification


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 /v"ADDFEATURES=<Name of the feature to be installed>"

For example, to add the Editors (Lotus Symphony), and the Feedreader user interface you would use the following command line:

setup /s/v"ADDFEATURES=Editors,Feedreader /qb+"

Note: You can continue to use SELECTINSTALLFEATURES to install named features. For example, to add the Feed Reader you could use the following command line, specifying SELECTINSTALLFEATURES instead of ADDFEATURES:

setup /s /v"SELECTINSTALLFEATURES=Feedreader /qb+"


Use cases illustrating ADDFEATURES and REMOVEFEATURES command line arguments

The following use case scenarios show examples of how the ADDFEATURES and REMOVEFEATURES arguments work in conjunction with an upgrade to Notes 8.5.2 or greater when installing or removing Notes features silently. These use cases include adding and/or removing MSI-only features, Notes install manifest-only features, and hybrid features during a silent installation.

Note: You can combine ADDFEATURES and REMOVEFEATURES in a single command line. For example, to add Lotus Symphony but remove the Feed Reader you could use the following command:

setup /s /v"ADDFEATURES=Editors REMOVEFEATURES=Feedreader /qb+"


Silent install use cases for upgrading to a new release (8.5.2 or greater):
These use case scenarios show examples of how the ADDFEATURES and REMOVEFEATURES arguments work in conjunction with an upgrade to Notes 8.5.2 or greater to install or remove Notes features silently.


Using ADDFEATURES when upgrading to release 8.5.2 from an earlier Notes release

Scenario Current install on disk Command line (only listing the properties) Expected behavior
Adding Activities when upgrading to 8.5.2 Notes Allclient 8.5 with Editors/Lotus Symphony, CAE ADDFEATURES=Activities
Upgrade Editors/Lotus Symphony and CAE

Install Activities/Connections
Adding Editors (Lotus Symphony) when upgrading to 8.5.2 Notes client 8.5 with Activities/Connections, CAE, SametimeUI ADDFEATURES=Editors Upgrade Activities/Connections, CAE, SametimeUI

Install Editors/Lotus Symphony
Adding NSL (Notes single logon) when upgrading to 8.5.2 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, for example 8.5
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


Using REMOVEFEATURES when upgrading to release 8.5.2 from an earlier Notes release
Scenario Current install on disk Command line (only listing the properties) Expected behavior
Removing Activities when upgrading to 8.5.2 Notes Allclient with Editors/Lotus Symphony, CAE, Activities/Connections REMOVEFEATURES=Activities
Upgrade Editors/Lotus Symphony and CAE

Uninstall Activities/Connections
Removing Editors (Lotus Symphony) when upgrading to 8.5.2 Notes client only with Activities/Connections, CAE, SametimeUI, Editors/Lotus Symphony REMOVEFEATURES=Editors Upgrade Activities, CAE, SametimeUI

Uninstall Editors/Lotus Symphony
Removing NSL (Notes single logon) when upgrading to 8.5.2 Notes AllClient with Designer, Activities/Connections, Feed Reader, NSL REMOVEFEATURES=ClientSingleLogon Upgrade Designer, Activities/Connections, Feed Reader

Uninstall Notes Single Logon


Silent install use cases for modifying within the same release (8.5.2 or greater):
These use case scenarios show examples of how the ADDFEATURES and REMOVEFEATURES arguments work when modifying an existing Notes installation (8.5.2 or greater) within the same release to install or remove Notes features silently.

Using ADDFEATURES when re-running the installer within the same release
Scenario Current install on disk Command line (only listing the properties) Expected behavior
Adding Activities after re-running setup.exe for 8.5.2 Notes Allclient 8.5.2 with Editors/Lotus Symphony, CAE ADDFEATURES=Activities
Install Activities/Connections
Adding Editors after re-running setup.exe for 8.5.2 Notes client 8.5.2 with Activities/Connections, CAE, SametimeUI ADDFEATURES=Editors Install Editors/Lotus Symphony
Adding NSL (Notes single logon) after re-running setup.exe for 8.5.2 Notes AllClient 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

Using REMOVEFEATURES when re-running the installer within the same release
Scenario Current install on disk Command line (only listing the properties) Expected behavior
Removing Activities Notes Allclient 8.5 with Editors/Lotus Symphony, CAE, Activities/Connections REMOVEFEATURES=Activities
Uninstall Activities/Connections
Removing Editors (Lotus Symphony) Notes client 8.5 with Activities/Connections, CAE, SametimeUI, Editors/Lotus Symphony REMOVEFEATURES=Editors Uninstall Editors/Lotus Symphony
Removing NSL (Notes single logon) Notes AllClient with Designer, Activities/Connections, Feed Reader, NSL REMOVEFEATURES=ClientSingleLogon Uninstall Notes Single Logon

Related information

Information Center - Notes and Domino product documenta
Wiki - Notes and Domino community posts and related doc
Notes and Domino Upgrade Cookbook
Lotus Support site and Tech Notes
Notes command line argument SELECTINSTALLFEATURES no lo


Document information

More support for: IBM Notes
Install/Setup

Software version: 8.5.2

Operating system(s): Windows

Reference #: 1424066

Modified date: 08 June 2011