HP Operations Manager for Windows

bbc.ini


NAME

bbc.ini

- configuration file for HTTPS communication.

DESCRIPTION

bbc.ini is the configuration file of a node using HTTPS communication.

It is located in the following directory:

/<OvDataDir>/conf/confpar

The file consists of sections headed by namespaces, which contain the settings for each namespace. The bbc.ini file contains the namespaces listed below. Possible and default settings are described for each namespace.

bbc.cb

Communication-Broker Namespace.

You can use the following parameters:

string CHROOT_PATH = <path>
On UNIX systems only, the chroot path is used by the ovbbccb process. If this parameter is set, the ovbbccb process uses this path as the effective root, thereby restricting access to a limited part of the file system. The default is <OvDataDir>. This parameter is ignored on Microsoft Windows and Sun Solaris 7 systems. For details about chroot, see the chroot man page.

bool SSL_REQUIRED = false
If this parameter is set to true, the communication broker requires SSL authentication for all administration connections to the communication broker. If this parameter is set to false, non-SSL connections are allowed to the communication broker.

bool LOCAL_CONTROL_ONLY = false
If this parameter is set to true, the communication broker allows only local connections to execute administrative commands, such as start and stop.

bool LOG_SERVER_ACCESS = false
If this parameter is set to true, every access to the server is logged, providing information about the sender's IP address, requested HTTP address, requested HTTP method, and response status.

int SERVER_PORT = 383
By default, this port is set to 383. This port is used by the communication broker to listen for requests. If a port is set in the namespace [bbc.cb.ports], it takes precedence over this parameter.

string SERVER_BIND_ADDR = <address>
Bind address for the server port. The default is INADDR_ANY.

bbc.cb.ports

Communication-Broker-Port Namespace. This parameter defines the list of ports for all Communications Brokers in the network that may be contacted by applications on this host. The default port number for all BBC CBs is 383.

You can use the following parameters:

string PORTS
This configuration parameter must be the same on all nodes. To change the port number of a BBC CB on a particular host, you must add the hostname to this parameter (for example, name.hp.com:8000). You can use an asterisk (*) as a wildcard to denote an entire network (for example; *.hp.com:8001). You should use either a comma (,) or a semicolon (;) to separate entries in a list of hostnames.

Example:

name.hp.com:8000, *.hp.com:8001.

In these examples, all hostnames ending in hp.com configure their BBC Communication Broker to use port 8001, except the host name, which uses port 8000. All other hosts use the default port 383.

You can also use IP addresses and the asterisk wildcard (*) to specify hosts.

Example:

15.0.0.1:8002, 15.*.*.*:8003

bbc.http

HTTP Namespace for node-specific configuration. For application-specific settings, see the section bbc.http.ext.*. Note that application-specific settings in bbc.http.ext.* override node-specific settings in bbc.http.

You can use the following parameters:

int SERVER_PORT = 0
By default, this port is set to 0. If set to 0, the operating system assigns the first available port number. This is the port used by the application <app_Name> to listen for requests. Note that it makes sense to explicitly set this parameter only in the bbc.http.ext.<app_Name> namespace, as the parameter is application-specific with any other value than the default value.

string SERVER_BIND_ADDR = <address>
Bind address for the server port. The default is localhost.

string CLIENT_PORT = 0
Bind port for client requests. This may also be a range of ports (for example, 10000-10020). This is the bind port on the originating side of a request. The default is port 0. The operating system assigns the first available port.

Microsoft Windows systems do not immediately release ports for reuse. On Microsoft Windows systems, this parameter should be a large range.

string CLIENT_BIND_ADDR = <address>
Bind address for the client port. The default is INADDR_ANY.

bool LOG_SERVER_ACCESS = false
If this parameter is set to true, every access to the server is logged, providing information about the sender's IP address, requested HTTP address, requested HTTP method, and response status.

string PROXY
Defines which proxy and port to use for a specified hostname.

Format:

proxy:port +(a)-(b);proxy2:port2+(a)-(b); ...;

a
List of hostnames, separated by a comma or a semicolon, for which this proxy is used.

b
List of hostnames, separated by a comma or a semicolon, for which the proxy is not used.

The first matching proxy is chosen.

It is also possible to use IP addresses, instead of hostnames. As a result, 15.*.*.* or 15:*:*:*:*:*:*:* would be valid as well. However, you must specify the correct number of dots or colons. IP version 6 support is not currently available, but will be available in the future.

string DOMAIN
Defines the default DNS domain to use if no domain is specified for a target host. This domain name is appended to hostnames not containing a DNS domain name if a match for the hostname alone cannot be found. This is done for PROXY lookups and lookups in the [cb.ports] table. (For example, if you specify the hostname merlin and DOMAIN ="bbn.hp.com", the [cb.ports] entries are first searched for the match of merlin. If there is no match found for the hostname merlin, a search is made for "merlin.bbn.hp.com", "*.bbn.hp.com", "*.hp.com", "*.com", and "", in that order.

bbc.fx

BBC File-Transfer Namespace for node-specific configuration. For application-specific settings, see the section bbc.fx.ext.*. Note that application-specific settings in bbc.fx.ext.* override node-specific settings in bbc.fx.

You can use the following parameters:

int FX_MAX_RETRIES = 3
Maximum number of retries to be attempted for the successful transfer of the object.

string FX_BASE_DIRECTORY = <directory path>
Base directory for which files may be uploaded or downloaded. The default directory is <OvDataDir>.

string FX_TEMP_DIRECTORY = <directory path>
Temporary directory where uploaded files are placed while the upload is in progress. After the upload completes, the file is moved to <directory path>. The default directory is <OvDataDir>/tmp/bbc/fx.

string FX_UPLOAD_DIRECTORY = <directory path>
Target directory for uploaded files. By default, this is the base directory. You may override the upload target directory with this configuration parameter. The default directory is FX_BASE_DIRECTORY.

bbc.snf

BBC Store-and-Forward Namespace for node-specific configuration. For application-specific settings, see the section bbc.snf.ext.*. Note that application-specific settings in bbc.snf.ext.* override node-specific settings in bbc.snf.

You can use the following parameters:

string BUFFER_PATH = <path>
Specifies the SNF path where the buffered requests are stored.

Default:

<OvDataDir>/datafiles/bbc/snf/<app_Name>

int MAX_FILE_BUFFER_SIZE = 0
Specifies the maximum amount of disk space that the buffer is allowed to consume on the hard disk.

0 = No limit

bbc.http.ext.*

HTTP External-Communication Namespaces:

This is the Dynamic External-Communication Namespace for application-specific settings. Note that application-specific settings in bbc.http.ext.* override node-specific settings in bbc.http.

For a list of the parameters you can use in the bbc.http.ext.* namespace, see the section "bbc.http."

bbc.fx.ext.*

The Dynamic File-Transfer (fx) Namespace for external-component and application-specific settings. Note that application-specific settings in bbc.fx.ext.* override node-specific settings in bbc.fx.

File Transfer External Namespaces:

for a list of the parameters you can use in the bbc.fx.ext.* namespace, wee the section "bbc.fx."

bbc.snf.ext.*

The Dynamic Store-and-Forward (snf) Namespace for external-component and application-specific settings. Note that application-specific settings in bbc.snf.ext.* override node-specific settings in bbc.snf.

Store and Forward External Namespace:

For a list of the parameters you can use in the bbc.snf.ext.* namespace, see the section "bbc.snf."

AUTHOR

bbc.ini was developed by Hewlett-Packard Company.

EXAMPLES

PROXY=web-proxy:8088-(*.hp.com)+(*.a.hp.com;*)

The proxy web-proxy is used with port 8088 for every server, (*) except hosts that match *.hp.com (for example www.hp.com). If the hostname matches *.a.hp.com (for example, merlin.a.hp.com), the proxy server is used.

SEE ALSO

ovbbccb(1), bbcutil(1).

COPYRIGHT

© Copyright 2001-2007 Hewlett-Packard Development Company, L.P.

HP shall not be liable for technical or editorial errors or omissions contained herein.