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
through the rest of this document. $ cd $ tar xvf ctm631.tar x x x x x x x x x x x x x x x x x x x x x x x x x x x x x x $
ctm631, 0 bytes, 0 tape blocks ctm631/Unix, 0 bytes, 0 tape blocks ctm631/Unix/setup.sh, 36474 bytes, 72 tape blocks ctm631/Unix/setup_files, 0 bytes, 0 tape blocks ctm631/Unix/setup_files/agent_aix.tar.Z, 9672638 bytes, 18892 tape blocks ctm631/Unix/setup_files/agent_hp-ux-11.tar.Z, 13098526 bytes, 25584 tape blocks ctm631/Unix/setup_files/agent_hp-ux-ia64.tar.Z, 13255691 bytes, 25891 tape blocks ctm631/Unix/setup_files/agent_irix.tar.Z, 4611592 bytes, 9008 tape blocks ctm631/Unix/setup_files/agent_linux-i386.tar.Z, 9513198 bytes, 18581 tape blocks ctm631/Unix/setup_files/agent_linux-ia64.tar.Z, 10799894 bytes, 21094 tape blocks ctm631/Unix/setup_files/agent_linux-s390.tar.Z, 7528732 bytes, 14705 tape blocks ctm631/Unix/setup_files/agent_linux-x86_64.tar.Z, 9513198 bytes, 18581 tape blocks ctm631/Unix/setup_files/agent_ncr.tar.Z, 8173683 bytes, 15965 tape blocks ctm631/Unix/setup_files/agent_osf1.tar.Z, 12026141 bytes, 23489 tape blocks ctm631/Unix/setup_files/agent_sco_sv.tar.Z, 5682643 bytes, 11099 tape blocks ctm631/Unix/setup_files/agent_solaris-i386.tar.Z, 9735967 bytes, 19016 tape blocks ctm631/Unix/setup_files/agent_solaris.tar.Z, 10801171 bytes, 21097 tape blocks ctm631/Unix/setup_files/ctma_uninstall.sh, 23885 bytes, 47 tape blocks ctm631/Unix/setup_files/eula.txt, 40452 bytes, 80 tape blocks ctm631/Unix/setup_files/helper_functions.sh, 27565 bytes, 54 tape blocks ctm631/Unix/setup_files/install.sh, 54692 bytes, 107 tape blocks ctm631/Unix/setup_files/installed-versions.txt, 268 bytes, 1 tape blocks ctm631/Unix/setup_files/menu.sh, 26828 bytes, 53 tape blocks ctm631/Unix/setup_files/post_inst_conf_funcs.sh, 1372 bytes, 3 tape blocks ctm631/Unix/setup_files/post_install_conf.sh, 5747 bytes, 12 tape blocks ctm631/Unix/setup_files/product.id, 13 bytes, 1 tape blocks ctm631/Unix/setup_files/sharch, 3274 bytes, 7 tape blocks ctm631/Unix/setup_files/version.txt, 146 bytes, 1 tape blocks ctm631/fixpack, 0 bytes, 0 tape blocks 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 /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 /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 == Cancel 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 : == Cancel Previous 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 == Cancel Previous 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 [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: /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 [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) $