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
- Administration services and
- Open metadata and governance services.
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.