System installation

Installation and setup procedure must be performed before LiKee can start working. All parts required for installation are included in the distribution package. (When other than the embedded HSQLDB database will be used, the database platform must be installed independently first and database schema created before referencing it in the setup.)

Prerequisites

Libraries activation-1.1.jar mail-1.4.jar must be added to library list of the target application server before installation. (Library location differs by application server. Server restart is usually necessary for library activation).

Direct serial connection to the GSM modem (without Ethernet converter) requires adding libraries RXTXcomm.jar and rxtxSerial.dll to the folder %JAVA_HOME%\bin on MS Windows operating system (32bit). Linux systems require library librxtxSerial.so in folder %JAVA_HOME%/jre/lib/i386.

Database choice

An advantage of the embedded HSQL DB is effortless installation together with LiKee; a disadvantage is a limited performance with growing data volume. Recommended maximum is approx 1.5 mil logging records. That means e.g. 3 monitored URL’s with 5 patterns each, running at test period of 1 minute and storing max 2 months-old data in the database.

Usage of MySQL is recommended for higher demands.

Setup procedure

Install page is always shown in place of the LiKee management pages if the setup procedure was not completed yet. The page contains setup instructions and customization parameters.

  1. Choose database type
    Database platform for configuration and monitoring logs. Keep default "HSQLDB" to use the embedded database HSQL DB. Choice of MySQL requires it to be already installed at the server. Only HSQLDB is part of LiKee distribution. 
    When using MySQL, create an empty database first. Then execute ANT target “release-drop-create-schema” to generate a schema in the database. Set MySQL driver, Hibernate dialect and URL in the file “build-release.properties” first.

  2. Enter "connection string" to the database
    For "HSQLDB", use an absolute path to database folder, prefixed by "jdbc:hsqldb:file:". For MySQL, use appropriate connection string. 

  3. Enter username for access to the database
    Default username for "HSQLDB" is "sa".

  4. Enter password for access to the database
    Default password for "HSQLDB" is empty.

  5. Enter username and password for access to LiKee management pages.
    Only one username and password is used for access to LiKee administration pages. If username and password are left empty, the system will not ask for authentication. When username and password are filled, all management pages will require authentication.