jsbadmin

< Previous		Next >

DESCRIPTION

The jsbadmin command runs a Java implementation of the StreamBase administration client utility, sbadmin. Both commands let you perform StreamBase administration tasks such as addContainer, suspend, resume, and shutdown.

To stop a running sbd process, use the jsbadmin shutdown command.

OPTIONS

With a few exceptions, the jsbadmin command has the same options as the sbadmin command, as described in sbadmin. The exceptions are:

No space after -u or -p

For jsbadmin, there must be no space between -u and the following URI, and no space between -p and the following port number:

jsbadmin -usb://localhost:10000 listConnections
jsbadmin -p9900 listConnections

enqueue and dequeue support the --json option

The jsbadmin command supports running all jsbc subcommands, in the same way that sbadmin supports all sbc subcommands. When jsbadmin invokes the jsbc enqueue and dequeue subcommands, it supports the --json option. For dequeue, this prints all tuples in the form of a JSON object (as defined on http://www.json.org) instead of the default CSV format. For enqueue, --json specifies that the tuples to be enqueued are in JSON object format. Use this option after the enqueue or dequeue subcommand:

jsbadmin enqueue --json InputPort
jsbadmin dequeue --json OutputPort

-J option supported

The jsbadmin command accepts the -J option, but sbadmin does not.

-J jvm-option

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

A space between the -J and its argument is optional. 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 jsadmin.

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

No arguments for -h and --help

Unlike the sbadmin command, this jsbadmin command's -h and --help options do not take subcommand arguments.

COMMANDS

The jsbadmin command accepts the same subcommands as the sbadmin command, with the exception of the following, which are supported since release 7.6.0 only on jsbadmin.

getTargetTime

Use this command to return a timestamp representing the time StreamBase Server thinks it is right now. This function is useful in a controlled time environment to retrieve a custom starting point time you have set with elements like the following in the project's sbd.sbconf.

<time-service-configurations>
  <type>CONTROLLABLE</type>
  <target-time>2015-10-06 12:00</target-time>
</time-service-configurations>

fastForwardTime millis

Use this command to advance the current time of a running StreamBase Server instance by the number of milliseconds specified as millis. This command is normally used to add the specified number of milliseconds to a custom start time specified with the <target-time> sbconf element; or to the Server's actual start time otherwise. For this command to work, you must specify controllable time using an sbd.sbconf construction like the following for the containing project.

<time-service-configurations>
  <type>CONTROLLABLE</type>
</time-service-configurations>

For example, jsbadmin fastForwardTime 60000 advances the Server's current time by one minute. Subsequent fastForwardTime commands add to the then-current time. Thus, another jsbadmin fastForwardTime 60000 command advances the current time by two minutes, compared to the custom <target-time>.

FILES

There is no separate configuration file for jsbadmin. Enabling or changing the StreamBase authentication setting for jsbadmin commands is accomplished by editing <authentication> element of the server configuration file.

ENVIRONMENT

STREAMBASE_SERVER: Optional. Contains the URI for a StreamBase Server instance. Use this variable to set a default StreamBase URI for StreamBase commands that take the -u option. If set, commands use the URI in this variable, overriding their built-in default URI, which is sb://localhost:10000. If this variable is set, you must use the -u option to communicate with any server other than the one specified in this variable. See the sburi page in the Reference Guide for more on StreamBase URIs.
STREAMBASE_LOG_LEVEL: Optional. Sets the minimum severity of messages that StreamBase writes to logging output. Default is 0, which gets NOTICE level messages and higher. Reasonable values are -1 (which disables NOTICE messages and shows only WARN, ERROR and FATAL messages), 1 (which adds INFO messages to the standard messages), and 2 (which adds DEBUG messages).