Forge Home

tsm

Install and manage the TSM client

31,114 downloads

10,838 latest version

4.3 quality score

We run a couple of automated
scans to help you access a
module's quality. Each module is
given a score based on how well
the author has formatted their
code and documentation and
modules are also checked for
malware using VirusTotal.

Please note, the information below
is for guidance only and neither of
these methods should be considered
an endorsement by Puppet.

Support the Puppet Community by contributing to this module

You are welcome to contribute to this module by suggesting new features, currency updates, or fixes. Every contribution is valuable to help ensure that the module remains compatible with the latest Puppet versions and continues to meet community needs. Complete the following steps:

  1. Review the module’s contribution guidelines and any licenses. Ensure that your planned contribution aligns with the author’s standards and any legal requirements.
  2. Fork the repository on GitHub, make changes on a branch of your fork, and submit a pull request. The pull request must clearly document your proposed change.

For questions about updating the module, contact the module’s author.

Version information

  • 1.2.0 (latest)
  • 1.1.3
  • 1.1.2
  • 1.1.1 (deleted)
  • 1.1.0
  • 1.0.1
  • 1.0.0
  • 0.3.1
  • 0.2.2
  • 0.2.0
  • 0.1.0
  • 0.0.2
  • 0.0.1
released Apr 13th 2017
This version is compatible with:
  • Puppet Enterprise 2017.2.x, 2017.1.x, 2016.5.x, 2016.4.x
  • Puppet >= 3.0.0 < 5.0.0
  • , , , , , ,

Start using this module

  • r10k or Code Manager
  • Bolt
  • Manual installation
  • Direct download

Add this module to your Puppetfile:

mod 'nosolutions-tsm', '1.2.0'
Learn more about managing modules with a Puppetfile

Add this module to your Bolt project:

bolt module add nosolutions-tsm
Learn more about using this module with an existing project

Manually install this module globally with Puppet module tool:

puppet module install nosolutions-tsm --version 1.2.0

Direct download is not typically how you would use a Puppet module to manage your infrastructure, but you may want to download the module in order to inspect the code.

Download

Documentation

nosolutions/tsm — version 1.2.0 Apr 13th 2017

puppet-tsm Build Status Coverage Status

  1. Overview
  2. Module Description - What the module does and why it is useful
  3. Setup - The basics of getting started with tsm
  4. Usage - Configuration options and additional functionality
  5. Reference - An under-the-hood peek at what the module is doing and how
  6. Limitations - OS compatibility, etc.
  7. Development - Guide for contributing to the module

Overview

Install and manage TSM (Tivoli Storage Manager) client with puppet. It's heavily inspired by the puppetlabs-ntp module.

Module Description

This module handles installing, configuring and running the IBM Tivoli Storage Manager (TSM) client on the following operating systems:

  • RedHat Linux 5/6/7
  • CentOS 5/6/7
  • Oracle Linux 5/6/7
  • Scientific Linux 5/6/7
  • Solaris 10/11
  • Debian 6/7
  • AIX 7.1

Setup

What tsm effects

  • TSM package (TIVsm-Ba and TIVsm-API)
  • TSM configuration files (dsm.sys and InclExcl)
  • TSM service (dsmsched)

Setup requirements

RedHat

For RedHat Linux you need a yum repository that contains the rpm packages IBM provides in the TSM installation tar.gz.

These usually are

  • TIVsm-API64.x86_64.rpm
  • gskssl64-8.0.14.26.linux.x86_64.rpm
  • gskcrypt64-8.0.14.26.linux.x86_64.rpm
  • TIVsm-BA.x86_64.rpm

Debian

For Debian you need an apt repository that contains the deb packages. IBM only provides rpms so you might need to use alien to convert the rpms IBM provides in the TSM installation tar.gz. For info on converting rpms to debs consult: http://www.planetcobalt.net/sdb/tsm_debian.shtml

These usually are

  • tivsm-api64.deb
  • tivsm-ba.deb
  • gskcrypt64.deb
  • gskssl64.deb

Solaris

For Solaris 10 and 11 you need a HTTP server that provides the following packages for downloading:

  • TIVsmCapi.pkg
  • TIVsmCba.pkg
  • gsk8cry32.pkg
  • gsk8cry64.pkg
  • gsk8ssl32.pkg
  • gsk8ssl64.pkg

IBM provides the gsk packages as file systems packages (thanks IBM!), so you have to translate them with pkgtrans:

$ pkgtrans . gskssl32.pkg gsk8ssl32/

and copy them to your HTTP download location. You are going to need two download locations: one for sparc and one for i386 (see params.pp for an example).

AIX

For AIX TSM is shipped by IBM as LPP in BFF format. The package can be installed using the 'nim' (default) or 'aix' provider. Installing from a NIM repository, the variable package_uri must contain a valid lpp_source in order to make the installation work. This module will then install tivoli.tsm.client.ba.64bit.base and its requesite software.

By setting the 'service_manage' variable to true, 'dsmc sched' will be added as a subsystem definition to the subsystem object class in AIX.

Beginning with TSM

Include class TSM on hosts where you would like to install the TSM client packages. By default no config files will be replaced. The TSM class just makes sure the TSM packages are installed.

include tsm

If there is no dsm.sys this module creates a new one from the default template. Be sure to set config_replace to true if you would like to manage dsm.sys after the default template has been deployed.

Usage

All available options (see init.pp) should be changed via the main tsm class.

The default dsm.sys template only sets

  • COMMMethod
  • TCPPort
  • TCPServeraddress

if you would like to add additional default options for nodes, you have to use a hash (parameter config_hash) or hiera. Here's a hiera example:

tsm::config_hash:
    errorlogname: "/var/log/dsmerror.log"
    errorlogretention: "31 D"
    schedlogname: "/var/log/dsmsched.log"
    schedlogretention: "30 d"
    nodename: "%{::hostname}"
    inclexcl: "/opt/tivoli/tsm/client/ba/bin/InclExcl"
    inclexcl: "/opt/tivoli/tsm/client/ba/bin/InclExcl.other"
    passwordaccess: "generate"
    domain: "all-local"
    makesparsefile: "no"

There is also the possibility to add node local options to dsm.sys.local. Settings in dsm.sys.local are going to be merged into the global dsm.sys on the next puppet run.

Use the parameter config_opt_hash to manage dsm.opt in a similar way as dsm.sys. There is currently no support for a local dsm.opt file.

The Include/Exclude file

If there is no /opt/tivoli/tsm/client/ba/bin/InclExcl file available, this module also deploys a default InclExcl file.

For a puppet managed include/exclude file set inclexcl_replace to true.

In the case of a puppet managed include/exclude file, you can add local include/exclude rules to /opt/tivoli/tsm/clien/ba/bin/InclExcl.local

The default dsm.sys template already includes the InclExcl.local file.

It is also possible to add InclExcl entries via hiera. Please use the inclexcl_hash option for this:

tsm::inclexcl_hash
  exclude:
  - /var/log/.../*
  - /var/tmp/.../*

The default location for the file generated with tsm::inclexcl_hash is /opt/tivoli/tsm/client/ba/bin/InclExcl.hash. You can change this with the tsm::inclexcl_hash_source option.

Using the Client Acceptor Daemon (dsmcad)

If you want to use the Client Acceptor Daemon (dsmcad) instead of the Scheduler (dsmsched), you have to overwrite the following variables.

Example for RedHat 7:

tsm::service_script: "/etc/systemd/system/dsmcad.service"
tsm::service_name: "dsmcad"
tsm::service_script_source: 'puppet:///modules/tsm/dsmcad.redhat7'

Reference

Please see init.pp for an explanation of all available options.

Limitations

This module has been built on and tested against Puppet 3.1.0 and higher.

The module has been tested on:

  • RedHat Enterprise Linux 5/6/7
  • Solaris 10 i386/sparc
  • Solaris 11 i386/sparc
  • Debian 6/7
  • AIX 7.1

Development

Fork me and create pull requests.

Contributors

The list of contributors can be found at: https://github.com/nosolutions/puppet-tsm/graphs/contributors