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

From wiki.olisystems.com
Jump to: navigation, search
(→‎Download the software)
(→‎Overview)
 
(36 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 
==Overview==
 
==Overview==
  
−
With version 3.1 OLI has introduced a softkey version of the OLI Network License Manager. This version does not require a hardware device (a/k/a usb key or dongle). Rather, a "Footprint" of the target computer is required to ensure uniqueness. The steps for installing the software are similar to the hardware version but there are some significant differences.
+
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==
 
==Download the software==
Line 15: Line 26:
  
 
   
 
   
−
  ''(Note: in the past, hardware versions were prefixed with the letters LH - LAN Hardware. Softkey versions are prefixed with LS - LAN Softkey)''
+
  ''(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.
 
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:Softkey22x.png|600px]]
+
[[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.
+
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]]
 
[[File:Softkey 3.png|600px]]
  
−
A list of program to which you are entitled to download will be displayed. For this excercize 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)
+
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]]
 
[[File:Softkey 4.png|700px]]
Line 32: Line 44:
 
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.
 
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:Softekey 5.png|400px]]
+
[[File:Usbhardware5x.png|400px]]
  
 
Once downloaded, please locate the file. Here we have downloaded the file in the default Firefox folder.
 
Once downloaded, please locate the file. Here we have downloaded the file in the default Firefox folder.
Line 40: Line 52:
 
Locate the OLI Network License Server that you just downloaded and move it to the same folder as the license file.
 
Locate the OLI Network License Server that you just downloaded and move it to the same folder as the license file.
  
−
[[File:Softkey 6.png|700px]]
+
 
 +
[[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.
 
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.
 
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.
 
OLI uses InstallShield as its delivery application. Click the next button to begin.
 +
  
 
[[File:Softkey1x.png|500px]]
 
[[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.
 
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.
Line 77: Line 95:
 
[[File:Softkey4x.png|500px]]
 
[[File:Softkey4x.png|500px]]
  
−
If you have never installed the OLI Softkey before you will get the following error message. The installer attempts to start the security provider and failed
+
== Plugging in the USB Network hardlock key==
−
 
 
−
[[File:Softkey5x.png|400px]]
 
−
 
 
−
This is expected since the necessary footprint of the target computer has not been generated. Click the OK button to continue.
 
−
 
 
−
[[File:Softkey6x.png|500px]]
 
−
 
 
−
We are now temporarily done with the installation of the OLI Network Security Provider.
 
−
 
 
−
==Generating the OLI Footprint for the softkey==
 
−
 
 
−
 
 
−
We now must generate the footprint. To do this we need to locate a tool
 
−
 
 
−
'''Start > Programs > OLI Systems > Network License Server > Tools > Hardlock Restore Unitity'''
 
−
 
 
−
[[File:Softkey7x.png]]
 
−
 
 
−
When started you should have a dialog as follows:
 
−
 
 
−
[[File:Softkey16x.png]]
 
−
 
 
−
Click the ''Collect Information'' button. This will scan your computer and compose a list of objects and then encode them in a binary format. OLI can use this file but cannot read this file. Under no circumstances will OLI Systems, Inc. share this information without your express/written consent.
 
−
 
 
−
This will launch a familiar save dialog.
 
−
 
 
−
[[File:Softkey17x.png]]
 
−
 
 
−
We automatically populate the file name with the name of your computer. In this case the computer is a virtual computer with the name win7-x64. We will append the extensin OLIc2v which means client-to-vendor.
 
−
 
 
−
Please save this file in a location where you can find it and then send the file to OLI Systems. Our Email address is in the footer of this page.
 
−
 
 
−
==Applying the OLI Softkey==
 
−
 
 
−
 
 
−
You will receive a file from OLI Systems with the name of the softkey with the extension OLIv2c (vendor-to-client). In our example this file name would be: LS00006.OLIv2c. You will need to restart the tool as before:
 
−
 
 
−
'''Start > Programs > OLI Systems > Network License Server > Tools > Hardlock Restore Unitity'''
 
−
 
 
−
[[File:Softkey18x.png]]
 
−
 
 
−
Click the '''Apply Update''' button. This will open a familar open dialog:
 
−
 
 
  
−
[[File:Softkey 19x.png]]
 
  
−
Locate the file that was supplied by OLI Systems. Highlight it and select Open.
+
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==
−
 
 
−
This message means that the key was installed correctly.
 
−
 
 
−
== Applying the OLI Softkey License==
 
  
 
Go to the '''OLILic''' license file sent by OLI via email.
 
Go to the '''OLILic''' license file sent by OLI via email.
Line 137: Line 110:
 
The attachment will look similar to the following file image:
 
The attachment will look similar to the following file image:
  
−
[[File:Softkey20x.png]]
+
[[File:Usbhardware4x.png]]
  
 
Copy the file on the machine which has OLI Network License Manager installed.
 
Copy the file on the machine which has OLI Network License Manager installed.
Line 145: Line 118:
 
Now double click on the file, it will prompt the following message:
 
Now double click on the file, it will prompt the following message:
  
−
[[File:Softkey21x.png]]
+
[[File:Usbhardware6x.png]]
  
 
Click '''Yes'''
 
Click '''Yes'''
Line 172: Line 145:
 
[[File:Softkey15x.png]]
 
[[File:Softkey15x.png]]
  
−
Success! The server has started. You can now begin to update any client programs.
+
  '''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.
 
Click on any line to see the contents of the notification.
Line 178: Line 151:
 
==Server Errors==
 
==Server Errors==
  
−
In case there are error please proceed to the following steps:
+
 
 +
'''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.
 
To find out exactly what is causing the error. Close this error dialog and click on the Event Log tab.

Latest revision as of 07:08, 31 August 2018

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

Retrieved from "https://wiki.olisystems.com/wiki/index.php?title=Installing_and_Running_the_OLI_License_manager_3.1-_USB_Hardware_Key_edition&oldid=5230"