Use Registry Keys to Configure System Center Advisor
You can use registry keys to control most configuration settings for the gateway and agent. By changing the various registry keys, you can customize the frequency of data uploads (between the agent and the gateway, and between the gateway and the service), the size and location of mailbox shares on both the gateway and agent, and the archival period for content. The following sections describe the configuration settings that you can change for the gateway and agent, including setting the proxy configuration for the gateway through the config.xml file.
Configuring the gateway
The following table lists the registry keys and default values for the gateway’s configuration settings. The registry keys for the gateway are stored in HKEY_LOCAL_MACHINE\Software\Microsoft\SystemCenterAdvisor\Gateway.
After you change any of the registry keys, you will need to restart the gateway service. To restart the gateway service, in the Services console, right-click System Center Advisor Gateway, and then click Restart.
| Setting Name | Type | Description | Default Value |
|---|---|---|---|
UploadFrequency |
REG_DWORD |
Defines how frequently the gateway uploads data to the service. Use one of the following values:
|
1 |
UploadDay |
REG_DWORD |
Defines the day of the week to upload data to the service. The day of the week is represented by a number, where 1 is Monday and 7 is Sunday. > [!NOTE] > Use this setting only when the UploadFrequency key is set to 3. > |
1 |
UploadTimeHour |
REG_DWORD |
Defines the hour of the day to upload data to the service. Use a number between 0 and 23 to specify the hour. |
A random number between 2 and 6 |
UploadTimeMin |
REG_DWORD |
With the UploadTimeHour setting, defines the minute to upload data to the service. Use a number between 0 and 59. |
A random number between 0 and 59. |
PollingFreq |
REG_DWORD |
Defines the frequency, in minutes, that the gateway uses to check for new agents and for the size of the mailbox. |
15 minutes |
MaxMailboxSizePerAgent |
REG_DWORD |
Defines the maximum size, in megabytes (MB), for the mailbox per agent. If this size is exceeded, the oldest content is deleted. |
1024 MB |
ArchivePeriod |
REG_DWORD |
Defines the number of days Advisor retains data in the sent items folder after the data is uploaded. |
5 |
MaxLogSize |
REG_DWORD |
Defines the maximum size, in MB, for the log file. Specify a number greater than 10. (By default, a lower number indicates that logging should not occur, because an individual log file can be 10 MB.) |
100 |
BlockUpload |
REG_DWORD |
Indicates whether to upload content to the service. If this registry setting is present, content is not uploaded. |
Not applicable |
LogLevel |
REG_DWORD |
Defines the level of logging for the gateway. |
3 |
Configuring the agent
The following table lists the registry keys and default values for the agent’s configuration settings. The registry keys for the agent are stored in HKEY_LOCAL_MACHINE \Software\Microsoft\SystemCenterAdvisor\Agent.
After you change any of the registry keys, you will need to restart the agent. To restart the agent, in the Services console, right-click System Center Management, and then click Restart.
| Setting Name | Type | Description | Default Value |
|---|---|---|---|
GatewayServer |
REG_SZ |
Defines the gateway server for this agent. |
Not applicable. This value is supplied during agent installation. |
UploadFrequency |
REG_DWORD |
Defines how frequently the agent uploads data to the gateway. Use one of the following values:
|
1 |
UploadDay |
REG_DWORD |
Defines the day of the week to upload data to the gateway. The day of the week is represented by a number, where 1 is Monday and 7 is Sunday. > [!NOTE] > Use this setting only when the UploadFrequency key is set to 3. > |
1 |
UploadTimeHour |
REG_DWORD |
Defines the hour of the day to upload data to the service. The Use a number between 0 and 23 to specify the hour. |
A random number between 0 and 1. |
UploadTimeMin |
REG_DWORD |
With the UploadTimeHour setting, defines the minute to upload data to the service. Use a number between 0 and 59. |
A random number between 0 and 59. |
MaxCacheSize |
REG_DWORD |
Defines the maximum size, in MB, for the cache folder on the agent. This folder contains data collected from the health service that has not yet been packaged and sent to the gateway. |
1024 MB |
MaxMailboxSize |
REG_DWORD |
Defines the maximum size, in MB, for the mailbox on the agent. If this size is exceeded, the oldest content is deleted. |
1024 MB |
ArchivePeriod |
REG_DWORD |
Defines the number of days Advisor retains data in the sent items folder after the data is uploaded. |
0 |
MaxLogSize |
REG_DWORD |
Defines the maximum size, in MB, for the log file. Specify a number greater than 10 (By default, a lower number indicates that logging should not occur, because an individual log file can be 10 MB). |
100 |
BlockUpload |
REG_DWORD |
Indicates whether to upload content to the gateway. If this registry setting is present, content is not uploaded. |
Not applicable |
LogLevel |
REG_DWORD |
Defines the level of logging for the agent. |
3 |