setting up activevos multisite on oracle weblogic

of 21

Setting up ActiveVOS MultiSite on Oracle WebLogic

Technical Note

This document describes the steps to set up ActiveVOS MultiSite on Oracle WebLogic

Platform.

Dated: November 2015

of 21

Contents ActiveVOS MultiSite Configuration ............................................................................................................... 3

What is MultiSite? ...................................................................................................................................... 3 Prerequisites .............................................................................................................................................. 3

ActiveVOS MultiSite Setup............................................................................................................................ 4 Setup the Databases ................................................................................................................................. 4 Setup the Oracle WebLogic clusters ......................................................................................................... 4 Install ActiveVOS database schema ......................................................................................................... 6 Setup Oracle Streams ............................................................................................................................... 6 Test Oracle Streams .................................................................................................................................. 9 Configure and Deploy ActiveVOS Server................................................................................................ 10 Add the MultiSite License ........................................................................................................................ 10 MultiSite Testing ...................................................................................................................................... 13 Configuring an existing MultiSite Environment ........................................................................................ 13

Scenario 1 Rebuilding a Site ............................................................................................................ 13 Scenario 1 Procedure ....................................................................................................................... 13 Scenarios 2 Adding a New Site ........................................................................................................ 13 Scenario 2 Procedure ....................................................................................................................... 13

Troubleshooting MultiSite Issues ............................................................................................................ 14 Appendix A Sample Installation Screenshots .......................................................................................... 16

of 21

ActiveVOS MultiSite Configuration

What is MultiSite?

ActiveVOS Server supports a site configuration, which allows a cluster of process servers to replicate its

database to other databases serving other sites. Each site has its own cluster of servers with a single

persistent database. All process instances are available for execution at each site. In the event of a

server failure at one site, a process that started execution on that site can complete on a different site.

In addition, most ActiveVOS server configuration properties are replicated from site to site. This means

you can configure server properties in one sites server console, and they are automatically copied to

another sites server console.

In the event of a site failure, work on a process instance can be failed over to another site.

The database setup is a master-master replication, as shown in the following illustration.

For more information on MultiSite setup, configuration as well as MultiSite properties please refers to our

help center documentation at the following URL:

http://infocenter.activevos.com/infocenter/ActiveVOS/v92/topic/doc.server_console/html/SvrUG6-11.html

This technote provides steps that can be used to setup an ActiveVOS MultiSite environment consisting of

two sites each site consisting of a 2-node Oracle WebLogic cluster installed on a physical server with a

dedicated backend database.

Prerequisites At the time of this writing, ActiveVOS MultiSite requires Oracle Database 11g and Oracle Streams.

Apache Ant needs to be installed on the server where you are running the ActiveVOS Multisite setup.

http://infocenter.activevos.com/infocenter/ActiveVOS/v92/topic/doc.server_console/html/SvrUG6-11.html

of 21

ActiveVOS MultiSite Setup ActiveVOS MultiSite setup requires a number of steps and they are described below:

Setup the Databases Setup two Oracle databases, say, STRMA and STRMB. These databases will later be used to install

ActiveVOS database schema as well as setup Oracle Streams.

Setup the Oracle WebLogic clusters 1) Setup a 2-node Oracle WebLogic cluster and a JDBC datasource on each of the two machines.

The Installing ActiveVOS on Oracle WebLogic technote (which is available for download on

our website) provides more details on setting up Oracle WebLogic cluster. While setting up

Oracle WebLogic clusters on the two sites, make sure each cluster uses a unique multicast

address as shown in the sample screenshots below:

[Here the weblogic domain JB_domain has been setup on machine mkhan_dt which houses the site1

with the same name (i.e. mkhan_dt) and the other weblogic domain multisite1_domain has been setup on

another machine mkhan_vm which houses site2 having the same name as the machine.]

Site2 can be configured as follows. Note that the multicast address for Site1 and Site2 are different

(something that is required in our lab for example given we have created this configuration on a single IP

subnet.

of 21

2) You may also want to setup a temp directory for each managed server on both the sites as

shown in the screenshot below. This is done so that each managed server has its own space for

temporary files. Without this, both the managed servers might use the same directory and cause

conflict.

of 21

3) Using the Oracle WebLogic admin console, start the managed server on each site and test JDBC

datasource. It should test successfully.

4) Stop the managed servers on both sites.

Install ActiveVOS database schema Install the ActiveVOS database schema for Oracle database on both databases. This is achieved by

running the DDL scripts located in your installation folder, for example, ..\Server803\server-

enterprise\weblogic_config\ddls.

Setup Oracle Streams ActiveVOS provides an automated setup for Oracle Streams. The setup files are in the ActiveVOS

installation folder in the location weblogic_config/bin/multisite_ setup. The automated setup configures

two databases at a time. If your environment requires multiple databases, you can reconfigure setup.

The setup files include the following:

streams_readme.txt Contains instructions for configuring MultiSite

database.properties Contains your values for user/password of the Oracle user with administrative (DBA) rights

multisite.properties Contains your values for setup of two MultiSite databases to replicate

setup.cmd Command line script to perform Oracle Streams setup with your values

teardown.cmd Command line script to remove Oracle Streams setup

multisite.xml Ant file used in setup and teardown commands

of 21

Configure appropriate values in database.properties, multisite.properties and run setup.cmd. Assuming

the databases and the properties files are configured correctly, the setup should complete successfully as

shown in the screenshot below:

It should be noted that setup.cmd internally runs the following command which invokes Apache Ant:

SETUP

Ant f multisite.xml multisite.oracle.setup

Apache Ant needs to be installed on the server where you are running the ActiveVOS Multisite setup

utility.

If the setup utility completes successfully, Oracle Streams should be setup on the two databases. Oracle

Stream setup on our sample database STRMA is shown here:

of 21

Test Oracle Streams ActiveVOS provides a utility that verifies database replication which is located here: ..\Server\server-

enterprise\weblogic_config\bin\multisite_test. This utility performs inserts and deletes within each sites

database tables and verifies synchronization of the data. To use this utility, modify siteConfig.xml to

provide parameters describing your environment. Then run multisite_test.bat. This script should execute

successfully as shown in the screenshot below:

of 21

Configure and Deploy ActiveVOS Server 1) Using the Oracle WebLogic admin console, start the managed servers on Site 1 and Site 2.

2) Run the installer utility config_deploy.bat (usually located at ..\ServerWL803\Server\server-

enterprise\weblogic_config\bin) on both sites to install ActiveVOS server and central. While

running the utility, make sure to UNCHECK install database schema checkbox (since the

database schema has already been installed by running DDL scripts as described earlier).

Sample screenshots showing ActiveVOS server installation on Site 1 machine are included in the

appendix at the end of this technote.

Add the MultiSite License After you have installed ActiveVOS server and central, here are steps you need to perform to get

ActiveVOS MultiSite up and running:

A. On Site 1 > Oracle WebLogic console > Deployments, start ActiveVOS server and ActiveVOS

central.

B. On Site 2 > Oracle WebLogic console > Deployments, start ActiveVOS server and ActiveVOS

central.

C. Navigate to ActiveVOS console on one the sites, say, Site 1 using the URL -

http://site1:port/activevos.

D. Navigate to Admin > License. Add the license. Navigate to Admin > Server Status and start the

server. Make sure it starts without any errors.

E. Navigate to Admin > Cluster. Make sure all the nodes are up and running. In case, a particular

node is stopped, click on the node and click 'Start Engine'.

F. Navigate to ActiveVOS console on the other site Site 2 using the URL http://site2:port/activevos.

G. Navigate to Admin > License. You do not need to add the license here. It should already be there (replicated from Site 1).

H. Navigate to Admin > Cluster. The nodes should be either running or in starting mode. If they are

in starting mode, you may need to wait for some time until they are also up and running.

I. At this time, both the sites should be up and running as shown in the screenshots shown below:

http://site1:port/activevoshttp://site2:port/activevos

of 21

Site 1:

of 21

and Site 2:

of 21

J. In case a particular site appears as Unavailable, you may need to correct the Site URL and stop and

start the ActiveVOS Server (Admin > Server Status).

MultiSite Testing A sample project is available which can be used to test whether process data is being replicated between

the two sites. It is a simple HelloWorld project with a bpr PartnerHello.bpr which you can deploy using

ActiveVOS console (ActiveVOS Console > Admin > Deploy). A generateRequest.xml ant script has also

been added to the project which you can run in ActiveVOS Designer (Right click on generateRequest.xml

> Run As > Ant Build).It will execute the three sample requests (also included in the project) and create

three process instances on both the sites. The process instances can be viewed by navigating to

ActiveVOS console on any of the site. Once the process instances have been confirmed on both the

sites, they can be deleted and PartnerHello.bpr can be deleted by setting its contribution to offline and

deleting the contribution or if you are using a version of ActiveVOS earlier than version 8, you can

navigate to ActiveVOS Console > Storage > Delete Inactive Plans to delete the HelloWorld Process.

Configuring an existing MultiSite Environment

This section describes two scenarios which MultiSite users may experience and provides general

guidelines which can be used to configure the MultiSite environment.

Scenario 1 Rebuilding a Site

Suppose there are 2 sites running in a MultiSite environment. For some reason, Site 2 stops functioning

and it needs to be setup again with all new equipment. In the meantime, Site 1 continues to run and

service requests. When Site 2 is back on line, it needs to be brought in sync with Site 1.

Scenario 1 Procedure

Here are the general steps you can use to get the two sites in synch:

1) Stop deployments and the managed servers on Site 1. Stop the managed servers on Site 2 2) Execute the script to tear down streams 3) Run the ActiveVOS DDL scripts on Site 2 database 4) Copy the database from Site 1 to Site 2 database so that both the databases are the same 5) Run streams setup scripts 6) Wait 5 minutes, to be sure streams are fully initialized 7) Run streams test tool 8) Start the managed servers on Site 2 and proceed with ActiveVOS installation on Site 2 only if

streams test tool succeeds 9) First, get Site 1 up and running and then bring Site 2 up

Scenarios 2 Adding a New Site Suppose there are two sites up and running in a MultiSite environment and a third site needs to be added

to the configuration.

Scenario 2 Procedure Here are the general steps you can use to get the three sites in sync:

1) Stop deployments and the managed servers on both sites 2) Run ActiveVOS DDL scripts on Site 3 database 3) Copy database from Site 1 to Site 3 database so that all the databases are the same 4) Run streams setup scripts for Site 1 and Site 3 5) Run stream setup scripts for Site 2 and Site 3

of 21

6) Run streams test tool between Site 1 & Site 3, and then Site 2 & Site 3 7) Proceed with ActiveVOS installation on Site 3 only if streams test tool succeeds. 8) Get Site1 up and running and then bring up the other two sites in succession

In this scenario (as well in the scenario # 1), a better approach would be to first try in a test environment

before implementing it in production.

Troubleshooting MultiSite Issues

This section describes problematic scenarios you may experience in a MultiSite setup and suggestion on

resolving those issues.

Invalid identifier Error

While running the streams test tool, getting the following error occurs if you are using incorrect

siteConfig.xml (i.e. using siteConfig.xml packaged with ActiveVOS version 7 while running streams test

tool for ActiveVOS version 8).

Suggestions

Make sure you are using siteConfig.xml that is packaged with the version of ActiveVOS you are installing.

of 21

Database Inconsistency

If you observe the following errors in Oracle Streams this indicates that there is inconsistency between

the backend databases. This problem can occur if a user tries to add a new site (say, site2) to an existing

site (say, site1) before first copying the database from the existing site to the new site. Please refer to

Configuring an existing multisite environment section of this technote for information on how a new

site can be added to an existing one.

Suggestions

You can try to resolve the streams errors. The following link provides details on that:

http://download.oracle.com/docs/cd/B28359_01/server.111/b28322/troub_rep.htm

In case this issue is still not resolved, you will need to re-build the two sites. As mentioned earlier, here

are the steps you can use:

1) Delete the deployments and stop the managed servers on both sites. 2) Execute script to tear down streams. 3) Run ActiveVOS DDL scripts on Site 1 and then on Site 2 4) Run streams setup scripts 5) Wait 5 minutes, just be sure streams are fully initialized 6) Run streams test tool 7) Start the managed servers on Site 1 and run installer utility to install ActiveVOS server and Central.

Do the same on Site 2 8) First get Site 1 up and running and then bring Site 2 up

http://download.oracle.com/docs/cd/B28359_01/server.111/b28322/troub_rep.htm

of 21

Appendix A Sample Installation Screenshots After you have configured your Oracle WebLogic environment (i.e. setting up managed servers, the data

source and security) and setup and tested Oracle Streams, you can run the installer utility

config_deploy.bat (usually located in ..Server\server-enterprise\weblogic_config\bin) on each site to

install ActiveVOS Server and ActiveVOS Central.

Here are the screenshots of a typical installation:

of 21

Worldwide Headquarters, 2100 Seaport Blvd, Redwood City, CA 94063, USA Phone: 650.385.5000 Fax:

650.385.5500

Toll-free in the US: 1.800.653.3871 informatica.com linkedin.com/company/informatica

twitter.com/InformaticaCorp

Copyright 1993-2015 Informatica LLC. All rights reserved. Informatica and Put potential to work are

trademarks or registered trademarks of Informatica

Corporation in the United States and in jurisdictions throughout the world. All other company and product

names may be trade names or trademarks.

ActiveVOS MultiSite ConfigurationWhat is MultiSite?Prerequisites

ActiveVOS MultiSite SetupSetup the DatabasesSetup the Oracle WebLogic clustersInstall ActiveVOS database schemaSetup Oracle StreamsTest Oracle StreamsConfigure and Deploy ActiveVOS ServerAdd the MultiSite LicenseMultiSite TestingConfiguring an existing MultiSite EnvironmentScenario 1 Rebuilding a SiteScenario 1 ProcedureScenarios 2 Adding a New SiteScenario 2 Procedure

Troubleshooting MultiSite Issues

Appendix A Sample Installation Screenshots

setting up activevos multisite on oracle weblogic

Documents