Setting up a proxy connection on a relay

Complete the following steps to allow the relay to communicate with its parent components.

  1. Open the console and go to the 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 for server and relays
    Setting Name Setting Value Details
    _Enterprise Server
    _ClientRegister
    _ProxyServer
    Sets the hostname that is used to reach the proxy.

    Default Value: None
    Type: String
    Value Range: N/A
    Mandatory: No

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

    Default Value: None
    Type: Numeric
    Value Range: N/A
    Mandatory: No

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

    Default Value: None
    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
    Type: String
    Value Range: N/A
    Mandatory: No (depending
    on the authentication
    method)

    _Enterprise Server
    _ClientRegister
    _ProxySecureTunnel
    If set, it defines whether or not the proxy is enforced to attempt tunneling. By default the proxy does not attempt tunneling.

    Default Value: false
    Type: Boolean
    Value Range: 0 | 1
    Mandatory: No

    _Enterprise Server
    _ClientRegister
    _ProxyAuthMethods
    Allowed
    Restricts the set of authentication methods that can be used. You can specify more than one value separated by a comma. For information about restrictions affecting the supported authentication methods when using FIPS, see Setting a proxy connection on the server.

    Default Value: None (Any)
    Type: String
    Value Range: basic|digest|
    negotiate|ntlm
    Mandatory: No

    _Enterprise Server
    _ClientRegister
    _ProxyUseFor
    DownstreamComm
    If set to 1, this setting indicates that all downstream communications in your environment pass through the proxy.

    Default Value: 0
    Type: Numeric
    Value Range: 0 | 1
    Mandatory: No

    _Enterprise Server
    _ClientRegister
    _ProxyExceptionList
    Specifies the computers, for example the parent relay, domains and subnetworks that must be reached by the relay without passing through the proxy. Use the following format:
    "localhost, 127.0.0.1, hostname1, 
    hostname2, IP_Addr_A, IP_Addr_B, 
    domain_Z, domain_Y, ..."
    By default internal communications are not diverted towards the proxy. To maintain this behavior, ensure that you include localhost, 127.0.0.1 in the list of exceptions when specifying a value for this setting.
    Note: Ensure that you read Setting up a proxy connection to learn more about using the proxy exception list on a relay thru the samples.

    Default Value: localhost,
    127.0.0.1
    (internal communications
    are not diverted towards
    the proxy)
    Type: String
    Value Range: N/A
    Mandatory:  No

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

  6. Click OK to send activate the configuration settings.
Note: If a HTTP proxy exists between the relay and a client or a child relay, ensure that you follow the instructions provided in Enabling client polling to enable downstream communications.
Complete these additional steps if you want to allow your relay to download files from the internet through the proxy:
  1. Open the console and go to the 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 activate the configuration settings.
For additional configuration settings that you can use to configure your BigFix environment, see List of settings and detailed descriptions.