Starting the OMAG Server Platform

The OMAG Server Platform’s installation directory contains a Java Archive (Jar) file for the server platform itself along with a directory of resources.

$ ls
resources				server-chassis-spring-1.8-SNAPSHOT.jar

The name of the Java Archive (Jar) file will depend on the release of ODPi Egeria that you have installed. In this example, the release is 1.8-SNAPSHOT.

The OMAG Server Platform is started with the java command. Ensure you have a Java runtime at Version 8 (Update 151) or above installed on your machine. Check the version of Java you have with the command java -version (You can download Java from AdoptOpenJDK and select OpenJDK 8 (LTS) and the HotSpot version for your operating system. You only need the JRE but select the JDK if you expect to also write some Java code.)

Start the OMAG server platform as follows - the -Dserver.port option is needed if you want multiple instances running on different ports, as required by the tutorials.

$ java -Dserver.port=8080 -jar server-chassis-spring-1.8-SNAPSHOT.jar

The OMAG server platform first displays this banner and then initializes itself.

 ODPi Egeria
    ____   __  ___ ___    ______   _____                                 ____   _         _     ___
   / __ \ /  |/  //   |  / ____/  / ___/ ___   ____ _   __ ___   ____   / _  \ / / __    / /  / _ /__   ____ _  _
  / / / // /|_/ // /| | / / __    \__ \ / _ \ / __/| | / // _ \ / __/  / /_/ // //   |  / _\ / /_ /  | /  _// || |
 / /_/ // /  / // ___ |/ /_/ /   ___/ //  __// /   | |/ //  __// /    /  __ // // /  \ / /_ /  _// / // /  / / / /
 \____//_/  /_//_/  |_|\____/   /____/ \___//_/    |___/ \___//_/    /_/    /_/ \__/\//___//_/   \__//_/  /_/ /_/

 :: Powered by Spring Boot (v2.1.2.RELEASE) :: 

When the initialization is complete, you will see this message:

Thu Jan 31 13:15:26 GMT 2019 OMAG server platform ready for configuration

This means your OMAG server platform is running.

If you get an error that the port is in use, check for any applications using the same port. Note that in current versions of zookeeper, an AdminServer uses port 8080 by default - see zookeeper docs

Try the following command (replace 8080 accordingly if using a non standard port):

$ curl -X GET http://localhost:8080/open-metadata/platform-services/users/test/server-platform/origin
ODPi Egeria OMAG Server Platform

This calls the OMAG server platform using a REST API call. The response ODPi Egeria OMAG Server Platform means the curl command communicated with a running OMAG server platform instance.

The OMAG server platform has many REST APIs. Enter localhost:8080/swagger-ui.html into your browser to see the list of available REST APIs.

Broadly speaking, the OMAG server platform supports

The administration services (the ones beginning config and operational) are available all of the time the OMAG server platform is running.

The open metadata and governance services are routed to the OMAG Servers running on the OMAG server platform.

OMAG servers are started on the server platform using a configuration document. This configuration document is both configured and activated in the OMAG server platform using the administration services.

Understanding how to create a configuration document using the administration services is the next task in this tutorial.


License: CC BY 4.0, Copyright Contributors to the ODPi Egeria project.