In slow or busy network environments, you might encounter timeout exception errors in the communication between the Control Center console and the Control Center repository. You can change certain SQL connection and command/query parameters to better adapt console and repository communication to your environment.
You can edit these parameters in standard .NET XML configuration files:
AMCC.exe.config
AMCC.exe.config controls communication between the Control Center console and the CCDB.
NQCQS.exe.config
NQCQS.exe.config controls communication between the CCDB and the QDBs you are managing with Control Center.
DeploymentService.exe.config
DeploymentService.exe.config controls communication between the Deployment Service and the CCDB.
Before you edit these configuration files, contact Technical Support.
These configuration files are located in the same directory where the associated application or service runs. The default location is C:\Program Files\NetIQ\AppManager\Control Center\bin.
You can change the following parameters in both the NQCQS.exe.config file and the AMCC.exe.config file:
The time to wait (in seconds) before terminating an attempt to establish a connection to an instance of SQL Server and generating an error.
The default value is 15 seconds.
The time to wait (in seconds) before terminating an attempt to execute a command and generating an error.
The default value for NQCQS.exe.config is 600 seconds and for AMCC.exe.config the default value is 90 seconds.
The size (in bytes) of network packets used to communicate with an instance of SQL Server.
The default value is 8192 bytes.
The number of times to retry a connection or command operation if the operation failed.
The default value is 1.
Specifies the maximum size, in bytes, for the log file. If the log file exceeds this threshold, a new log file is created.
Specifies the maximum number of log files. When the maximum number is reached, the oldest log file is overwritten.
The default value is 1.
The path on the command queue service computer for the log file.
The default path is: C:\<install path>\NetIQ\temp\netiq_debug\CC_CQSTrace\CQSLog.txt.
Specifies the level of tracing information you want in the log file. Do not change the trace level unless instructed to do so by Technical Support. After Technical Support has diagnosed the log files, return the tracing level to its original value. These are the available tracing levels:
Off to disable logging for non-Error events.
Error to log program exceptions to the Windows Event Log and the command queue service (NQCQS.exe.config) or AMCC.exe.config log file. All critical messages are always logged to the Windows Event Log. This is the default for NQCQS.exe.config.
Warning to log program recoverable errors to the command queue service (NQCQS.exe.config) or AMCC.exe.config log file. This is the default for AMCC.exe.config.
Info to log program warnings and flow information to the command queue service (NQCQS.exe.config) or AMCC.exe.config log file.
Verbose to log program debug and trace information such as variable values and thread state to the command queue service (NQCQS.exe.config) or AMCC.exe.config log file.
You can change the following additional parameters in the NQCQS.exe.config file:
The name of the CCDB computer.
The name of the CCDB. You must specify the original SQL Server name and not an alias. Otherwise, the command queue service will not be able to connect to the CCDB.
The interval at which AppManager checks the health of the command queue service and the QDB. The default value is 30.
The interval at which the command queue service looks for Knowledge Scripts in the CCDB that need to be re-encrypted in an older security format (prior to version 8.0) for use in older QDBs. The default value is 30
You can change the following parameters in the DeploymentService.exe.config file:
Name and instance of the SQL Server that hosts the CCDB to which the Deployment Service connects
Name of the CCDB to which the Deployment Service connects
Name of the Deployment Web Service computer with which the Deployment Service communicates
The Deployment Service proxy capability is only active when firewalls are present. If firewalls are not present, the value is empty.
NetIQ Corporation does not recommend changing this value.
Location for Web Depot packages
Number of trace log backups stored in the \Program Files\NetIQ\Temp\NetIQ_Debug\CC_ADSTrace folder
For more information about tracing, see the TraceLevel parameter.
The default value is 10.
Maximum file size for the trace log files
When the log files reach this size, AppManager backs up the trace log to the DeploymentServerZ.log file, where Z is an integer from 1 to the NumBackups value.
The default value is 5,000,000 bytes.
Location of the trace logs
The default value is Program Files\NetIQ\Temp\NetIQ_Debug\CC_ADSTrace.
Number of threads that will be available for executing tasks
The threads deliver and install files simultaneously.
The default value is 50 threads.
Level of tracing information in the Deployment Service log files
The default value is Warning, which logs errors and warnings generated during Deployment Service execution.
The following additional values are valid:
Error
Info
Verbose
The default trace level is sufficient for normal testing and use. For troubleshooting, NetIQ Corporation recommends the Info or Verbose settings.
Email address for notifications about the success or failure of deployment tasks
Use the Deployment Rule Wizard in Control Center to configure the email settings. For information about using the Deployment Rule Wizard, see the Control Center User Guide for AppManager, available on the AppManager Documentation page.
In most cases the default settings for these parameters provide optimal performance. Any adjustments you make to these settings will depend upon your environment and the kinds of communication issues you are experiencing.
If you make modifications to the AMCC.exe.config file you must restart the Control Center console for the changes to take effect. If you make modifications to the NQCQS.exe.config file, you must restart the command queue service for the changes to take effect. If you make changes to the DeploymentService.exe.config file, you must restart the Deployment Service for the changes to take effect.
Parameter values you specify in the configuration files override any default values. If a value set in one of these configuration files cannot be parsed into a number, the default value is used. If a value falls outside the allowed range, the closest allowed value is used.
The NQCQS.exe.config file contains additional parameters that you can configure. For more information about these additional parameters, see the Control Center User Guide for AppManager, available on the AppManager Documentation page.