Deploying and Configuring with Apache Tomcat

This section explains how to configure and deploy the Semarchy Convergence for MDM Application with Apache Tomcat.

In this section, <tomcat> refers to the Apache Tomcat installation folder.

Note: Refer to the Tomcat Documentation for more details about the deployment and configuration processes for Apache Tomcat.

Installing Additional Libraries

Note: Before adding libraries, you must stop the Apache Tomcat server using <tomcat>/bin/shutdown.bat (Windows) or <tomcat>/bin/shutdown.sh (UNIX/Linux).
Similarly, after installing the libraries, restart the Apache Tomcat server using <tomcat>/bin/startup.bat (Windows) or <tomcat>/bin/startup.sh (UNIX/Linux)

Installing the Oracle JDBC Driver

To install the Oracle JDBC driver:

  1. Copy the oracle driver file ( ojdbc6.jar) in the <tomcat>/lib directory.

Installing the Mail Session Libraries

This configuration is required for mail notifications using JEE Mail Session.

To install the Java Mail Libraries:

  1. Copy the temp/geronimo-javamail_1.4_mail-1.8.3.jar file in the <tomcat>/lib/ folder

Configuring the Security

To configure the Semarchy administrator user:

  1. Stop the Apache Tomcat server.
  2. Edit the <tomcat>/conf/tomcat-users.xml file.
  3. In the <tomcat-users> section, add the following line:
  4. Save the file.
  5. Restart the Apache Tomcat server.

This operation adds to Apache Tomcat a semadmin user with its password. This user has full privileges to the Semarchy application. Make sure to use a strong password for this user.

Deploying the Application

To deploy the application:

  1. Uncompress the semarchy_war_only.zip file in the temp/ folder.
  2. Connect to the Apache Tomcat Manager ( http://<tomcat_host>:<tomcat_port>/manager/).
  3. In the Deploy War File section, click the Select File button , then select the temp/semarchy.war file.
  4. Click the Deploy button.

The Semarchy application is uploaded and deployed in the server.

Setting Up the Datasources

Tip: It is recommended to keep a backup copy of the semarchy.xml file. If you un-deploy the application, this file is removed and the changes performed are lost.

To configure the repository datasource:

  1. Edit the <tomcat>/conf/Catalina/localhost/semarchy.xml file.
  2. In the <context> configuration element, search the jdbc/SEMARCHY_REPOSITORY datasource and edit the following parameters:
  3. Save the semarchy.xml file.

Important: Do not change the name of the SEMARCHY_REPOSITORY datasource. The application refers to a datasource with this name for the repository.

To configure a data location datasources:

  1. Edit the <tomcat>/conf/Catalina/localhost/semarchy.xml file.
  2. In the <context> configuration element, copy and un-comment the datasource sample definition called jdbc/DATA_LOCATION_1.
  3. Rename and edit the copy of the datasource settings with the following parameters:
  4. Repeat the two previous steps for each data location’s datasource.
  5. Save the semarchy.xml file.

If you want to use the Convergence for MDM dashboards powered by Convergence Pulse Metrics configure the Pulse Metrics Warehouse datasource.

To configure the Pulse Metrics Warehouse datasource:

  1. Edit the <tomcat>/conf/Catalina/localhost/semarchy.xml file.
  2. In the <context> configuration element, search the jdbc/SEMARCHY_PULSE_METRICS datasource and edit the following parameters:
  3. Save the semarchy.xml file.

Important: Do not change the name of the SEMARCHY_PULSE_METRICS datasource. The application refers to a datasource with this name for the Pulse Metrics Warehouse.

The repository and data location datasources are now configured, pointing to the schemas previously created.

Note: Depending on the Tomcat server configuration, you may have to restart the Semarchy application for refreshing the application configuration with your changes.

Configuring JavaMail Session

This configuration is required for mail notifications using JEE Mail Session.

To configure JavaMail Session:

  1. Edit the <tomcat>/conf/Catalina/localhost/semarchy.xml file.
  2. In the <context> configuration element add the entry given below and then save the semarchy.xml file. Change the entry below to match your SMTP server configuration.
<Resource name="mail/Session" auth="Container" type="javax.mail.Session" 
 mail.smtp.host="<mail_server_host>" 
 mail.port="<mail_server_port>"
 mail.smtp.user="<mail_user_name>"
 mail.transport.protocol="smtp"
 password="<mail_user_password>"
 mail.smtp.auth="true"
/>

Testing the Application

To test the application:

  1. Open a web browser.
  2. In the URL, enter: http://<tomcat_host>:<tomcat_port>/semarchy/.

The Semarchy Convergence for MDM Login page appears.

Tip: Proceed directly to the Installing the Repository task.