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>
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
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
true
, the
communication broker allows only local connections to execute
administrative commands, such as start
and
stop
.
bool LOG_SERVER_ACCESS = false
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
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>
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
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
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>
localhost
.
string CLIENT_PORT
= 010000-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>
INADDR_ANY
.
bool LOG_SERVER_ACCESS = false
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
Format:
proxy:port +(a)-(b);proxy2:port2+(a)-(b); ...;
a
b
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
[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
string FX_BASE_DIRECTORY
= <directory
path>
<
OvDataDir
>
.
string FX_TEMP_DIRECTORY =
<directory
path>
<directory path>
. The default
directory is
<
OvDataDir
>/tmp/bbc/fx
.
string FX_UPLOAD_DIRECTORY =
<directory path>
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>
Default:
<OvDataDir>
/datafiles/bbc/snf/
<app_Name>
int MAX_FILE_BUFFER_SIZE = 0
0
= No limit
bbc.http.ext.*
HTTP External-Communication Namespaces:
bbc.http.ext.
<compID>
.
<app_Name>
bbc.http.ext.
<app_Name>
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:
bbc.fx.ext.
<compID>
.
<app_Name>
bbc.fx.ext.
<app_Name>
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:
bbc.snf.ext.
<compID>
.
<app_Name>
bbc.snf.ext.
<app_Name>
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
COPYRIGHT
© Copyright 2001-2007 Hewlett-Packard Development Company, L.P.
HP shall not be liable for technical or editorial errors or omissions contained herein.