StreamBase Proxy — starts the StreamBase Proxy server
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.
The server configuration file where you have defined the
<security>element to enable sbproxy security.
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
-Joptions 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-optionthat you would use at the Java command line, including the initial hyphen. For example, specify
-J-Dstreambase.log-level=2to increase the log level for this invocation of sbproxy.
jvm-optionargument 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
-Joptions. For example:
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.
The port number to be used by the sbproxy server instance you are running.
The remote host on which the sbd server runs.
The port number used by the sbd server.
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