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 – Data is uploaded every 12 hours

2 – Data is uploaded every 24 hours

3 – Data is uploaded once per week

Note

If you set the value to 3, you must also specify a value in the UploadDay key.

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 – Data is uploaded every 12 hours

2 – Data is uploaded every 24 hours

3 – Data is uploaded once per week

Note

If you set the value to 3, you must also set the UploadDay.

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.