Skip to content

Task installing egeria

Installing Egeria

Change to the top level egeria directory where your local copy of egeria.git is downloaded to.

The egeria build process creates the distribution files for Egeria in the open-metadata-distribution module. To see its contents, use the following cd command to change to the target directory:

cd open-metadata-distribution/open-metadata-assemblies/target
List the files:
ls -l
The name of the files is determined by the release level of the code that you downloaded from GitHub. In this example, the release is egeria-3.8-SNAPSHOT. The files in this list will also change as Egeria develops.
antrun                                                  egeria-3.8-SNAPSHOT-distribution
archive-tmp                                             egeria-3.8-SNAPSHOT-distribution.tar.gz
egeria-3.8-SNAPSHOT-deploy                              open-metadata-assemblies-3.8-SNAPSHOT-javadoc.jar
egeria-3.8-SNAPSHOT-deploy.tar.gz                       open-metadata-assemblies-3.8-SNAPSHOT-sources.jar
The install image tar file is {{release}}-distribution.tar.gz or egeria-3.8-SNAPSHOT-distribution.tar.gz in this example.

Create a directory for the install and copy the tar file into it. The two commands shown below create an install directory at the same level in the file system as the egeria build library and then copies the egeria distribution file into it.

mkdir ~/egeria-install
cp egeria*-distribution.tar.gz ~/egeria-install

These next commands change to the new directory and lists its contents.

cd ~/egeria-install
ls
egeria-3.8-SNAPSHOT-distribution.tar.gz

It is now possible to unpack the tar file.

tar -xf egeria*-distribution.tar.gz
A new directory is created called egeria-omag-3.8-SNAPSHOT. Change to this new directory and list its contents as shown below.

cd egeria-omag*
ls
LICENSE                 content-packs           samples                 user-interface
NOTICE                  keystore.p12            server                  utilities
conformance-suite       sample-data             truststore.p12

As before, you may notice different files as Egeria evolves.

Under server is a directory for the OMAG Server Platform that is used to run open metadata and governance services. This is the server-chassis-spring-3.8-SNAPSHOT.jar.

ls server
lib             server-chassis-spring-3.8-SNAPSHOT.jar
The lib directory is where the jar files for connectors, samples and new registered services are installed. The initial list includes the connectors that are located in the egeria.git repository.
ls server/lib
audit-log-console-connector-3.8-SNAPSHOT.jar
audit-log-event-topic-connector-3.8-SNAPSHOT.jar
audit-log-file-connector-3.8-SNAPSHOT.jar
audit-log-slf4j-connector-3.8-SNAPSHOT.jar
avro-file-connector-3.8-SNAPSHOT.jar
basic-file-connector-3.8-SNAPSHOT.jar
cohort-registry-file-store-connector-3.8-SNAPSHOT.jar
configuration-encrypted-file-store-connector-3.8-SNAPSHOT.jar
configuration-file-store-connector-3.8-SNAPSHOT.jar
csv-file-connector-3.8-SNAPSHOT.jar
data-folder-connector-3.8-SNAPSHOT.jar
discovery-service-connectors-3.8-SNAPSHOT.jar
dynamic-archiver-connectors-3.8-SNAPSHOT.jar
elasticsearch-integration-connector-3.8-SNAPSHOT.jar
files-integration-connectors-3.8-SNAPSHOT.jar
governance-action-connectors-3.8-SNAPSHOT.jar
governance-services-sample-3.8-SNAPSHOT.jar
graph-repository-connector-3.8-SNAPSHOT-jar-with-dependencies.jar
inmemory-open-metadata-topic-connector-3.8-SNAPSHOT.jar
inmemory-repository-connector-3.8-SNAPSHOT.jar
kafka-integration-connector-3.8-SNAPSHOT.jar
kafka-open-metadata-topic-connector-3.8-SNAPSHOT.jar
omrs-rest-repository-connector-3.8-SNAPSHOT.jar
open-lineage-janus-connector-3.8-SNAPSHOT.jar
open-metadata-archive-directory-connector-3.8-SNAPSHOT.jar
open-metadata-archive-file-connector-3.8-SNAPSHOT.jar
open-metadata-security-samples-3.8-SNAPSHOT.jar
openapi-integration-connector-3.8-SNAPSHOT.jar
openlineage-integration-connectors-3.8-SNAPSHOT.jar
spring-rest-client-connector-3.8-SNAPSHOT.jar

Copy the jar files for any additional connectors not added by default into the lib directory. The connectors available for Egeria are listed in the Connector Catalog.

Back to top