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 --helpAll 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.