Tower Help & Support

Licensing via CLI Tool

Using the Command Line Tool you can handle all of Tower's licensing requests in a scripted manner.
This enables managing and automating the deployment of licenses and trials for other machines.
As the prerequisite, you need a machine with Tower and its Command Line Tool installed connected to the internet.

Available Commands

  gittower license -i [-c|--code <value>] [-e|--email <value>] [--machine name <value>]
  gittower license -a | --activate [<options>] [<pathspec>]
  gittower license -t | --trial [<options>] [<pathspec>]
  gittower license -d | --deactivate <pathspec>
  gittower license --install <pathspec>
  gittower license --help

All ouput is printed on STDOUT in Apple's Plist XML format.
Files referenced must be in this format too.

See below for a detailed explanation of all available commands.

Gather License Information

  gittower license -i [-c|--code] [-e|--email] [--machine name <value>]

Description

Reads anonymous identification information from the Tower installation.

Options

-c "<value>"
--code "<value>"
Include a license key in output, must be enclosed in "

-e "<value>"
--email "<value>"
Include a registered email address in output, must be enclosed in "

--machine-name "<value>"
Include a user visible machine name in output, must be enclosed in "
This information will be visible in the Customer Portal.

Create a License

  gittower license -a | --activate [<options>] [<pathspec>]

Description

Retrieves validated license information from the licensing system for the given data.
You can supply the necessary information via a referenced file (e.g. generated by gittower license -i), via the option flags, or a combination of both.

If neither options or files are passed, Tower defaults to the licensing data of the local machine.

The retrieved information can be further used by gittower license --install.

Options

If one option is present, all information has to be supplied via option flags or via <pathspec>.

-c "<value>"
--code "<value>"
Include license key in output, must be enclosed in ".

-e "<value>"
--email "<value>"
Include registered email address in output, must be enclosed in ".

-u "<value>"
--user "<value>"
An anonymous user identifier, must be enclosed in ".
Retrievable in the output of gittower license -i.

-m "<value>"
--machine "<value>"
An anonymous machine identifier, must be enclosed in ".
Retrievable in the output of gittower license -i.

<pathspec>
A reference to a valid Plist XML formatted file.
Retrievable via gittower license -i.

Create a Trial License

  gittower license -t | --trial [<options>] [<pathspec>]

Description

Retrieves validated trial information from the licensing system for the given data.
You can supply the necessary information via a referenced file (e.g. generated by gittower license -i), via the option flags, or a combination of both.

If neither options nor a <pathspec> are passed, Tower defaults to the licensing data of the local machine.

Options

If one option is present, all information has to be supplied via option flags or via <pathspec>.

-u "<value>"
--user "<value>"
An anonymous computer user identifier, must be enclosed in ".
Retrievable in the output of gittower license -i.

-m "<value>"
--machine "<value>"
An anonymous machine identifier, must be enclosed in ".
Retrievable in the output of gittower license -i.

<pathspec>
A reference to a valid Plist XML formatted file.
Retrievable via gittower license -i.

Deactivate a License

  gittower license -d | --deactivate <pathspec>

Description

Instructs Tower's licensing system to deactivate the given license.
You have to supply the necessary information via a referenced file.

Install a License

  gittower license --install <pathspec>

Description

Instructs Tower to register the given license.
Starts a 30 day trial for a trial license or unlocks Tower for indefinite usage in case of a full license.
You have to supply the necessary information via a referenced file.

Options

<pathspec>
A reference to a valid Plist XML formatted file.
Retrievable via gittower license -a or gittower license -t.