Page tree

The Windows proxy manager enables you to install and manage proxies on the Windows host on which the manager is installed. The Windows proxy manager is installed when you install a proxy. For more information, see Installing Windows proxies.

To run the Windows proxy manager

Select Start > Programs > BMC Software > ADDM Proxy > Proxy Manager.
The Windows proxy manager is displayed with a credential and an Active Directory proxy, as shown in the following illustration.
The main Windows proxy manager showing a credential and an Active Directory proxy.

Managing proxies

You can perform the following proxy management tasks from the Windows proxy manager:

  • Create (install a new proxy service)
  • Edit the port and the user account that the proxy uses
  • Delete (uninstall a proxy service)
  • View the log directory for a proxy
  • Start a selected proxy
  • Stop a selected proxy
  • Restart a selected proxy

These are described in the following table:

Task

Button/Menu

Description

Create a new proxy

Alternate text.
or Proxy > Create menu

Click the Create button, or from the corresponding menu:

  1. Enter the following information on the create proxy dialog:
    Name: A name for the proxy
    Type: Select either Active Directory or Credential.
    Port: Enter a port if you need to use a specfic unused port. Otherwise, choose the port which is automatically populated.
    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 any discovery.
    If you select This account, you must enter the domain and username for the user account that will run the Windows proxy in the domain\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.
  2. To create the new proxy, click OK.
    You are prompted to login to the Create Windows proxy page of the UI with pre-populated proxy details.

    Proxy registration using IPv6

    When registering a proxy with an appliance using IPv6, the proxy IP address that is automatically populated in the Create Windows Proxy page may 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 only been observed in Internet Explorer.

Edit the selected proxy

Alternate text.

  1. Click the Edit button.
    You can edit the following:
    • Port that the proxy uses
    • User account that the proxy runs as
  2. When prompted, confirm the changes by clicking OK.
    Changes in the user account automatically updates the file permissions and restart the proxy service.

Delete the selected proxy

Alternate text.

  1. Click the Delete button.
  2. When prompted, click Yes.

Open Log Directory

Alternate text.

Click the Open Log Directory button. The log directory for the currently selected proxy is displayed in an Explorer window (an example pathname is C:\Program Files\BMC Software\ADDM Proxy\runtime\AD4\log).

Start

Alternate text.

Click the start button. When the proxy starts, a green check icon is displayed next to its name.

Stop

Alternate text.

Click the stop button. When the proxy stops, a red cross icon is displayed next to its name.

Restart

Alternate text.

Click the restart button to stop and start the proxy.

Refresh proxy list

Alternate text.

Click the refresh button to refresh the list. Sometimes the list does not pick up changes in the status of services, so it is good practice to refresh the list before starting or stopping a proxy.

Editing proxy config files is only undertaken through the main user interface

You cannot edit the proxy configuration file as that is better handled centrally from the appliance.

Managing known appliances

You can manage the appliances to which the proxies can register (known appliances) from the Windows proxy manager. By default, the Windows proxy manager displays the appliance from which you have downloaded and installed the Windows proxies as a known appliance.

To manage known appliances, click Edit > Known Appliances. The Known Appliances dialog is displayed which enables you to perform the following tasks:

  • View the known appliances
  • Add new known appliances
  • Edit known appliances
  • Delete known appliances

These are described in the following table:

Task

Description

View the known appliances

The Known Appliances dialog displays the available known appliances.

Add new known appliances

  1. From the Known Appliances dialog, click the Add a new Appliance address button.
  2. Enter the following information on the Add New Appliance dialog:
    • Appliance Name: The name of the new appliance to be added.
    • IP Address: IP address of the new appliance to be added.
  3. To add the new known appliance, click OK.

Edit known appliances

  1. From the Known Appliances dialog, click on the appliance to edit.
  2. Click the Edit the selected Appliance address button.
    You can edit the following:
    • Name of the known appliance
    • IP address of the known appliance
  3. To save the changes, click OK.

Delete known appliances

  1. From the Known Appliances dialog, click on the appliance to delete.
  2. Click the Delete the selected Appliance address button.
  3. When prompted, confirm the action by clicking Yes.

Additional tasks

You can perform the following additional tasks from the Windows proxy manager:

Task

Menu

Description

Refresh Windows proxy list

View > Refresh

Refreshes the Windows proxy list displayed on the Windows proxy manager.

Open the Service Control Manager

View > Service Control Manager

Opens the Service Control Manager (SCM).

View documentation

Help > Documentation

Displays the Windows proxy manager online documentation.

View Windows proxy manager version

Help > About

Displays the version of the Windows proxy manager.

Exit the Windows proxy manager

Proxy > Exit

Exits the Windows proxy manager.

The Windows proxy manager enables you to perform only the tasks listed on this page. You can perform tasks like 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's UI. To learn how to manage the Windows proxies from the appliance's UI, see Managing Windows proxies.

  • No labels