Upgrading the Windows client

You can upgrade an earlier version of the Tivoli® Storage Manager Windows backup-archive client to Version 7.1.3. Your previous configuration settings are preserved, where it is possible to do so. However, enhancements that are in the latest version of the client can deprecate or prohibit the use of options that were available in earlier versions of the client.

Before you begin

Wait for any in-progress backup-archive client tasks (backup, restore, archive, retrieve) to complete before you upgrade a client node.

About this task

To upgrade to the Version 7.1.3 Windows client, install the Version 7.1.3 Windows client; you do not need to uninstall previously installed client software first. The Version 7.1.3 client installation program preserves your current client options and settings (in dsm.opt), and it does not overwrite or delete the dsmerror.log, dsmsched.log, and dsmwebcl.log files, if you install the new client into the same directory that was used by the previous installation.

The Logical Volume Snapshot Agent (LVSA) component was deprecated in Tivoli Storage Manager Version 6.4. If you previously had LVSA configured as your snapshot provider, install the Version 7.1.3 client, and then configure it to use the Microsoft Volume Shadow Copy Service (VSS) as the snapshot provider in the new installation. If LVSA was installed, your client reboots after the upgrade installation completes, to allow for the removal of LVSA entries from the registry.

The installation program stops any client services that are running before it upgrades the client software. If you prefer, you can manually stop the services by using the control panel or command line. Table 1 shows the stoppable services, and the names to look for in the Control Panel > Administrative Tools > Services list, so you can stop them with the Control Panel. The table also provides the commands to stop them from a command prompt or a script.

Note: The service names that are shown in the table are the default names that are set by the installation program. You can change some of these service names when you configure the services by using one of the configuration wizards on the Utilities > Setup Wizard menus. If you change the service name, record the name that you specify and use that name to stop the services.

Table 1. Stoppable services
Control panel display name	Command-line procedure
TSM Journal Service	`net stop "tsm journal service"`
TSM Client Acceptor	`net stop "tsm client acceptor"`
TSM Client Scheduler	`net stop "tsm client scheduler"`
Remote Client Agent	`net stop "tsm remote client agent"`

Perform the following steps to upgrade an earlier version of the Tivoli Storage Manager Windows backup-archive client to Version 7.1.3:

Procedure

Install the product by using the installation DVD or the compressed installation file that you downloaded from Passport Advantage®.

Option	Description
DVD	Insert the DVD into the DVD drive. If the installation program does not automatically start, browse the DVD to locate the setup.exe file. Double-click the setup.exe file.
Compressed installation file	Copy the compressed installation file that you downloaded from Passport Advantage a local disk or to a network-accessible share. Double-click the compressed installation file name. The program prompts you for a directory to unpack the files to. By default, this directory is the current disk drive, in `drive`:\tsm_images\TSM_BA_Client directory. Accept or change the location for the uncompressed installation files. If the installation program detects files from another client installation attempt in this directory, you are prompted to determine whether you want to overwrite the old files. If you receive this prompt, select Yes to All to overwrite the existing files; this selection ensures that only the files from the current installation are used.

Option

Description

DVD

Insert the DVD into the DVD drive.
If the installation program does not automatically start, browse the DVD to locate the setup.exe file. Double-click the setup.exe file.

Compressed installation file

Copy the compressed installation file that you downloaded from Passport Advantage a local disk or to a network-accessible share.
Double-click the compressed installation file name.
The program prompts you for a directory to unpack the files to. By default, this directory is the current disk drive, in drive:\tsm_images\TSM_BA_Client directory.
Accept or change the location for the uncompressed installation files. If the installation program detects files from another client installation attempt in this directory, you are prompted to determine whether you want to overwrite the old files. If you receive this prompt, select Yes to All to overwrite the existing files; this selection ensures that only the files from the current installation are used.

Select a language to use for this installation and click OK.
If you are prompted to install one, or more, Microsoft C++ redistributable files, the prompt indicates that your node does not have the C++ files that are required by the Windows backup-archive client. Click Install to install the files and continue with the client installation; or, click Cancel to end the installation process.
The Tivoli Storage Manager Windows backup-archive client installation program starts. On the Welcome screen, click Next to begin installing the new client software.
Accept or change the default installation directory.

Select the installation type: Typical or Custom.

Option	Description
Typical	A typical installation installs the following components: The backup-archive client GUI files (required to use the Java™ GUI) The backup-archive client web files (required to use the web client) The client API files (as needed by your client and operating system)
Custom	A custom installation installs the same files as a typical installation. However, you can choose to install the following optional components: The API SDK files. These files are only needed if you are developing applications that work with the Tivoli Storage Manager backup-archive client. The administrative client command line files. These files are needed if you want to run administrator functions on the Tivoli Storage Manager server. VMware vStorage API runtime files. These files are required if you are using this client as a data mover to back up VMware virtual machines. Windows data mover nodes must run the 64-bit Windows client.

Option

Description

Typical

A typical installation installs the following components:

The backup-archive client GUI files (required to use the Java™ GUI)
The backup-archive client web files (required to use the web client)
The client API files (as needed by your client and operating system)

Custom

A custom installation installs the same files as a typical installation. However, you can choose to install the following optional components:

The API SDK files. These files are only needed if you are developing applications that work with the Tivoli Storage Manager backup-archive client.
The administrative client command line files. These files are needed if you want to run administrator functions on the Tivoli Storage Manager server.
VMware vStorage API runtime files. These files are required if you are using this client as a data mover to back up VMware virtual machines. Windows data mover nodes must run the 64-bit Windows client.

Click Next, then click Install.
When the installer completes the installation, click Finish.
Verify the installation. Click Start > All Programs > Tivoli Storage Manager. The client components that you installed are shown in the list of Tivoli Storage Manager startable programs. This list includes only the administrative command-line client, backup-archive command-line client, or the backup-archive GUI. The other installable components (the API, SDK, and VMware vStorage API runtime files) do not display in this list.
Click the Backup-Archive GUI entry in the startable programs list.
1. When prompted, type your user ID and password and click Login.
2. After the GUI starts, click Help > About TSM. Verify that the version shown is Version 7.1.3.

What to do next

Your previous configuration settings are preserved in the dsm.opt file. If you previously used LVSA as the snapshot provider, warning messages are displayed when the command-line client is started. The messages provide instructions to edit the dsm.opt file and remove the LVSA options. Removing the unused options is not required, but removing options that have no affect or are not used, can facilitate troubleshooting. If you are using the GUI, the messages are not displayed, but they are logged in the dsmerror.log file, which is in the client installation directory, in the baclient directory. Messages are issued when any of the following options are included in dsm.opt. Some of these options are valid for VSS, and if they are, the messages are displayed and logged only if they contain parameters that are specific to LVSA.

snapshotcachelocation
snapshotfsidleretries
snapshotproviderimage
snapshotproviderfs
snapshotcachesize

You can set VSS options on the Snapshot tab in the Preferences Editor. They can also be set by running the online image support and open file support configuration wizards. To use the wizards, start the GUI and click Utilities > Setup Wizard. Select the wizards that you want to run, click Next, and follow the prompts to make your selections.