Deploying and Configuring with JBoss | ||
---|---|---|
Previous | Next | |
Deploying and Configuring with Apache Tomcat | Deploying and Configuring with GlassFish |
This section explains how to configure and deploy the Semarchy Convergence for MDM Application with JBoss Application Server.
In this section,
<jboss_home>
refers to the JBoss server installation folder.
Note: Refer to the JBoss Documentation for your JBoss version for more details about the deployment and configuration processes in JBoss.
This version of JBoss is configured by default to delete the application working directory when the server is restarted. This behavior is similar to redeploying the original application at server startup. With this behavior, plug-ins added to the Semarchy application disappear when the server restarts.
To prevent this effect, the JBoss 6 configuration needs to be changed.
To configure work directory deletion to false:
<jboss_home>/server/configuration/deployers/jbossweb.deployer/META-INF/war-deployers-jboss-beans.xml
file.
<property name="deleteWorkDirOnContextDestroy">false</property>
To install the Oracle JDBC driver for JBoss 6:
ojdbc6.jar
) in the
<jboss_home>/server/configuration/lib
directory.
To install the Oracle JDBC driver for JBoss 7 and 8:
ojdbc6.jar
) in the
<jboss_home>/standalone/deployments
directory.
Warning: The configuration in this section uses the UsersRolesLoginModule (properties file based login module) and may be changed to a stronger authentication mechanism.
The following example explains how to configure the semadmin user for JBoss 6 in the default configuration.
To configure the security realm for JBoss 6:
<jboss_home>/server/configuration/conf/users.properties
file with the following user and password definition:
semadmin=<semadmin_password>
<jboss_home>/server/configuration/conf/roles.properties
file with the following user/role mapping:
semadmin=semarchyConnect,semarchyAdmin
The following example explains how to configure the semadmin user for JBoss 7 and 8 in the default configuration.
To configure the security realm for JBoss 7 and 8:
<jboss_home>/bin
folder and start the
add-user.sh
or
add_user.bat
script
semadmin
for the
Username and then press
Enter.
semarchyConnect,semarchyAdmin
and then press
Enter.
To configure the repository datasource:
<jboss_home>/server/configuration/deploy/semarchy_repository.xml
file based on the template given below. Make sure to modify the
connection-url
,
user-name
and
password
elements to match your repository schema connection information.
<datasources>
<no-tx-datasource>
<jndi-name>jdbc/SEMARCHY_REPOSITORY</jndi-name>
<connection-url>jdbc:oracle:thin@<oracle_instance_hostname>:<oracle_listener_port>:<oracle_SID_name></connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name><repository_user_name></user-name>
<password><repository_user_password></password>
<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>
<metadata>
<type-mapping>Oracle9i</type-mapping>
</metadata>
</no-tx-datasource>
</datasources>
Important: Do not change the jndi-name of the SEMARCHY_REPOSITORY datasource. The application refers to a datasource with this name for the repository.
To configure a data location datasource:
<jboss_home>/server/configuration/deploy/
an XML file named after the data location, and based on the template given below. Make sure to modify the
jndi-name
,
connection-url
,
user-name
and
password
elements to match your data location schema connection information:
<datasources>
<no-tx-datasource>
<jndi-name>jdbc/<data_location_datasource_name></jndi-name>
<connection-url>jdbc:oracle:thin@<oracle_instance_hostname>:<oracle_listener_port>:<oracle_SID_name></connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name><data_location_user_name></user-name>
<password><data_location_user_password></password>
<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>
<metadata>
<type-mapping>Oracle9i</type-mapping>
</metadata>
</no-tx-datasource>
</datasources>
Repeat this operation for each data location’s datasource.
To optionally configure the Pulse Metrics Warehouse datasource:
<jboss_home>/server/configuration/deploy/semarchy_pulse_metrics.xml
file based on the template given below. Make sure to modify the
connection-url
,
user-name
and
password
elements to match your Pulse Metrics Warehouse schema connection information.
<datasources>
<no-tx-datasource>
<jndi-name>jdbc/SEMARCHY_PULSE_METRICS</jndi-name>
<connection-url>jdbc:oracle:thin@<oracle_instance_hostname>:<oracle_listener_port>:<oracle_SID_name></connection-url>
<driver-class>oracle.jdbc.driver.OracleDriver</driver-class>
<user-name><pulse_user_name></user-name>
<password><pulse_user_password></password>
<exception-sorter-class-name>org.jboss.resource.adapter.jdbc.vendor.OracleExceptionSorter</exception-sorter-class-name>
<metadata>
<type-mapping>Oracle9i</type-mapping>
</metadata>
</no-tx-datasource>
</datasources>
Important: Do not change the jndi-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.
To configure the repository datasource:
SEMARCHY_REPOSITORY
jdbc/SEMARCHY_REPOSITORY
<repository_user_name>
<repository_user_password>
jdbc:oracle:thin:
@
<oracle_instance_hostname>:<oracle_listener_port>:<oracle_SID_name>
To configure a data location datasource:
<data_location_datasource_name>
jdbc/<data_location_datasource_name>
<data_location_user_name>
<data_location_user_password>
jdbc:oracle:thin:
@
<oracle_instance_hostname>:<oracle_listener_port>:<oracle_SID_name>
To optionally configure the Pulse Warehouse Metrics datasource:
SEMARCHY_PULSE_METRICS
jdbc/SEMARCHY_PULSE_METRICS
<pulse_user_name>
<pulse_user_password>
jdbc:oracle:thin:
@
<oracle_instance_hostname>:<oracle_listener_port>:<oracle_SID_name>
The repository and data location datasources are now configured, pointing to the schemas previously created.
To deploy the application for JBoss 6:
semarchy_war_only.zip
file in the
temp/
folder.
temp/semarchy.war
file in the
<jboss_home>/server/configuration/deploy/
folder.
To deploy the application for JBoss 7 and 8:
semarchy_war_only.zip
file in the
temp/
folder.
temp/semarchy.war
file in the
<jboss_home>/standalone/deployments/
folder.
The Semarchy application is deployed in the server.
This configuration is required for mail notifications using JEE Mail Session.
To configure JavaMail Session for JBoss 6:
<jboss_home>/server/<configuration>/deploy/mail-service.xml
and alter the default service configuration for your network. See http://community.jboss.org/wiki/JavaMail for more information.
To test the application:
http:/<jboss_host>:<jboss_port>/semarchy/
.
Tip: Proceed directly to the Installing the Repository task.
Previous | Top | Next |
Deploying and Configuring with Apache Tomcat | Deploying and Configuring with GlassFish |