the agentparm file: configuring your environment mib file is located >...

The Agentparm File: Configuring Your Environment

Presenter – Bill Sager

Terms of This PresentationThis presentation was based on current information and resource allocations as of October

2009 and is subject to change or withdrawal by CA at any time without notice.

Notwithstanding anything in this presentation to the contrary, this presentation shall not serve

to (i) affect the rights and/or obligations of CA or its licensees under any existing or future

written license agreement or services agreement relating to any CA software product; or (ii)

amend any product documentation or specifications for any CA software product. The

development, release and timing of any features or functionality described in this presentation

remain at CA’s sole discretion. Notwithstanding anything in this presentation to the contrary,

upon the general availability of any future CA product release referenced in this presentation,

CA will make such release available (i) for sale to new licensees of such product; and (ii) to

existing licensees of such product on a when and if-available basis as part of CA maintenance

and support, and in the form of a regularly scheduled major product release. Such releases

may be made available to current licensees of such product who are current subscribers to CA

maintenance and support on a when and if-available basis. In the event of a conflict between

the terms of this paragraph and any other information contained in this presentation, the

terms of this paragraph shall govern.

2

For Informational Purposes Only

Certain information in this presentation may outline CA’s general product direction. All

information in this presentation is for your informational purposes only and may not be

incorporated into any contract. CA assumes no responsibility for the accuracy or completeness

of the information. To the extent permitted by applicable law, CA provides this document “as

is” without warranty of any kind, including without limitation, any implied warranties or

merchantability, fitness for a particular purpose, or non-infringement. In no event will CA be

liable for any loss or damage, direct or indirect, from the use of this document, including,

without limitation, lost profits, lost investment, business interruption, goodwill, or lost data,

even if CA is expressly advised of the possibility of such damages.

3 August 12, 2009 [Enter presentation title in footer] Copyright © 2009 CA

Agentparm.txt

> Install Process

Asks questions to create agentparm.txt

Installs agentparm.txt

Copies in executables and utilities

The agentparm.txt file can be modified


Agentparm.txt


# Log log.level=0 log.maxsize=1024000 log.allow.method=true log.archive=1 # # Agent name # agentname=CAWAR7AGENT communication.alias_1=CAWAR7AGENT_DB # # Communications # communication.managerid_1=CAWA_6500 communication.manageraddress_1=192.168.1.103 communication.managerport_1=6507 communication.monitorobject_1=CAWAR7AGENT/AGENTMON1.0/MAIN communication.inputport=6520 communication.prefixlevel=2 # # Security # security.filename=C:/Program Files/CA/Workload Automation/ESPSystemAgent/security.txt security.cryptkey=0x3132333435363738 security.level=off # # Initiators # There will be separate line for each pair of <class, number of initiators> # initiators.class_N, where N is number running from 1 to ... # Class is user definable, (should be the same here and in AFM) # Soft shutdown mode waits for all jobs to be completed # initiators.class_1=Default,1000 # # Persistence # persistence.gcinterval=10000 persistence.level=2 # # Core parameters # core.health.monitor.enable=true # # General characteristics #

Log Information

> log.level=0

Specifies which logs to create (5 creates more for

debugging)

> log.maxsize=1024000

Can be changed to hold more information

> log.allow.method=true

Allows additional debugging information

> log.archive=1

Keeps current log and previous log. Log.archive=0 retains

all previous logs with time/date stamp


Agent Name and Communication

> agentname=CAWAR7AGENT

Must match what is defined in Manager

> communication.alias_1=CAWAR7AGENT_DB

Can use multiple alias names, define as agent in Manager

> communication.inputport=6520

MUST Match what is in Manager

> communication.prefixlevel=2

Should always be 2 for R7. Turns on encryption


Communication Information

> communication.managerid_1=CM_CAESP

Manager name

> communication.manageraddress_1=TSO21

DNS or IP Address

> communication.managerport_1=9665

Must match what is defined to Manager

> communication.monitorobject_1=AGENT/AGENTMON2.0/

MAIN

Used to help monitor


Security – Adds Local Agent Security

> security.filename=C:/Program Files/CA/Workload

Automation/ESPSystemAgent/security.txt

Where security level information is located

> security.cryptkey=0x3132333435363738

Must match what is in the Manager definition

> security.level=off

Turns local security off or on


General Characteristics

> spooldir=./spool

Change where the STDOUT/STDERR is written to.

> oscomponent.initialworkingdirectory=script|user|path

Default is agent directory

Script is path of script to be run

User is home directory of script owner

> oscomponent.noexitcode=255

Process stays in EXEC status even though has completed


Plugins – What Can This Agent Do?

> plugins.start_internal_1=runner

> plugins.start_internal_2=filemon

> plugins.start_internal_3=objmon

> plugins.start_internal_4=filebrowser

> plugins.start_internal_5=management

> plugins.start_internal_6=ftp

> plugins.start_internal_7=router

> plugins.start_internal_8=database


SNMP Definition

> management.snmp.mibfile=C:/Program

Files/CA/Workload

Automation/ESPSystemAgent/cybermib.txt

Where MIB file is located

> management.snmp.host=localhost

Address of SNMP Manager

> management.snmp.port=162

SNMP Manager port

> management.snmp.community=public

Public or Private


Spool File Cleanup

> runnerplugin.spool.clean.enable=false

Automatically clean up spool files

> runnerplugin.spool.expire=10D

How old do you want the spool file to be to delete

> runnerplugin.spool.sleep=1D

How often do you want to remove spool files


Where to Find Additional Parameters

> ESP_System_Agent_R7.0_Administrators_Guide

> Contains all possible parameters

> Agent needs to be restarted for new parameters

> Used for setting User parmeters

Force profile

Login shell

Check uid

Check valid shell


Some Other Examples

> FTP Information

> How often does the file trigger look for file

> Database Plugin information

> Set environment variables at agent level


the agentparm file: configuring your environment mib file is located >...

Documents