Skip to content

Microsoft Windows installation (64-bit)

Manual installation

This document describes how to manually install IBM Spectrum Protect Backup-Archive Client on Windows (64-bit).

Required files:

Installation and Configuration

Installation of the software

  1. Download the required files according to above into a temporary folder.
  2. Run 8.x.x.x-TIV-TSMBAC-WinX64.exe to extract all installation files.
  3. Open the TSMClient Installation directory that just got created and run spinstall.exe and accept the UAC pop-up that comes up, "Setup Launcher Unicode". UAC Pop-up Follow the instructions on the screen, and if this is a new installation, you maybe need to install a few requirements.

    Spectrum Protect Backup-Archive Client - InstallShield Wizard

    1. The installation process could sometimes require a reboot, due to the installation of a couple of VC redistributables.
    2. If a reboot is unpleasant, at the above decision point, jump to the "Circumvent reboot during install" section below.
    3. Resume the installation, choose Typical installation.
    4. After installation, answer 'No' to the reboot question.

Create Configuration File

  1. Retrieve client node configuration and password from the Safespring Backup Portal, and edit the dsm.opt.sample, copy the Setup Information from the portal and paste it in to dsm.opt.sample file and save that file in C:\Program Files\Tivoli\TSM\baclient.

Copy the Backup Configuration information

Paste the information to the dsm.opt.sample file between the *** Copy and Paste Information from Safespring Backup Portal *** sections.

dsm.opt sample file

Save the file as dsm.opt in the Backup-Archive Directory e.g C:\Program Files\Tivoli\TSM\Baclient\dsm.opt.

Install the certificate

Run the SafeDC-Net-Root-CA-win64.bat script as admin. It will remove all previous certificates and install the correct CA Root for the BaaS service into the IBM cert store. TSM/IBM will not use, nor touch the system certificate stores in any way. This is safe to run several times, it will just remove and reinstall the same CA Root certificate every time.

First connection

  1. Test the connection, the easiest way is either via GUI or CLI.

    1. Login via Command-Line

    Start a Command-Line window in Administrator Mode and change to the Backup-Archive Client directory e.g., cd C:\Program Files\Tivoli\TSM\Baclient Start the dsmc.exe and it will now ask you to confirm the User ID that is the same as your node name, and copy and paste the password from the Safespring Backup Portal

    Copy Password from Safespring Backup Portal Paste Password to the Password Feild

    Run quit to exit Spectrum Protect Backup-Archive Client CLI.

    1. Login via GUI

    The GUI icon can be found in the start-menu, search for "Backup-Archive GUI".

    GUI via Start-Menu

    When the Backup-Archive GUI starts, it will ask for Node Admin ID and Password. These can be copied and pasted from the Safespring Backup Portal.

    Copy Password from Safespring Backup Portal Paste Password to Password Feild

    If the application starts, it has logged in successfully, and will save the password (encrypted) for future use.

Schedule Daily Backups

  1. IBM Spectrum Protect Backup-Archive Client is polling the backup server regularly to see when it should backup your data next time. To assign a predefined schedule, open Safespring Backup Portal and go to the consumption unit you want to define a schedule too and click on schedule Consumption Unit Schedule

Here can you schedule the backup for your consumption unit.

  1. Setup IBM Spectrum Protect Backup-Archive Client schedule polling.

    1. Setup schedule via Command-Line

    Start a Command-Line window in Administrator Mode and change to the Backup-Archive Client directory e.g cd C:\Program Files\Tivoli\TSM\Baclient. Run the following commands to set up your schedule.

    dsmcutil install scheduler /name:"TSM Client Scheduler" /node:<NODENAME> /optfile:"<PATH TO DSM.OPT>" /password:<TSM PASSWORD> /autostart:no /startnow:no
    dsmcutil install cad /name:"TSM Client Acceptor" /node:<NODENAME> /password:<TSM PASSWORD> /optfile:"<PATH TO DSM.OPT>" /autostart:yes /startnow:no
    dsmcutil update cad /name:"TSM Client Acceptor" /cadschedname:"TSM Client Scheduler"
    net start "TSM Client Acceptor"
    1. Setup schedule via GUI

    The GUI icon can you find in the start-menu, search for Backup-Archive GUI

    GUI via Start-Menu

    Click on Utilities -> Setup Wizard to start the Configuraton Wizard.

    Start the Schedule Setup Wizard

    A wizard will help you to go through the process step-by-step of setting up the schedule.

    Schedule Wizard Guide

    Confirm that you want to Install a new or additional scheduler, if Update ... and Remove ... is enabled, that means you already have an earlier Spectrum Protect Schedule configured.

    Install a new or addition scheduler

    Make sure you enable [X] Use the client acceptor to manage the scheduler

    Enable Client Acceptor to Manage Scheduler

    Confirm the name of the TSM Client Acceptor and press Next

    Client Acceptor Configuration File Path

    Confirm the Client Acceptor TCP Port, this port doesn't need to be exposed externally.

    Client Acceptor TCP Port, default is 1581

    Insert the node password, the password can be copied from the Safespring Backup Portal.

    Insert Node name and Password

    Click on (o) Automatic when Windows boots to automatic start the TSM Client Acceptor Services

    Client Acceptor Services

    Confirm the location where you want to save the TSM Schedule and Error Logs, and if you want to log to Windows Event Logger

    TSM Client Logs Files

    Click on (o) Yes to start the TSM Client Acceptor when the wizard is done.

    Start TSM Client Acceptor after wizard

    Confirm the configuration before the Setup Wizard creates the services.

    Confirm the Schedule Services

    The Configuration is now done, click Finish to quit the wizard.

    Finish the configuration


Basic installation of the Backup-Archive Client is now done. If you need to set up an Online agent for e.g., Microsoft SQL, Oracle Database or any other application, you can continue with that installation.