Managing proxies
The BMC Discovery Proxy Manager (Proxy Manager) enables you to install and manage proxies on the Windows host on which the Proxy Manager is installed. This section explains the various tasks that you can perform using the Proxy Manager. For more information about installing proxies, see Installing BMC Discovery Proxy Manager. The Windows Proxy Manager enables you to perform only the tasks listed on this page.
You can perform tasks such as adding a Windows proxy to a pool or configuring advanced proxy settings (for example, configuring the log level, recording mode, discovery methods, purging, and so on) only from the appliance UI. To learn how to manage Windows proxies from the appliance UI, see editing Windows Proxies.
To create a Windows Proxy
- Select Start > Programs > BMC Software > ADDM Proxy > Proxy Manager.
The BMC Discovery Proxy Manager is displayed with a credential and an Active Directory proxy, as shown in the following illustration. - In the BMC Discovery Proxy Manager, click the Create button.
- In the Create proxy dialog, specify the following details:
- Name—The name for the proxy.
- Type—Whether the proxy that you are creating is Active Directory or Credential.
- Port—If you need to use a specific unused port, specify it in this field. Otherwise, skip to
step d
. - Log on as—Select either Local System or This account.
If you select Local System, the Windows proxy will run as the Local System user. An Active Directory Proxy running as a Local System user will not have the necessary domain credentials to perform discovery.
If you select This account, you must enter the domain and username for the user account that will run the Windows proxy in thedomain\username
format, and the corresponding password. - Options—Select the check box to run the proxy immediately after installation.
- Register With—Select the appliance for the proxy to register
Click OK.
You are prompted to log in to the Create Windows Proxy page of the UI with prepopulated proxy details.Note
Proxy registration using IPv6
When registering a Windows Proxy with an appliance using IPv6, the proxy IP address that is automatically populated in the Create Windows Proxy page might be a temporary address. The appliance can communicate while the temporary address is valid, but when no longer valid, communication is not possible. This behavior has been observed in Internet Explorer only.
To edit a Windows Proxy
- Select Start > Programs > BMC Software > ADDM Proxy > Proxy Manager.
The BMC Discovery Proxy Manager is displayed with a credential and an Active Directory proxy. - In the Proxy Manager, click the Edit button.
- Edit the following required fields:
- Port—The port that the proxy uses.
- User account—The user account using which the proxy runs.
When prompted, confirm the changes by clicking OK.
Changes in the user account automatically update the file permissions and restart the proxy service.Editing proxy config files is only undertaken through the main user interface
Do not attempt to edit the proxy configuration file using the Proxy Manager. You must edit the file centrally from the appliance.
Starting or stopping the Windows proxy service
We recommend that you start or stop the Windows proxy service by using the Proxy Manager. However, you can also perform the same task by using the Windows Control Panel. The following section explains how to start or stop the proxy service using the Proxy Manager and Windows Control Panel.
To start or stop using the Proxy Manager
- Select Start > Programs > BMC Software > ADDM Proxy > Proxy Manager.
The BMC Discovery Proxy Manager is displayed with a credential and an Active Directory proxy. - In the Proxy Manager, select the proxy service that you want to start or stop.
- To start a proxy, click the Start button from the submenu.
- To stop a proxy, click the Stop button from the submenu.
- To restart a proxy, click the Restart button from the submenu.
To start or stop using the Windows Control Panel
- Go to Start > Control Panel > Administrative Tools and access the Services list.
The Services panel is refreshed with information and links enabling you to start, restart, or stop the Windows proxy. - Select the Windows proxy service that you want to start or stop.
- To start the Windows proxy, click Start the service.
- To restart the Windows proxy, click Restart the service.
- To stop the Windows proxy, click Stop the service.
To start the Windows proxy automatically
When you create a new proxy from the Windows Proxy Manager, you can configure the proxy service to start automatically.
- Go to Start > Control Panel > Administrative Tools and access the Services list.
The services panel is refreshed with information and links enabling you to start, restart, or stop the Windows proxy. - Select the Windows proxy service that you want to start automatically, and select Properties from the popup menu.
- Select Automatic from the Startup type drop-down list, and click OK.
Specifying additional startup options
After you configure a Windows proxy, you can specify additional startup options, such as purge logs, configuration file location, port options, and so on. You can specify many of these options using the editing Windows Proxy page.
To address specific requirements, you can also enter the startup options described in the table in a registry value. On a 32-bit system, this is:
HKEY_LOCAL_MACHINE\SOFTWARE\BMC Software\Atrium Discovery Proxy\<proxyname>\CommandLine
On a 64 bit system this is:
HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\BMC Software\Atrium Discovery Proxy\
<proxyname>
\CommandLine
Option | Description |
---|---|
| You can configure the Windows proxy to automatically purge its log and record data directories. The default behavior is not to purge. Log and record data directories will be purged. Set via the UI. |
| Only log directories will be purged. Set via the UI. |
| Only record data directories will be purged. Set via the UI. |
| Age above which data is automatically purged. Set in days; the default is seven (weekly). Set via the UI. |
| Frequency at which the automatic purge occurs. Set in hours; the default is 24 (daily). Set via the UI. |
| Size limit (in MB) for the log directories. If this limit is exceeded, the oldest records are deleted. The default behavior is not to specify a limit (zero). |
| Size limit (in MB) for the record data directories. If this limit is exceeded, the oldest data is deleted. The default behavior is not to specify a limit (zero). |
| Enable or disable uploading configuration, overriding the setting specified in the configuration file. |
| Number of backup configuration files to keep. The default is none. If the default is exceeded, the oldest file is deleted. |
| Specify a configuration file to use. |
| Enable or disable OpenPorts, overriding the setting specified in the configuration file. |
| Enable or disable Tcpvcon, overriding the setting specified in the configuration file. |
| The |
| Enable or disable RemQuery, overriding the setting specified in the configuration file. |
| Specify a timeout value (in seconds) for RemQuery calls. The default is 60 seconds. |
| Enable or disable WMI, overriding the setting specified in the configuration file. |
| Specify a timeout value (in seconds) for WMI queries. The default is 120 seconds. |
Testing Windows credentials and communication
You can test the credentials by using it to discover a Windows computer that you know the user can access. From a command prompt on the Windows proxy, use the runas
command to run a Discovery command such as systeminfo
as the Domain user:
C:\> runas /user:DOMAIN\username "systeminfo /S TARGET"
Replace DOMAIN
with the domain name (for example, TIDEWAY); username
with the user name (for example, discovery); and TARGET
with the resolvable hostname or IP address.
Comments
Log in or register to comment.