Difference between revisions of "Installing a license key"

From Swivel Knowledgebase
Jump to: navigation, search
(Prerequisites)
(Solution)
Line 43: Line 43:
 
2. To login, you will need to enter the username and extract the PIN from the [[TURing]] image that appears and enter it into the One Time Code field;
 
2. To login, you will need to enter the username and extract the PIN from the [[TURing]] image that appears and enter it into the One Time Code field;
  
3. Once you've logged into the Swivel Administration Console, click 'Server', 'License' from the left hand menu;
+
3. Once you've logged into the Swivel Administration Console, in versions 3.11.x and 4.x you need to enter your site ID before the license key:
 +
click 'Server' then 'Name' on the left-hand menu. Enter the site ID you have been given in the Site ID field. You can leave the Name and Base URL fields for now.
  
 +
4. Click 'Server', 'License' from the left hand menu.
  
 
[[File:License_screen.JPG]]
 
[[File:License_screen.JPG]]
  
 +
5a. For earlier versions of 3.x, simply copy and paste the license key into the 'License key' field and click 'Apply';
  
4. Copy and paste the license key into the 'License key' field and click 'Apply';
+
5b. For 3.11.x onward and 4.x, copy and paste the license key as above, but you also need the license information.
 +
If your appliance is capable of accessing the internet, select "Yes" for the Online option and the license information will be filled automatically.
  
5. Check the status page, by clicking 'Status' on the left hand menu. The 'Swivel License Name' should be present along with the number of 'Licensed Users';
+
5c. If your appliance is not capable of accessing the internet, select "No" for the Online option. You will need to retrieve the license information:
 +
In a new browser window, enter the url https://smc.swivelsecure.net/slksext/licence/<licence_key>, replacing <license_key> with your actual license key. You should see a long string of characters. Select the entire string and copy it. You can now paste it into the license information field.
  
6. Check the logs for any errors.
+
6. Check the status page, by clicking 'Status' on the left hand menu. The 'Swivel License Name' should be present along with the number of 'Licensed Users';
  
7. Repeat for each Swivel instance as required.
+
7. Check the logs for any errors.
  
 +
8. Repeat for each Swivel instance as required.
  
 
= Troubleshooting =
 
= Troubleshooting =

Revision as of 08:37, 28 September 2018


Overview

How to install a license key on a Swivel Secure 3.x (PINsafe) or 4.x (Sentry) system. The procedure has changed from version 3.11 onwards.

See also License Key Update

Prerequisites

  • Swivel Secure 3.x or 4.x Administration console login with admin rights
  • Valid license key. From 3.11.x onwards, you also need a site ID.

Symptoms

  • Error Message: Swivel license contains an error
  • Status page does not show a license name or required number of users
  • Only a limited number of users are imported into Swivel (Swivel has a default 5 user evaluation license of unlimited duration)
  • License upgrade required
  • Swivel license installation


Solution

1. Access the Swivel Administration Console via a web browser. The default address for this is:

Virtual or hardware appliance Installation: https://IP:8080/pinsafe

Software Installation: http://IP:8080/pinsafe

The default login details for a newly shipped appliances are:

  • Username: admin
  • PIN: 1234

See How to initially configure PINsafe to set the database or changes may not be saved.

2. To login, you will need to enter the username and extract the PIN from the TURing image that appears and enter it into the One Time Code field;

3. Once you've logged into the Swivel Administration Console, in versions 3.11.x and 4.x you need to enter your site ID before the license key: click 'Server' then 'Name' on the left-hand menu. Enter the site ID you have been given in the Site ID field. You can leave the Name and Base URL fields for now.

4. Click 'Server', 'License' from the left hand menu.

License screen.JPG

5a. For earlier versions of 3.x, simply copy and paste the license key into the 'License key' field and click 'Apply';

5b. For 3.11.x onward and 4.x, copy and paste the license key as above, but you also need the license information. If your appliance is capable of accessing the internet, select "Yes" for the Online option and the license information will be filled automatically.

5c. If your appliance is not capable of accessing the internet, select "No" for the Online option. You will need to retrieve the license information: In a new browser window, enter the url https://smc.swivelsecure.net/slksext/licence/<licence_key>, replacing <license_key> with your actual license key. You should see a long string of characters. Select the entire string and copy it. You can now paste it into the license information field.

6. Check the status page, by clicking 'Status' on the left hand menu. The 'Swivel License Name' should be present along with the number of 'Licensed Users';

7. Check the logs for any errors.

8. Repeat for each Swivel instance as required.

Troubleshooting

  • Paste the license key into a text editor and view, to ensure that it is complete and that there are no carriage returns. This has been seen when pasting the license key directly from a PDF document.
  • A successfully added license will show a log message of: Swivel license valid, and in the status page the registered name and number of users will appear.
  • Verify that the license is a valid Swivel 3.x license that has not expired.
  • Ensure that the license is valid for the version of Swivel. A 2.x license will not work on a 3.x version of Swivel. A 3.x license will not work on a 2.x version of Swivel.


Error Messages

Pinsafe license contains an error.

The license is invalid or has not been correctly entered.


ERROR - The number of users in the Pinsafe users group has exceeded the license

exceeded licensed users

The number of licensed users has been exceeded. Note that this message will be displayed even if a new larger license is installed until Tomcat is restarted. Consider purchasing a larger license or freeing up some users such as Inactive users, see Delete a Swivel user.