IBM Endpoint Manager, Version 9.1

Setting up a proxy connection on a relay

On the system where the relay is installed, run the following steps to allow the relay to communicate with its parent components:
  1. Open the console and go to Computer section under the All Content domain.
  2. Select the computer where the relay is installed.
  3. Right-click the computer and select Edit Settings.
  4. Select Add to create custom settings.
  5. Enter the Setting Name and Setting Value listed in the following table:
    Table 1. Proxy configuration settings
    Setting Name Setting Value Details
    _Enterprise Server
    _ClientRegister
    _ProxyServer
    Sets the hostname that is used to reach the proxy.

    Default Value: None
    Setting Type: String
    Value Range: N/A
    Mandatory: Yes

    _Enterprise Server
    _ClientRegister
    _ProxyPort
    Sets the port that is used by the proxy server.

    Default Value: None
    Setting Type: String
    Value Range: N/A
    Mandatory: Yes

    _Enterprise Server
    _ClientRegister
    _ProxyUser
    Sets the user name that is used to authenticate with the proxy if the proxy requires authentication.

    Default Value: None
    Setting Type: String
    Value Range: N/A
    Mandatory: No (depending on
             the authentication method)

    _Enterprise Server
    _ClientRegister
    _ProxyPass
    Sets the password that is used to authenticate with the proxy if the proxy requires authentication.

    Default Value: None
    Setting Type: String
    Value Range: N/A
    Mandatory: No (depending on
             the authentication method)

  6. Optionally specify the proxy exception list setting if the relay must communicate to its parent relays without passing through the proxy.
    Table 2. Proxy optional configuration settings
    Setting Name Setting Value Details
    _Enterprise Server
    _ClientRegister
    _ProxyExceptionList
    Specifies the computers, domains and subnetworks that must be reached by the relay without passing through the proxy. Use the following format:
    "hostname1, hostname2, IP_Addr_A, 
    IP_Addr_B, domain_Z, domain_Y, ..."

    Default Value: None (always
           passes through the proxy)
    Setting Type: String
    Value Range: N/A
    Mandatory: No

    For more information about how to specify the proxy exception list, see Setting up a proxy connection on the server.

  7. Click OK to send out the configuration settings, which take effect immediately.

Specify the proxy exception list setting if the relay must communicate to its parent relays without passing through the proxy.

Depending on which platform the relay is installed, add the proxy exception list setting:
On Windows systems:
In the registry in the HKEY_LOCAL_MACHINE\SOFTWARE\BigFix\Enterprise Server\Proxy key.
On Linux systems:
In the besrelay.config file in the [SOFTWARE\BigFix\Enterprise Server\Proxy] section.

The syntax used to specify the proxy exception list is described in Setting up a proxy connection on the server.

Run the following steps if you want to allow your relay to download files through the proxy:
  1. Open the console and go to Computer section under the All Content domain.
  2. Select the computer where the relay is installed.
  3. Right-click the computer and select Edit Settings.
  4. Select Add to create the following custom settings:
    _BESGather_Download_CheckInternetFlag = 1
    _BESGather_Download_CheckParentFlag = 0
  5. Click OK to send the configuration settings, which take effect immediately.
Note: If the relay is installed on a Linux platform, the configuration file in which the settings are stored is called besrelay.config.


Feedback