Deploying and Configuring with Apache Tomcat | ||
---|---|---|
Previous | Next | |
Deployment and Configuration Overview | Deploying and Configuring with JBoss |
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.
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)
To install the Oracle JDBC driver:
ojdbc6.jar
) in the
<tomcat>/lib
directory.
This configuration is required for mail notifications using JEE Mail Session.
To install the Java Mail Libraries:
temp/geronimo-javamail_1.4_mail-1.8.3.jar
file in the
<tomcat>/lib/
folder
To configure the Semarchy administrator user:
<tomcat>/conf/tomcat-users.xml
file.
<tomcat-users>
section, add the following line:
<user username="semadmin" password="<semadmin_password>" roles="semarchyConnect,semarchyAdmin"/>
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.
To deploy the application:
semarchy_war_only.zip
file in the
temp/
folder.
http://<tomcat_host>:<tomcat_port>/manager/
).
temp/semarchy.war
file.
The Semarchy application is uploaded and deployed in the server.
To configure the repository datasource:
<tomcat>/conf/Catalina/localhost/semarchy.xml
file.
<context>
configuration element, search the
jdbc/SEMARCHY_REPOSITORY datasource and edit the following parameters:
jdbc:oracle:thin:
@
<oracle_instance_hostname>:<oracle_listener_port>:<oracle_service_name>
<repository_user_name>
<repository_user_password>
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:
<tomcat>/conf/Catalina/localhost/semarchy.xml
file.
<context>
configuration element, copy and un-comment the datasource sample definition called
jdbc/DATA_LOCATION_1.
jdbc/<data_location_datasource_name>
jdbc:oracle:thin:
@
<oracle_instance_hostname>:<oracle_listener_port>:<oracle_service_name>
<data_location_user_name>
<data_location_user_password>
semarchy.xml
file.
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.
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.
This configuration is required for mail notifications using JEE Mail Session.
To configure JavaMail Session:
<tomcat>/conf/Catalina/localhost/semarchy.xml
file.
<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"
/>
To test the application:
http://<tomcat_host>:<tomcat_port>/semarchy/
.
The Semarchy Convergence for MDM Login page appears.
Tip: Proceed directly to the Installing the Repository task.
Previous | Top | Next |
Deployment and Configuration Overview | Deploying and Configuring with JBoss |