Deploying and Configuring with Apache Geronimo

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

In this section, <geronimo_home> refers to the Glassfish server installation folder.

Note: Refer to the Geronimo Documentation for more details about the deployment and configuration processes in Geronimo.

Installing Additional Libraries

To install the Oracle JDBC Driver:

  1. Connect to the Apache Geronimo Console ( http://<geronimo_host>:8080/console).
  2. Switch the Navigator to the Advanced view.
  3. Select Resources > Repository.
  4. In the Add Archive to Repository section, select the Oracle driver file ( ojdbc6.jar).
  5. Check the Specify other parts option and enter the following values:
  6. Click the Install button. The driver is added to the repository.

Configuring the Security

To create the groups:

  1. Connect to the Apache Geronimo Console ( http://<geronimo_host>:8080/console).
  2. Switch the Navigator to the Advanced view.
  3. Select Security > Users and Groups.
  4. Click the Create New Group link, and create a new group with the following parameters:
  5. Click Add
  6. Click the Create New Group link, and create a new group with the following parameters:
  7. Click Add

To create the semadmin user:

  1. Connect to the Apache Geronimo Console ( http://<geronimo_host>:8080/console).
  2. Switch the Navigator to the Advanced view.
  3. Select Security > Users and Groups.
  4. Click the Create New User link, and create a new user with the following parameters:
  5. Click Add to add this new user.
  6. In the list of groups, click the Edit link on the semarchyConnectGroup line.
  7. Select the semadmin user in the list of users and click the Add >> button.
  8. Click Update.

The semadmin user is created and added to the two groups.

Note: With Geronimo, the roles/groups mappings are performed at a later stage in the application deployment plan.

Setting up the Datasources

To configure the repository datasource:

  1. Connect to the Apache Geronimo Console ( http://<geronimo_host>:8080/console).
  2. Switch the Navigator to the Advanced view.
  3. In the Navigator panel, select Resources Datasources.
  4. Click the Using the Geronimo database pool wizard link.
  5. Enter the following information:
  6. Click Next.
  7. In the Driver Jar, select the oracle/jdbc/11.2.0/jar driver previously added in the repository.
  8. Enter the following parameters:
  9. Click Next.
  10. Click the Test Connection button to test your connection.
  11. Click Deploy.

To configure a data location datasource:

  1. Connect to the Apache Geronimo Console ( http://<geronimo_host>:8080/console).
  2. Switch the Navigator to the Advanced view.
  3. In the Navigator panel, select Resources Datasources.
  4. Click the Using the Geronimo database pool wizard link.
  5. Enter the following information:
  6. Click Next.
  7. In the Driver Jar, select the oracle/jdbc/11.2.0/jar driver previously added in the repository.
  8. Enter the following parameters:
  9. Click Next.
  10. Click the Test Connection button to test your connection.
  11. Click Deploy.

Repeat this operation for each data location’s datasource.

To optionally configure the Pulse Metrics Warehouse datasource:

  1. Connect to the Apache Geronimo Console ( http://<geronimo_host>:8080/console).
  2. Switch the Navigator to the Advanced view.
  3. In the Navigator panel, select Resources Datasources.
  4. Click the Using the Geronimo database pool wizard link.
  5. Enter the following information:
  6. Click Next.
  7. In the Driver Jar, select the oracle/jdbc/11.2.0/jar driver previously added in the repository.
  8. Enter the following parameters:
  9. Click Next.
  10. Click the Test Connection button to test your connection.
  11. Click Deploy.

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

Deploying the Application

To deploy the application:

  1. Uncompress the semarchy_war_only.zip file in the temp/ folder.
  2. Connect to the Apache Geronimo Console ( http://<geronimo_host>:8080/console).
  3. Switch the Navigator to the Advanced view.
  4. In the Navigator panel, select Applications > Plan Creator.
  5. Select the temp/semarchy.war archive file.
  6. Click Configure.
  7. Leave the fields as is and click Next.
  8. Map the JDBC Ref for jdbc/SEMARCHY_REPOSITORY by selecting the SEMARCHY_REPOSITORY JDBC pool.
  9. Click Next.
  10. In the Security Role Mappings, for the semarchyConnect role, select the following options:
  11. Click Add.
  12. Click Next and then Next again.
  13. In the deployment plan, replace the <sec:role-mappings> with the section given below and click Deploy WAR to deploy the application.
<sec:role-mappings>
 <sec:role role-name="semarchyConnect">
 <sec:principal name="semarchyConnectGroup" class="org.apache.geronimo.security.realm.providers.GeronimoGroupPrincipal"/>
 </sec:role>
 <sec:role role-name="semarchyAdmin">
 <sec:principal name="semarchyAdminGroup" class="org.apache.geronimo.security.realm.providers.GeronimoGroupPrincipal"/>
 </sec:role>
</sec:role-mappings>

Testing the Application

To test the application:

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

Tip: Proceed directly to the Installing the Repository task.