How To Import A Hipchat Server License Via The Command Line

Still need help?

The Atlassian Community is here for you.

Ask the community

Platform notice: Server and Data Center only. This article only applies to Atlassian products on the Server and Data Center platforms.

Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Purpose

This article explains how to create and install a Hipchat Server license via the command line.

Solution

Gather and create the license file

  1. Obtain your Hipchat Server license via my.atlassian.com.
  2. Open up a text editor, create a new file and copy the entire license from my.atlassian.com into this file.
  3. Save the file with a .license extension. i.e. HCS-evaluation.license
    (warning) If you're using Notepad to create the file, be sure to set 'Save as type' to 'All Files' so the 'txt' extension isn't appended. 

Uploading the license file to Hipchat Server

  1. If you're on Mac or Linux, open up the local terminal. If you're on Windows, you can use Putty.
  2. SCP the license file to Hipchat Server:

    scp -i /path/to/ssh/file.pem /path/to/license/HCS-evaluation.license admin@server.mycompany.com:

    (warning)You will need to provide the .pem file with your SSH key to connect to the Hipchat Server command line.

    This will upload the file to /home/admin in Hipchat Server

Verifying the license file

In the Hipchat Server console, verify that the license file is valid:

hipchat license -v /path/to/license/HCS-evaluation.license


If valid, you will receive:

Success: the license is valid 


If Invalid, please double check that you have the correct extension and that the entirety of the license was copied into the file. Contact Hipchat Server Support if you continue to have a problem.

Applying the license file via the command line

    1. Apply the license using the -i or --import argument:

      hipchat license -i hcs-dev-license.license 
    2. Verify that the license is installed using the -w or --show argument:

      admin@mycompany:~$ hipchat license -w
      
      Description             : HipChat (Server) 5000 Users: Developer Term License
      
      NumberOfUsers           : 5000
      
      Organisation            : MyCompany
      
      Subscription            : true
      
      LicenseTypeName         : COMMERCIAL
      
      ContactEMail            : admin@example.com
      
      licenseVersion          : 2
      
      LicenseID               : <LICENSEID>
      
      LicenseExpiryDate       : 2025-05-31
      
      PurchaseDate            : 2015-04-30
      
      active                  : true
      
      SEN                     : <SEN NUMBER>
      
      CreationDate            : 2015-04-30
      
      Evaluation              : false
      
      MaintenanceExpiryDate   : 2025-05-31
Last modified on Jan 19, 2018

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.