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.1-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.1-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:


$ java -jar server*

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. Try the following command:

$ 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.