Welcome to Semarchy.

This tutorial shows you how to set up Semarchy xDM on Google Cloud Platform to run the tutorials available on the Semarchy website.

What you'll learn

What you'll need

The Semarchy xDM architecture includes the following components:

xDM on the Google Cloud Marketplace is launched as a single virtual machine, containing a pre-configured PostgreSQL Database with ready-to-use schemas for the repository and the data locations. It also starts up a Tomcat application server where the Semarchy xDM application is already installed and configured.

Semarchy xDM is available as a standalone Virtual Machine Offer on the Google Cloud Marketplace. In this step, we will create a Virtual Machine from this offer.

This section explains how to launch and connect a Virtual Machine.

Find xDM on the Google Cloud Marketplace

First, find the Semarchy xDM product on the Google Cloud Marketplace:

  1. Click the button below to navigate to the Google Cloud Marketplace.
    xDM on Google Cloud Platform
  2. Click the LAUNCH button.

  1. If the Required APIs page opens, select ENABLE to activate the missing APIs.

Configure and Launch the Virtual Machine

  1. On the New Semarchy xDM - Quick Start VM deployment page, enter a name for the virtual machine in the Deployment name field. Note that this name is used in the default password for the Semarchy xDM users.

  1. Select a Zone that corresponds to your location.
  2. In the Machine type section, select a Series and a Machine type for your virtual machine.

  1. In the Boot Disk section, select a Boot disk size in Gb. Note that a 20GB Standard Persistent Disk is enough for the tutorials.


  1. Leave all other settings by default.
  2. Review the Terms of Service.
  3. Scroll down to the bottom of the page, select I accept the GCP Marketplace Terms of Service and Semarchy Terms of Service, and then click DEPLOY.

  1. The Deployment Manager opens and shows the status of the ongoing deployment.

  1. When the deployment completes, click the generated virtual machine name (xdm-quickstart-vm in the example below) next to Instance in the right panel to open the details of the virtual machine.

Check that the Virtual Machine is Started

  1. In the VM instance details page, check that the instance is running by moving the mouse cursor over the status icon next to the virtual machine name.

Well done. You should now have a running virtual machine built from the Semarchy Virtual Machine offer, which contains a pre-installed Tomcat instance, a preconfigured PostgreSQL with appropriate schemas, and the latest version of Semarchy xDM.

In the next step, you will learn how to connect to xDM and log in.

Now that the virtual machine is running, you can access Semarchy xDM. Browse to the relevant IP address and log in as semadmin.

Follow the detailed steps below:

  1. In the VM instance details page, take note of the Virtual Machine name and the External IP (in the Network interfaces table).

  1. Paste the External IP address in the address bar of a new browser tab.
  2. The xDM welcome page opens. You should bookmark this page.
  3. On the welcome page, scroll down and click the LOGIN button at the bottom of the Start Here card.

  1. The Semarchy xDM Login page opens. Enter the following credentials:

  1. You are prompted to change your password. Enter the same password as previously in the Current Password field, and then enter a new password in the New password and Confirm new password fields. Click CHANGE.

  1. The Semarchy xDM Welcome Page opens.

Congratulations. You successfully installed Semarchy xDM using Semarchy's Google Cloud Marketplace Virtual Machine Offer. You created a new repository and now you're ready to complete the Demo Application tutorials, Data Authoring tutorials, and Data Consolidation tutorials.

Semarchy xDM is now up and running. You can find more details about system requirements and installing xDM in our documentation.

You are now ready to move on to the xDM tutorials where you can learn to design a new application, create matching rules, and much more.

GO TO TUTORIALS