Deploy Semarchy xDM

The Semarchy xDM server is a Java EE application that can be deployed to various environments. It requires a Java EE applications server (such as Tomcat, JBoss/WildFly, etc.). This page details the steps required to configure the application server and deploy the application in the application server.

The instructions provided describe a generic method to configure the application server:

The method may vary depending on the application server version. For up-to-date instructions and instruction details, see the application server documentation.
This method also may vary depending on the best practices used in your information system. Contact the application server administrator and review these instructions to adapt them to your practices.

Conventions

For the purpose of this deployment procedure, the following variables names are used in the tasks:

The semarchy-mdm-install-<version>.zip file refers to the xDM - Server Installation file you have downloaded to install Semarchy xDM. The name of this file varies as it includes the Semarchy xDM version and build number.
The temp folder refers to a temporary folder of your choice.

Configure the datasources

Semarchy xDM does not rely on JNDI datasources defined at the application-server level:

Two datasources—a repository datasource and a repository read-only datasource—defining the connections to the repository are required for the application to start. They are configured as part of the startup configuration.
Other datasources, such as those required to deploy data locations, are configured in the Semarchy xDM platform after the installation is complete.

Make sure to install the JDBC drivers of a database system before configuring a connection to this system. Refer to the instructions for each application server to install a JDBC driver.

Configure a JavaMail session

Semarchy xDM uses email servers, for example to send email notifications. For email features to work, you must configure an email notification server.

A notification server can be configured either:

By configuring the SMTP connection to the mail server in Semarchy xDM.
By referring to a JavaMail session resource configured in the application server.

If a JavaMail session resource is already configured in the application server, you can skip these steps. You can reuse the existing JavaMail session resources when configuring the notification server.

Configure an HTTP proxy

Components of Semarchy xDM act as HTTP clients. These components include the REST clients, the HTTP notification servers, the License synchronization process, and the built-in plugins using internet-based services.
Depending on your enterprise network configuration, these HTTP client components may need to use a proxy to access the servers they need to connect to.

You can configure the proxy for the application server using system properties.

These system properties include:

http.proxyHost or https.proxyHost: the hostname of the proxy server.
http.proxyPort or https.proxyPort: the proxy server port number (default: 80 or 443).
http.nonProxyHosts: list of hosts that can be reached without the proxy. This list of patterns is separated by |.

For a complete list of proxy parameters, see the reference documentation.

Download Semarchy xDM

The xDM Server Installation package (semarchy-mdm-install-<version>.zip) contains Semarchy xDM passive and active web application archive (WAR) files to deploy in an application server.

Visit the Download archives page of the Semarchy website.
In the xDM - Server Installation section, select the desired version to download the package.
Extract the downloaded file into the temp folder.

The table below lists the contents of this file for reference.

Table 1. *Semarchy xDM - Server Installation* file content
File/Folder	Description
`README.txt`	File describing the package
Installation files for Semarchy xDM `mdm-server/`
`semarchy.war`	Semarchy xDM deployable WAR file.
`semarchy-passive.war`	Semarchy xDM deployable WAR file for passive instances. Use this version for deploying xDM in an existing supported application server for high availability.
Sample configuration files `mdm-server/samples/`
`setenv_sample.bat`	Sample startup configuration using environment variables set in the Tomcat configuration file (Windows).
`setenv_sample.sh`	Sample startup configuration using environment variables set in the Tomcat configuration file (Linux/Unix).
`config_sample.properties`	Sample startup configuration file using properties.
`log4j.semarchy.properties`	Sample startup logging configuration.
`semarchy.xml`	Sample configuration for Apache Tomcat.
JDBC Driver and Additional libraries `mdm-server/additional-libraries/`
`ojdbc8.jar`	Oracle JDBC driver for Oracle Database version 12c. If you are using an older Oracle version, it is recommended to review the compatibility of this driver with your Oracle database version and possibly install an older driver version instead (ojdbc6 or ojdbc7).
`org.postgresql.jdbc<postgresql_version>.jar`	PostgreSQL JDBC driver.
`com.microsoft.sqlserver.mssql-jdbc_<version>.jar`	SQL Server JDBC driver.
`com.sun.mail.jakarta.mail_<version>.jar`	Library to install to enable JavaMail for Apache Tomcat. Ignore this file if you are using a different application server.
`com.sun.activation.jakarta.activation_.jar` `com.sun.istack.commons-runtime_.jar` `com.sun.xml.fastinfoset.FastInfoset_.jar` `jakarta.jws-api_.jar` `jakarta.xml.bind-api_.jar` `jakarta.xml.soap-api_.jar` `org.apache.servicemix.specs.jaxws-api-.jar` `org.glassfish.jaxb.runtime_.jar` `org.glassfish.jaxb.txw2_.jar` `org.jvnet.staxex.stax-ex_.jar` `org.glassfish.jakarta.json_*.jar`	Additional libraries required for Tomcat.

Deploy the application

Startup checklist

For the Semarchy xDM application to start correctly, make sure that your application server environment is correctly set up.

The repository and the data locations database schemas are created.
The driver libraries are installed in the application server.
The startup configuration is set to connect the repository schema.
For an initial startup, the setup token environment variable is set to be able to authenticate and create the repository.

The application is deployed by default with the semarchy context. Therefore it is accessible on the application server on the following URL: http://<application_server_host>:<application_server_port>/semarchy/.

During the application deployment, it is possible to use a different context than semarchy. If you use a different context, make sure to take it into account in the URL to test and connect to the application.