Forge Home

tsm

Install and manage the TSM client

30,906 downloads

10,757 latest version

2.7 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.

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 Nov 26th 2014
This version is compatible with:
  • Puppet Enterprise >= 3.0.0 < 3.4.0
  • Puppet 3.x
  • , , , , ,

Start using this module

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

Add this module to your Puppetfile:

mod 'nosolutions-tsm', '0.3.1'
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 0.3.1

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 0.3.1 Nov 26th 2014

puppet-tsm ![Build Status] (https://secure.travis-ci.org/nosolutions/puppet-tsm.png) 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
  • CentOS 5/6
  • Oracle Linux 5/6
  • Scientific Linux 5/6
  • Solaris 10/11
  • Debian 7

##Setup

What tsm effects

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

###Setup requirements

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

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

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).

###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.

##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 and add a second inclexcl option that points to /opt/tivoli/tsm/clien/ba/bin/InclExcl.local to dsm.sys. For example add the following to dsm.sys.local:

inclexcl /opt/tivoli/tsm/client/ba/bin/InclExcl.local

##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
  • Solaris 10 i386/sparc
  • Solaris 11 i386/sparc
  • Debian 7

##Development

Fork me and create pull requests.

###Contributors

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