Skip to main content

IBM TSAMP SSH

Pack Assets

Monitored Objects

The Pack IBM Tivoli System Automation for Multiplatforms collects metrics for:

  • Resource-groups

Discovery rules

Rule nameDescription
App-Ibm-Tsamp-SSH-Resource-Group-NameDiscover resource groups and monitor status

Collected Metrics

Metric nameDescriptionUnit
resource_groups.unknown.countNumber of unknown resource groups
resource_groups.offline.countNumber of offline resource groups
resource_groups.online.countNumber of online resource groups
resource_groups.failed_offline.countNumber of failed offline resource groups
resource_groups.stuck_online.countNumber of stuck online resource groups
resource_groups.pending_online.countNumber of pending online resource groups
resource_groups.pending_offline.countNumber of pending offline resource groups
resource_groups.ineligible.countNumber of ineligible resource groups
status resource groupCurrent state of the resource group

Prerequisites

The centreon-engine user performs a SSH connection to a remote system user. This user must have enough privileges to run lssam command.

Setup

  1. Install the Centreon Plugin on every Poller:
yum install centreon-plugin-Applications-Ibm-Tsamp-Ssh
  1. On the Centreon Web interface in Configuration > Monitoring Connector Manager, install the IBM TSAMP SSH Pack

Host configuration

  • Add a new Host and apply the App-Ibm-Tsamp-SSH-custom Host Template

Once the template applied, some Macros have to be configured. 3 SSH backends are available to connect to the remote server: sshcli, plink and libssh which are detailed below.

MandatoryNameDescription
XSSHBACKENDName of the backend: sshcli
XSSHUSERNAMEBy default, it uses the user running process centengine on your Poller
SSHPASSWORDCannot be used with backend. Only ssh key authentication
SSHPORTBy default: 22
SSHEXTRAOPTIONSCustomize it with your own if needed. E.g.: --ssh-priv-key=/user/.ssh/id_rsa

Warning With that backend, you have to validate the target server fingerprint manually (with the SSHUSERNAME used).

How to test the Plugin and what are the main options for?

Once the Plugin installed, log into your Poller using the centreon-engine user account and test by running the following command :

/usr/lib/centreon/plugins/centreon_ibm_tsamp_ssh.pl \
--plugin=apps::ibm::tsamp::local::plugin \
--mode=resource-groups \
--hostname=10.30.2.81 \
--ssh-username=centreon \
--ssh-password='centreon-password' \
--ssh-backend=libssh \
--verbose

Expected command output is shown below:

OK: All resource groups are ok | 'resource_groups.unknown.count'=0;;;0; 'resource_groups.offline.count'=0;;;0; 'resource_groups.online.count'=5;;;0; 'resource_groups.failed_offline.count'=0;;;0; 'resource_groups.stuck_online.count'=0;;;0; 'resource_groups.pending_online.count'=0;;;0; 'resource_groups.pending_offline.count'=0;;;0; 'resource_groups.ineligible.count'=0;;;0;
Resource group 'db2_db2inst1_db2inst1_AUDIT-rg' operational state: online [nominal: online]
Resource group 'db2_db2inst1_db2inst1_AUDIT2-rg' operational state: online [nominal: online]
Resource group 'db2_db2inst1_db2inst1_TCDB-rg' operational state: online [nominal: online]
Resource group 'db2_db2inst1_netdb101-v_0-rg' operational state: online [nominal: online]
Resource group 'db2_db2inst1_netdb102-v_0-rg' operational state: online [nominal: online]

The command above gets resource groups statuses (--mode=resource-groups).

It uses a SSH username centreon (--ssh-username=centreon), a SSH password centreon-password (--ssh-password='centreon-password'), uses a SSH backend libssh (--ssh-backend='libssh') and it connects to the host 10.30.2.81 (--hostname=10.30.2.81) on the SSH default port 22 (--ssh-port=22).

All the options as well as all the available thresholds can be displayed by adding the --help parameter to the command:

/usr/lib/centreon/plugins/centreon_ibm_tsamp_ssh.pl \
--plugin=apps::ibm::tsamp::local::plugin \
--mode=resource-groups \
--help

Troubleshooting

Troubleshooting plugins