Installing the HFS backup client for Solaris

1. Introduction: Prerequisites & Obtaining the Software

This document contains installation instructions for the TSM version 7 client for Solaris on SPARC and the Spectrum Protect version 8 client for Solaris on x86. IBM supports these client versions to run on Solaris 10 and Solaris 11. They should not be installed on older versions. Note that IT Services no longer have any SPARC based machines available for testing so although we can offer general support on use and configuration we may not be able to help with Solaris specific matters.

The current client software versions are Version 7, Release 1, Level 6.5 (also known as 7.1.6.5) for SPARC and Version 8, Release 1, Level 1=0.0 (also known as 8.1.0.0) for x86. Note that from version 8 IBM no longer provide a client for Solaris on SPARC.

The Backup/Archive client requires the following software in order to run:

  • Sun Solaris 10 or 11
  • Java Runtime Environment (JRE) 7 to run the GUI dsmj

You need to be connected to the university network directly or via VPN to download the software; an eduroam connection without VPN is not sufficient.  Once it is downloaded, you can install and use the client over eduroam as well as with a wired connection or VPN.

2. Upgrading from an earlier client version

To upgrade from an earlier version of the client you should first backup your configuration and remove the previous version as follows:

3. Obtaining & Installing the client software

3.1. Downloading and installation

  1. Download the latest client for your architecture - either SPARC or X86. This is a compressed tar file.
  2. To install the new Solaris client ensure that you have uninstalled any previous version of the software as detailed in the previous section, then login as the root user and change directory to where the package has been downloaded. Extract the tar file
    tar zxvf tsm-solaris-Sparc-7.1.6.5-1.tar.gz
    

    for SPARC or

    tar zxvf tsm-solaris-X86-8.1.0.0-1.tar.gz
    

    for X86

  3. Install the packages extracted from the tar file
    pkgadd -a ./tsmadmin -d ./gsk8cry64.pkg all
    pkgadd -a ./tsmadmin -d ./gsk8ssl64.pkg all
    pkgadd -a ./tsmadmin -d ./TIVsmCapi.pkg all
    pkgadd -a ./tsmadmin -d ./TIVsmCba.pkg all
    

    Answer yes if asked whether to create a directory

  4. Change to the directory /opt/tivoli/tsm/client/ba/bin and extract the hfs-config.tar file
    cd /opt/tivoli/tsm/client/ba/bin
    tar xvf (path to tar file)/hfs-config.tar
    

3.2. Initial Configuration

  • You now need to configure the software. How you do this depends on whether you are upgrading or performing a new installation.
    • If you are upgrading from a previous version copy the dsm.opt, dsm.sys, and (if it exists) incl.excl you saved during the uninstall to /opt/tivoli/tsm/client/ba/bin.
    • If you are performing a fresh installation
      cd /opt/tivoli/tsm/client/ba/bin
      cp dsm.opt.example dsm.opt
      cp dsm.sys.example dsm.sys
      

      You must now edit dsm.opt and dsm.sys to insert your Nodename, Servername, TCPServer, and TCPPort. For details see Manually Configuring TSM for Solaris. When you have done that run

      dsmc

      Hit return when asked for your user id (which accepts the default of the node name you configured in dsm.sys and then enter your TSM password. This will be cached so you won't be asked for it in future. Type quit to exit the client.

  • If you want to run the TSM scheduler follow the instructions in see Setting Up a New TSM Scheduler on Solaris

4. Allowing or preventing non-root use of the client

By default non-root users are able to use the TSM/Spectrum Protect software to back up and restore their own files. Should you wish to disable this functionality, do as follows:

  • Change the permissions on /opt/tivoli/tsm/client/ba/bin/dsmtca by running the following command as the root user:
    chmod 4700 /opt/tivoli/tsm/client/ba/bin/dsmtca 

If you wish to restrict access to a group of users do the following:

  • Create a trustedusers Unix group (the actual name is up to you).
  • Add each user who needs access to the trustedusers group.  The root user does not need to be a member of this group.
  • Change the group owner of /opt/tivoli/tsm/client/ba/bin/dsmtca to the trustedusers group by running the following command as the root user:
    chgrp trustedusers /opt/tivoli/tsm/client/ba/bin/dsmtca 
  • Change the permissions on /opt/tivoli/tsm/client/ba/bin/dsmtca by running the following command as the root user:
    chmod 4750 /opt/tivoli/tsm/client/ba/bin/dsmtca 
  • Ensure that there is access to dsmerror.log. You can do this by changing the value of errorlogname in dsm.sys from the default (/var/log/dsmerror.log) to a location where the user concerned has access, e.g. their home directory. An alternative is to change permissions on /var/log/dsmerror.log, to enable write-access.

This will enable a non-root user to back up and restore only their own files. To back up and restore all files, you must run TSM/Spectrum Protect as the root user.

Written by IT Services. Latest revision 16 June 2017