Built by Maven

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.2
├── echobase.properties           (1) embedded application config file
├── echobase-embedded-4.2.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.