Silent installation

The Tivoli® Storage Manager backup-archive client installation program supports silent, unattended installations.

Note: The backup-archive client requires the Microsoft Visual C++ 2010 redistributable package as a setup prerequisite. The graphical installation program installs this package for you. If you are silently installing the client using MSIEXEC, you must separately install the Microsoft Visual C++ 2010 redistributable package. The package can be installed before or after the silent installation of the client is performed, but it must be installed before you use the backup-archive client.

The C++ restributable package performs a self-check operation to determine if any updates are available on the web. If an update is available, the package downloads and installs the update. After the update is installed, the C++ redistributable package reboots the workstation to register and use the updated libraries. This reboot is forced by the C++ redistributable update; you cannot prevent this reboot by using the RebootYesNo="No" REBOOT="Suppress" options.

Use the following executable files to install the C++ 2010 redistributable package. In these paths, dir represents the drive and directory where you saved the files to when you extracted them from the installation package.

Windows 32-bit clients: dir\ISSetupPrerequisites\{D4408760-7D16-4F02-B7C1-E68612F5FBFD}\ (contains vcredist_x86.exe)
Windows 64-bit clients: dir\ISSetupPrerequisites\{270b0954-35ca-4324-bbc6-ba5db9072dad} (contains vcredist_x86.exe); dir\ISSetupPrerequisites\{7f66a156-bc3b-479d-9703-65db354235cc} (contains vcredist_x64.exe)

To install a predefined (custom) dsm.opt file, use the following instructions before you begin the silent installation.

Place the customized copy of the dsm.opt file in the ...\CONFIG directory located within the install image, for example:
```
tsm_images\TSM_BA_Client\baclient\Program Files\Tivoli\TSM\config
```
The file must be named "dsm.opt".
The install program copies the predefined dsm.opt file to the ..\BACLIENT directory when BOTH of the following conditions are met:
- dsm.opt does NOT exist in the ..\BACLIENT directory. The install program does not copy over an existing dsm.opt file.
- dsm.opt exists in the ..\CONFIG directory of the install image, as described earlier.

To perform a silent installation of the C++ redistributables or the backup-archive client, you must turn off User Account Control (UAC).

To turn UAC off, use either the Windows Control Panel or the MSCONFIG utility.

To turn UAC off in the Control Panel, select Control Panel > User Accounts > Change User Account Control settings, then select Never Notify.

To turn UAC off using MSCONFIG, open a command prompt window and start MSCONFIG. Then select the Tools tab and Change User Account Control settings; then click Launch and turn UAC by selecting Never Notify.

After you install the C++ redistributables and the Windows client, remember to turn UAC on.

The C++ redistributables require elevated privileges to install them. Open a command prompt window as follows:

Click Start Menu > All Programs > Accessories > Command Prompt.
Right click the Command Prompt icon to view the properties.
Click Run as administrator.
Click Continue in the permission window.
Start the product installation using the command prompt window. On a 32-bit Windows system, install the 32-bit C++ redistributable package. On a 64-bit Windows system, install the 64-bit C++ redistributable package.

Silently installing C++ redistributables for the 32-bit client

vcredist_x86.exe /q /c:"msiexec /i vcredist.msi /qn /l*v 
  %temp%\vcredist_x86.log"

Silently installing C++ redistributables for the 64-bit client

vcredist_x86.exe /q /c:"msiexec /i vcredist.msi /qn /l*v 
  %temp%\vcredist_x86.log"

vcredist_x64.exe /q /c:"msiexec /i vcredist.msi /qn /l*v 
  %temp%\vcredist_x64.log"

Install the Windows backup-archive client. User Account Control (UAC) should still be turned off. If it is not turned off, turn off UAC now. Open a command prompt that has elevated privileges.

Click Start Menu > All Programs > Accessories > Command Prompt.
Right click the Command Prompt icon to view the properties.
Click Run as administrator.
Click Continue in the permission window.
Start the Windows backup-archive client silent installation using the command prompt window. On a 32-bit Windows system, install the 32-bit clients and API. On a 64-bit Windows system, install the 64-bit clients and API. Install one or more language packs if languages other than English are needed.

Silent client installation on Windows 32-bit systems

When you place a customized version of the msiexec command (which invokes the Microsoft Software Installer) in a script or batch file, you can perform installations on multiple Windows systems. The following 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. While the command is physically spread across multiple lines on this page, enter it on a single command line.

msiexec /i 
"Z:\tsm_images\TSM_BA_Client\IBM Tivoli Storage Manager Client.msi"
RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 
INSTALLDIR="c:\program files\tivoli\tsm" 
ADDLOCAL="BackupArchiveGUI,BackupArchiveWeb,ApiRuntime,
AdministrativeCmd"
TRANSFORMS=1033.mst /qn /l*v "c:\log.txt"

Silent client installation on Windows 64 bit systems

This example is essentially the same as the 32-bit example. However, it names the 64 bit API feature on the ADDLOCAL= parameter. The language pack installation is the same for either platform.

msiexec /i 
"Z:\tsm_images\TSM_BA_Client\IBM Tivoli Storage Manager Client.msi"
RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 
INSTALLDIR="c:\program files\tivoli\tsm" 
ADDLOCAL="BackupArchiveGUI,BackupArchiveWeb,Api64Runtime,
AdministrativeCmd"
TRANSFORMS=1033.mst /qn /l*v "c:\log.txt"

Silent language pack installation (32 and 64-bit clients)

You must install client features before you install a language pack. Install a language pack with a command like the following. Although the command is physically split across multiple lines on this page, enter it on one single command line.

msiexec /i 
"Z:\tsm_images\TSM_BA_Client\IBM Tivoli Storage Manager Client - French.msi"
RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 
INSTALLDIR="c:\program files\tivoli\tsm" 
ADDLOCAL="LanguageFiles" TRANSFORMS=1036.mst /qn /l*v "c:\log.txt"

The descriptions of the silent installation parameters are as follows:

msiexec

Invokes the Microsoft Software Installer (MSI) program.

/i

Installs the specified source package (replace with /x to uninstall the package).

"drive:\tsm_images\TSM_BA_Client\IBM Tivoli Storage Manager Client.msi"

The complete path to the source package. Z: is the CD or network drive containing the installation image. You must substitute the appropriate drive letter for your system.

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 would be required is if the installation was an upgrade to an existing Tivoli Storage Manager client, and the installation was performed while the client programs were running. Therefore, shut down all Tivoli Storage Manager client programs and services before performing 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 have 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.

For 32-bit client installations: ADDLOCAL="BackupArchiveGUI,BackupArchiveWeb,ApiRuntime"

For 64-bit client installations: ADDLOCAL="BackupArchiveGUI,BackupArchiveWeb,Api64Runtime"

Specifies the features to install. Specify all the components on a single line within quotation marks, separated by commas, with no spaces before or after the commas. The backup-archive features are available as shown in the following table:

Windows 32 bit client features	Windows 64 bit client features	Feature description
BackupArchiveGUI	BackupArchiveGUI	Graphical user interface
BackupArchive web	BackupArchive web	Backup-archive web client
ApiRuntime	Api32Runtime Api64Runtime	API Runtimes
ApiSdk	ApiSdk	API SDK
AdministrativeCmd	AdministrativeCmd	Administrative Command Line
VMwareBackupTools	VMwareBackupTools	VMware vStorage API runtime files

ADDLOCAL="LanguageFiles"

After you install client features, you can install a language pack. You must install client features before you install a language pack.

Windows 32 bit client features	Windows 64 bit client features	Feature description
LanguageFiles	LanguageFiles	Language-specific files

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 perform the installation silently.

/l*v "c:\log.txt"

Specifies verbose logging and the name and location of the log file.

The installation process creates a Tivoli Storage Manager folder in the programs folder of the Windows Start menu. You can start Tivoli Storage Manager by clicking one of the icons in this folder.