Semarchy xDM System requirements

Before installing Semarchy xDM, you should review the system requirements and certifications to ensure that your environment meets these requirements.

Application Server

The Semarchy xDM server runs as a Java application in a supported application server, on physical or virtual machines.

Supported Java Versions

The Semarchy xDM application only supports Java 11 and 17 (LTS).

Java versions 8, 9, 10, 12, 14, and 15 (Non-LTS) are not supported.

The JAVA_HOME (for a JDK) or JRE_HOME (for a JRE) environment variable must be configured to point to a supported Java version.

Semarchy xDM supports the following Java Runtime Environments (JRE) or Java Development Kits (JDK):

  • Open JDK

  • Eclipse Temurin Open JDK

  • Oracle JDK

  • Amazon Corretto (not supported for Apple M1 platforms)

Supported Application Servers

The Semarchy xDM application is certified with the following Apache Tomcat application server versions:

  • Apache Tomcat 9.0.x

  • Apache Tomcat 8.5.x

As a JEE web application, Semarchy xDM may alternatively be installed on the following application servers:

  • Eclipse Jetty 9.4

  • IBM Websphere Liberty Profile 18.x, 19.x, 20.x

  • Wildfly 17.x, 18.x, 19.x

  • GlassFish 6.1+

  • Oracle WebLogic 14c

Single deployment per application server instance

Because of its startup configuration mechanism, Semarchy does not support multiple deployments within the same application server in a different context. For example, on a same Tomcat server, a http://host:80/semarchy/ deployment for production and a http://host:80/semarchy_test/ deployment for testing new releases is not supported.

Only one Semarchy xDM application may be deployed in each application server instance. In the previous example, each Semarchy instance must be deployed in a different Tomcat instance, for example, http://host:80/semarchy/ for production and http://host:81/semarchy_test/ for testing new releases.

Memory Recommendations

The following recommendations apply to the application server tier:

  • The maximum memory allocation pool (-Xmx) of the Java virtual machine running the application server should be set to at least 4Gb.

  • The operating system running the application server should have at least 8Gb of RAM.

The hardware and software requirements depend on the Application Server. Refer to your application server documentation for more information.

Database Server

The Semarchy xDM repository and data locations are certified for the database engines and versions listed below.

Oracle

Oracle Express, Standard or Enterprise edition, running on-premises or in the cloud:

  • Oracle Database 21c

  • Oracle Database 19c

  • Oracle Database 18c

  • Oracle versions listed above running on Amazon RDS

PostgreSQL

PostgreSQL, running on premises or in the cloud:

  • PostgreSQL version 14: 14.x

  • PostgreSQL version 13: 13.x

  • PostgreSQL version 12: 12.x

  • PostgreSQL version 11: 11.x

  • PostgreSQL versions listed above running on Amazon RDS

  • PostgreSQL versions listed above running on Amazon Aurora

  • PostgreSQL versions listed above running on Azure DB for PostgreSQL

  • PostgreSQL on Google Cloud Platform (Cloud SQL)

Microsoft SQL Server

Microsoft SQL Server, running on-premises or in the cloud:

  • Microsoft SQL Server 2019: v15.0

  • Microsoft SQL Server 2017: v14.0

  • Microsoft Azure SQL Database

  • Microsoft SQL Server versions listed above running on Amazon RDS

  • Microsoft SQL Server on Google Cloud Platform (Cloud SQL)

Memory Recommendations

The following recommendations apply to the database tier:

  • The machine running the database tier should have at least 4 CPUs and 16Gb of RAM. You should plan for more CPUs when using database parallelism.

  • For Oracle, the SGA size should be 8Gb or above, depending on the number of records.

  • For PostgreSQL, the Cache size should be 8Gb or above, depending on the number of records.

The hardware and software requirements depend on the database server type, the number of records processed, and the type of processing performed in the database. Refer to your database server documentation for more information and tuning recommendations.

Client & Browsers

The browsers supported for the Semarchy xDM web user interfaces are listed below:

  • Google Chrome 68 and later (incl. Chrome for Android)

  • Firefox 61 and later, Firefox ESR 60 and later

  • Microsoft Edge 42 and later

  • Safari 11 and later (macOS and iOS)

Browser changes and automatic upgrades may introduce issues when working with Semarchy xDM. Please review the release notes for an updated list of known issues on a specific browser or version.

License

A newly installed Semarchy xDM instance runs for a limited time - the grace period - without a license. Within that grace period, you should request an evaluation license from Semarchy to activate that instance.

When the grace period is over, the instance stops working: the applications, as well as the data stored in Semarchy xDM, is no longer available, and incoming data is no longer processed. The data stored in the hub is preserved as-is.

Refer to Manage the License for more information and detailed instructions to activate an instance and manage the license.