Installing a license key

From Swivel Knowledgebase
Revision as of 08:54, 28 September 2018 by RWithey (talk | contribs) (Solution)
Jump to: navigation, search


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.

Sentry Server Name.png

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

Older versions:

License screen.JPG

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

Version 4.x (3.11.x will have the same fields, but different style):

Sentry Server License.png

For 3.11.x onward and 4.x, copy and paste the license key as above, but you also need the license information.

a) If your appliance is capable of accessing the internet, select "Yes" for the Online option and the license information will be filled automatically.

b) 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.

License Server Info.png

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';

6. 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.