The SOFTWARE\NetIQ\AppManager\4.0\NetIQms (for 32-bit computers) and SOFTWARE\SysWow6432\NetIQ\AppManager\4.0\NetIQms (for 64-bit computers) folders store keys that define characteristics of the NetIQ Corporation AppManager Management Service. These keys are the registry keys that you are most likely to be interested in or need to modify. They control many important characteristics of a management server’s behavior and communication with other components. Several keys are directly under the NetIQms folder. Additional keys are organized in the following subfolders:
NOTE:The Integration folder contains keys used by AppManager connectors.
The NetIQms folder contains general-purpose keys for the NetIQ Corporation AppManager Management Service.
Key |
Description |
---|---|
NetIQmc Port |
Specifies the RPC port that the AppManager Client Resource Monitor service listens on for communication from the management server. The default is 9998 (0x270e). |
Port |
Specifies the RPC port number that the management server listens on for communication from the Client Resource Monitor service. The default is 9999 (0x270f). |
RP database |
Specifies the name of the repository database. Set during installation. For example: QDB |
RP DSN |
Specifies Data Source Name for the ODBC connection to the repository. Set during installation. For example: QDBms |
RP Logon Timeout |
Specifies the maximum period of time, in seconds, that the management server should wait for a successful connection to SQL Server. The management server uses this value to determine whether SQL Server is down when the management server attempts the connection. The default is 600 seconds. |
RP password |
Stores the encrypted password for the management server to use in logging on to the repository. |
RP server |
Stores the name of the computer where the repository is located. |
RP username |
Stores the username the management server uses to connect to the QDB. The default is netiq. |
Unix Port |
Specifies the port number that the UNIX agent uses to communicate with the management server. |
UUID |
Stores a unique identifier for the management server. |
The NetIQms\Admin folder contains keys that are used in management server self‑monitoring.
Key |
Description |
---|---|
AdminEvtSev |
Defines the default AppManager event severity level for management server self‑monitoring events. The default event severity level is 40. |
DisableAdminEvt |
Sets the flag indicating whether an event should be raised if an agent needs to be restarted. |
EnableMachineGrayOut |
Controls the display of computers in the TreeView pane of the Operator Console. If set to 1, computers that are unavailable to the management server are displayed as grayed-out in the TreeView pane of the Operator Console. You cannot start or stop AppManager jobs inactive computers. If set to 0, computers that are unavailable to the management server are not grayed out in the TreeView pane of the Operator Console. The default value is 1. |
General failure Events |
Used internally by management servers for specific error conditions. |
General Success Events |
Used internally by management servers for specific success conditions. |
GenKeyMismatchEvents |
Specifies whether a key mismatch between the agent and the management server should generate an Application Log event. The default value is 1 to generate an event is there is a mismatch in the key information. |
LogOptionalEvt |
Set the flag to enable or disable logging of optional events. The default is 0. |
MinKeyMismatchEventPeriod |
Specifies the number of seconds to wait before logging another Application Log event if a key mismatch is detected. |
The NetIQms\Config folder contains keys that control event and data handling and communication with managed computers.
Key |
Description |
---|---|
Allow Agent Install |
Identifies the management server to use for performing remote agent installation. Set to 1 to all the local management server to be used for remote installation jobs. Set to 0 to prevent a management server from attempting to start installation jobs. The default value is 1. NOTE:If you have more than one management server in your environment, you should select a single management server for performing installation-related tasks and manually set this registry key to 0 on all other management servers. |
Comm Timeout |
Specifies the time in milliseconds for the management server to wait before sending a message to a managed computer if there is an outstanding call. The default is 5000 milliseconds. |
Data Thread |
Specifies the number of data worker threads. Increasing this value increases the number of connections to the database, thereby increasing overhead. The default is 2 threads. |
Enable Flow Control |
Sets the flag that grants control over network traffic to the Client Communication Manager service on the management server. Enabling flow control allows the agent on the management server to use a high watermark, low watermark, and a transfer interval to dynamically adjust the flow of data. Set this key to 0 to disable flow control. Set this key to 1 to enable flow control. The default is 1. |
Event Thread |
Specifies the number of event worker threads. Increasing this value increases the number of connections to the database, thereby increasing overhead. The default is 2 threads. |
Job Dispatch Thread |
Specifies the number of threads the management server creates for dispatching jobs. The default is 5 threads. |
Job Poll Interval |
Sets the interval, in seconds, for the job polling thread to check for outstanding (pending) job requests. The default is 5 seconds. |
Job Resend Frequency |
Specifies the maximum number of synchronization updates to ignore before checking for orphan or error jobs. The default is 1 update. |
Job Status Change Batch |
Determines whether the management server updates the QDB in batches or sequentially. If set to 1, the management server updates the QDB in a single batch when it receives updates from the agent. If set to 0, the management server updates the QDB separately for each job. The default is 0. |
Job Status Change Thread |
Specifies the number of job status change worker threads. Increasing this value increases the number of connections to the database, thereby increasing overhead. The default is 1. |
Job Status Check Interval |
Set the interval, in seconds, for the job status check thread. The job status check thread performs a “job handshake” with each managed computer. The default is 300 seconds. |
Job Status IP Refresh Interval |
Sets the minimum interval, in seconds, before an IP name resolution refresh is performed by the job status check thread. The default is 1000 seconds. |
Machine Poll Interval |
Sets the interval, in seconds, for the machine polling thread.The default is 500 seconds. |
MaxQueueItem |
Sets the maximum size of this request queue for UNIX and Linux communications. When a request comes from a UNIX agent, it is placed in a request queue for processing. Whenever a thread from the thread pool becomes available (idle), it picks up an item in this request queue to process. The default maximum size is 1000 items. |
MaxSocketThread |
Sets the maximum number of threads in the thread pool for processing requests. |
MC Job Abort Event Sev |
Sets the severity level for an event caused by job aborting. The default severity level is 10. |
Number of Update Retry |
Specifies the number of times a management server should attempt an update. The default is 1. |
OptimisticSend |
Instructs the management server to clear out the list of pending requests after responding to the heartbeat from a UNIX agent. |
Orphan Job Event Sev |
Sets the severity level for an event caused orphaned jobs. The default is 5. |
Persistent IOC |
Sets the flag to enable or disable the persistent IOC data and event mapping file. The default is 1. |
Ping Machine Poll Interval |
Sets the interval for the ping machine thread. The default is 5 seconds. |
PIOC Data Map File Size MB |
Defines the size of the persistent IOC file for data. The default is 25 MB. |
PIOC Event Map File Size MB |
Defines the size of the persistent IOC file for event information. The default is 25 MB. |
PIOC JobStat Map File Size MB |
Defines the size of the persistent IOC file for job information. The default is 25 MB. |
PIOC Map File Path |
Specifies the path to where the persistent IOC file is stored. For example: C:\Program Files\NetIQ\AppManager\dat\pioc |
RecordEvents |
Sets the flag that controls how the management server handles events. The valid values for this key are:
The default is 1. |
RPC Encryption |
Specifies whether the management server uses encrypted communication. If set to 1, RPC encryption is enabled. If set to 0, encryption is not enabled. Set during installation. |
SocketRetryInterval |
Defines the retry interval (in milliseconds) for sending or receiving data between a UNIX agent and the management server. If the management server fails to send data to the agent, it will wait for the retry interval and then try again. The default is 500. The number of retry attempts is defined by the MaxSocketRetryCount value, which has a default value of 10. |
StateChangeClassic |
Defines the content of short and detailed event messages for state change events when the Generate a new event when original event condition no longer exists option is selected on the Advanced tab of a Knowledge Script Properties dialog box. When set to 0, the short event message contains “State Change” and the detailed message contains the original message for the event that was closed. When set to 1, the short event message contains the original event ID and the string “State Change” and the detailed message contains the original event ID for the event that was closed. The default is 0. |
Unix Machine Check Interval |
Sets the interval, in seconds, to control how often the management server checks the time of the last heartbeat signal from each of its UNIX agents. Used in conjunction with the Unix Machine Timeout value to determine whether a UNIX or Linux computer is available. If the management server hasn’t received a heartbeat signal within the period specified as the Unix Machine Timeout value, the UNIX agent is considered unavailable. The default is 300 seconds. |
Unix Machine Timeout |
Sets the interval, in seconds, that identifies a UNIX agent as unavailable. If the UNIX agent does not send a heartbeat signal within this period of time, it is considered unavailable. The default is 300 seconds. |
The NetIQms\RP folder contains keys that control connections to the repository.
Key |
Description |
---|---|
RP Connection Refresh Wait |
Sets the interval between the management server’s attempts to reconnect to the repository when SQL Server goes down.The default is 300 seconds. |
RP RPC Shutdown Threshold |
Specifies the number of times the management server tries to connect to SQL Server before shutting down the RPC Server thread when SQL Server goes down. The default is 0. |
Stop Rpc On SQL Failure |
Sets a flag to stop the RPC service when the management server detects that the SQL Server is down. Setting this key to 1 stops the RPC service and 0 turns this feature off. The default is 1. |
The NetIQms\Tracing folder stores keys for tracing the activity of the NetIQ Corporation AppManager Management Service and connections to the repository.
Key |
Description |
---|---|
Action Log |
Sets the flag to enable or disable tracing for management server actions and proxy actions. Set to 1 to enable action debugging for management server actions. Information about action processing errors are written to the msaction.log file. The default is 0 (off). |
NT Event Log Tracing Threshold |
Sets the flag to enable or disable tracing for the Windows event logs. Set to 1 to enable tracing for the Windows logs. The default is 1 (on). |
Qdb Log |
Sets the flag to enable or disable tracing for repository communication errors. Set to 1 to enable repository connection tracing. Errors are written to msqdb.log file. The default is 0 (off). |
Rpc Log |
Sets the flag to enable or disable tracing for RPC. Set to 1 enable tracing for RPC communication between the management server and the agents. The default is 0 (off). |
TraceCache |
Sets the flag to enable or disable tracing for the cache. Set to 1 to enable tracing for the IOC cache processing on the management server. The default is 0 (off). |
TraceData |
Sets the flag to enable or disable tracing for data processing. Set to 1 to enable data point tracing on the management server. The default is 0 (off). |
TraceEvent |
Sets the flag to enable or disable tracing for event processing. Set to 1 to enable event tracing on the management server. The default is 0 (off). |
TraceJob |
Sets the flag to enable or disable tracing for job processing. Set to 1 to enable job tracing on the management server. The default is 0 (off). |
TraceOther |
Sets the flag to enable or disable tracing for other processing. Set to 1 to enable other process tracing. The default is 1 (on). |
TraceQueueSize |
Sets the size of the temporary message queue. The management server writes log messages to a queue, which is cached in memory temporarily. When the queue reaches the size set by this registry key, a background thread is activated to flush the messages from the temporary queue to the log file.The default is 100. |
TraceRepository |
Sets the flag to enable or disable tracing for communication with the repository. Set to 1 to enable tracing. The default is 1 (on). |
TraceRPC |
Sets the flag to enable or disable tracing for RPC communication. Set to 1 to enable RPC tracing between the management server and the repository. The default is 1 (on). |
TraceSockets |
Sets the flag to enable or disable tracing for socket communication. Set to 1 to turn on socket tracing. The default is 0 (off). |
TraceTimeOut |
Sets the interval for activating the background thread that flushes the messages from the temporary queue to the log file. In addition to the TraceQueueSize, this key controls when the background thread should flush messages to the log file.The default is 60 seconds. |
TraceXml |
Sets the flag to enable or disable tracing for XML communication. Set to 1 to turn on XML tracing. The default is 0 (off). |