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
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.
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.
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 |
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. |
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 |
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 |
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. |
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. |
- Using the REMOVEFEATURES argument when removing Notes® features silentlyUse 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:
For example, when rerunning the Notes® command line installer to remove Activities, you would use the following command line:setup /s /v
REMOVE=Name of the feature to be uninstalled
setup /s /v
REMOVE=Activities /qb+
- Using the ADDFEATURES argument when installing Notes® features silentlyUse 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:
For example, to add the CAE and Feedreader, use the following command line:setup /s /v
ADDFEATURES=Name of the feature to be uninstalled
setup /s/vADDFEATURES=CAE,Feedreader /qb+
You can optionally use SELECTINSTALLFEATURES to install these named features:setup /s /v
SELECTINSTALLFEATURES=Feedreader /qb+
- Using the ADDFEATURES and REMOVEFEATURES arguments togetherYou 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:
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 /s /v
ADDFEATURES=Activities REMOVEFEATURES=Feedreader /qb+
setup.exe /s /v
SETMULTIUSER=1 ADDFEATURES=ALL REMOVEFEATURES=SametimeUI,Feedreader /L*v c:\temp\log852.log /qb+
- To perform a Notes® silent
multi-user install or upgrade , use the
SETMULTIUSER=1
command line statement:setup.exe /v
SETMULTIUSER=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 /V
ADDFEATURES=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 theADDFEATURES
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 /v
ADDFEATURES=Activities,SametimeUI,CAE /qn