Licensing Procedure

Step 1: Determine the Host Id string for the server system. 1

Each Verj.io Server system requires a licence to operate. This document describes the procedure to obtain and install the licence file.

Note that the Studio does not require a licence to operate. The Embedded Test Server supplied with the Studio does require a licence, however the licence included with the distribution supports up to 2 concurrent users which should be enough for most development requirements.

You will need to follow this procedure in any of the following circumstances:

You need a new licence to increase the number of concurrent users
A new installation of the Verj.io Server
An upgrade to the server system hardware which results in a change to the MAC Address, e.g. replacement of the network card

In this document, $VERJIO_HOME refers to the directory where the Verj.io Server has been installed.

Step 1: Determine the Host Id string for the server system

Start the Server Administration Application either from a designer or using URL http://<hostname>:<port>/<webapp>/ebaseAdmin.eb, click License under Information on the home page, then click the Get host id for this server button.

If for any reason you don’t have access to the Server Administration Application, you can obtain the host id as follows:

Windows systems

Install the Verj.io Server if not already done
Open a DOS Command Window and cd to the $VERJIO_HOME/licence
Enter command: licencecheck

The system will respond with “Ebase licence string: …………”

Linux and Unix systems

Install the Verj.io Server if not already done
cd to directory $VERJIO_HOME/licence
Enter command: licencecheck.sh

The system will respond with “Ebase licence string: …………”

Linux and Unix systems important notes:

The licencecheck command runs a standalone Java program that requires Java 1.4 or higher to run. If a lower level of Java is used, it will fail with message:

Exception in thread "main" java.lang.UnsupportedClassVersionError:

com/ebasetech/ufs/licence/GetHostId (Unsupported major.minor version 48.0)

The licencecheck procedure issues operating system commands, and these can fail if access to these commands is restricted. In Linux and Unix systems this can be overcome by running licencecheck as root. However, the same checking procedure is also used by the Verj.io Server during its startup checks, therefore access to the operating system commands will also be needed at this point.

Note that for application servers where Verj.io is supplied as a .war or an .ear file, the admin directory can be copied separately to the target server system. In addition, the licencecheck.bat or licencecheck.sh scripts may need to be adjusted to set the JAVA_HOME variable.

Step 2: Obtain the licence file

Complete the licence application form (in VerjioServer/licence/licenceform.doc) and email it to Neumann Systems at [email protected].

Include the following information:

Your Name:
Customer Name:
Your Email Address:
Verj.io Version:	Which version of Verj.io do you require the licence file for?
Host Id:	Licence string obtained from step 1 above
System Type:	Development, Test or Production (see below)
System Id:	A unique id for this instance (this is optional)

The system types have the following characteristics:

Development:

Allows use of designer and runtime, restricted by number of concurrent users.

Test:

Use of designer and runtime is unrestricted but all HTML pages contain an additional header:

* T E S T * T E S T * T E S T * T E S T * T E S T * T E S T *

Production:

Allows unrestricted use of designer and runtime.

Step 3: Install the licence file

Copy the supplied licence file ebaselicence.properties to the ebaseConf folder within the Verj.io web application. For Tomcat and Jboss/Tomcat systems this will normally be <userdata>/app/<webappname>/ebaseConf.

Note that the licence file must not be renamed or modified in any way. Licence files cannot be copied between server systems.

Step 4: Start the Verj.io Server

This concludes the licence installation procedure.

Additional Notes:

1. For any queries regarding outstanding licence application requests or on the licensing procedure, please send an email to [email protected] or call +44 (0)1767 654987.

2. If you are an existing customer and you have an emergency, e.g. a server is down and you need to start the Verj.io Server on another system, please call +44 (0)1767 654987. An emergency licence can be supplied immediately that will allow the system to operate.