sbproxy

StreamBase Proxy — starts the StreamBase Proxy server

SYNOPSIS

sbproxy [-f file.sbconf] [proxy-version] proxy-port sbd-hostname sbd-port

DESCRIPTION

Run the StreamBase proxy server separately from the sbd server to provide authentication services using TLS/SSL or LDAP for StreamBase clients attempting to access StreamBase Server. The server is configured to require a secure connection using settings in the <security> section of the server's configuration file. This subject is discussed in Using the Proxy Server in the StreamBase Administration Guide.

To use TLS/SSL with client certificates, you must configure keystores for certificates on both client and server machines. For details and instructions see SSL Authentication.

In previous releases, the proxy server was also used to translate the network protocol for client programs built with older StreamBase releases connecting to newer StreamBase Servers. However, the protocol proxying aspect of sbproxy is now incorporated into the sbd server. You no longer need to run the proxy server to translate between StreamBase clients and servers of different releases.

The StreamBase proxy server supports both enqueuing and dequeuing remote clients. It is a pass-through server, and exchanges data between client and server without other processing.

OPTIONS

-f file.sbconf

The server configuration file where you have defined the <security> element to enable sbproxy security.

-Jjvm-option

Specifies a system property setting or other JVM argument to be passed to the JVM that runs this sbproxy command. Use this option to specify temporary settings that affect only the current invocation of sbproxy. You must specify multiple -J options to specify multiple JVM arguments.

There must be no space after the -J. For example, specify -J-Xmx2G. Use the full option syntax for jvm-option that you would use at the Java command line, including the initial hyphen. For example, specify -J-Dstreambase.log-level=2 to increase the log level for this invocation of sbproxy.

Your jvm-option argument might require surrounding quotes, depending on the characters it contains and the shell you are using. However, do not use quotes to escape the spaces between separate JVM arguments; instead use separate -J options. For example: -J-Xms512M -J-Xmx2G

ARGUMENTS

proxy-version

The StreamBase version that the client application was created with. The sbd server now automatically supports older protocols, so this option is no longer required. It will be removed in a future release of StreamBase.

proxy-port

The port number to be used by the sbproxy server instance you are running.

sbd-hostname

The remote host on which the sbd server runs.

sbd-port

The port number used by the sbd server.

Example

The following command starts sbproxy and forces the associated sbd server to communicate with clients only through sbproxy on the local host:

sbproxy -f sbd.sbconf 9999 localhost 10000