Install Semarchy xDM

This document provides an overview of the steps to install Semarchy xDM.

Installation Process

Before the installation, make sure to understand the Semarchy xDM architecture and review carefully the system requirements.

The Semarchy xDM installation process is as follows:

Download Semarchy xDM

Semarchy xDM ships as two different packages, available from the Semarchy website:

  • xDM - Server Installation (semarchy-mdm-install-xxx.zip).
    This package contains the Semarchy xDM passive and active Web Application Archive (WAR) files to deploy to an application server. Use this package to deploy Semarchy in an existing application server, for complex and clustered configurations.

  • xDM - Preconfigured with Apache Tomcat (semarchy-mdm-preconfigured-xxx.zip).
    This package contains Semarchy xDM with a bundled Apache Tomcat Application Server. Use this package for a trial, or for a simple development setup. You may also want to use this package to avoid installing and configuring an application server.

The xDM - Preconfigured with Apache Tomcat is recommended only for evaluation. The Server Installation package must be used in production in to have more detailed control over its configuration.

Prepare the Infrastructure

Install the infrastructure components required by Semarchy xDM, including:

  • The Java Virtual Machine, required to run the application server.

  • The Application Server to deploy Semarchy xDM. The recommended application server is Apache Tomcat. You can skip this step if using the xDM - Preconfigured with Apache Tomcat package.

  • The Database Server that will host the repository and data locations (PostgreSQL, Oracle or Microsoft SQL Server).

Make sure to review the system requirements to install supported versions of these components.
Installing Semarchy xDM in a Cloud infrastructure does not differ from an installation on-premises. The Java machine and application server should be deployed in a virtual machine resource, and the database server should be one of the supported cloud database engines.

Configure the Database Schemas

Before installing Semarchy xDM, you must create the databases and schemas that will host the repository and data locations, as well as the credentials to access these storages.

You can create these manually or use your database administration interface for this purpose. See Configure the Database Schemas for sample scripts to create these databases, schemas, and credentials.

Define the Startup Configuration

The startup configuration is required to start Semarchy xDM. It provides:

  • The connection information (Repository Datasource and Repository Read-Only Datasource) to connect the repository schema. This information is required to install and access the repository contents.

  • A Setup Token, required to perform the installation and seed the first user in the repository.

See Startup Configuration for instructions on how to define this configuration.

Deploy Semarchy xDM

Deploy in an existing application server the Semarchy xDM Web Application Archive (WAR).
You can skip this step if using the xDM - Preconfigured with Apache Tomcat package.

See Deploy Semarchy xDM for instructions on how to deploy Semarchy xDM to a supported application server.

Create the Repository

Once Semarchy xDM runs, you can proceed and create the repository.

Post-Installation Steps

After the repository creation, you can finalize the installation and perform the post-installation steps.