First use

How to use EchoBase?

The application can be run in two different ways:

  • the portable application, which does not require a server

  • the server-borne application which requires to install EchoBase on a tomcat or jetty server.

How to use the portable (embedded) Echobase?

To use the portable Echobase, you just need to install java on your computer.

Windows requirements

Install a Java runtime environment from:

Oracle download page

Linux requirements

Install a Java runtime environment from:

Oracle download page

Installation procedure

If all requirements are fullfilled, it should be very easy:

echobase-embedded-4.0.9
├── echobase.properties           (1) embedded application config file
├── echobase-embedded-4.0.9.war
├── LICENSE.txt
├── README.txt
├── startEchobase.bat             (2) Startup script (windows)
├── startEchobase.sh              (3) Startup script (linux)
└── THIRD-PARTY.txt

  • Run the startEchobase.sh (linux) or startEchobase.bat (windows) script.

The application starts and will be available at:

http://localhost:8888

Detailed installation procedure (windows)

  • Unzip the compressed folder downloaded from Echobase website.

  • Open a console (Windows key + R , type cmd then Enter)

  • Go to the uncompressed folder location by typing:

cd uncompressed folder path

  • Run the script:

startEchobase.bat

  • the console should display startup messages and logs

  • When the application is launched, the internet browser should display the login page.

Detailed installation procedure (Linux)

  • Unzip the compressed folder downloaded from Echobase website.

  • Open a console (Windows key + R , type cmd then Enter)

  • Go to the uncompressed folder location by typing:

cd uncompressed folder path

  • Make the Echobase startup script executable:

chmod +x startEchobase.sh

  • Run the Echobase startup script

./startEchobase.sh

  • the console should display startup messages and logs

  • When the application is launched, the internet browser should display the login page.

Users

By default, two users are created in the portable database:

  • admin / admin (with administration rights)

  • user / user (with data query rights)

Working database configuration

A working database configuration is also created by default, pointing toward an H2 database located in the db folder, with the following credentials:

  • login: sa

  • password: sa

Using Echobase in server mode

The application must be installed on a web server (see the online documentation).

Ask your server administrator for connexion url and login.