Important This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent 21.3 for BMC Helix Operations Management.

When changes to the configuration take effect


Every operation that changes the configuration of a PATROL Agent also changes the data and index configuration files and the variables in the agent's memory. The new variables take effect immediately. Such changes, however, do not affect variables that must be acted upon at startup.

List of variables that do not require the PATROL Agent to be restarted
  • /AgentSetup/pemCommands_policy
  • /AgentSetup/pemCommands_defaultAccount
  • /AgentSetup/IPAddresses
  • /AgentSetup/cos/maxNumRetries
  • /AgentSetup/cos/retryPeriod
  • /AgentSetup/cos/connectTimeout
  • /AgentSetup/cos/keepAlivePeriod
  • /AgentSetup/cos/messageCacheMaxMessages
  • /AgentSetup/cos/messageCacheTimerInterval
  • /AgentSetup/disabledKMsArch
  • /AgentSetup/prmHistCacheSize
  • /AgentSetup/prmHistCacheFlushTimer
  • /AgentSetup/prmHistCacheFlushIncrement
  • /AgentSetup/historyRetentionPeriod
  • /AgentSetup/preloadedKMs
  • /AgentSetup/pemIssueV30traps
  • /AgentSetup/pemIssueV31traps
  • /AgentSetup/pemIssueNativeLangTraps
  • /AgentSetup/aclGrpCacheExpirationTime
  • /AgentSetup/pemCacheSize
  • /AgentSetup/pemLogSize
  • /AgentSetup/suppressConsoleInfoMsgMask
  • /AgentSetup/staticApplications
  • /AgentSetup/defaultAccountShell
  • /AgentSetup/PerfGetDebugFile
  • /AgentSetup/PerfGetTimeout
  • /AgentSetup/PerfGetMaxTimes
  • /AgentSetup/PerfMaxRestartCount
  • /AgentSetup/comSecurityLevel
  • /AgentSetup/comUserAllowed
  • /AgentSetup/comMsgProcessRate
  • /AgentSetup/auditLog
  • /AgentSetup/executeRecoveryActions
  • /AgentSetup/ExternalOverride
  • /AgentSetup/ExternalOverridePolltime
  • /AgentSetup/maxNumberKmLogFiles
  • /AgentSetup/maxEventSize
  • /AgentSetup/XPC_DEBUG/numBackupLogs
  • /AgentSetup/XPC_DEBUG/debugLogFileSize
  • /AgentSetup/XPC_DEBUG/XPCServerNames
  • /AgentSetup/pconfigRequiresAuthentication
  • /snmp/trapMibTable
  • /snmp/trapConfTable
  • /snmp/masterAgentStartLine
  • /snmp/masterAgentWorkingDir
  • OSdefaultAccount
  • OSdefaultAccountAppliesToCmds
  • xpemPFSnmpEndTime
  • /AgentSetup/disabledKMs

    Note

    The variable /AgentSetup/disabledKMs needs a PATROL Agent restart if you use regular expressions that contains special characters such as .*.

    For example, /AgentSetup/disabledKMs" = {REPLACE="NT.*,CentOS.*"}. For more information, see Disabling-applications-based-on-application-name.

  • /EventSetup/Configuration/EventCells
  • /EventSetup/Configuration/Key
  • /EventSetup/Configuration/Format
  • /EventSetup/Configuration/ForwardEventsToIS
  • EventSetup/Format/BiiP3/catalogs/0/active
  • /EventSetup/Format/BiiP3/catalogs/0/types/11/active
  • /EventSetup/Format/BiiP3/catalogs/0/types/11/KM/AS_EVENTSPRING/active
  • /EventSetup/Format/BiiP3/catalogs/AS_EVENTSPRING/types/NOTIFY_EVENT/active
  • /EventSetup/Format/BiiP3/slots/msg
  • /EventSetup/Format/BiiP3/catalogs/0/types/10/slots/msg
  • /EventSetup/Format/BiiP3/catalogs/0/types/10/KM/AS_EVENTSPRING/slots/msg
  • /EventSetup/Format/BiiP3/catalogs/AS_EVENTSPRING/types/NOTIFY_EVENT
List of variables that require the PATROL Agent to be restarted
  • /AgentSetup/preloadedKMsArch
  • /AgentSetup/defaultAccount
  • /AgentSetup/accessControlList
  • /AgentSetup/accessDenyList
  • /AgentSetup/sessionsInitMayFail
  • /AgentSetup/defaultDisplay
  • /AgentSetup/pemEvMemRetention
  • /AgentSetup/pemLogName
  • /AgentSetup/PslDebug
  • /AgentSetup/SnmpConfigAccess
  • /AgentSetup/MatchShortHostName
  • /AgentSetup/msvcrtMinVer
  • /AgentSetup/hostLookupCacheSize
  • /AgentSetup/EnableSysOutputAclCheck
  • /AgentSetup/maxOutboundRemoteSessions


Warning

Do not use the PATROL console to edit the /AgentSetup/defaultAccount and OSdefaultAccount variables. For more information about default account variables, see Modifying the default account variable.

Where to go from here

Controlling-the-configuration-of-PATROL-Agents

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*