To configure the broker to accept HTTP and HTTPS connections,
add a connection to the configuration file on the broker.
About this task
Edit the trc_broker.properties file
to configure the connection type and parameters that are required
for enabling the proxy feature on the broker. On a Windows™ computer, this file is in the \Broker directory
within the brokers working directory.
For example, \Documents
and Settings\All Users\Application Data\IBM\Tivoli\Remote Control\Broker.
If
you are using a Windows™ 2008
server, the file is in \ProgramData\IBM\Tivoli\Remote Control\Broker\.
In Linux™ systems, the file
is in the /etc directory. For more information
about broker configuration, see the BigFix® Remote Control Administrator's
Guide.
To configure the connections, complete the following steps:
Procedure
- To configure the broker to accept HTTP connections:
- Add a connection to the configuration file by using
connection type InboundHTTP.
- prefix.ConnectionType
- Defines the type of connection. Must be set to InboundHTTP or InboundHTTP6.
- InboundHTTP
- Listen for HTTP connections that use IPv4 addresses.
- InboundHTTP6
- Listen for HTTP connections that use IPv6 addresses.
-
Set optional keywords. The connection inherits values from the default configuration, except
for PortToListen.
- prefix.PortToListen
- The TCP port to use for listening. Default is 80.
- prefix.BindTo
- Accept incoming connections on the specified address only. Default is the
DefaultBindTo value that is inherited from the default configuration.
- prefix.RetryDelay
- Time between attempts to open the listening port. Default is the
DefaultRetryDelay value that is inherited from the default configuration.
- To configure the broker to accept HTTPS connections:
- Add a connection to the configuration file by using
connection type InboundHTTPS.
- prefix.ConnectionType
- Defines the type of connection. Must be set to InboundHTTPS or InboundHTTPS6.
- InboundHTTPS
- Listen for HTTPS connections that use IPv4 addresses.
- InboundHTTPS6
- Listen for HTTPS connections that use IPv6 addresses.
-
Set optional keywords. The connection inherits values from the default configuration, except
for PortToListen.
- prefix.PortToListen
- The TCP port to use for listening. Default is 443.
- prefix.BindTo
- Accept incoming connections on the specified address only. Default is the
DefaultBindTo or DefaultBindTo6 value that is inherited
from the default configuration.
- prefix.RetryDelay
- Time between attempts to open the listening port. Default is the
DefaultRetryDelay value that is inherited from the default configuration.
- prefix.TLSCertificateFile
- File name and path of the broker's certificate. Default is the
DefaultTLSCertificateFile value that is inherited from the default
configuration.
- prefix.TLSCertificatePassphrase
- Passphrase for the broker's certificate. Default is the
DefaultTLSCertificatePassphrase value that is inherited from the default
configuration.
- prefix.HTTPSCipherList
- List of cipher suites that can be used to secure network connections. Default is the
DefaultHTTPSCipherList value that is inherited from the default
configuration.
Note: For more information about default broker configuration parameters, see the BigFix® Remote Control Administrator's
Guide.