qacli config license-server

Manage the list of license servers used by Perforce QAC.

Usage

config license-server  {-A <port@host|host[:port]>|-R <port@host|host[:port]>|-L|-C} [-P <directory>] [-K <config name>] [-b] [--] [-h]

Extended Description

In order to analyze and view results for a project a suitable licence is required. These licences are managed by a separate license server. Several servers may be specified in an ordered list to allow for failure of an individual server.

Options

Name, shorthand	Default	Description
`--add, -A`		Add a license server (to the top of the server list) to be used by Perforce QAC.
`--bottom, -b`		When adding a license server, add the server to the bottom of the ordered list of license servers.
`--check, -C`		Check the availability of licenses. By default, all licenses for the components available within the installation will be checked, but this may be restricted to only the licences relevant to a project by specifying the project (`--qaf-project`) and optional config (`--config`).
`--config, -K`		For projects with multiple configurations, specify which configuration to use. If none specified, then the default will be used.
`--help, -h`		Displays usage information and exits.
`--ignore-rest, --`		Ignores the rest of the labeled arguments following this flag.
`--list, -L`		Output an ordered list of license servers.
`--qaf-project, -P`		Specify a path to a valid Perforce QAC project.
`--remove, -R`		Remove the license server from the list of servers used by Perforce QAC.

When adding or removing a server the name (or IP) and the port is required. It can be specified in either of two formats: port@host or host:port

Examples

Adding a Server

To add a server to the top of the list of existing servers:

qacli config license-server --add 5055@rlm-server.com

Or, using the alternative format:

qacli config license-server --add rlm-server.com:5055

Adding a Server to the Bottom of the List of Servers

To add a server to the bottom of the list of existing servers add the --bottom option.

qacli config license-server --add 5055@rlm-server.com --bottom

Removing a Server

To remove a server from the list of servers:

qacli config license-server --remove 5055@rlm-server.com

Or, using the alternative format:

qacli config license-server --remove rlm-server.com:5055

List All Servers

To produce a list of servers:

qacli config license-server --list

Check Licence Availability

Once a server has been added you can query the server to see if licences are available for the installed components:

qacli config license-server --check

If no license server(s) have been configured or the server(s) are unavailable, this command may take some time to complete.

Check License Availability for a Project

To check if all the required license for a project are available, add --qaf-project and reference the project location:

qacli config license-server --check --qaf-project /home/trinity

If you are using a multi-config project and want to target a different config then add "--config <config-name>"