Deploy Semarchy xDM to Jetty

This page explains how to configure and deploy Semarchy xDM to a Jetty application server.

On this page, <jetty_home> refers to the Jetty server installation folder.

For more details about the deployment and configuration processes in Jetty, see the official Jetty documentation.

Install additional libraries

JDBC drivers

Install the JDBC drivers to connect the repository and data location databases, as well as the additional drivers required for the databases accessed by the xDM Dashboard charts and dashboards, or profiled by xDM Discovery.

To install the JDBC drivers:

  1. Copy the appropriate database driver file from temp/mdm-server/additional-libraries/ to the <jetty_home>/lib/ext directory.

  2. Copy additional drivers to the same directory.

Configure a JavaMail session

  1. Edit the <jetty_home>/etc/jetty.xml file and add the new JavaMail resource as described in the template below.

<New id="mail" class="org.eclipse.jetty.plus.jndi.Resource">
     <Arg><Ref refid="wac"/></Arg>
     <Arg>mail/Session</Arg>
     <Arg>
       <New class="org.eclipse.jetty.jndi.factories.MailSessionReference">
         <Set name="user"><mail_user_name></Set>
         <Set name="password"><mail_user_password></Set>
         <Set name="properties">
           <New class="java.util.Properties">
             <Put name="mail.transport.protocol">smtp</Put>
             <Put name="mail.smtp.host"><mail_server_host></Put>
             <Put name="mail.smtp.port"><mail_server_port></Put>
             <Put name="mail.from"><mail_from_user_name></Put>
             <Put name="mail.debug">true</Put>
             <!-- Adjust the default settings below to specify timeout durations.
             For an SMTP server:
               <Put name="mail.smtp.connectiontimeout">30000</Put>
               <Put name="mail.smtp.timeout">30000</Put>
               <Put name="mail.smtp.writetimeout">30000</Put>
             For an SMTPS server:
               <Put name="mail.smtps.connectiontimeout">30000</Put>
               <Put name="mail.smtps.timeout">30000</Put>
               <Put name="mail.smtps.writetimeout">30000</Put> -->
           </New>
          </Set>
       </New>
     </Arg>
</New>

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.

To deploy the application:

  1. Copy the temp/mdm-server/semarchy.war file to the <jetty_home>/webapp/ folder.

  2. Open a command line in the <jetty_home> folder and then run java -jar start.jar to start the Jetty server.

The Semarchy xDM application is deployed and the server is started.

Test the application

To test the application:

  1. Open a web browser.

  2. In the URL, enter: http:/<jetty_host>:<jetty_port>/semarchy/.