Appendix B.
Performing a Silent Installation
This appendix describes how to perform a silent Tivoli Storage Manager installation. A silent installation runs unattended, requiring no monitoring or dialog box input. No installation wizards appear. Silent installation is run by using the MSIEXEC command from the command line interface, or by incorporating the MSIEXEC command into a command file. The command file can also be used to combine a silent installation of the server with a configuration of the server. You can use the silent installation method to ensure consistent configuration if you are installing Tivoli Storage Manager on multiple computers with identical hardware. For example, if you have multiple Tivoli Storage Manager servers in different locations, you can produce and distribute a CD containing the same silent installation package for each server. You can also place a silent installation package on a file server for distribution over a network. Because Tivoli Storage Manager is based on the Microsoft Windows Installer technology, all of the Tivoli Storage Manager components can be deployed using Active Directory and Group Policy. For more information on deploying Tivoli Storage Manager using Group Policy, refer to the Windows 2000 online help. This appendix contains the following sections that describe how to use the silent installation function: Installing the Server Installing the Licenses Installing the Backup-Archive Client Installing the Device Driver Feature Tables Including a Custom Client dsm.opt File Installation Troubleshooting Performing a Silent Uninstall
Installing the Server
The MSIEXEC command is used to silently install the Tivoli Storage Manager server, licenses, client, and device driver from the command line. Each of these components should be installed separately by specifying its respective feature information from the feature tables. The source file of each component can be identified by its .msi extension. These files are located on the product CD. For more information about the MSIEXEC command, refer to Microsoft documentation. The following is an example of installing the Tivoli Storage Manager server using the MSIEXEC command for a silent installation. Explanations of the parameters follow the example. Command msiexec /i "c:\tsm_images\TSM51_Complete\server\Tivoli Storage Manager Server.msi" RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 INSTALLDIR="e:\program files\tivoli\tsm" ADDLOCAL="Online_Main,Online_Server_Readmes,Online_Server,Server_Base" TRANSFORMS=1033.mst /qn /l*v "c:\server_log.txt" /i
Specifies an installation. "c:\tsm_images\TSM42_Complete\server\Tivoli Storage Manager Server 5.0.msi" Specifies the complete path to the server source package. Look for the actual source package on the product CD. It will have an .msi extension. RebootYesNo="No" REBOOT="Suppress" Specifies that a reboot should not be performed. Except for the Tivoli Storage Manager device driver, it is recommended that you not allow a reboot of your machine when using silent installation. ALLUSERS=1 Specifies that the package is for all users. This parameter is required. INSTALLDIR="c:\program files\tivoli\tsm" Specifies the destination path. If Tivoli Storage Manager is already installed on the system and you are upgrading your server, the existing path will be used as the destination path. ADDLOCAL="Online_Main,Online_Server_Readmes,Online_Server,Server_Base" Specifies the list of features to install. See Table 17 for a complete list. TRANSFORMS=1033.mst Specifies the language transform to use. See Table 21 for a complete list. /qn Specifies that this is a silent install. /l*v "c:\install_log.txt" Specifies verbose logging and the name and location of the Tivoli Storage Manager installation log file.
Installing the Licenses
The following is an example of installing the Tivoli Storage Manager licenses using the MSIEXEC command for a silent installation. Note that only the source package name and the ADDLOCAL parameter are different from the server install example. Command msiexec /i "c:\tsm_images\TSM51_Complete\licenses\Tivoli Storage Manager Licenses.msi" RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 INSTALLDIR="e:\program files\tivoli\tsm" ADDLOCAL=License TRANSFORMS=1033.mst /qn /l*v "c:\license_log.txt"
Installing the Backup-Archive Client
The following is an example of installing the Tivoli Storage Manager backup-archive client using the MSIEXEC command for a silent installation. Note that only the source package name and the ADDLOCAL parameter are different from the server install example. Command msiexec /i "c:\tsm_images\TSM51_Complete\baclient\TivoliStorageManagerClient.msi"
RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 INSTALLDIR="e:\program files\tivoli\tsm" ADDLOCAL="BackupArchiveGUI,BackupArchiveWeb,ApiRuntime,AdministrativeCm d, Online_Client_Readmes" TRANSFORMS=1033.mst /qn /l*v "c:\client_log.txt"
Installing the Device Driver
The following is an example of installing the Tivoli Storage Manager device driver using the MSIEXEC command for a silent installation. Note that only the source package name and the ADDLOCAL parameter are different from the server install example. Command msiexec /i "C:\tsm_images\TSM51_Complete\driver\Tivoli Storage Manager Device Driver.msi" RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 INSTALLDIR="e:\program files\tivoli\tsm" ADDLOCAL="Online_Main,Online_Driver_Readmes,DeviceDriver_Files" TRANSFORMS=1033.mst /qn /l*v "c:\driver_log.txt"
Feature Tables
Table 17. Server Features and Feature Descriptions Server Feature Online_Main Online_Server_Readmes Online_Server Server_Base chs cht deu esp fra itn jpn kor ptb Description Main HTMLHelp Online Information Files Server Readmes and HTMLHelp Books Server HTMLHelp Online Book Files Server and Management Console Files Simplified Chinese support Traditional Chinese support German support Spanish support French support Italian support Japanese support Korean support Portuguese support
Table 18. Server License Feature and Feature Description
Server License Feature License
Description Server Licenses
Table 19. Backup Archive Client Features and Feature Descriptions Client Feature BackupArchiveGUI BackupArchiveWeb ApiRuntime ApiSdk AdministrativeCmd Online_Client_Readmes BooksPdf BackupArchiveGuiChs BackupArchiveWebChs BackupArchiveGuiCht BackupArchiveWebCht BackupArchiveGuiDeu BackupArchiveWebDeu BackupArchiveGuiEsp BackupArchiveWebEsp BackupArchiveGuiFra BackupArchiveWebFra BackupArchiveGuiIta BackupArchiveWebIta BackupArchiveGuiJpn BackupArchiveWebJpn BackupArchiveGuiKor BackupArchiveWebKor BackupArchiveGuiPtb BackupArchiveWebPtb Description BA Graphical User Interface BA Web Client API Runtimes API SDK Administrative Command Line Client Readmes and HTMLHelp Book PDF Book Simplified Chinese GUI support Simplified Chinese Web support Traditional Chinese GUI support Traditional Chinese Web support German GUI support German Web support Spanish GUI support Spanish Web support French GUI support French Web support Italian GUI support Italian Web support Japanese GUI support Japanese Web support Korean GUI support Korean Web support Portuguese GUI support Portuguese Web support
Table 20. Device Driver Features and Feature Descriptions Device Driver Feature Online_Main Online_Driver_Readmes Description Main HTMLHelp Online Information Files Readme.dev file
DeviceDriver_Files
Device driver and related files
Table 21. Transform and Language Transform 1028.mst 1031.mst 1033.mst 1034.mst 1036.mst 1040.mst 1041.mst 1042.mst 1046.mst 2052.mst Language CHT Traditional Chinese DEU German ENG English ESP Spanish FRA French ITA Italian JPN Japanese KOR Korean PTB Portuguese CHS Simplified Chinese
Including a Custom Client dsm.opt File
Users who would like to install a predefined DSM.OPT file should place a copy of the DSM.OPT file in the CONFIG directory located within the install image. tsm_images\TSM_BA_Client\baclient\Program Files\Tivoli\TSM\config.
The file must be named DSM.OPT. The installation program will copy 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 on the target computer. The installation program will not copy over an existing DSM.OPT file. DSM.OPT exists in the install image's CONFIG directory, as described above
Installation Troubleshooting
Table 22. Symptoms and Resolutions Symptom If you receive a message during setup indicating that you do not have enough Resolution Try updating an entry in the setup.ini file that is included with the package. If your package is on CD, you'll have to copy the
free space to install on a drive that does entire package to a hard drive so that you can edit setup.ini. have free space. Once setup.ini is available on your hard drive you can edit it and change the line DiskSpace=8000 to DiskSpace=0000. If you receive a message indicating an internal error of 2735 If you do not see any TSM icons on the desktop after an install If near the end of the installation process, a warning message box titled 'HTML 1.31 Update' displays with the text, "This computer already has a newer version of HTML Help" If Silent Install doesn't appear to work Ensure that you have at least NT4 SP3 installed, including the level of Internet Explorer that ships with SP3 or higher. Click on an empty area of the desktop and press F5 to refresh the desktop display Click on the OK button and continue
Remove the /qn parameter and re-execute your msiexec command. Any errors should be displayed. After you fix the problem add the /qn parameter again.
Performing a Silent Uninstall
You should stop any running Tivoli Storage Manager services before performing an uninstallation. To see which Tivoli Storage Manager services are running, you can type net start in a Windows command prompt. Look for any services that have Tivoli Storage Manager in them. If you have installed any Tivoli Storage Manager services using your own names, look for those as well. Each Tivoli Storage Manager service you plan to remove should be stopped. To stop a Tivoli Storage Manager service, type net stop "service name". For example, to stop the first server instance you can type net stop "tsm server1". You can silently uninstall the Tivoli Storage Manager server, licenses, and device driver by using the /x parameter instead of the /i parameter for each command. All other parameters remain the same. The following is an example of silently uninstalling the Tivoli Storage Manager server using the MSIEXEC command. Command msiexec /x "c:\tsm_images\TSM51_Complete\server\Tivoli Storage Manager Server 5.0.msi" RebootYesNo="No" REBOOT="Suppress" ALLUSERS=1 INSTALLDIR="c:\program files\tivoli\tsm" ADDLOCAL="Online_Main,Online_Server_Readmes,Online_Server,Server_Base" TRANSFORMS=1033.mst /qn /l*v c:\install_log.txt
