CA Workload Automation Agent For UNIX, Linux, Or Windows

CA Workload AutomationAgent for UNIX, Linux, orWindowsImplementation Guider11.3, Third Edition

This Documentation, which includes embedded help systems and electronically distributed materials, (hereinafter referred toas the “Documentation”) is for your informational purposes only and is subject to change or withdrawal by CA at any time.This Documentation may not be copied, transferred, reproduced, disclosed, modified or duplicated, in whole or in part, withoutthe prior written consent of CA. This Documentation is confidential and proprietary information of CA and may not be disclosedby you or used for any purpose other than as may be permitted in (i) a separate agreement between you and CA governingyour use of the CA software to which the Documentation relates; or (ii) a separate confidentiality agreement between you andCA.Notwithstanding the foregoing, if you are a licensed user of the software product(s) addressed in the Documentation, you mayprint or otherwise make available a reasonable number of copies of the Documentation for internal use by you and youremployees in connection with that software, provided that all CA copyright notices and legends are affixed to each reproducedcopy.The right to print or otherwise make available copies of the Documentation is limited to the period during which the applicablelicense for such software remains in full force and effect. Should the license terminate for any reason, it is your responsibility tocertify in writing to CA that all copies and partial copies of the Documentation have been returned to CA or destroyed.TO THE EXTENT PERMITTED BY APPLICABLE LAW, CA PROVIDES THIS DOCUMENTATION “AS IS” WITHOUT WARRANTY OF ANYKIND, INCLUDING WITHOUT LIMITATION, ANY IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULARPURPOSE, OR NONINFRINGEMENT. IN NO EVENT WILL CA BE LIABLE TO YOU OR ANY THIRD PARTY FOR ANY LOSS OR DAMAGE,DIRECT OR INDIRECT, FROM THE USE OF THIS DOCUMENTATION, INCLUDING WITHOUT LIMITATION, LOST PROFITS, LOSTINVESTMENT, BUSINESS INTERRUPTION, GOODWILL, OR LOST DATA, EVEN IF CA IS EXPRESSLY ADVISED IN ADVANCE OF THEPOSSIBILITY OF SUCH LOSS OR DAMAGE.The use of any software product referenced in the Documentation is governed by the applicable license agreement and suchlicense agreement is not modified in any way by the terms of this notice.The manufacturer of this Documentation is CA.Provided with “Restricted Rights.” Use, duplication or disclosure by the United States Government is subject to the restrictionsset forth in FAR Sections 12.212, 52.227-14, and 52.227-19(c)(1) - (2) and DFARS Section 252.227-7014(b)(3), as applicable, ortheir successors.Copyright 2013 CA. All rights reserved. All trademarks, trade names, service marks, and logos referenced herein belong totheir respective companies.

CA Technologies Product ReferencesThis document references the following CA Technologies products: CA Process Automation CA Workload Automation AE CA Workload Automation Agent for Application Services (CA WA Agent forApplication Services) CA Workload Automation Agent for Databases (CA WA Agent for Databases) CA Workload Automation Agent for i5/OS (CA WA Agent for i5/OS) CA Workload Automation Agent for Informatica (CA WA Agent for Informatica) CA Workload Automation Agent for Linux (CA WA Agent for Linux) CA Workload Automation Agent for Micro Focus (CA WA Agent for Micro Focus) CA Workload Automation Agent for Microsoft SQL Server (CA WA Agent forMicrosoft SQL Server) CA Workload Automation Agent for Oracle E-Business Suite (CA WA Agent forOracle E-Business Suite) CA Workload Automation Agent for PeopleSoft (CA WA Agent for PeopleSoft) CA Workload Automation Agent for Remote Execution (CA WA Agent for RemoteExecution) CA Workload Automation Agent for SAP (CA WA Agent for SAP) CA Workload Automation Agent for UNIX (CA WA Agent for UNIX) CA Workload Automation Agent for Web Services (CA WA Agent for Web Services) CA Workload Automation Agent for Windows (CA WA Agent for Windows) CA Workload Automation CA 7 Edition CA Workload Automation DE CA Workload Automation Desktop Client (CA WA Desktop Client) CA Workload Automation ESP Edition CA Workload Control Center

Contact CA TechnologiesContact CA SupportFor your convenience, CA Technologies provides one site where you can access theinformation that you need for your Home Office, Small Business, and Enterprise CATechnologies products. At http://ca.com/support, you can access the followingresources: Online and telephone contact information for technical assistance and customerservices Information about user communities and forums Product and documentation downloads CA Support policies and guidelines Other helpful resources appropriate for your productProviding Feedback About Product DocumentationIf you have comments or questions about CA Technologies product documentation, youcan send a message to techpubs@ca.com.To provide feedback about CA Technologies product documentation, complete ourshort customer survey which is available on the CA Support website athttp://ca.com/docs.

ContentsChapter 1: Introduction11Intended Audience . 11Agents and Agent Plug-ins . 11CA WA Agent for UNIX or CA WA Agent for Linux. 12Job Types Supported by CA WA Agent for UNIX or CA WA Agent for Linux . 13CA WA Agent for Windows . 14Job Types Supported by CA WA Agent for Windows . 14How a Scheduling Manager and Agents Communicate . 15Receiver Ports . 16Communication Configuration Example . 17Chapter 2: Implementation Checklist19How to Install and Configure the Agent . 19Collecting Information about the Scheduling Manager . 20Chapter 3: Installing the Agent21Agent Installation Considerations for CA Workload Automation AE . 21Installing Multiple Agents on a Single Computer . 22Agent Installation Options. 22User Account Considerations for UNIX Installations . 29Install the JRE (for AIX and z/Linux) . 29Set the PATH Environment Variable (for AIX and z/Linux) . 29Install the Agent on UNIX Using an Interactive Program . 30Install the Agent on Windows Using an Interactive Program . 31How to Install the Agent Using a Silent Installer . 32Configure the installer.properties File . 33Run the Silent Installer on UNIX . 42Run the Silent Installer on Windows . 42Review the Generated Log File . 42Migrating an R6 or R7 ESP System Agent to R11.3 . 43Convert an Existing agentparm.txt File Using an Interactive Program . 43Convert an Existing agentparm.txt File Using the Silent Installer . 44How to Remove the Agent . 45Uninstall the Agent on UNIX . 45Uninstall the Agent on Windows . 46Contents 5

Chapter 4: Controlling the Agent47Starting the Agent . 47Start the Agent on UNIX . 47Start the Agent on Windows Using the Command Prompt . 48Start the Agent as a Windows Service . 48Set the Agent on Windows to Start Automatically . 49Run the Agent in Windows Console Mode . 49Stopping the Agent. 50Stop the Agent on UNIX . 50Stop the Agent on Windows Using the Command Prompt. 50Stop the Agent as a Windows Service . 51Stop the Agent Running in Windows Console Mode . 51Verifying the Status of the Agent . 51View the status File . 52Check the Agent Process Status on UNIX . 52Check the Agent Status on Windows . 53Chapter 5: Configuring the Agent55How to Configure Agent Parameters . 55Configure Agent Parameters on the Agent . 56Configure Agent Parameters on the Scheduling Manager. 56Agent Parameters in the agentparm.txt File . 57Configure Communication with a Scheduling Manager . 65Configure the Agent for Internet Protocol Version 6 (IPV6) Communication. 68How to Configure SSA Communication with CA Workload Automation AE . 69Install CA Secure Socket Adapter (SSA) on UNIX . 69Install CA Secure Socket Adapter (SSA) on Windows . 71Configure the Agent to Communicate Using an SSA-Enabled Port . 72Define the Agent SSA Port on CA Workload Automation AE . 74Define a Default User ID . 75How to Set Up Environment Variables . 75Defining Environment Variables in a File . 76Specify the Path to the Environment Variables . 77Specify Job Classes and Number of Initiators. 77Configure the Agent to Monitor Available Disk Space . 79How to Set Up Wake On LAN (WOL) . 81Collecting the MAC Address . 81Configure WOL Properties on the Agent. 82Defining a WOL Job . 83Enable Operating System Reporting in the Agent Status . 83Configure the Agent for Windows Interactive Jobs . 846 Implementation Guide

How to Configure the Agent to Run as a Windows Service . 85Register the Agent as a Windows Service . 85Configure the Agent Service to Run Under the Local System Account . 86Configure the Agent Service to Run Under the Local User . 87Set PAM Parameters for User Authentication on UNIX Systems . 88Test User Authentication Settings. 89Force the Default Shell for UNIX Jobs . 90Configure the Agent for Monitoring Jobs. 90Configure the Agent to Run File Triggers as Separate Processes . 91Configure the Agent for auto remote . 92Chapter 6: Configuring the Agent as an SNMP Manager93Configure the Agent as an SNMP Manager . 93Configure the SNMP Trap Listener for SNMP Subscribe Jobs . 94Filter Interpretation for SNMP Subscribe Jobs . 96Chapter 7: Configuring Agent Aliases for Clustered Environments97How to Configure Agent Aliases for Clustered Environments. 97Enable Aliasing on the Agent . 98Enable the Agent Aliasing on the Scheduling Manager . 98Considerations for Alias-Enabled Agents in Clustered Environments. 99Chapter 8: Connecting the Agent to External Applications101Configure the Agent to Connect with a JMX Console . 101Configure the Agent to Connect with an SNMP Manager . 102Configure Connection with a Version 3 SNMP Manager . 104Chapter 9: Setting Up Security105Types of Security . 105How to Set Up Security between the Agent and the Scheduling Manager . 107Security Permissions on the Scheduling Manager . 107Set the Encryption on the Agent Using the Keygen Utility . 108Configure the Agent for No Encryption. 110Set the Encryption Key on the Scheduling Manager . 110Restart the Agent . 111Configure the Agent for Encryption Standard FIPS 140-2 . 111How to Set Up Local Security on the Agent .

Implementation Guide r11.3, Third Edition CA Workload Automation Agent for UNIX, Linux, or Windows