Difference between revisions of "Installing and Running the OLI License manager 3.x- USB Hardware Key edition"

From wiki.olisystems.com
Jump to: navigation, search
Line 8: Line 8:
  
 
{{#ev:youtube|NrU-VCYhSdY}}
 
{{#ev:youtube|NrU-VCYhSdY}}
 +
 +
 +
==Overview==
 +
 +
Following instructions talk about OLI License manager 3.1 - the USB Hardware key edition.
 +
 +
Here there is an instructional video:
 +
 +
{{#ev:youtube|oqNjTRKAbs4}}
 +
 +
 +
 +
'''Do not''' plug in the Network key till you get to the ''section 4'', Plugging in the USB Network hardlock key.
 +
:
 +
 +
<span style="color:darkblue">'''Please note, you cannot install multiple licenses on the same machine!!'''</span>
 +
 +
==Download the software==
 +
 +
We begin by asking you to download the latest software from the OLI download website '''[http://downloads.olisystems.com]'''
 +
 +
To do this you will need the Server Serial number in the license file that OLI supplied to you. As an example, the white USB key should contain a file that is similar to the one shown below "LH54XXXXX..."
 +
 +
[[File:Usbhardware1x.png|1000px]]
 +
 +
 +
Open Notepad on your machine and drag the license file to it.Once you do that you will be able to see the License Information stored within the file. Please note, do '''NOT''' save the changes to this file in notepad, that '''WILL''' corrupt the file.
 +
 +
 +
''(Note: in the past, hardware versions were prefixed with the letters LH - LAN Hardware. Now we use the term "LA" for the HASP keys)''
 +
 +
Locate the ''Server'' Serial Number. We will use this number for several download and install steps. Please note, for all network users of the OLI software this is the only serial number that will allow you access to the download program site.
 +
 +
[[File:Usbhardware2x.png|600px]]
 +
 +
 +
On the OLI download web site, enter your information as well as the server serial number. When this information has been added click the Go button. For example, here we have used email address of Rasika Nimkar (Technical Support) :
 +
 +
 +
[[File:Softkey 3.png|600px]]
 +
 +
A list of program to which you are entitled to download will be displayed. For this exercise we are only interested in the OLI Network License Server 3.1. When ready click the Download icon. (Note: The beta version of the 3.1 license manager is not displayed here, it will be provided in a separate link)
 +
 +
[[File:Softkey 4.png|700px]]
 +
 +
Save the file to your computer. For this excercize we are using FireFox as our web browser and we have selected the default Firefox download folder to receive this file.
 +
 +
[[File:Usbhardware5x.png|400px]]
 +
 +
Once downloaded, please locate the file. Here we have downloaded the file in the default Firefox folder.
 +
 +
==Install the OLI Network License Server==
 +
 +
Locate the OLI Network License Server that you just downloaded and move it to the same folder as the license file.
 +
 +
 +
[[File:Usbhardware3x.png|700px]]
 +
 +
 +
Next, locate the license file OLI sent to you on the USB key or via Email. Copy this file to the same folder as the OLI Network License Server installation file.
 +
 +
 +
Double-Click the OLI Network License Server install icon. Accept the request to run the software.
 +
 +
 +
OLI uses InstallShield as its delivery application. Click the next button to begin.
 +
 +
 +
[[File:Softkey1x.png|500px]]
 +
 +
 +
You will be prompted to press the next button many times. Unless we tell you different, please press the next button or the yes button.
 +
 +
 +
[[File:Softkey1.png|500px]]
 +
 +
 +
 +
Please click on the "I accept..." button and then click the Next button
 +
 +
 +
[[File:Softkey2x.png|500px]]
 +
 +
 +
Select '''Typical''' and then click the '''Next''' button.
 +
 +
[[File:Softkey3x.png|500px]]
 +
 +
Click the '''Install''' button.
 +
 +
The Serial Number is automatically retrieved from the license file if it is in the same folder as the installer file. If the box is blank you will have to manually enter the serial number from the license file.
 +
 +
If you are requested to elevate the security, please click '''Yes'''.
 +
 +
This is an image of the installation in progress. Please wait for it to complete.
 +
 +
[[File:Softkey4x.png|500px]]
 +
 +
== Plugging in the USB Network hardlock key==
 +
 +
 +
Please note that this is a Hardware key, hence it needs to be '''Plugged IN''' in a USB port on the machine, where you will be installing the OLI Network License Manager.
 +
When the key is plugged in, it should look like the following:
 +
[[File:Usbhardwarekey.jpg|500px]]
 +
 +
'''PLEASE REBOOT YOUR SERVER TO MAKE SURE THE DRIVERS WERE UPDATED PROPERLY.'''
 +
 +
== Applying the OLI Network License==
 +
 +
Go to the '''OLILic''' license file sent by OLI via email.
 +
 +
The attachment will look similar to the following file image:
 +
 +
[[File:Usbhardware4x.png]]
 +
 +
Copy the file on the machine which has OLI Network License Manager installed.
 +
 +
Go to the machine and make sure that you have admin privileges for that particular machine.
 +
 +
Now double click on the file, it will prompt the following message:
 +
 +
[[File:Usbhardware6x.png]]
 +
 +
Click '''Yes'''
 +
 +
Once the application of license is completed successfully you will see the following message:
 +
 +
 +
[[File:LS3.png]]
 +
 +
==Verifying the OLI Network License Manager is up and running==
 +
 +
Start the OLI Network Security Provider (a/k/a the License Manager) via this path:
 +
 +
'''Start > All Programs > OLI Systems > Network License Server > Network License Server'''
 +
 +
[[File:Softkey13x.png]]
 +
 +
 +
 +
Click on the '''Event Log''' tab. This way you can see if any errors occur.
 +
 +
[[File:Softkey14x.png]]
 +
 +
Click the '''Start''' button.
 +
 +
[[File:Softkey15x.png]]
 +
 +
  '''Success! The server has started. You can now begin to update any client programs''' .
 +
 +
Click on any line to see the contents of the notification.
 +
 +
==Server Errors==
 +
 +
 +
'''In case''' there are errors, please proceed to the following steps:
 +
 +
To find out exactly what is causing the error. Close this error dialog and click on the Event Log tab.
 +
Please follow the next steps to get the event log:
 +
 +
If you see the following message " Starting Service : failed"
 +
 +
 +
[[File:LS5.png]]
 +
 +
 +
 +
At that point we will need to see the event log. In order to obtain that, please follow the following steps:
 +
 +
 +
* '''Go to the Network License Server'''
 +
 +
Start the OLI Network License Server The path is:
 +
 +
Programs >  OLI Systems > Network License Server >  Network License Server
 +
 +
[[File:LS6 1.png]]
 +
 +
 +
* '''Go to the Event Log tab'''
 +
 +
 +
[[File:LS7.png]]
 +
 +
 +
You may see an empty Event log
 +
 +
 +
[[File:LS8.png]]
 +
 +
 +
* '''Populate the Event log'''
 +
 +
 +
Click on the Start button encircled in the step above.
 +
 +
Following message will pop up:
 +
 +
 +
[[File:LS9.png]]
 +
 +
Click '''OK'''
 +
 +
* '''Save Events'''
 +
 +
[[File:L10.png]]
 +
 +
Clicking on Save Events will pop up the following window.
 +
 +
[[File:LS11.png]]
 +
 +
Please make sure to write the company name and the '' key ID'' in the file name. It will be a text file.
 +
 +
Please send it to OLI support after that point.
 +
 +
 +
 +
 +
Please send this text file to OLI for analysis via the support email link below
 +
 +
'''[mailto:oli.support@olisystems.com oli.support@olisystems.com]'''
 +
 +
 +
[[Category: Security]]
 +
[[Category:Installation]]

Revision as of 09:28, 18 September 2018

These instructions apply to all versions of the OLI License Manager version 3.x.

The current version of the OLI License Manager is 3.4


Here is a video overview of the installation procedure:



Overview

Following instructions talk about OLI License manager 3.1 - the USB Hardware key edition.

Here there is an instructional video:


Do not plug in the Network key till you get to the section 4, Plugging in the USB Network hardlock key.

Please note, you cannot install multiple licenses on the same machine!!

Download the software

We begin by asking you to download the latest software from the OLI download website [1]

To do this you will need the Server Serial number in the license file that OLI supplied to you. As an example, the white USB key should contain a file that is similar to the one shown below "LH54XXXXX..."

Usbhardware1x.png


Open Notepad on your machine and drag the license file to it.Once you do that you will be able to see the License Information stored within the file. Please note, do NOT save the changes to this file in notepad, that WILL corrupt the file.


(Note: in the past, hardware versions were prefixed with the letters LH - LAN Hardware. Now we use the term "LA" for the HASP keys)

Locate the Server Serial Number. We will use this number for several download and install steps. Please note, for all network users of the OLI software this is the only serial number that will allow you access to the download program site.

Usbhardware2x.png


On the OLI download web site, enter your information as well as the server serial number. When this information has been added click the Go button. For example, here we have used email address of Rasika Nimkar (Technical Support) :


Softkey 3.png

A list of program to which you are entitled to download will be displayed. For this exercise we are only interested in the OLI Network License Server 3.1. When ready click the Download icon. (Note: The beta version of the 3.1 license manager is not displayed here, it will be provided in a separate link)

Softkey 4.png

Save the file to your computer. For this excercize we are using FireFox as our web browser and we have selected the default Firefox download folder to receive this file.

Usbhardware5x.png

Once downloaded, please locate the file. Here we have downloaded the file in the default Firefox folder.

Install the OLI Network License Server

Locate the OLI Network License Server that you just downloaded and move it to the same folder as the license file.


Usbhardware3x.png


Next, locate the license file OLI sent to you on the USB key or via Email. Copy this file to the same folder as the OLI Network License Server installation file.


Double-Click the OLI Network License Server install icon. Accept the request to run the software.


OLI uses InstallShield as its delivery application. Click the next button to begin.


Softkey1x.png


You will be prompted to press the next button many times. Unless we tell you different, please press the next button or the yes button.


Softkey1.png


Please click on the "I accept..." button and then click the Next button


Softkey2x.png


Select Typical and then click the Next button.

Softkey3x.png

Click the Install button.

The Serial Number is automatically retrieved from the license file if it is in the same folder as the installer file. If the box is blank you will have to manually enter the serial number from the license file.

If you are requested to elevate the security, please click Yes.

This is an image of the installation in progress. Please wait for it to complete.

Softkey4x.png

Plugging in the USB Network hardlock key

Please note that this is a Hardware key, hence it needs to be Plugged IN in a USB port on the machine, where you will be installing the OLI Network License Manager. When the key is plugged in, it should look like the following: Usbhardwarekey.jpg

PLEASE REBOOT YOUR SERVER TO MAKE SURE THE DRIVERS WERE UPDATED PROPERLY.

Applying the OLI Network License

Go to the OLILic license file sent by OLI via email.

The attachment will look similar to the following file image:

Usbhardware4x.png

Copy the file on the machine which has OLI Network License Manager installed.

Go to the machine and make sure that you have admin privileges for that particular machine.

Now double click on the file, it will prompt the following message:

Usbhardware6x.png

Click Yes

Once the application of license is completed successfully you will see the following message:


LS3.png

Verifying the OLI Network License Manager is up and running

Start the OLI Network Security Provider (a/k/a the License Manager) via this path:

Start > All Programs > OLI Systems > Network License Server > Network License Server

Softkey13x.png


Click on the Event Log tab. This way you can see if any errors occur.

Softkey14x.png

Click the Start button.

Softkey15x.png

  Success! The server has started. You can now begin to update any client programs .

Click on any line to see the contents of the notification.

Server Errors

In case there are errors, please proceed to the following steps:

To find out exactly what is causing the error. Close this error dialog and click on the Event Log tab. Please follow the next steps to get the event log:

If you see the following message " Starting Service : failed"


LS5.png


At that point we will need to see the event log. In order to obtain that, please follow the following steps:


  • Go to the Network License Server

Start the OLI Network License Server The path is:

Programs > OLI Systems > Network License Server > Network License Server

LS6 1.png


  • Go to the Event Log tab


LS7.png


You may see an empty Event log


LS8.png


  • Populate the Event log


Click on the Start button encircled in the step above.

Following message will pop up:


LS9.png

Click OK

  • Save Events

L10.png

Clicking on Save Events will pop up the following window.

LS11.png

Please make sure to write the company name and the key ID in the file name. It will be a text file.

Please send it to OLI support after that point.



Please send this text file to OLI for analysis via the support email link below

oli.support@olisystems.com