Professional Documents
Culture Documents
Date :
18/07/2007
Version :
V 1.0
The information in this document is the property of BMC
Software Services and is provided on a confidential and
restricted basis. This information shall not be disclosed
outside customer organization and shall not be duplicated,
used or disclosed in whole or in part for any purpose other
than to evaluate this Statement of Work from BMC Software.
BMC Software and the BMC Software logo are registered
trademarks or trademarks of BMC Software, Inc.
Copyright 2003, BMC Software, Inc.
Page 1/38
Admin-CTM
Contents
1 Introduction.......................................................................................................5
2
CONTROL-M administration...........................................................................6
2.1
2.1.1
Start........................................................................................................................ 6
2.1.2
Stop ....................................................................................................................... 7
2.2
2.3
CONTROL-M maintenance..............................................................................9
2.3.1
2.3.2
2.3.3
2.3.4
2.3.5
2.3.6
Statistics................................................................................................................ 14
2.3.7
2.3.8
2.3.9
Agents list............................................................................................................ 19
3 CONTROL-M/EM Administration...................................................................21
3.1
3.1.1
Start...................................................................................................................... 21
3.1.2
Stop...................................................................................................................... 22
3.2
Alerts ............................................................................................................. 25
4.2
Users .............................................................................................................26
4.3
4.4
Logs ..............................................................................................................27
Sysouts..........................................................................................................29
5.2
6 Cluster............................................................................................................31
6.1
Scripts ............................................................................................................31
6.1.1
Start CTM.............................................................................................................. 31
6.1.2
Start EM................................................................................................................ 33
6.1.3
Stop EM............................................................................................................... 35
6.1.4
Stop CTM.............................................................................................................. 37
Page 2/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Page 3/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
History of rvisions
Version
Date
Author
Commentary
1.0
18/072007
Emanuel Kwedi
1.2
24/09/2007
Karim Mansouri
Traduction
Diffusion list
Name
Company
Title
Thierry Hareng
Cap Gemini
Project manager
Stephane Marioni
BMC
PS Manager
Page 4/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
1 Introduction
The goal of this document is to have a concrete reference for the administration
of the environment Control-MR. It deals with administration task of the different
components.
The objective is to have a good performance of the product with an optimal use of the
resources.
To achieve this task, the responsibilities for the administrator can be defined as follows:
Make a backup of the data base Control-M./Server, and directories of Control-M. to
ensure a complete restoration in the event of crash of the machine or crash of the data
base.
To plan the tasks to be put in production.
To carry out the tasks of maintenance of the base
to purge the log periodically
to purge the conditions,
to check the integrity of the base,
To define levels of authorizations for the users of Control-M.
Page 5/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
2 CONTROL-M administration
The current administration tasks of the server Control-M. are:
Back up.
Purging SQL data Base message log
Purging of the directories proclog
Check the size of the database
Check the good performance of the product
2.1.1 Start
1. Database
Connect as oractm and execute
>Sqlplus /nolog
>Connect /as sysdba
>startup
1
sqlplus /nolog
SQL*Plus: Release 10.2.0.2.0 - Production on Tue Jul 17 13:43:13 2007
Copyright (c) 1982, 2005, Oracle. All Rights Reserved.
SQL> connect /as sysdba
Connected to an idle instance.
SQL> startup
ORACLE instance started.
Total System Global Area 1258291200 bytes
Fixed Size
2070944 bytes
Variable Size
822085216 bytes
Database Buffers
Redo Buffers
419430400 bytes
14704640 bytes
Database mounted.
Page 6/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Database opened.
2. Control-M serveur
To have the controlm menu execute: ctm_menu after the option Manager Menu and
Start ControlM
2.1.2 Stop
1. Control-M serveur
Controlm server is stopped by the interactive menu ctm_menu after Manager
Menu and Stop Control-M .
You can also use the command: shut_ctm
Page 7/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
2. Database
Connect as oractm and execute
> Sqlplus /nolog
>Connect /as sysdba
>shutdown immediate
1
sqlplus /nolog
SQL*Plus: Release 10.2.0.2.0 - Production on Tue Jul 17 13:33:34 2007
Copyright (c) 1982, 2005, Oracle. All Rights Reserved.
SQL> connect / as sysdba
Connected.
SQL> shutdown immediate
Database closed.
Database dismounted.
ORACLE instance shut down.
Page 8/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
They are batch processing, called by the utility ctmudly in the jobs ordered in the plan
by daily SYSTEM.
Each Scheduling table having the parameter associated in the command ctmudly will
be scann and the eligible jobs of this table will be placed in the plan, in Active the Job
File.
To well done the user daily jobs does not have a predecessor.
Page 9/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
The database contains a table of log of activity of Control-m (including the logs of the
jobs). This table must be purged regularly. The utility ctmlog allows the purging of the
oldest messages. We purge the messages older than 10 days.
Job which can be made
JOB NAME
Ctmlog
command
AutoEdit Assignement :
%%A=%%CALCDATE %%DATE 30
%%A=%%SUBSTR %%A 3 4
%%B=%%CALCDATE %%DATE 10
%%B=%%SUBSTR %%B 3 4
Ligne de commande :
Ctmlog delete %%A %%B
This job has neither predecessor nor successor, it execute when it is ordered in the
plan.
1
Page 10/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
JOB NAME
COMMAND
proclog
Page 11/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
JOB NAME
COMMAND
cond01
cond02
The first job ensures the calculation of the manual conditions. To avoid any conflict with
the end of User daily, this is preceded, by precaution, of a two minutes waiting
(recommendation BMC).
The second job ensures the addition of the manual conditions resulting from the
absence of planned predecessors.
The calculation of the manual conditions supposes that the plan is entirely loaded for
the day
The job of calculation is before the job which loads the conditions.
Page 12/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Controlm conditions table of the old conditions must be purged. This operation is done
bye the utility ctmcontb.
Jobs which can be done :
JOB NAME
Ctmcontb
COMMAND
AutoEdit Assignement :
%%DF=%%CALCDATE %%DATE 25
%%DT=%% CALCDATE %%DATE 20
Ligne de commande :
ctmcontb -DELETEFROM "*" %%DF %%DT
The variables %%DF and %%DT determine a range of dates for the account of which
the conditions are to be removed.
This job has neither predecessor nor successor. It is executed when it is ordered.
Page 13/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
2.3.6 Statistics
CONTROL-M maintains statistics of execution of the job which, are used for :
Visualization, via CONTROL-M/EM,
Alarm, by SHOUT WHEN EXECTIME.
During the flow of the production, statistical recordings are produced at a rate of one
per execution.
These instantaneous statistics can be cumulated and realised. This operation is
ensured by the utility ctmjsa.
Job which can be set up
Command ctmjsa
JOB NAME
COMMAND
ctmjsa
ctmjsa "*"
This job has neither predecessor nor successor. It is executed just when it is ordered.
Page 14/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
It is possible constantly to know the jobs are in the plan and their statute.
During the flow of the production, recordings are updated in the table containing
information of the day of planning.
Job which can be done :
Job Name
ctmpsm
Command
ctmpsm LISTALL > $home/psm.txt
This job has neither predecessor nor successor. It is carried out as of its rise in the plan
and cyclic.
Page 15/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
2.3.8.1
Ctmdbspace
It is possible constantly to have information on the size of the base and the logs.
This utility returns a message failed at the time the size is higher than the given limit.
Example: ctmdbspace - limit 50%
Nom du job
ctmdbspace
Ligne de commande
ctmdbspace -limit 50%
Page 16/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
2.3.8.2
Ctmdbused
Nom du job
ctmdbused
Ligne de commande
ctmdbused
Page 17/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
2.3.8.3
Ctmdiskspace
Nom du job
ctmdiskspace
Ligne de commande
ctmdiskspace -limit 25% -path /ctm_server/ctmuser
Page 18/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Job NAME
ctm_agstat
COMMAND
ctm_agstat LIST*
Page 19/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Page 20/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
3 CONTROL-M/EM Administration
The current tasks of the administration of the Control-M/EM server are:
Backup of the Oracle environment
back up of the definitions (Jobs, Scheduling groups, calendars)
Purging of the files Log
The management of alarms
The following components can be stopped/started from the Configuration Manager in
graphic mode, or by script (cli) on the Control-M/EM server.
The GUI Server
The GAS Server
The GCS Server
Gateway
2070944 bytes
Variable Size
822085216 bytes
Database Buffers
Redo Buffers
419430400 bytes
14704640 bytes
Database mounted.
Database opened.
Page 21/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
connect as emuser
type :
root_menu choose activation_menu
and choose start All to start :
Start of Configuration server
Start of Configuration Agent
Start of Corba
The components are launched automatically during the starting of the Unix
server. In manual mode, launching is carried out by putting following
components UP in the Configuration Manager:
GUI Server
Gateways
Global Alert Server
Global Server Condition
3.1.2 Stop
The components are launched automatically during the starting of the Unix
server. In manual mode, launching is carried out by putting following
components DOWN in the Configuration Manager:
GUI Server
Gateways
Global Alert Server
Global Server Condition
connect as emuser
type : root_menu choose activation_menu
and choose stop All to stop :
Page 22/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
sqlplus /nolog
SQL*Plus: Release 10.2.0.2.0 - Production on Tue Jul 17 13:33:34 2007
Copyright (c) 1982, 2005, Oracle. All Rights Reserved.
SQL> connect / as sysdba
Connected.
SQL> shutdown immediate
Page 23/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Database closed.
Database dismounted.
ORACLE instance shut down.
Page 24/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
JOB NAME
COMMAND
Alert
Use of autoedit to calculate the date -2
Page 25/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
4.2 Users
Profil
outils
fonctions
Administrateur Control-M
Responsable Ordo
Control-M Desktop
Control-M Gui
Configuration Manager
Expert technique
Control-M
Control-M Desktop
Control-M Gui
Oprateur
Control-M Gui
JOB NAME
COMMAND
dbcheck
Db_check_space
Page 26/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
4.4 Logs
The logs of the processes Control-M/EM are written in the following repertory:
<controlm/em>/log/
With each stop/starting of Control-M/EM, the logs of the processes are written in this
repertory and in mode diagnoses the files log will use much disk space, the
administrator must purge these files regularly.
Nom du job
log
Ligne de commande
find [path]/controlm/em/log/. -mtime +4 -exec rm {} \;
Page 27/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Page 28/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
5.1 Sysouts
The sysouts created by the execution of the jobs are stored on agent directory.
The duration of retention is managed by the parameter Maximum Days to Retain
Sysout Files, specified by the utility ctmsys.
Its value is 4 days. The sysouts older than 4 days are automatically removed.
Page 29/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Page 30/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
6 Cluster
6.1 Scripts
6.1.1 Start CTM
1
#!/bin/ksh
##################################################################
###########
##
start of CTM_serveur resource
#
07/07/2007 TOOLS TEAM
##################################################################
##########
exec >> /tmp/hacmp.out
control()
{
if [ $1 -ne 0 ]
then
echo " ${Label} Failed with Return Code $1" >> $HACMP_LOG
exit 1
fi
}
mmjjyy=`/usr/bin/date +%m/%d/%y`
hhmmss=`/usr/bin/date +%H:%M:%S`
/usr/bin/echo " *-*-*-*-*-*-*-*-*-*-*-* The begin ${mmjjyy} $
{hhmmss}*-*-*-*-*-*-*-*-*-*-*-*-*-"
#
-------------------------------------------------------------------------# variables
#
-------------------------------------------------------------------------CTM_ACC=controlm
ORACLE_DIR=/softs/oracle_ctm
CTM_DIR=/softs/controlm
ORASID=oractm
CTM_OWNER=controlm
HOSTNAME=`hostname`
AGENT_ACC=ctmagctm
AGENT_DIR=/softs/ctmagctm/ctm
HACMP_LOG=/tmp/hacpm.out
#
Page 31/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
${mmjjyy} $
exit
Page 32/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
6.1.2 Start EM
1
#!/bin/ksh
##################################################################
#
Script : Start resources control-M EM
#
Date : 2007/07/05
#
Version: V2
##################################################################
#
exec >> /tmp/hacmp.out
# ------------------------------------------# condition
# ------------------------------------------control()
{
if [ $1 -ne 0 ]
then
/usr/bin/echo " ------------ > ${Label} Failed with Return
Code $1"
/usr/bin/echo " *-*-*-*-*-*-*-*-*-*-*-* End ${mmjjyy} $
{hhmmss}*-*-*-*-*-*-*-*-*-*-*-*-*-"
exit 1
else
/usr/bin/echo " ------------ > ${Label} Is OK"
fi
}
mmjjyy=`/usr/bin/date +%m/%d/%y`
hhmmss=`/usr/bin/date +%H:%M:%S`
/usr/bin/echo " *-*-*-*-*-*-*-*-*-*-*-* The begin ${mmjjyy} $
{hhmmss}*-*-*-*-*-*-*-*-*-*-*-*-*-"
# -----------------------------------------# initalisation Varriables
# -----------------------------------------HACMP_OUT=/tmp/hacpm.out
EM_ACC=emuser
ORACLE_DIR=/softs/oracle_em
EM_DIR=/softs/ctm_em
ORASID=oraem
EM_OWNER=emuser
EM_OWPD=em_adm
AGENT_ACC=ctmagem
EMDB_VNAME=iz6em
EMDB_SID=EMIZ6
HOSTNAME=`hostname`
AGENT_DIR=/softs/ctmagem/ctm
# -----------------------------------------Label="Start Oracle Database and listener"
# -----------------------------------------su - $ORASID -c lsnrctl start
su - $ORASID -c sqlplus <<EOF
connect /as sysdba
startup
EOF
rc=$?
control ${rc}
Page 33/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Page 34/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
6.1.3 Stop EM
1
#!/bin/ksh
##################################################################
#
#
script : Stop resources CTM_EM
#
Date : 2007/07/05
#
Version : V2
#
##################################################################
exec >> /tmp/hacmp.out
# ------------------------------------------# condition
# ------------------------------------------control()
{
if [ $1 -ne 0 ]
then
/usr/bin/echo " ------------ > ${Label} Failed with Return
Code $1"
/usr/bin/echo " *-*-*-*-*-*-*-*-*-*-*-* End ${mmjjyy} $
{hhmmss}*-*-*-*-*-*-*-*-*-*-*-*-*-"
exit 1
else
/usr/bin/echo " ------------ > ${Label} Is OK"
fi
}
mmjjyy=`/usr/bin/date +%m/%d/%y`
hhmmss=`/usr/bin/date +%H:%M:%S`
/usr/bin/echo " *-*-*-*-*-*-*-*-*-*-*-* The begin ${mmjjyy} $
{hhmmss}*-*-*-*-*-*"
# -----------------------------------------# initalisation Varriables
# -----------------------------------------EM_ACC=emuser
ORACLE_DIR=/softs/oracle_em
EM_DIR=/softs/ctm_em
ORASID=oraem
EM_OWNER=emuser
AGENT_ACC=ctmagem
EM_OWPD=em_adm
EMDB_VNAME=iz6em
EMDB_SID=EMIZ6
HOSTNAME=`hostname`
PLATFORM=ibm4
AGENT_DIR=/softs/ctmagem/ctm
# -----------------------------------------Label="Stop of the CONTROL-M/EM Configuration Agent and the
CONTROL-M/EM Server components"
# -----------------------------------------su - $EM_ACC -c "$EM_DIR/appl/bin/ecs ctl -U $EM_OWNER -P $EM_OWPD
-C Config_Agent -all -cmd shutdown "
rc=$?
control ${rc}
Page 35/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
Page 36/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
#!/bin/ksh
##################################################################
#
#
stop of CTM_serveur resource
#
07/07/2007 TOOLS TEAM
##################################################################
exec >> /tmp/hacmp.out
control()
{
if [ $1 -ne 0 ]
then
echo " ${Label} Failed with Return Code $1" >> $HACMP_LOG
exit 1
fi
}
mmjjyy=`/usr/bin/date +%m/%d/%y`
hhmmss=`/usr/bin/date +%H:%M:%S`
/usr/bin/echo " *-*-*-*-*-*-*-*-*-*-*-* The begin ${mmjjyy} $
{hhmmss}*-*-*-*-*-*-*-*-*-*-*-*-*-"
#
---------------------------------------------------------------------------# variables
#
---------------------------------------------------------------------------CTM_ACC=controlm
ORACLE_DIR=/softs/oracle_ctm
CTM_DIR=/softs/controlm
ORASID=oractm
CTM_OWNER=controlm
HOSTNAME=`hostname`
AGENT_ACC=ctmagctm
AGENT_DIR=/softs/ctmagctm/ctm
HACMP_LOG=/tmp/hacpm.out
#
---------------------------------------------------------------------------Label="stop of controlm configuration agent "
#
---------------------------------------------------------------------------su - $CTM_ACC -c $CTM_DIR/ctm_server/scripts/shut_ca
rc=$?
control $rc
#
----------------------------------------------------------------------------
Page 37/38
Copyright 2007 BMC Software, Inc.
Admin-CTM
${mmjjyy} ${hhmmss}*-
exit
Page 38/38
Copyright 2007 BMC Software, Inc.