provides a command-line interface for accessing the Faban harness
functionality. At allows scripts and programs to interface with the
Faban harness directly without going through the web interface. The
fabancli can be run from both the local system where the Faban master
is running, or from any remote machine.
Sends the command to a remote master instead of a local
one. By default, fabancli will send the command to
Uses the given user to access the Faban master. Since
this username is often put into scripts, this is not a regular user but
a special user provided in the Faban harness configuration file -
Provides the password to the user name given in the -U
option. This password is also as configured in the harness
Cancels the run identified by runId. If the run is still
not started, it is removed from the run queue. The run is killed if
already in progress. Note - only runs submitted using the fabancli can
be cancelled or queued using fabancli's kill command.
Lists the runs in the run queue.
showlogsrunId [-f] [-t]
Shows the run log for the given runId.
Keeps following and updating the log display until
the run is done.
Starts only with the 10 most recent log entries.
Combined with the -f option, this will start with the 10 most recent
log entries and keep updating the logs till the end of the run. This
behaves like the tail -f Unix command.
Prints the current status of the given runId. Run status
QUEUED RECEIVED STARTED COMPLETED FAILED KILLED
The run is submitted to the run queue, but not yet
For submission proxies only, the run has been
received by the running rig and may have been started.
The run has been started. It is running at this
The run has been finished and results are available.
The run failed to complete due exceptions.
The run was killed by a user.
Submits a run for a given benchmark, identified by it's
short name. The benchmark must already be deployed on the
master. The given configuration will be saved in the profile identified
Blocks waiting for the given runId to terminate. The wait
command will return immediately if the run is already finished.