semarchy/xdm repository overview

⁠Quick reference

• Maintained by: Semarchy⁠
• Where to get help: Semarchy Community⁠ and Semarchy Support Library⁠.

⁠Version

For the versions available, see the tags on this repository⁠.

⁠Semarchy xDM

Semarchy, a leader in the data integration and master data management markets, enables organizations to rapidly generate business value from their data. Its unified platform enables organizations of any size, to quickly discover, govern, manage, integrate, and report critical information scattered across applications.

Semarchy xDM automates the discovery, management, enrichment, and governance of a data to quickly generate business value. Semarchy xDM is agile and pragmatic allowing organizations to rapidly scale and adapt and its pragmatic approach to management and governance reduces IT administration and overhead. Semarchy xDM is natively available on the most popular cloud marketplaces, including Microsoft Azure, Amazon Web Services (AWS), and Google Cloud Platform (GCP), and also as Software as a Service (SaaS), all with the same features as the on-premises platform.

For more information, visit www.semarchy.com⁠.

⁠Base image

The Semarchy xDM images are using an official tomcat base image⁠ composed of:

• Tomcat version supported by Semarchy xDM⁠
• Base image: Ubuntu (prior to 2025.1.0) and Alpine (2025.x)
• OpenJDK version supported by Semarchy xDM⁠

For example: tomcat:9.0-jdk17-temurin-jammy

⁠Docker Compose Sample

Use the Docker Compose Sample⁠ as a template to create your own Docker Compose file.
The sample configuration describes two containers:

• The Semarchy xDM active server.
• The database instance is based on the official image of PostgreSQL.

Note: This sample refers to a SQL script⁠ that will create the database and initiate the repository.

⁠Usage

To run the application server and database containers you need to:

1. Download the Docker Compose Sample⁠ file.
2. Download the create-schemas.sql⁠ script.
3. Edit those files to adapt the configuration to your requirements.
   For example, edit the environment variable to specify the repository connection, the setup token, or the context path.
4. Run the following command from the location where these two files are: $ docker compose -f <your_docker_compose>.yml up

You can test it by visiting http://<container-ip>:8080/semarchy in a browser.

⁠Tutorials

This Docker Compose creates and starts a complete instance of Semarchy xDM. This instance has a 7-day trial period allowing you to complete the Tutorials⁠ available on the Semarchy website. After that period, you must register⁠ to extend your trial.

⁠Configuration

• Use the environment variables for the Semarchy xDM Startup Configuration⁠ (see details with Docker Compose Sample).
• Use the CATALINA_OPTS options to define System properties.
• Use the JVM_MEMORY_OPTS to set the memory options for the Java Virtual Machine (defaults to -XX:MaxRAMPercentage=75)
• Optionally, third-party libraries can be added by mounting a volume on /usr/local/tomcat/additional-libraries
• Other configurations requiring to modify server.xml or semarchy.xml necessitate creating a custom image⁠ on the Semarchy xDM base image.

⁠Logs

Semarchy xDM logs are redirected to the container log system⁠.

⁠Image Tags

The xdm images are available with different options, each designed for a specific use case.

⁠xdm:latest

This image contains the latest version of Semarchy xDM active server (semarchy.war). See details about Semarchy xDM Architecture⁠.

This is the main image to use for single node implementation and for the active node used in high-availability configurations⁠.

Important: this is not recommended to use the latest tag in production, as it will automatically upgrade to the latest version that Seamrchy is publishing.

Important: this active server image should never be started more than once per repository.

⁠xdm:latest-passive

This is image contains the latest version of Semarchy xDM passive server (semarchy-passive.war) and used only in passive nodes for high-availability configurations⁠

See details about Semarchy xDM Architecture⁠.

Important: this is not recommended to use the latest-passive tag in production, as it will automatically upgrade to the latest version that Semarchy is publishing.

⁠xdm:<minor_version>

This image contains the latest version for a specific minor version of Semarchy xDM active server (semarchy.war).

For example: semarchy/xdm:2025.1

Important: this is not recommended to use the minor_version tag in production, as it will automatically upgrade to the latest patch version that Semarchy is publishing.

⁠xdm:<minor_version>-passive

This image contains the latest version for a specific minor version of Semarchy xDM passive server (semarchy-passive.war).

For example: semarchy/xdm:2025.1-passive

Important: this is not recommended to use the minor_version-passive tag in production, as it will automatically upgrade to the latest patch version that Semarchy is publishing.

⁠xdm:<full_version>

This image contains a specific full version of Semarchy xDM active server (semarchy.war).

For example: semarchy/xdm:2025.1.4

⁠xdm:<full_version>-passive

This image contains a specific full version of Semarchy xDM passive server (semarchy-passive.war).

For example: semarchy/xdm:2025.1.4-passive

⁠License

View license information⁠ for the software contained in this image.