How To Import A Hipchat Server License Via The Command Line
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
- Obtain your Hipchat Server license via my.atlassian.com.
- Open up a text editor, create a new file and copy the entire license from my.atlassian.com into this file.
Save the file with a .license extension. i.e. HCS-evaluation.license
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
- If you're on Mac or Linux, open up the local terminal. If you're on Windows, you can use Putty.
SCP the license file to Hipchat Server:
scp -i /path/to/ssh/file.pem /path/to/license/HCS-evaluation.license admin@server.mycompany.com:
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
Apply the license using the -i or --import argument:
hipchat license -i hcs-dev-license.license
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