Deploying and Configuring with Oracle WebLogic

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

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

Note: Prior to configuring Semarchy, configure and start the WebLogic domain into which you plan to deploy and configure the Semarchy application.

Configuring the Security

To create the groups:

  1. Connect to the WebLogic Server Administration Console.
  2. Select Security Realms from the left pane and then click the realm you are configuring.
  3. Select the Users and Groups tab, then Groups.
  4. Click New.
  5. In the Create a New Group page provide the following information:
  6. Click OK. The group is added to the Groups table.
  7. Click New.
  8. In the Create a New Group page provide the following information:
  9. Click OK. The group is added to the Groups table.

To create the semadmin user:

  1. Connect to the WebLogic Server Administration Console.
  2. Select Security Realms from the left pane and then click the realm you are configuring.
  3. Select the Users and Groups tab, then Users.
  4. Click New.
  5. In the Create a New User page provide the following information:
  6. Click OK. The user is added to the Users table.
  7. Click the semadmin user from the Users table, then select the Groups tab.
  8. Select the semarchyAdminGroup and semarchyConnectGroup groups in the Available group list, then click the Add button to add them to the Chosen list.
  9. Click Save to save the group membership.

To configure the roles mappings:

  1. Connect to the WebLogic Server Administration Console.
  2. Select Security Realms from the left pane and then click the realm you are configuring.
  3. Select the Roles and Policies tab, then Realm Roles.
  4. In the Roles hierarchy, select Global Roles > Roles.
  5. In the Global Roles table, select New to create a new role with the following properties:
  6. Click OK.
  7. Select the semarchyConnect role in the Global Roles table.
  8. Click Add Conditions.
  9. Select Group for the Predicate List and then click Next.
  10. In the Group Argument Name, enter semarchyConnectGroup and then click Add.
  11. Click Finish.
  12. Click Save.
  13. Use the breadcrumb to go to the Global Roles.
  14. In the Global Roles table, select New to create a new role with the following properties:
  15. Click OK.
  16. Select the semarchyAdmin role in the Global Roles table.
  17. Click Add Conditions.
  18. Select Group for the Predicate List and then click Next.
  19. In the Group Argument Name, enter semarchyAdminGroup and then click Add.
  20. Click Finish.
  21. Click Save.

Setting up the Datasources

To configure the repository datasource:

  1. Connect to the WebLogic Server Administration Console.
  2. Select Services > Data Sources from the left pane.
  3. Select New > Generic Data Source in the Data Sources table.
  4. Enter the following JDBC datasource properties:
  5. Click Next.
  6. In the Database Driver select Oracle’s Driver (Thin) for Instance connections: Version:9.0.1 and later.
  7. Click Next.
  8. De-select the Supports Global Transaction option.
  9. Click Next.
  10. Enter the following connection properties:
  11. Click Next.
  12. Click Test Configuration to validate the connection information.
  13. In the Properties field, add the following line: defaultAutoCommit=false
  14. Click Next.
  15. Select a deployment target (by default Admin Server) and then click Finish.

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 the data location datasource:

  1. Connect to the WebLogic Server Administration Console.
  2. Select Services > Data Sources from the left pane.
  3. Select New > Generic Data Source in the Data Sources table.
  4. Enter the following JDBC datasource properties:
  5. Click Next.
  6. In the Database Driver select Oracle’s Driver (Thin) for Instance connections: Version:9.0.1 and later.
  7. Click Next.
  8. De-select the Supports Global Transaction option.
  9. Click Next.
  10. Enter the following connection properties:
  11. Click Next.
  12. Click Test Configuration to validate the connection information.
  13. In the Properties field, add the following line: defaultAutoCommit=false
  14. Click Next.
  15. Select a deployment target (by default Admin Server) and then click Finish.

Repeat this operation for each data location’s datasource.

To optionally configure the Pulse Metrics Warehouse datasource:

  1. Connect to the WebLogic Server Administration Console.
  2. Select Services > Data Sources from the left pane.
  3. Select New > Generic Data Source in the Data Sources table.
  4. Enter the following JDBC datasource properties:
  5. Click Next.
  6. In the Database Driver select Oracle’s Driver (Thin) for Instance connections: Version:9.0.1 and later.
  7. Click Next.
  8. De-select the Supports Global Transaction option.
  9. Click Next.
  10. Enter the following connection properties:
  11. Click Next.
  12. Click Test Configuration to validate the connection information.
  13. In the Properties field, add the following line: defaultAutoCommit=false
  14. Click Next.
  15. Select a deployment target (by default Admin Server) and then click Finish.

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.

Deploying the Application

To deploy the application:

  1. Uncompress the semarchy_war_only.zip file in the temp/ folder.
  2. Connect to the WebLogic Server Administration Console.
  3. Select Deployments from the left pane.
  4. Click the Install button.
  5. Click the Upload your file(s) link.
  6. Select for the Deployment Archive the temp/semarchy.war file on your local disk.
  7. Click Next and then Next.
  8. In the Choose target style page select Install this deployment as an application and then click Next.
  9. In the Optional Settings page, in the Security option group, select Custom Roles: Use roles that are defined in the Administration Console; use policies that are defined in the deployment descriptor.
  10. Click Next.
  11. In the Review your choices and click Finish page Select No, I will review the configuration later.
  12. Click Finish.

The Semarchy application is deployed in the server.

Configuring JavaMail Session

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

To configure JavaMail Session:

  1. Connect to the WebLogic Server Administration Console.
  2. Select Services > Mail Sessions from the left pane.
  3. Click the New button.
  4. In the Mail Session Properties page, enter the following properties:
  5. In the JavaMail Properties, enter the following lines:
  6. Click Save to save the mail session configuration.

Testing the Application

To test the application:

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

Tip: Proceed directly to the Installing the Repository task.