Local Installation

Monolith comes packaged as a .zip file: Monolith Studio. Extract this file to a new directory on your system.

Monolith needs at least Java 11 to run.

Docker

If you prefer you can use the Dockerfile in order to run Monolith. Just do the following:

  1. Download last release of Monolith Studio
  2. Unzip the folder
  3. Build image: 
    docker build --tag monolith-studio .
  4. Create a folder for the mastro-home in your machine file system or a volume accessible to docker and copy your license files in mastro-home/license
  5. Launch container: 
    docker run --publish 8989:8989 --volume=<volume-name-or-path>:/root/mastro-home monolith-studio

Where <volume-name-or-path> is either a local path to bind to the container’s /root/mastro-home or a volume name, as created with the docker volume create command, e.g.:

docker volume create mastro-home
docker run --publish 8989:8989 --volume=mastro-home:/root/mastro-home monolith-studio
  1. Open browser at http://localhost:8989/monolith

N.B. In order to connect to a datasource which is hosted on the main machine (localhost) you should use the host.docker.internal instead.

MASTRO_HOME

The envoironment variable MASTRO_HOME will tell the system which directory in your file system it should use to store all its files (configuration files, ontology and mapping files, etc.).

By default it is set up in your user home directory.

If you want to place the directoroy somewhere else, according to your operating system, set up the MASTRO_HOME environment variable wherever you like on your file system, and you are ready to go (if you are not sure how to do so, a quick Google search will help you out). Or, you can decide to stick with the default settings, and the MASTRO_HOME will be set up in your user home directory.

Monolith License

To use Monolith, you need to load the license files that we have provided you into the Mastro Home. Therefore, copy the license.info and license.key files into the MASTRO_HOME/license/ folder, and you’re all set.

Installing JDBC Drivers

Monolith uses JDBC connections to interact with specific DBMSs. To install the JDBC Driver for your DBMS, simply copy the driver jar file into the monolith/jdbc/ folder, and, after logging into the application with administrator rights, access the JDBC Drivers tab of the Settings page and add the driver (class name and, optionally, URL template).

For example, to add the MySQL JDBC Driver, you can insert the following parameters:

  • Class name: com.mysql.cj.jdbc.Driver
  • URL template: jdbc:mysql://localhost/

Monolith is distributed with an embedded H2 database for the Books specification. To add the H2 JDBC Driver, type in these parameters:

  • Class name: org.h2.Driver
  • URL template: jdbc:h2:mem:

Currently Monolith has specific support (SQL dialects, connectors, ecc.) for all main commercial and open source DBMSs, including:

  • Oracle
  • SQLServer
  • MySQL
  • MariaDB
  • Cloudera Impala
  • PostgreSQL
  • Denodo
  • DB2
  • Derby
  • SQLLite
  • Impala

For DBMSs not on the list, Monolith provides standard SQL support. Since we are always looking to add more specific SQL dialects, let us know if you have a specific need.

Running the application

Open a command line console and move inside the main directory of the application. To start the Mastro Web Server in Windows systems, double click on the run.bat file in the main directory of the folder, or in OSX/UNIX, double click on the run.command file, or execute from a terminal the following command:

$ ./run.sh

User session timeout is by default set at 5 minutes (or 300000 milliseconds). If you want to increase it, you can change the MWS_SESSION_TIME variable in the run.bat or run.sh scripts.

The server will run on a new system window while the web application will now be accessible at http://localhost:8989/monolith/#/, your default browser will open a new tab on that page once available.

Stop the application

You can stop the application simply closing the server window.

Previous Next