Welcome to Semarchy.

This tutorial shows you how to set up Semarchy xDM on Microsoft Azure to run the tutorials available on the Semarchy website.

What you'll learn

• Launch xDM from the Azure Marketplace
• Log into xDM
• Create a Repository

What you'll need

• Access to the Internet
• A Browser, such as Chrome or Firefox.
• An Azure account

The Semarchy xDM architecture includes the following components:

• A web browser. The Application Builder and data steward applications run in a browser such as Google Chrome, Firefox, Safari or Microsoft Edge.
• A Java EE Application Server (Tomcat, Oracle WebLogic, Glassfish, etc) running the Semarchy xDM Application.
• A database instance (Oracle, PostgreSQL or SQL Server) containing the Repository (where xDM stores its metadata) and one or more data locations (where xDM stores your organization's data).

xDM on Azure 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.

While xDM on Azure Marketplace is perfect for completing tutorials, it is not suitable for production. For production configurations, you should use the Semarchy xDM Solution Offer.

Semarchy xDM is available as a standalone Virtual Machine Offer in the Azure Marketplace. In this step, we will create an Virtual Machine from this offer.

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

☆ For Advanced Users

• You must launch a virtual machine based on the Semarchy Virtual Machine Offer.

If you're familiar with the Azure portal, you are welcome to launch this instance from the Portal rather than from the Azure Marketplace. Then proceed to the next step, Connect to xDM.

Find xDM on the Azure Marketplace

First, find the Semarchy xDM product in the Azure Marketplace:

1. Click the button below to navigate to Azure Marketplace.
   xDM on Azure
2. Click the GET IT NOW button.

3. On the Create this app in Azure page, select the latest version of Semarchy xDM, review the Terms and Conditions, and then click the Continue button.

4. Click the Create button to enter the configuration wizard.

Configure and Launch the Virtual Machine

1. On the Create a virtual machine page, in the Basics tab, select or create the Resource group into which the virtual machine and its associated resources are created.
2. Provide a Virtual machine name. Note that this name is used in the default password for the Semarchy xDM users.
3. Select a Region and Size for the virtual machine. Note that the default Standard B2s size selected is sufficient for the tutorials.

4. Configure the virtual machine administrator account. Enter the Username and then select whether this user will connect using a Password or an SSH Key (you must provide the SSH Public Key, and will need the corresponding private key to connect).

5. Leave all settings by default in the Disks configuration and click on Next for the Networking step.
6. In the Networking step, review the network configuration. The wizard will create the network resources, including the Network security group to connect the machine.

7. Leave all settings by default in the Management and Advanced steps and move to the Tags steps.
8. In the Tags step, optionally add tags that will help you identify the resources created for the virtual machine.

9. Go to the Review + create step to review your configuration.

10. Click the Create button to create the virtual machine. The deployment starts as a background task.
11. A notification appears in the Azure Portal when the deployment completes. Click Go to resource to view the deployed virtual machine.

Check that the Virtual Machine is Started

1. In the Virtual machine page, check that the Status of the virtual machine is Running.

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 or hostname and log in as semadmin.

Follow the detailed steps below:

1. In the Virtual machine page, take note of the values in the Public IP address and Computer name fields.

• The Public IP address is the machine address on the Internet.
• The Computer name is used in the default password for all the user logins (semadmin, businessuser, datasteward, etc) that you will use during the tutorials to connect xDM. Note that this computer name is only visible from the Azure Portal.

2. Copy the Public IP address and paste it in the address bar of a new browser tab.
3. Wait until the browser opens the xDM welcome page (this can take between one and two minutes). You should bookmark this page.
4. On the welcome page, scroll down and click the LOGIN button at the bottom of the Start Here card.

5. If the installation of Semarchy xDM is still in progress, the following page opens.

Refresh the page until the Semarchy xDM Login page opens.

6. Enter these values:

• User name: semadmin
• Password: semadmin-<your virtual machine computer name> (semarchy-xdmtest in the example shown previously)

7. The Semarchy xDM Welcome Page opens.

Congratulations. You successfully installed Semarchy xDM using Semarchy's Azure 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