Skip to Content

Default language.

Editing Windows proxies

You can view and update details about the list of available Windows Proxy pools and the corresponding proxies in each pool. Each proxy pool displays the Windows proxies in rows. For discovery tasks, the Windows proxy pool checks for a Windows proxy. For any proxy that was not previously used to discover endpoints, BMC Discovery attempts to communicate each proxy pool (matching the domain) in the order in which it appears in the UI table.

Related topics

Adding Windows proxies

Upgrading and configuring Windows proxies

If BMC Discovery is able to successfully communicate with a given proxy, that proxy is used. If a communication timed out, other proxies in the pool are attempted. If a communication with a given proxy is unsuccessful due to an error, BMC Discovery attempts communication with the remaining pools in the order in which they appear.

Warning

Note

Reordering of Windows proxies in a Windows proxy pool is not supported, as the proxy used is selected automatically.

To edit a Windows Proxy pool

  1. From the main menu, select Manage > Outposts & Proxies.
    The Outposts tab is displayed by default.
  2. Click the Windows Proxies tab.
    A list of existing Windows proxies is displayed.

    windows_proxy_1.png
  3. Click the Actions list in the corresponding pool and perform one of the following steps as required:
    • To edit a proxy pool, select Manage.
       The Edit Windows Proxy Pool page is displayed. For more information about editing the fields, see additional details for Windows Proxy Pools.
      • Update the proxy pool details as required, and click Apply.
    • To delete a proxy pool, click Delete.
    • To change the order of the Windows Proxy Pools, select the Move to top or Move to bottom option as required.

To edit Windows proxies

  1. From the main menu, select Manage > Outposts & Proxies.
    The Outposts tab is displayed by default.
  2. Click the Windows Proxies tab.
    A list of existing Windows proxies is displayed. 

    windows_proxy_2.png
  3. Click the Actions list and then select Manage for the Windows proxy you want to edit.
    The Manage Windows Credential Proxy page is displayed.

    edit-proxies.png
  4. Update the fields as required, and click Apply or Upload in the corresponding sections of the page.
    For more information about the fields, see additional details for editing Windows proxy.

Additional details for editing Windows Proxy

The following table lists the fields and their descriptions for editing Windows Proxies.

Field Name

Details

General Details—Enables you to update general information regarding a proxy, such as pool, address, port, and so on.

Proxy Pool

The Windows proxy pool for the Windows proxy.
 To change the Windows proxy pool for the Windows proxy, select from the corresponding proxy pool list. The list is populated only with pools that contain the same proxy type.

Proxy Address

The Windows proxy IP address.
To change the current IP address, enter the new IP address in the IP Address field.

Port

The port number associated with the Windows proxy.
 To change the current port number, enter the new port number in the Port field.

Certificate

The contents of the certificate that was generated automatically by the Windows Proxy Manager. To have the appliance automatically retrieve the certificate, leave this field as Not Set.

Enabled

Displays whether the Windows proxy is enabled.
 You can enable or disable the windows proxy by selecting or clearing the check box.

Apply General Details

If you have modified any of the general details and want to apply them, click Apply General Details.

Reset General Details

To reset the current general details, click Reset General Details.

Proxy Settings—Enables you to manage the logging and discovery methods used for the proxy.

Log Level

You can change the log level of the Windows proxy at runtime here in the same way as you can for the service log levels from the main Logging page in BMC Discovery. For more details, see Changing-log-levels-at-runtime.
The Log Level list has the following levels:

  • Debug—Fine-grained informational events that are most useful to debug an application.
  • Info—Informational messages that highlight the progress of the application at coarse-grained level.
  • Warning—Potentially harmful situations.
  • Error—Error events that might still allow the application to continue running.
  • Critical—Severe error events that might cause the application to abort.

Recording Mode

Displays the recording mode of the Windows proxy. The recording mode can be one of the following:

  • Record
  • Playback
  • None

Discovery Methods

Information
Info

If you specify command line options which modify the PowerShell (or WMI, RemQuery) defaults when you run the proxy, those options take precedence over the PowerShell, WMI, or RemQuery settings entered into this page.

  1. Select the required discovery methods for the Windows proxy. 
  2. For each method, select the configuration setting and enter the required value. The available methods and configuration settings are:
    • PowerShell
      • Timeout: Enter the required timeout in seconds. The default is 60 seconds.
      • https port: Enter the required port. The default is 5986.
      • http port: Enter the required port. The default is 5985.
      • JEA: Enter the enter the JEA Endpoint Name. See Discovering Windows hosts by using PowerShell.
    • WMI
      • Timeout: Enter the required timeout in seconds. The default is 60 seconds.
    • RemQuery
      • Timeout: Enter the required timeout in seconds. The default is 60 seconds.
Information
Info

If you disable RemQuery, some discovery information is not available, including network connection details and the contents of files.

Overload Notification

If you select this option, the Windows proxy informs the main Discovery service when it is overloaded (that is, the Windows proxy has a large number of requests in progress). In such a situation, BMC Discovery, if possible, will try another Windows proxy from the same Windows proxy pool. However, if you do not select this option, BMC Discovery will wait for all the requests in progress to finish, which can take a long time if the Windows proxy is overloaded.

Log Directory Disk Usage

Displays the disk usage of the log directory on the Proxy Server.

Record Directory Disk Usage

Displays the disk usage of the record directory on the Proxy Server.

Purge

Enables you to automatically purge stored data for a specific time period for log files and record data.
 A selection list enables you to select the purge date. After you have selected the time period to purge data from the Windows proxy, select the Log Files check box or Record Data check box, or both, and click Apply.
 The selected data is now set to be automatically deleted on the specified duration.
 To immediately purge data, select the data (the Log Files check box or the Record Data check box, or both) to delete, and then click Purge Files Now.

Apply Proxy Settings

If you have modified any of the proxy settings details and want to apply them, click Apply Proxy Settings.

Reset Proxy Settings

To reset the current proxy setting details, click Reset Proxy Settings.

 Proxy Information—Enables you to view the configuration details of the proxy server

Operating System

The name and version of the Windows Operating System.

Processor(s)

Displays the number of processors and the processor type.

Memory

Displays the memory of the appliance and the percentage of memory used.

Disk Free

Available disk space, in MB.

Notes

Based on the proxy version, the OS version on which the proxy runs, and IPv6 capability, one of the following is displayed:

  • Can get IPv6 data and scan IPv6 addresses—The proxy version is 9.0 or later and runs on Windows 2008 or later OS.
  • Can get IPv6 data but Windows version does not support scanning IPv6 addresses—The proxy version is 9.0 or later and runs on a version of the OS earlier than Windows 2008.
  • IPv6 not supported—The proxy version is earlier than 9.0.
  • IPv6 functionality is not enabled until proxies of versions earlier than 9.0 are upgraded to 9.0 or later or are removed.

Proxy Configuration—Enables you to view, download, and apply the Windows proxy configuration data from this section.

Retrieve Current Configuration

  • View winproxy.conf.—Click this option if you want to view the current Windows proxy configuration in XML format.
    The current Windows proxy configuration in the XML format is displayed.
  • (download)—Click this option if you want to download the Windows proxy configuration in XML format.
    You can either choose to open the configuration file with an XML editor or save the file and open it later.

Apply New Configuration

To apply a new Windows proxy configuration file, perform the following steps:

  1. Click Choose File and navigate to the new Windows proxy configuration XML file.
  2. Select the file in the File Upload box and click Open.
  3. Click Upload Proxy Configuration.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

BMC Helix Discovery 26.2 (On-Premises)