Windows operating systems

Upgrading the Windows client

You can upgrade an earlier version of the IBM Spectrum Protect™ Windows backup-archive client to Version 8.1.4. 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 8.1.4 Windows client, install the Version 8.1.4 Windows client; you do not need to uninstall previously installed client software first. The Version 8.1.4 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 IBM Spectrum Protect Version 6.4. If you previously had LVSA configured as your snapshot provider, install the Version 8.1.4 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"

Complete the following steps to upgrade an earlier version of the Windows backup-archive client to Version 8.1.4:

Procedure

  1. Download the appropriate package file from one of the following websites.
  2. Install the product by using the compressed installation file that you download from Passport Advantage®.
    1. Copy the downloaded compressed installation package to a local disk or to a network-accessible share. Be sure to extract the installation files to an empty directory.
    2. To extract the installation files to the same directory, double-click the compressed installation package.
    3. By default, the uncompressed files are stored in the current disk drive, in the download_directory\TSMClient directory. If the installation program detects files from another client installation attempt in this directory, you are prompted about whether to overwrite the old files. If you receive this prompt, enter A to overwrite the existing files; this selection ensures that only the files from the current installation are used.
    4. Double-click the spinstall.exe file to start the client installation program.
  3. Select a language to use for this installation and click OK.
  4. 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.
  5. The backup-archive client installation program starts. On the Welcome screen, click Next to begin installing the new client software.
  6. Accept or change the default installation directory.
  7. 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 to connect to IBM Spectrum Protect server V8.1.1 or earlier or V7.1.7 or earlier V7 levels)
    • The client API files (as needed by your client and operating system)

    Starting in V8.1.4, the NetApp API runtime files are no longer installed in a typical installation. If you must install them, use the Custom installation type.
    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 required if you are developing applications that work with the backup-archive client.
    • The administrative client command line files. These files are required if you want to run administrator functions on the IBM Spectrum Protect server.
    • The NetApp API runtime files. These files are required for snapshot differential backup operations.
  8. Click Next, then click Install.
  9. When the installer completes the installation, click Finish.
  10. Verify the installation. Click Start > All Programs > IBM Spectrum Protect. The client components that you installed are shown in the list of IBM Spectrum Protect 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 Runtime and SDK files) do not display in this list.
  11. 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 IBM Spectrum Protect. Verify that the version shown is Version 8.1.4.

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.
Related concepts:
Troubleshooting problems during installation (Windows)