The SOFTWARE\NetIQ\AppManager\4.0\NetIQmc (for 32-bit computers) and SOFTWARE\SysWow6432\NetIQ\AppManager\4.0\NetIQmc (for 64-bit computers) folders store keys that define characteristics of the NetIQ Corporation AppManager Client Resource Monitor service and control many aspects of the managed computer’s behavior and communication with other services. There are several keys directly under the NetIQmc folder. Additional keys are organized in the following subfolders:
The NetIQmc folder contains general-purpose keys for the NetIQ Corporation AppManager Client Resource Monitor.
|
Key |
Description |
|---|---|
|
Exchange Mailbox |
Specifies the Exchange mailbox alias name to use if the managed computer can send MAPI mail as an action or if the agent is set to monitor Exchange Server on this computer. Set during installation when you enable MAPI mail as an action or install the Exchange managed object. |
|
Exchange Profile |
Specifies the Exchange profile name to use if the managed computer can send MAPI mail as an action or if the agent is set to monitor Exchange Server on this computer. Set during installation when you enable MAPI mail as an action or install the Exchange managed object. |
|
Exchange Server |
Specifies the Exchange Server name to use if the managed computer can send MAPI mail as an action or if the agent is set to monitor Exchange Server on this computer. Set during installation when you enable MAPI mail as an action or install the Exchange managed object. |
|
Local repository |
Specifies the path to the local repository. Set during installation. For example: C:\Program Files\NetIQ\AppManager\db |
|
MS Backup |
Specifies the management server you have identified as the backup management server for this managed computer. You designate the primary and backup management server by running the SetPrimaryMS Knowledge Script. |
|
MS Primary |
Specifies the management server you have identified as the primary management server for this managed computer. You designate the primary and backup management server by running the SetPrimaryMS Knowledge Script. |
|
NetIQms Port |
Specifies the RPC port number where the management server listens for communication from the NetIQ Corporation AppManager Client Resource Monitor service. The default is 9999 (0x270f). |
|
Port |
Specifies the RPC port where the AppManager Client Resource Monitor service listens for communications from the management server. The default is 9998 (0x270e). |
|
ServiceDependency |
A comma-separated list of services on which the managed computer is dependent. The Client Resource Monitor service checks for the dependent services before starting up. The value is dependent on the managed objects installed. For example, if the managed object for monitoring SQL Server is installed, this key may contain a list similar to this: MSSQLSever,SQLExecutive,msftpsvc |
|
User Domain |
Specifies the domain for a Windows user account if a Windows user account is being used for the agent services to run under. Set during installation if you:
|
|
User Name |
Specifies the username for the Windows user account for the agent services. Set during installation under the same circumstances as the User Domain key. |
|
User Password |
Specifies the password for the Windows user account for the agent services. Set during installation under the same circumstances as the User Domain key. |
The NetIQmc\Admin folder contains keys that are used in agent self‑monitoring.
|
Key |
Description |
|---|---|
|
AdminEvtSev |
Defines the default AppManager event severity level for agent self‑monitoring events. Default event severity is 40. |
|
DisableAdminEvtSev |
Sets the flag to enable or disable the event severity level for agent self‑monitoring events. Default event severity is 0. |
|
DisableJobAbort |
Sets the flag that enables or disables the ability of a script to abort a job. If this key is set to 0, the agent will allow a script to abort a job. If this key is set to 1, the agent will not allow a script to abort a job. Default is 0. |
|
Knowledge Script Failure Events |
Contains internal Knowledge Script abort and exception codes. This is not the same as the event severity value you can set on the Values tab of a Knowledge Script Properties dialog box. |
|
LastMCCheck |
Stores the timestamp of the last self-monitoring check in UTC format (seconds since January 1, 1970, 12:00 am GMT). If the timestamp is older than the MCFreezeThreshold, the NetIQ Corporation AppManager Client Communication Manager attempts to restart the NetIQ Corporation AppManager Client Resource Monitor service. |
The NetIQmc\Config folder contains keys that control agent autonomy, data persistence, event handling, service availability, and failover support.
|
Key |
Description |
|---|---|
|
AppDetectionPollInterval |
The interval at which the agent scans local resources for new software for which there are modules available. This information is provided to the deployment services to install modules according to deployment services rules. |
|
Autonomy |
Sets the flag that enables or disables agent autonomy. If set to 1, the agent runs in Autonomous mode. If set to 0, autonomy is disabled. The default is 1. |
|
AutoUpdateMS |
Sets the flag that allows the managed computer to update its management server information automatically. If set to 1, automatic updates are allowed. If set to 0, the agent is prevented from automatically updating its management server information. If set to 1 and the management server is moved to another computer or the name of the management server computer changes, the managed computer updates its internal information about the management server to reflect the new information. The default is 1 to enable automatic updates. |
|
ConcurrentRptJob |
Specifies the maximum number of concurrent reports that can run on the agent. The default is 3. |
|
Disable64BitPerProvider |
Determines whether AppManager uses both the 32-bit and 64-bit performance providers or uses only the 32-bit performance provider. |
|
EventLogLvl |
Defines the level of the event log messages in the Windows log files. Valid values for this key include: 0x0 - Don't log any event 0x1 - Log Info events 0x2 - Log Warning events 0x4 - Log Error events Values are added together to combine the events logged. For example, 0x5 logs Info and Error events. The default value is 0xF (Log everything). |
|
FullInventoryInterval |
Defines how often (in seconds) the agent sends full software inventory information to Control Center. The default value is 86400 (every 24 hours). |
|
JobSpacingInterval |
Controls how long an agent should pause for each subsequent job to run. This registry key allows you to set a time delay between the jobs to prevent overloading the system. The default delay is 3 seconds. |
|
JobStatusPollInt |
Sets the interval for performing a health check of the communication between the agent and the management server. At each job polling interval, the agent collects data about the list of jobs that are running, the version ID for each job, and the version number of the agent. The version number of the agent is useful information during upgrades. The default interval is 300 seconds. |
|
MonitorInterval |
Defines the monitoring interval (in seconds) to check whether the NetIQccm service is running. If you set an interval, the Client Resource Monitor service automatically attempts to restart the Client Communication Manager service if the service is detected down. To turn off self-monitoring, set this value to 0. The default value is 1800 seconds (30 min). |
|
NoEventSev |
Defines a severity level that does not raise an event. For example, you can set a value for this key to trigger an action when a condition is met but not raise an event in the Operator Console. The default value, 0, disables the key. |
|
NoMSEvent |
Specifies a comma-separated list of management server names that should not receive event information. The managed computer does not send event information to the computers you specify. For example, to restrict the management servers MARS and AJAX from receiving events from the AppManager agent on the local computer: NoMSEvent:REG_SZ:MARS,AJAX By default, no value is set for this key, indicating that no management servers are prevented from receiving event information. |
|
PDH threshold |
Threshold at which legacy performance providers are abandoned for PDH information. |
|
Persistent |
Sets the flag that enables or disables data persistence. If this key is set to 1, persistence is enabled and events and data are written to the local repository when communication with the management server fails. If this key is set to 0, events and data are only transferred to the management server. If communication with the management server is interrupted, any event or data collected during the interruption is lost. The default is 1. |
|
PrimaryMSFailOverCtrlTimes |
Specifies the threshold for the number of times the agent should send ping requests to the primary management server before failing over to the secondary management server. If the ping request fails the number of times specified, the agent identifies the primary management server as unavailable and transfers all events and data to the backup management server, if you have designated one. If you have not designated a secondary management server, events and data are written to the local repository until communication with the primary management server is restored. The default value for this key is 3 ping attempts. |
|
PrimaryMSFailOverInterval |
Specifies the interval in seconds to ping the primary management server. The default is 60 seconds. |
|
StartUpDelay |
Controls how long the agent should pause after the Client Communication manager service starts before starting an iteration of any job on the agent. The default is 15 seconds. |
|
SvcWaitInterval |
Specifies the time, in seconds, for the Client Resource Monitor service to wait before attempting to restart dependent services. The default is 5 seconds. |
|
vbStringSpaceSize |
Specifies the string size, in bytes, allocated for the Summit scripting engine to use. The default value is 1048576 characters (0x100000). |
|
VMRPCNoOfRetry |
Sets the number of retry attempts for making RPC calls from the agent to the management server to send software inventory and application detection data. The default is 3. |
|
VMRPCTimeout |
The time (in seconds) the agent will wait to receive an RPC response from the management server before producing an error. The default is 60. |
The NetIQmc\Security folder contains keys that control the management servers authorized to communicate with the managed computer and the operations that the local managed computer is authorized to perform.
|
Key |
Description |
|---|---|
|
AllowDosCmd |
Specifies the management servers that are allowed to run DOS commands on the local computer. The default value, *, allows all management servers to initiate DOS commands. To create a restricted list of management servers that can run DOS commands, set this key to a comma‑separated list of computer names. For example, if only SHASTA and DYNAMO are allowed to run DOS commands: AllowDosCmd:REG_SZ:shasta,dynamo This registry key value controls whether the General_RunDOS and Action_DosCommand Knowledge Scripts can run commands on this managed computer. NOTE:Checking is based on the management server that initiates the job, not the user account that starts it. For example, if the management server TANGO starts a RunDOS job on SHASTA, but was not included in the key, the job on SHASTA will abort with an error. |
|
AllowMS |
Specifies the list of management servers that can communicate with the Client Resource Monitor. An asterisk (*) authorizes all management servers to communicate with the local computer. NOTE:You should not use this registry key to enforce security or control communication between the management server and the managed computer within a single management site. If you have more than one management server in a site, use the SetPrimaryMS Knowledge Script to identify the primary and secondary management server for each managed computer. Use the Windows and UNIX key file utilities to manage security for the site. |
|
AllowReboot |
Specifies the management servers that can request the local managed computer to reboot. The default value, 0, prevents all management servers from rebooting managed computers. To restrict reboot operations to specific computers, enter a comma-separated list of computer names. For example: AllowReboot:REG_SZ:NYC001,190.12.1.28 You can use the asterisk (*) wild card to permit all management servers to reboot the local managed computer. NOTE:You must specify at least one computer if you want to use the Action_RebootSystem Knowledge Script. |
|
RemoveAllowMSStar |
Indicates whether to remove the anonymous authorization that allows all management servers to communicate with the agent (AllowMS set to *). When set to 1, this key updates the AllowMS key with current information when you change the agent's designated primary or secondary management server. |
The NetIQmc\Tracing folder stores keys for tracing the activity of the NetIQ Corporation AppManager Client Resource Monitor service and managed objects.
|
Key |
Description |
|---|---|
|
TraceKS |
Specifies the tracing level for Knowledge Scripts. The higher the value, the more verbose the tracing output. Specifying 0 turns tracing off. The default is 1 (0x1). Enabling Knowledge Script tracing creates an ASCII copy of the compiled Knowledge Script with debugging line numbers in the TraceLogPath\mc subdirectory and logs entries for each job running on the agent in the mctrace.log file. A separate file is created for each job and action executed on the agent. The name of each file includes the related JobID and the SiteID. |
|
TraceMC |
Specifies the tracing level for the NetIQ Corporation AppManager Client Resource Monitor service. The higher the value, the more verbose the tracing output. Specifying 0 turns tracing off. The default is 1 (0x1). If you enable TraceMC, the NetIQ Corporation AppManager Client Resource Monitor (NetIQmc) records information about its activity in the mctrace.log file. The information recorded in this file includes the status of polling threads, job requests, and job execution. If you also enable TraceKS, the mctrace.log also includes line-by-line trace entries for each job running on the agent to help you step through the Knowledge Script as it is executed to locate a point of failure. |
|
TraceMOcomponent |
Specifies the tracing level for specific application managed objects (for example, use TraceMOactiveds to enable tracing for Active Directory managed objects). The higher the value, the more verbose the tracing output. Specifying a value of zero (0) turns tracing off. The default is 16 (0x10). If you enable tracing for any managed object, the mo.log records information about monitoring activity for that managed object. The information recorded includes all function calls made from the managed object during job execution. |