Installing A New License File

TASK

How do I install a new license file?

SOLUTION

When you add new users, or when the Perforce Server's IP address changes, you need to install a new license file. To install a new license file, use one of the following three methods.

Install the File and Restart the Server

If the Perforce Server's IP address changes, you must restart the server. If you are just adding new users, consider using one of the other license installation methods detailed below, because they do not involve stopping the server.

1. Stop the Perforce Server by issuing the following command:

   p4 admin stop

2. Replace the old license file in the server's root folder with the new license file. The file is named 'license'.
   
   
3. Restart the Perforce Server as follows:
   
   
   • Windows: Go to the Services control panel (Start > Run, type 'services.msc' and hit enter), scroll to the Perforce server entry, then right click and select 'Start'.
     
     
   • Linux/Unix: Run the Perforce startup script you usually use. If you do not have a Perforce startup script, cd to the Perforce Server root location ($P4ROOT) and issue the following command:

     p4d -r . -d

Use the p4 license Command

The p4 license command enables Perforce 'super' users to update or display the Perforce license file. This command requires a valid license file already in the Perforce server root directory.

To display your current license:

p4 license -o

To install a new license:

cat license | p4 license -i

or

p4 license -i < license

Most new license files obtained from Perforce can be installed using this method, except when the server IP address has changed. If the server IP address has changed, use the first method.

Use the P4V Administration Tool

For server versions 2006.2 and later, you can use the Administration Tool in P4V (available in P4V 2008.1 and later), as long as the IP address has not changed. To install your new licenses using P4V:

1. Launch P4V (version 2008.1 and later) as a Perforce superuser.
2. Choose Tools > Administration.
3. On the Administration Home page, click on the "Load new license file" link and browse to the license file on your local disk.

After successful installation, the Administration tool Home page is updated with the new license information.