Loading licences

Purpose

To load a valid licence, in order to run the Erudine Behaviour Engine.

Theory

Once you have installed the Erudine Behaviour Engine, you will need a valid licence file (license.lic) to be able to start the Engine. The licence details are contained within the license.lic file and the server.NaCl file. The licence files must be saved in the correct location so that it can be found and validated by the Erudine Behaviour Engine. The licensing requirements may differ depending upon the environment on which you have installed the Erudine Behaviour Engine.

The contents of the licence file are referred to as the licence key.

If this licence file is missing, you will be prompted to apply for a new licence by emailing a Licence Request to Erudine. Once you have been sent a licence file (a text file containing a licence key), you must copy and paste it into the relevant section of the Licence screen. You will then be able to run the Erudine Behaviour Engine successfully, and will not be prompted to apply for a new licence until your current licence expires. See Renewing licences for details.

In this exercise, you will move the existing licence file from your machine to another location. This is to simulate a situation where no licence exists. You will then request a new licence key, load it on to your machine and run the Erudine Behaviour Engine.

The process of requesting a new licence key and loading it is the last part of the installation process, which is described in [int:Installing on to a Microsoft Windows environment] and Installing on a Unix or Linux environment.

Actions

To load a licence:

1. Open My Computer.
   
2. Navigate to one of the following locations to find the licence file, which is called license.lic:
   
   • C:\Documents and Settings\<user name>\Application Data\erudine\Server\license
     
   • /var/erudine/server/license
     
3. Move the licens e.lic file and the server.NaCl file into a temporary location. If you complete this exercise successfully, then you can delete these files at the end of the exercise. If you do not complete the exercise successfully, then you should move these files back to their original location.
   
4. Start the Erudine Behaviour Engine by either:
   
   • Clicking the Start button of the Taskbar and selecting All Programs > Erudine > Erudine Behaviour Engine , if you are using Windows.
     Or
     
   • Entering startErudine.sh at the command prompt, if you are using Unix/Linux.
     The Licence screen is displayed.
     
5. Enter your Company Name and Contact Name into the boxes.
   
6. Click the Send Email button.
   An email is displayed containing the details you just entered.
   
7. Send the email to Erudine, so that a valid licence key can be sent to you.
   You will receive an email from licence@erudine.com containing a valid licence.
   Note: If you send your email within office hours, you will receive a reply within 1 hour.
   
8. Copy and paste the licence key from the email into the Licence screen, using CTRL + C and CTRL + V.
   
9. Click the Load Licence button.
   
10. Click OK at the confirmation message.
    
11. Click OK at the next message, which confirms that you have a valid licence.
    

Once the validation is complete, the knowledge model screen is displayed and you can start using the Erudine Behaviour Engine.

Platform: all
EBE Version: 2.4
Category: Administrator Guide
Author: Colin Froggatt