opus_broker
This command line program is used to start OPUS processes. This is the
very program invoked by the PMG (via the
context server) when it is directed to
start an OPUS process.
Outside of the PMG,
this can also be run interactively on the command line, on the node where
the servers are running, if for some reason the use of a GUI is not
possible. When used in a script, an entire pipeline may be brought up
without requiring a user's presence. Note however, that the servers must
have been brought up cleanly
before this command can be used to start processes.
The program takes as input the name of the node where the process is
to be run, but if it is the same as the current node, the program
will start it locally rather than using the value of the
OPUS_REMOTE_SHELL
environment variable.
Usage: opus_broker [username@]node process_name path [encrypted_password]
Run with no arguments, the command will print out its usage statement.
Context
Inputs
Outputs
Exit Status
Returned status value is: '0' on success, '1' on spawn failure.
Arguments
[username@]node
The node and user name (account) where the process is to be run.
The "username@" part can be omitted if the username on the target node is
the same as it is on the current node.
process_name
The name of OPUS process to be run (the PROCESS part of the PSTAT), e.g.
"listhd".
path
The simple OPUS path name under which the process is to be started (the PATH
part of the PSTAT), e.g. "g2f".
encrypted_password (optional)
An encrypted password for the process, if any is used by the process.
This is not necessarily the password for the target user account. There
should be no command-line
password-prompting
during the start of a process using either opus_broker or the PMG.
This argument is the encrypted string as given by the OPUS "crypto"
command (e.g. crypto -e mYpAsWoRd). Note - none of the sample pipeline
processes use a password in this way.
Examples
% opus_broker mynode listhd g2f
Starts one "listhd" process running in the "g2f" path on "mynode".
% opus_broker myname@othernode cleandata quick
Starts one "cleandata" process running in the "quick" path on "othernode"
which is networked to this node.