5. qmtest gui

5.1. Summary

Start the graphical user interface.

5.2. Synopsis

qmtest gui [ option ...]

5.3. Description

The qmtest gui starts the graphical user interface. The graphical user interface is accessed through a web browser. You must have a web browser that supports JavaScript to use the graphical interface. QMTest has been tested with recent versions of Internet Explorer and Netscape Navigator. Other web browsers may or may nor work with QMTest.

The gui command accepts these options:

-A address, --address address

Bind the server to the indicated internet address, which should be a dotted quad. By default, the server binds itself to the address 127.0.0.1, which is the address of the local machine. If you specify another address, the server will be accessible to users on other machines. QMTest does not perform any authentication of remote users, so you should not use this option unless you have a firewall in place that blocks all untrusted users.

-c name=value, --context name=value

For details about this option, see the description of the qmtest run command.

-C file, --load-context file

For details about this option, see the description of the qmtest run command.

--daemon

Run the QMTest GUI as a daemon. In this mode, QMTest will detach from the controlling terminal and run in the background until explicitly shutdown.

-j count, --concurrency count

For details about this option, see the description of the qmtest run command.

--no-browser

Do not attempt to start a web browser when starting the GUI. QMTest will still print out the URL at which the server can be accessed. You can then connect to this URL manually using the browser of your choice.

-O file, --outcomes file

For details about this option, see the description of the qmtest run command.

--pid-file path

Specify the path to which the QMTest GUI will write its process ID. This option is useful if you want to run QMTest as a daemon. If this option is not provided, no PID file is written. If you specify this option, but path is the empty string, QMTest will check the .qmrc configuration file for a pid-file entry. If there is no such entry, QMTest will use an appropriate platform-specific default value.

--port port

Specify the port on which the QMTest GUI will listen for connections. If this option is not provided, QMTest will select an available port automatically.

-T file, --targets file

For details about this option, see the description of the qmtest run command.