how to create bmc server automation(bsa) for deploying … · how to create bmc server...

How to create BMC Server Automation(BSA) configuration file, depot and job objects for deploying new Control-M Agents on Unix/Linux servers

This document details the steps needed to create automatic installation BSA packages for deploying new

Control-M Agents. In order to create these packages, the BSA and Control-M administrators will need to

work together as knowledge of both products is required.

These steps use temporary directories for the installation files, but this is normally only needed for DMZ

servers as you can remotely mount the BSA server share as the source directory. Likewise, the

CONFIG.dat updates are only required for DMZ servers. These steps also assume local entries for the

Control-M Agent user account and group, but you could also LDAP and NIS instead. Steps for a clean

install are documented, but you could modify the package for upgrades by removing steps for creating

the user, group, local directory, and startup scripts.

Table of Contents Standards for Depot and Job structure ................................................................................................ 3

Depot hierarchy ............................................................................................................................... 3

Job Hierarchy ................................................................................................................................... 5

Configuration File Objects.................................................................................................................... 6

Unix Installation Steps ......................................................................................................................... 7

Linux DMZ clean install flow with screenshots ..................................................................................... 8

Batch Job with all steps .................................................................................................................... 8

Install check ..................................................................................................................................... 9

Add ctmagent service to /etc/services ........................................................................................... 10

Add ctmagent local account ........................................................................................................... 11

Copy install files since you can’t mount back to production from DMZ ........................................... 13

Silent install commands ................................................................................................................. 14

Create automatic startup script links.............................................................................................. 14

Remove install files ........................................................................................................................ 15

Update the CONFIG.dat entries for DMZ. ....................................................................................... 15

Standards for Depot and Job structure a. Create a consistent hierarchy structure

b. Evaluate the structure of the Source installation files

i. Download the installation files

ii. Place them in a directory on the BladeLogic Application Server share

iii. Directory will be copied or mounted for source directory

c. Hierarchy used in this document

i. Applications

ii. Application Name (Control-M)

iii. Specific OS folder (AIX, Solaris, HPUX, Linux, Windows)

iv. Common Unix

Depot hierarchy

Top Level for Control-M Agents

Specific OSes and Common Unix

Job Hierarchy

Configuration File Objects Connect to a server that already has a Control-M Agent installed to create the configuration file objects

for CONFIG.dat and installed-versions.txt. You will need configuration file objects for each different

Unix/Linux OS using name space value grammar (nsvp_space.gm). Once created, it will appear under the

Configuration branch for each server with a Control-M Agent.

Folder

Example server

Unix Installation Steps a. Remove any older 32 bit agents since they can’t be upgraded to 64 bit. Depending on

the use case, you may need to leverage 32 bit agents. For example, some Control

Modules are still only 32 bit on specific OSes.

i. Run shut-ag scripts

ii. Verify no more p_ctm* processes are running. This may indicate multiple

instances of the agent, so validate installation and configuration files.

iii. Archive sysout directory, if sysadmins would like to validate prior jobs.

iv. Delete the directory

d. Review prerequisites from installation documents

i. Check for sufficient disk space

ii. Check Install Path

iii. Check group membership

iv. Check user account

v. Add Control-M service to /etc/services

b. Actual install

i. File location

1. Mount for Production servers

2. Copy for DMZ servers

ii. Platform specific setup.sh calls silent install file

c. Setup automatic startup script links

d. Run Config.dat updates if needed.

e. Delete any temporary directories created for the installer

Linux DMZ clean install flow with screenshots

Batch Job with all steps

Install check

This must be a local directory and not NFS as per the installation documentation. Since this is a clean

install, the script fails and exits with a return code if the directory already exists.

Add ctmagent service to /etc/services

Add ctmagent local account

i. Add local controlm group

ii. Create /bmc/local/apps/controlm

iii. Create /bmc/local/apps/controlm/ctmagent

iv. Update permissions

v. Create actual user

Copy install files since you can’t mount back to production from DMZ

Network path to source

Silent install commands

(Generate silent installer XML via interactive installation)

#!/bin/sh

cd /bmc/local/apps/controlm/ctmagent &&

/bmc/local/apps/controlm/ctm8install/blswin/controlm/DRKAI.8.0.00/UNIX/Linux-i386/setup.sh -silent

/bmc/local/apps/controlm/ctm8install/blswin/controlm/DRKAI.8.0.00/controlm-install-user.xml

Create automatic startup script links

Remove install files

Update the CONFIG.dat entries for DMZ.

Each configuration entry is on a separate line. The Name and Value0 match the left hand side. Value1

matches the right hand side of the file. DMZ hosts will need to have ALLOW_COMM_INIT set to N and

PERSISTENT_CONNECTION set to Y. You will also need to update the settings in Control-M Configuration

Manager so that the Control-M Server initiates the connection to the DMZ server.