How-to: Manage UNIX/Linux WA Agent 11.3 SPx installed from CA Workload Automation Agents DVD, via unisrvcntr/unicntrl commands.

Document ID : KB000045804
Last Modified Date : 14/02/2018
Show Technical Document Details

Introduction:

If you are a CA Workload Automation AE shop, you may have had to install the Unix/Linux Workload Automation System Agent 11.3.x using the independent CA Workload Automation Agents product DVD, instead of the CA WA AutoSys (WAAE) product installer for various reasons, including:

  • Needed a newer version of the System Agent than what is bundled with the WAAE installer.
  • Needed 64bit System Agent (Solaris SPARC, HP IA64 and suchlike) which the WAAE installer does not bundle.
  • Migrating from the legacy (erstwhile Unicenter AutoSys JM) release 11.0 SP5 and need the new System Agent 11.3 SPx alongside the legacy Remote Agent, and the server platform is no longer supported by the latest WAAE  11.3.x release, although the CA WA System Agent is compatible (Example: HP-UX 11i v1/v2, Solaris 9, AIX 5.3 TL07,CentOS 7).

Presently to start/stop the WA System Agent 11.3 service, you execute `cybAgent [-a | -s]` script in the System Agent directory or the run control scripts, and you would prefer to manage it using commands unisrvcntr, unicntrl, unifstat, unicycle, unistart and unishutdown.

Summary:

This document describes the procedure to setup independent CA WA Agent 11.3.x for unicntrl/unifstat commands.

Environment: 

CA Workload Automation AE 11.3.x
CA Workload Automation Agents 11.3.x

Instructions: 

Pre-requisite:

The unisrvcntr, unicntrl, unifstat commands are part of the CA Common Componets 11.2 install.
Example:

# lsm -l -O pif | grep ca-cs-utils
PIF      ca-cs-utils                    11.2.15103.0         Solaris
# lsm -q ca-cs-utils -l | grep uni
lrwxrwxrwx root     root           50 08/20/16 22:27 /opt/CA/SharedComponents/csutils/config/unisrvcntr.cfg -> /opt/CA/SharedComponents/csutils/config/casrvc.cfg
lrwxrwxrwx root     root           43 08/20/16 22:27 /opt/CA/SharedComponents/csutils/bin/unisrvcntr -> /opt/CA/SharedComponents/csutils/bin/casrvc
-r-xr-xr-x root     root         3360 10/13/09 03:40 /opt/CA/SharedComponents/csutils/bin/univer
-r-xr-xr-x root     root         7132 08/08/11 11:50 /opt/CA/SharedComponents/csutils/bin/unistart
-r-xr-xr-x root     root         1590 06/09/05 09:45 /opt/CA/SharedComponents/csutils/bin/unicntrl
-r-xr-xr-x root     root         7975 11/04/09 04:38 /opt/CA/SharedComponents/csutils/bin/unicycle
-r-xr-xr-x root     root         1867 11/04/09 04:37 /opt/CA/SharedComponents/csutils/bin/unifstat
-r-xr-xr-x root     root         7258 08/08/11 11:05 /opt/CA/SharedComponents/csutils/bin/unishutdown
-r-xr-xr-x root     root         3216 11/02/09 12:57 /opt/CA/SharedComponents/csutils/bin/unips
-rw-r--r-- root     root         1889 05/12/05 15:40 /opt/CA/SharedComponents/csutils/config/uniscc.cfg

Therefore, we need the ca-cs-utils package if it is not already installed. If the system already has the legacy AutoSys 11.0 SPx remote agent or client, or any other CA software installed, then the ca-cs-utils is probably already available. Else, quick way to get this package is by installing the CA Secure Socket Adapter minimally from the CA Common Components DVD part of the CA WAAE 11.3.6 SPx download package.

Steps to register the CA WA System Agent 11.3.x service with unisrvcntr command:

Note: In the following examples, the latest CA WA System Agent 11.3 SP5 and CA Common Components 11.2.15103.0 (from CA WAAE 11.3.6 SP4) were used.

Linux:


i) Copy the cybagent-WA_AGENT.init from the System Agent installation path (Ex: /opt/CA/WA_Agent) to the /etc/init.d/ directory (where WA_AGENT is name given to the Agent at install time).

     # cp -p /opt/CA/WA_Agent/cybagent-WA_AGENT.init /etc/init.d/

ii) Execute the following command as root user:

     # casrvc register --copy --StartInit=35 --StopInit=01246 /etc/init.d/cybagent-WA_AGENT.init

iii) Check the Run control scripts:

     # find /etc/rc?.d/ -name "*WA_AGENT*" -exec ls -l '{}' \;
     lrwxrwxrwx. 1 root root 29 Dec 7 2014 /etc/rc0.d/K59cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx. 1 root root 29 Dec 7 2014 /etc/rc1.d/K59cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx. 1 root root 29 Dec 7 2014 /etc/rc2.d/K59cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx. 1 root root 29 Dec 7 2014 /etc/rc3.d/S29cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx. 1 root root 29 Dec 7 2014 /etc/rc4.d/K59cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx. 1 root root 29 Dec 7 2014 /etc/rc5.d/S29cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx. 1 root root 29 Dec 7 2014 /etc/rc6.d/K59cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init

iv) Verify the CA WA System Agent 11.3 SP5 service status report, starting and stopping with unicntrl, unisrvcntr and unifstat commands. The component name will be cybagent-WA_AGENT.init.

# unicntrl stop cybagent-WA_AGENT.init

# unicntrl start cybagent-WA_AGENT.init

# unisrvcntr status cybagent-WA_AGENT.init

Solaris:

1. Copy the cybagent-WA_AGENT.init from the System Agent installation path (Ex: /opt/CA/WA_Agent) to the /etc/init.d/ directory (where WA_AGENT is name given to the Agent at install time).

     # cp -p /opt/CA/WA_Agent/cybagent-WA_AGENT.init /etc/init.d/

2. Execute the following command as root user:

     # casrvc register --copy --StartInit=3 --StopInit=012 /etc/init.d/cybagent-WA_AGENT.init

3. Check the Run control scripts:   

     # find /etc/rc?.d/ -name "*WA_AGENT*" -exec ls -l '{}' \;
     lrwxrwxrwx   1 root     root          32 Aug 21 15:59 /etc/rc0.d/K51cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx   1 root     root          32 Aug 21 15:59 /etc/rc1.d/K51cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx   1 root     root          32 Aug 21 15:59 /etc/rc2.d/K51cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxrwxrwx   1 root     root          32 Aug 21 15:59 /etc/rc3.d/S00cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init

4. Verify the CA WA System Agent 11.3 SP5 service status report, starting and stopping with unicntrl, unisrvcntr and unifstat commands. The component name will be cybagent-WA_AGENT.init.

     # unishutdown cybagent-WA_AGENT.init
     CA-System Agent WA_AGENT stopped.
     Executed cybagent-WA_AGENT.init stop.............................OK
     # unistart cybagent-WA_AGENT.init
     CA-System Agent WA_AGENT started.
     Executed cybagent-WA_AGENT.init start............................OK
     # unifstat
               CA Services Status Report

           Component Name               Pid        Status
------------------------------------  -------  --------------
CA-System Agent WA_AGENT                24899  running

HP-UX:

a. Copy the cybagent-WA_AGENT.init from the System Agent installation path (Ex: /opt/CA/WA_Agent) to the /sbin/init.d/ directory

     # cp -p /opt/CA/WA_Agent/cybagent-WA_AGENT.init /sbin/init.d/

b. Execute the following command to register the Agent with unicntrl, unisrvcntr, unifstat commands:

     # casrvc register --copy --StartInit=3 --StopInit=012 /sbin/init.d/cybagent-WA_AGENT.init

c. Above steps will have created the following run control (RC) script for the WA System Agent to start/stop automatically on server reboot:

     # find /sbin/ -name "*cybagent*" -exec ls -l '{}' \;
     -rwxr-xr-x 1 root sys 4831 Aug 9 00:24 /sbin/init.d/cybagent-WA_AGENT.init
     lrwxr-xr-x 1 root sys 32 Aug 9 00:21 /sbin/rc1.d/K099cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxr-xr-x 1 root sys 32 Aug 9 00:21 /sbin/rc2.d/K099cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxr-xr-x 1 root sys 32 Aug 9 00:21 /sbin/rc0.d/K099cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init
     lrwxr-xr-x 1 root sys 32 Aug 9 00:21 /sbin/rc3.d/S436cybagent-WA_AGENT.init -> ../init.d/cybagent-WA_AGENT.init

d. Execute `unisrvcntr status` to see if the CA WA 11.3 SP5 Agent appears in the status report

# unisrvcntr status

               CA Services Status Report
           Component Name               Pid        Status
------------------------------------  -------  --------------
CA-System Agent WA_AGENT                24088  running
CA-Message Queuing Service               2398  running
CA-UAJM Agent                           27511  running

e. Stop the CA WA 11.3 SP5 Agent via unicntrl or unisrvcntr commands

    # unicntrl stop cybagent-WA_AGENT.init
     CA-System Agent WA_AGENT stopped.
     Executed cybagent-WA_AGENT.init stop.............................OK

f. Start the CA WA 11.3 SP5 Agent via unicntrl or unisrvcntr commands:

     # unicntrl start cybagent-WA_AGENT.init
     CA-System Agent WA_AGENT started.
     Executed cybagent-WA_AGENT.init start............................OK

AIX:

I. Copy the cybagent-WA_AGENT.init from the System Agent installation path (Ex: /opt/CA/WA_Agent) to the /etc/rc.d/ directory (where WA_AGENT is name given to the Agent at install time).

    # cp -p /opt/CA/WA_Agent/cybagent-WA_AGENT.init /etc/rc.d/

II. Execute the following command to register the Agent with unicntrl, unisrvcntr, unifstat commands:

    # casrvc register --copy --StartInit=2 --StopInit=2 /etc/rc.d/cybagent-WA_AGENT.init

III. Verify the CA WA System Agent 11.3 SP5 service status report, starting and stopping with unicntrl, unisrvcntr and unifstat commands.

 

Additional Information:

TEC618920: How-To: Setup and manage CA Workload Automation System Agent via Service Management Facility (SMF) on Oracle Solaris OS 10 and higher.

TEC1824945: Agent Doesn’t Start When Server is Rebooted