Windows operating systems

Silent installation

Edit online

The backup-archive client installation program supports silent, unattended installations.

If you plan to install the client on the same system as the IBM® Storage Protect 8.1.2 or later server, ensure that you halt the IBM Storage Protect server before you install the client. This action will prevent the client installation process from forcing the system to reboot. After you install the client, you can restart the IBM Storage Protect server.

Important: The Microsoft Visual C++ 2017 redistributable packages and the IBM Java™ Runtime Environment (JRE) package are required to use the backup-archive client. The graphical installation program installs these packages for you. However, if you are installing the client in silent mode by using MSIEXEC, you must install the Microsoft Visual C++ 2017 redistributable packages and the IBM JRE package separately. The packages can be installed before or after the silent installation of the client is completed, but they must be installed before you use the backup-archive client.
For systems with Microsoft Visual C++ 2015-2019:

If the Microsoft Visual C++ 2015-2019 Redistributable package is installed on your system, you do not need to install the "Microsoft Visual C++ 2017 Redistributable (x64)" package that is included with the backup-archive client installation package.

Microsoft Visual C++ 2015, 2017, and 2019 all share the same redistributable files. These redistributable files are combined into the following redistributable package by Microsoft:
  • Microsoft Visual C++ 2015-2019 Redistributable (x64)

If you install the Visual C++ 2015-2019 redistributable, an earlier version, such as the Visual C++ 2017 redistributable, is updated because the files that are included with Visual C++ 2015-2019 are compatible with earlier versions. If you install the Visual C++ 2017 redistributable on a system that already has Visual C++ 2015-2019 installed, the newer versions of the files that are installed by the Visual C++ 2015-2019 redistributable are not replaced. Indeed, if you install a lower-level redistributable package, a "newer version found" message is generated after the installation is started.

Use the following executable files to install the C++ and IBM JRE redistributable packages. In the paths that are shown, the dir text string represents the drive and directory where you saved the files when you extracted them from the installation package.

Windows executable files for installing C++ redistributable packages
dir\ISSetupPrerequisites\{915387C3-E260-4985-861D-E7A891A4F74B} (contains MS 2017 x64 C++ Runtime - vc_redist.x64.exe)
Windows executable file for installing the IBM JRE redistributable package
dir\ISSetupPrerequisites\IBM Java(TM) 21 Runtime Environment\spinstall.exe (contains IBM JRE - spinstall.exe)

To install the backup-archive client in silent mode, complete the actions in the following sections.

Install the C++ redistributable packages in silent mode

To install the C++ redistributable packages in silent mode, complete the following steps:
  1. From the dir\ISSetupPrerequisites\{25E2F1F0-09A7-4C6A-ADC7-CA620D43574E} directory, run the following command:
    vcredist_x64.exe /install /quiet /norestart /log logfilename
  2. From the dir\ISSetupPrerequisites\IBM Java(TM) 21 Runtime Environment directory, run the following command:
    vc_redist.x64.exe /install /quiet /norestart /log logfilename
For more information about the vcredist_x64.exe command, run the following command: 
vcredist_x64.exe /?
For more information about the vc_redist.x64.exe command, run the following command:
vc_redist.x64.exe /?

Install the IBM JRE redistributable package in silent mode

The following example is a sample command that installs the IBM JRE package. To run the command correctly on your system, you might need to customize this example.

Although the command is physically spread across multiple lines in the following example, enter it on a single command line as administrator

spinstall /s /v"RebootYesNo=\"No\" Reboot=\"ReallySuppress\" ALLUSERS=1 /qn /l*v \"jre_log.txt\""

Install the backup-archive client in silent mode

Install the Windows backup-archive client.

To install the backup-archive client in silent mode, complete the following steps:
  1. Click the Start Menu and type "command" to search for the Windows command prompt.
  2. Right-click the Command Prompt icon to view the properties.
  3. Click Run as administrator.
  4. Click Yes in the permission window.
  5. Start the Windows backup-archive client silent installation by using the command prompt window.

    When you place a customized version of the msiexec command (which calls the Microsoft Software Installer) in a script or batch file, you can perform installations on multiple Windows systems. The following example is a sample command to install the backup-archive command-line client, client GUI, web client, API, and Administrative command-line client.

    You might need to customize this example to run correctly on your system. Although the command is physically spread across multiple lines in the following example, enter it on a single command line:

    msiexec /i "Z:\tsm_images\TSMClient\IBM Storage Protect Client.msi" RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 INSTALLDIR="C:\Program Files\Tivoli\Tsm" ADDLOCAL="BackupArchiveGUI,RemoteWebServices,Api64Runtime,AdministrativeCmd" TRANSFORMS=1033.mst /qn /l*v "C:\log.txt"

The descriptions of the silent installation parameters are as follows:
msiexec
Starts the Microsoft Software Installer (MSI) program.
/i
Installs the specified source package (replace with /x to uninstall the package).
"Z:\tsm_images\TSMClient\IBM Storage Protect Client.msi"
Specifies the complete path to the source package. The Z drive is shown in this example. Specify the drive letter for the disk drive, in your configuration, that contains the installation image.
RebootYesNo="No" REBOOT="Suppress"
Under certain conditions, a system reboot might be necessary for the installation to complete successfully. This option causes the installation program to not reboot the system if circumstances would otherwise cause the reboot to occur. While this option is convenient, use it with caution because suppressing the reboot might cause the program to behave in an unpredictable manner. The most common reason that a reboot is required is if the installation was an upgrade to an existing backup-archive client, and the installation was performed while the client programs were running. Therefore, shut down all backup-archive client programs and services before you begin the installation.
ALLUSERS=1
Specifies that the package is for all users. This option is required.
INSTALLDIR="C:\Program Files\Tivoli\TSM"
Specifies the destination path. If you already installed this product or a previous version of this product on your workstation, use the current installation directory as the destination path for this package.
ADDLOCAL="BackupArchiveGUI,RemoteWebServices,Api64Runtime"
Specifies the features to install. Specify all the components on a single line within quotation marks, which are separated by commas, with no spaces before or after the commas. The installable client features are shown in the following table:
Windows client features Feature description
BackupArchiveGUI Graphical user interface
RemoteWebServices Client Web Server (for remote client operations using the web user interface)
AdministrativeCmd Administrative Command Line
ApiSdk API SDK
NetAppLibs NetApp API runtime files
Api64Runtime API Runtime
TRANSFORMS=1033.mst
Specifies which language transform to use. The following language transforms are available:
Transform Language
1028.mst CHT Traditional Chinese
1029.mst CSY Czech
1031.mst DEU German
1033.mst ENG English
1034.mst ESP Spanish
1036.mst FRA French
1038.mst HUN Hungarian
1040.mst ITA Italian
1041.mst JPN Japanese
1042.mst KOR Korean
1045.mst PLK Polish
1046.mst PTB Portuguese
1049.mst RUS Russian
2052.mst CHS Simplified Chinese
/qn
Specifies to install the product silently.
/l*v "C:\log.txt"
Specifies verbose logging and the name and location of the log file.

The installation process creates the IBM Storage Protect folder in the programs folder of the Windows Start menu. You can start the backup-archive client by clicking one of the icons in this folder.