p4 license

Update or display the license file.

Syntax conventions

p4 [g-opts] license -o
p4 [g-opts] license -i
p4 [g-opts] license -u

Description

The p4 license command allows Helix server superusers to update or display the Helix server license file. This command requires that there is already a valid license file in the Helix server root directory.

Use p4 license to add licensed users to a Perforce service without having to shut down the service and manually copy the license file into the server root.

Note

Most new license files obtained from Perforce can be installed with p4 license, or by copying over the existing license file. However, if the server IP address or port number has changed, you must explicitly "stop" the server:

For UNIX, see Stopping the Perforce Service and Starting the Perforce Service.

For Windows, see Starting and stopping the Helix Server.

Important

License expiration occurs at the START of the expiration date according to Coordinated Universal Time (UTC). For example, if p4 license -o shows the UNIX time for expiration as 1546300801, that means Tuesday, January 1, 2019 12:00:01 AM for UTC (GMT). If your server is in California, the license expires the day before on Monday, December 31, 2018 4:00:01 PM because California local time is 8 hours behind UTC. To convert UNIX time to a more readable format, use a converter, such as https://www.epochconverter.com/.

Alternatively, to get licenseTimeRemaining in seconds, use p4 license -u as in this example:

>p4 -u su-bruno -p p4prod.mycompany.com:1666 license -u
... isLicensed yes
... userCount 651
... userLimit 1000
... clientCount -
... clientLimit unlimited
... fileCount -
... fileLimit unlimited
... repoCount -
... repoLimit unlimited
... licenseExpires 1582934400
... licenseTimeRemaining 5172009
... supportExpires 1582934400

Tip

If you want a warning that the license will expire within a specified amount of time, consider the script at https://swarm.workshop.perforce.com/files/guest/nick_poole/scripts/nagios/readme.txt.

Limits for unlicensed use depend on the release

2016.1 and later	prior to 2016.1
unlimited number of files for 5 users and 20 client workspaces, or unlimited number of users and workspaces for up to 1,000 files	unlimited number of files for 20 users and 20 client workspaces, or unlimited number of users and workspaces for up to 1,000 files

Options

`-o`	Display the current license file on the standard output.
`-i`	Read in a new license file from the standard input. For example, see Adding or updating the license file.
`-u`	Report license limits, including the expiration of the license and of Support, and show how many entities (users or files) are in use with respect to these limits.
`g-opts`	See Global options.

Usage Notes

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
N/A	N/A	super (`admin` for `-u` option)

Examples

`p4 license -o`	Display the current license file on the standard output.
`p4 license -i`	Read in a new license file from the standard input.