Prereqs For Installing Control-M Agent for Unix/Linux

• Make group for controlm

• Add the user controlm with the comment “Control-M PsuedoUser”
• Add the user ctmagent with the comment “Control-M Agent PsuedoUser”
and make the home directory /opt/ctmagent.
• Change /opt/ctmagent to have the owner as ctmagent and group controlm
• Set permissions for /opt/ctmagent to 775
Installation instructions for Control-M Agent 6.3.1 for Unix/Linux
1. Copy and expand ctm631.tar file to an "install directory". This path with be referred to as
<instdir> through the rest of this document.
$ cd <instdir>
$ tar xvf ctm631.tar
x ctm631, 0 bytes, 0 tape blocks
x ctm631/Unix, 0 bytes, 0 tape blocks
x ctm631/Unix/setup.sh, 36474 bytes, 72 tape blocks
x ctm631/Unix/setup_files, 0 bytes, 0 tape blocks
x ctm631/Unix/setup_files/agent_aix.tar.Z, 9672638 bytes, 18892 tape blocks
x ctm631/Unix/setup_files/agent_hp-ux-11.tar.Z, 13098526 bytes, 25584 tape blocks
x ctm631/Unix/setup_files/agent_hp-ux-ia64.tar.Z, 13255691 bytes, 25891 tape blocks
x ctm631/Unix/setup_files/agent_irix.tar.Z, 4611592 bytes, 9008 tape blocks
x ctm631/Unix/setup_files/agent_linux-i386.tar.Z, 9513198 bytes, 18581 tape blocks
x ctm631/Unix/setup_files/agent_linux-ia64.tar.Z, 10799894 bytes, 21094 tape blocks
x ctm631/Unix/setup_files/agent_linux-s390.tar.Z, 7528732 bytes, 14705 tape blocks
x ctm631/Unix/setup_files/agent_linux-x86_64.tar.Z, 9513198 bytes, 18581 tape blocks
x ctm631/Unix/setup_files/agent_ncr.tar.Z, 8173683 bytes, 15965 tape blocks
x ctm631/Unix/setup_files/agent_osf1.tar.Z, 12026141 bytes, 23489 tape blocks
x ctm631/Unix/setup_files/agent_sco_sv.tar.Z, 5682643 bytes, 11099 tape blocks
x ctm631/Unix/setup_files/agent_solaris-i386.tar.Z, 9735967 bytes, 19016 tape blocks
x ctm631/Unix/setup_files/agent_solaris.tar.Z, 10801171 bytes, 21097 tape blocks
x ctm631/Unix/setup_files/ctma_uninstall.sh, 23885 bytes, 47 tape blocks
x ctm631/Unix/setup_files/eula.txt, 40452 bytes, 80 tape blocks
x ctm631/Unix/setup_files/helper_functions.sh, 27565 bytes, 54 tape blocks
x ctm631/Unix/setup_files/install.sh, 54692 bytes, 107 tape blocks
x ctm631/Unix/setup_files/installed-versions.txt, 268 bytes, 1 tape blocks
x ctm631/Unix/setup_files/menu.sh, 26828 bytes, 53 tape blocks
x ctm631/Unix/setup_files/post_inst_conf_funcs.sh, 1372 bytes, 3 tape blocks
x ctm631/Unix/setup_files/post_install_conf.sh, 5747 bytes, 12 tape blocks
x ctm631/Unix/setup_files/product.id, 13 bytes, 1 tape blocks
x ctm631/Unix/setup_files/sharch, 3274 bytes, 7 tape blocks
x ctm631/Unix/setup_files/version.txt, 146 bytes, 1 tape blocks
x ctm631/fixpack, 0 bytes, 0 tape blocks
x ctm631/fixpack/PAKAI.6.3.01.300.INSTALL_BIN, 61254961 bytes, 119639 tape blocks
$

2. The tar file expands to the ctm631 directory and two sub-directories; one for the installation
binaries and another containing the most current Fix Pack:
$ ls -l <instdir>/ctm631
total 4
drwxr-xr-x 3 rgibbons users 512 Jan 16 2008 Unix
drwxr-xr-x 2 rgibbons users 512 Apr 22 17:26 fixpack
iadehr01%

3. Begin the installation by making the ctmagent home directory your “current” directory:
$ cd /opt/ctmagent

4. Now as either ROOT or a privileged user, execute the installation binary:

$ sudo <instdir>/ctm631/Unix/setup.sh
5. The first thing that appears is the License Agreement screen. Continue to press the
<SPACE> bar on you keyboard until the “agree to the terms” question appears:
=== Installation of CONTROL-M/Agent version 6.3.01 ===
END USER LICENSE AGREEMENT
BY OPENING THE PACKAGE, INSTALLING, PRESSING "AGREE" OR "YES" OR USING THE PRODUCT, THE
ENTITY OR
INDIVIDUAL ENTERING INTO THIS AGREEMENT AGREES TO BE BOUND BY THE FOLLOWING TERMS. IF YOU
DO NOT
AGREE WITH ANY OF THESE TERMS, DO NOT INSTALL OR USE THE PRODUCT, PROMPTLY RETURN THE
PRODUCT TO
BMC OR YOUR BMC RESELLER, AND IF YOU ACQUIRED THE LICENSE WITHIN 15 DAYS OF THE DATE OF
YOUR ORDER
CONTACT BMC OR YOUR BMC RESELLER FOR A REFUND OF LICENSE FEES PAID. IF YOU REJECT THIS
AGREEMENT,
YOU WILL NOT ACQUIRE ANY LICENSE TO USE THE PRODUCT.
This Agreement ("Agreement") is between the entity or individual entering into this
Agreement ("Customer") and the BMC Entity for
the applicable Territory as described in Section 19 ("BMC"). In addition to the
restrictions imposed under this Agreement, any other
usage restrictions contained in the Product installation instructions or release notes
shall apply to your use of the Product.
***
--More--
***
YOU AGREE THAT YOU HAVE READ THIS AGREEMENT AND INTEND TO BE BOUND, AS IF YOU HAD SIGNED
THIS
AGREEMENT IN WRITING. IF YOU ARE ACTING ON BEHALF OF AN ENTITY, YOU WARRANT THAT YOU HAVE
THE
AUTHORITY TO ACCEPT THE TERMS OF THIS AGREEMENT FOR SUCH ENTITY.
EULA .doc (v05.16.06)
Do you accept and agree to the terms of this Software License Agreement (Y/N)?

6. Type “y” then press <Enter> to accept the License Agreement.

7. The main installation screen will appear next. Select “2” for the “Custom Installation”
CONTROL-M/Agent New Installation - Installation Mode
------------------------------------------------------
Current selection: [ Default installation ]
1). Default installation
2). Custom installation
== <C> Cancel <N> Next ==
Enter command or item number you wish to change:

8. Item numbers 3 & 4 MUST be specified as 7510 & 7511 respectively. Items 1 & 2 are
determined by the Control-M Administrator. Leave 5 blank. Once your updates are
complete, type “n” to go to the next screen.
CONTROL-M/Agent Installation - Configuration Customization
------------------------------------------------------------
1). Primary CONTROL-M/Server Host : densun4
2). Authorized CONTROL-M/Server Hosts : densun4|escbmc.svc.doi.test
(For example: host1|host2|...)
3). Agent-to-Server Port Number : 7510
4). Server-to-Agent Port Number : 7511
5). Locale :
== <C> Cancel <P> Previous <N> Next ==
Enter command or item number you wish to change:
9. Verify the information is correct on the “Summary” screen. If you need to make changes,
type “p” to go to the previous screen, otherwise, type “I” to continue.
CONTROL-M/Agent Installation - Summary
----------------------------------------
Installation type: New installation
Installation mode: Custom installation
CONTROL-M/Agent UNIX user: ctmagent
CONTROL-M/Agent install directory: /opt/ctmagent
Primary CONTROL-M/Server Host: densun4
Authorized CONTROL-M/Server Hosts: densun4|escbmc.svc.doi.test
Agent-to-Server Port Number: 7510
Server-to-Agent Port Number: 7511
== <C> Cancel <P> Previous <I> Install ==
Enter command:

10. Enter “y” when asked if you want to install:

Enter command: i
Do you want to install (Y/N)?

11. You should then see a series of status messages, which should end with “completed
successfully”
Extract CONTROL-M/Agent.
Extract CONTROL-M/Agent [100%].
Configure CONTROL-M/Agent.
Configure CONTROL-M/Agent [100%].
Activate CONTROL-M/Agent.
Activate CONTROL-M/Agent [100%].
Installation of CONTROL-M/Agent completed successfully.
[rgibbons@denof12 ctmagent]$

12. Check to make sure that the agent and tracker processes have started:
$ ps -ef | grep ctm
root 17299 1 0 15:42 pts/0 00:00:00 p_ctmag
root 17391 1 0 15:42 pts/0 00:00:00 p_ctmat
rgibbons 17467 15369 0 15:43 pts/0 00:00:00 grep ctm
$

13. As root/privileged user, (with /opt/ctmagent as the current directory), shut-down for the
Control-M agent. This is the first step in applying the fixpack.
$ sudo ./ctm/scripts/shut-ag
Enter CONTROL-M/Agent UNIX username [ctmagent]:
Enter CONTROL-M/Agent Process Name <AG|AT|AR|ALL> [ALL]:
Killing Control-M/Agent Listener pid:17299
Killing Control-M/Agent Tracker pid:17391
$

14. Switch to the ctmagent id:

$ sudo su – ctmagent

15. As ctmagent, run the fixpack:

<instdir>/ctm631/fixpack/PAKAI.6.3.01.300.INSTALL_BIN

16. The following will be displayed, type “y” to continue.

Installing Fix Pack PAKAI.6.3.01.300 for CONTROL-M/Agent Version 6.3.01
Unix User: ctmagent
CONTROL-M/Agent installation directory: /opt/ctmagent/ctm
Platform: Linux
Installation will install the following updates:
1) CONTROL-M/Agent - PAKAI.6.3.01.100 updates
2) CONTROL-M/Agent - PAKAI.6.3.01.200 updates
3) CONTROL-M/Agent - PAKAI.6.3.01.300 updates
Do you wish to continue? (y/n) [default n]:
17. The next series of messages should display, ending with the fix pack saying that it was a
success.
Extracting files...
Backup installed files into /opt/ctmagent/ctm/patches/PAKAI.6.3.01.300/BACKUP_ORIG
directory
Processing, please wait...
CONTROL-M/Agent Fix Pack PAKAI.6.3.01.300 was successfully installed.
*******************************************************************
$

18. Switch back to ROOT/Privileged user, cd to the ctmagent home, and restart the Control-M
Agent:
$ cd /opt/ctmagent
$ sudo ./ctm/scripts/start-ag
Enter CONTROL-M/Agent UNIX username [ctmagent]:
Enter CONTROL-M/Agent Process Name <AG|AT|AR|ALL> [ALL]:
Control-M/Agent Listener started. pid: 19022
Control-M/Agent Tracker started. pid: 19119
Control-M/Agent started successfully.
$

19. The last step is to switch to ctmagent and run the communications diagnostics program.
Your results should be similar to below:
$ sudo su - ctmagent
$ ag_diag_comm
This procedure runs for about 30 seconds. Please wait
CONTROL-M/Agent Communication Diagnostic Report
-----------------------------------------------
Agent User Name : ctmagent
Agent Directory : /opt/ctmagent/ctm
Agent Platform Architecture : Solaris-sparcv9
Agent Version : 6.3.01.300
Agent Host Name : iadehr01
Logical Agent Name : iadehr01
Server Host Name : densun4
Authorized Servers Host Names : densun4 escbmc.svc.doi.test
Server-to-Agent Port Number : 7511
Agent-to-Server Port Number : 7510
Server-Agent Protocol Version : 07
Server-Agent Comm. Protocol : TCP
Server-Agent Connection mode : Transient
Unix Ping to Server Platform : Succeeded
Agent Ping to Control-M/Server : Succeeded
Agent processes status
======================
Agent Router : Not running
Agent Listener : Running (8243)
Agent Tracker : Running (8313)
$