Home Resource Center Support Center Contact Us

OLI Security Issues

 


Last updated: July 18, 2011

Getting Started Guides
Analyzers
ESP
OLI Pro
Aspen PLUS OLI
Help Guides
OLI Security
OLI Analyzer Installatin Help
Computer Issues
Return to Support Center

 

 

Table of Contents

Overview
OLI Security Information
OLI Security Settings and Test
Serial Numbers
Resetting the timelock/trial codes
Hardlock Devices
Hardlock Errors
*Key Invalidated
*Missing or no hardlock device
Static Security Provider Errors
*Hardlock Driver Repair
Registry Settings
OLI Network License Server
How to Administer the OLI Network License Server
Accessing the OLI Keyserver Program
Installing Version Locked Software

Overview

Under construction

OLI Security Information

Many security related issues can be resolved by letting the OLI software tell you what is wrong. There is a great deal of data located on the OLI Security Tab in the software. Follow this link to the OLI Security Information page.

OLI Security Settings and Test

For the Alliance products it is not as easy to test the security settings. So OLI has created a tool called the Security Settings and Test program. Follow this link to the OLI Security Settings and Test program.

Serial Numbers

Serial Numbers are used by OLI Systems to control access to the software. Serial numbers are similar to this following:

V2-LWSY-JBSV-1FK8-57TQ-3RRJ-JUCW

Serial numbers have embedded hardlock codes and expiration dates. You may need to reset the serial number regularly depending on the terms and conditions of your license. You can download the Serial Number resetting guide for more information.

If you have a network version of the OLI software then instructions for updating the serial number is a bit different. You can download a guide to updating the serial numbers here: Updating the OLI Network Security Manager

Hardlock Devices (aka "Dongles")

The hardware device that OLI Systems uses in its security model are manufactured by Alladin. They are USB keys which plug into a USB 1.0 port or later. A picture of a typical OLI USB key is pictured below. All OLI USB keys, also known as "Dongles" are blue in color and have a hardware ID label on them. All OLI USB key IDs begin with either the letters "PH" or "LH" which designate "Personal Hardlock" or "Lan Hardlock"

The USB key will illuminate with a red LED if your computer has properly installed the hardware drivers for this device.

Return to Top

Hardlock Errors

There are several errors that are issued by the OLI software which indicate that the Hardlock device has failed. Here is a short video which shows some of the common error conditions. You can get a list of Hardlock Error Codes here: Error Codes

Date and Time Issues
Missing or No Hardware Key

Date and time issues

Perhaps the leading cause of hardlock device failures is the user attempting to reset the date and/or time on their computer. The hardlock device is designed to detect a date change and then fail if a date was changed backwards. There is a small perpetual clock running inside of each key. This security model is designed to prevent a user from back dating their computer to avoid the expiration date.

Unfortunately there are many legitimate reasons to back date a computer. One is to recover time stamped files and another is when a central server issues a date change to synchronize times on a network. If this occurs, then the user will receive the infamous Hardlock Error (1002), Your system date was changed, Key invalidated.

Fortunately OLI had anticipated this event and we have instructions on how to reset your key. You can watch a short video on how to reset the hardware device or download a guide which explains the same thing. We have summarized the steps here:

If the computer time has been backdated either through design or by accident you may see the following OLI Security Error dialog. For this example we are using OLI Analyzers 3.0.

The error message is pretty clear. You can field reset the hardlock key with help from OLI. Please make sure the hardware key is attached and then click the Restore Hardlock Key button.

The following dialog will be displayed.

The number displays as the Unlock Code (in our example 483504044) needs to be sent to OLI Systems. Use the Technical support Email address below to send the code.

After OLI Received the unlock code, we run a small utility to create the restore code.

We then send the Key Restore Code back to you which you then enter into the Hardlock Restore Code Box.

Click the OK button and the success message is displayed.

Click OK to close the dialog. You now need to close the OLI software to allow the changes to take effect.

Return to Hardlock Errors
Return to Top

Missing Hardlock device

If you have forgotten to attach your hardware key (dongle) to your computer you may receive this error message:

Hardlock Error(19): Cannot acquire port

This usually means that the USB key is not attached to your computer. Please attach the key and close and restart the software.

Return to Hardlock Errors

Return to Top

Static Security Provider Errors

Manual Hardlock Driver Repair

There are several problems that can can result in errors in the Static Security Provider. A typical error message looks like this:

On stand-alone versions of the software (those with "PH" type hardware keys) the most common reason for the error is that the hardlock drivers did not properly install when installing the software. If you are running a network version of the software then the most common reason for the error is that you have lost connection to the computer hosting the OLI Network License Server.

Hardlock Driver Repair

Stand-alone installations: Manually Repair Hardlock Installation

The first thing you should try when you receive this type of error message is to reinstall the software as the administrator. It is important to note that you may have to log off your network login and login with out the network as the administrator. If you do not know how to do this or are not permitted to do this, contact your IT department.

If re-installing the software as the administrator fails to resolve the issue, you may wish to manually repair the hardlock installation. First plug in the device to a USB port. Close out of the automatic hardware installation if it has started. Then you will need to change to the following folder:

C:\Program Files\Common Files\OLI Systems\Hardlock

Notice that the folder of interest is in the "Common Files" tree on your computer and not the same location as the software. In this folder is a batch file with the name:

OLIHardlockRepair.bat

If you are not displaying the file extensions you may need to look for the file type which will be "MS-DOS batch file"

Double-click this file and wait. You will see several "Command" prompt windows appear and then disappear.

If no error messages are displayed, please try to start the OLI software.

Return to Static Security Errors

Return to Top

Registry Settings

The OLI Systems Security model requires that some values be recorded in your computer's registry. From time to time you will need to provide OLI with the contents of your registry for diagnostic purposes. When you first install the OLI software, the OLI installation program will update the section of the registry called "Local Machine." These settings are designed for all users of this computers. Any updates you make to the software such updated serial numbers will be placed in "Current User"

To provide OLI with the contents of your registry for debugging purposes you will need to export some of your registry keys. These are small files which are readable by a text editor.

Warning! Modifications to your Registry can cause your computer to become unstable or unusable. Proceed with caution!

This example will assume we are exporting the registry keys for the OLI Analyzers 2.0 program. Use the Start button and select the "Run" command.

This will display the Run dialog. Enter the command "regedit"

This brings up your registry editor. If you have some keys open, please collapse them all till your screen looks similar to the screen below.

Locate the section "HKEY_LOCAL_MACHINE

Scroll down to the section "SOFTWARE"

Expand this section by clicking the "+" and then scroll down to "OLI Systems"

Note: On some Computers that have older OLI Software you may have an older key named "OLI Systems, Inc." avoid expanding this key.

Scroll down to find the software package of interest. In our example this is Analyzer 2.0

We now need to export this registry key. The exported file is a text file with an REG extension. What every you do, do not open this file without instructions from OLI or your IT department. Right-Click this registry key and select the "Export" menu item.

This brings up a standard windows file "save/save as" dialog. Change the file type to "Win9x/NT4 Registration Files" and then provide a name for the file. In this example we chosen the name "Analyzer.reg" and are saving the file on the desktop.

 

Locate the saved registry file. In our example an icon appears on desktop although the file will be wherever you stored it.

Do not double-click this file!!!

Right-click this file and select EDIT. This will bring up a notepad style editor.

The below information is from a computer here at OLI Systems. The circled area is the serial number that was used when the program was first installed. It may no longer be valid but that is allowed. Please send this file to OLI Systems as a compressed file (e.g., ZIP) since OLI's Email system will strip out registry files.

We now need to repeat the steps for the "Current User" settings. Return to the registry editor and once again collapse all the registry keys. Locate and expand the key "HKEY_CURRENT_USER"

 

As before we are going to drill into the registry to export the desired key. Scroll down and expand the "Software" key

Expand the "Software" key until you get to the "OLI Systems" key. Notice that status bar indicates where you are in the registry.

Expand the "OLI Systems" key and export the software package of interest. In our example this is the OLI Analyzers 2.0

This exported key should be sent to OLI as a compressed file. You will notice that if you edit this file that the serial number (outlined below) is quite different from the file above. The serial number is entered into the registry only if the serial number is updated by the user. Normally this is done when a license has been renewed.

These registry files allow OLI to determine if your program was installed correctly or if some third party program has corrupted our installation.

Installing and running the OLI Network License Manager

The OLI Network License Manager is used to control access to the OLI software in a multi user environment. Frequently there are installation issues and run-time issues that disrupt the network.

Follow this link for information on how to install the OLI Network License Manager for version 2.1

To find instructions on how to install and run the older version 2.0 license manager click here:
OLI Network License Manager for version 2.0.25

Follow this link to find instructions on administering the OLI Network License Manager

Return to top

Return to the OLI Support Home Page

   



PHONE  
973.539.4996 main
973.784.3327 sales
973.539.4996 option 2 support

FAX
973.539.5922

ADDRESS
OLI Systems, Inc.
108 American Road
Morris Plains NJ 07950

EMAIL