8 Installing SOA Facades

This chapter describes the tasks necessary to install the Service Oriented Architecture (SOA) Facades for Oracle Communications Services Gatekeeper. It also describes the different deployment types related to SOA.

Introduction

The Services Gatekeeper SOA Facades integrate Services Gatekeeper with SOA environments. The SOA Facades are deployed in Oracle Service Bus (OSB) and expose an interface identical to the SOAP interfaces in the Web Services SOAP Facades. From an application point of view, there is no difference between interacting with a SOA Facade or a SOAP Facade. The SOA product must be installed in addition to Services Gatekeeper to interact with SOA environments.

If you use clustering, each SOA Facade must be co-located with an Access Tier but nothing else. Network Tiers must be in a separate cluster.

Both Services Gatekeeper core and communication services are deployed in OSB servers. You use these Service Bus servers instead of Access Tier and Network Tier servers.

Task Overview

To install the Services Gatekeeper SOA Facades:

1. Install Services Gatekeeper on all servers, see "Install Services Gatekeeper" for details.

2. Install OSB on all servers, see "Install Oracle Service Bus" for details.

3. Configure the domain for the SOA Facades. There are different ways to do this:

   1. Configure the Domain Using the Graphical Domain Configuration Wizard.

   2. Configure Oracle Service Bus Domain Using the Console Configuration Wizard.

4. Add OSB settings to the domain configuration script. See "Edit and Verify the Domain Configuration Settings" for details.

5. Make sure that the WebLogic Server installation directory is set in the domain configuration file. See "Verify the Domain Configuration Settings" for details.

6. (As needed) Upgrade your existing SOA facade projects to Services Gatekeeper 5.1 with the instructions in ”Managing and Configuring SOA Facades” in the Oracle Communications Services Gatekeeper System Administration Guide, another document in this set.

Install Services Gatekeeper

Install Services Gatekeeper normally. See "Installing Oracle Communications Services Gatekeeper" for details. Do not configure a domain yet.

Install Oracle Service Bus

Install Oracle Service Bus 11gR1 (11.1.1.6.0) on all Services Gatekeeper AT servers. Do not use an OSB version later than 11.1.1.6.0. if you are installing on Services Gatekeeper 5.1.

For information about installing OSB, see Oracle Fusion Middleware Installation Guide for Oracle Service Bus 11g Release 1 (11.1.1.6.0) at:

http://docs.oracle.com/cd/E23943_01/doc.1111/e15017/overview.htm#OSBIN1010

Use the same Oracle Middleware home directory for OSB and Services Gatekeeper.

Configure the Domain

Follow the domain configuration in the section below that matches your implementation.

Configure the Domain Using the Graphical Domain Configuration Wizard

OSB domain configuration is similar to Services Gatekeeper domain configuration. See "Configuring a Domain With the Graphical Mode Configuration Wizard" for details.

For information on how to start and use the Oracle Service Bus Domain Configuration Wizards, see Oracle Fusion Middleware Installation Guide for Oracle SOA Suite 11g Release 1 at

http://docs.oracle.com/cd/E23943_01/doc.1111/e15017/configure_osb.htm#OSBIN1566

Always use this configuration template during installation:

OCSG OSB Integration configuration

This configuration template is very similar to the template OCSG Domain with Access and Network Clusters. It contains a few specialized configuration settings which are described in "Configuring Domain Settings".

Configure Oracle Service Bus Domain Using the Console Configuration Wizard

The Console Configuration Wizard is a text-based version of the Graphical Console Configuration Wizard.

For information on how to start and use the Oracle Service Bus Domain Configuration Wizards, see Oracle Fusion Middleware Installation Guide for Oracle Service Bus 11g Release 1 (11.1.1.6.0) at

http://docs.oracle.com/cd/E23943_01/doc.1111/e15017/configure_osb.htm#BGBJCGIJ

For details, see "Using the Console Configuration Wizard" for details.

Edit and Verify the Domain Configuration Settings

Add the Oracle Service Bus definitions to the set domain script (setDomainEnv.cmd or setDomainEnv.sh). The StartWeblogic.bat script uses these scripts to configure domains. Use either the Windows or Linux/UNIX instructions.

Configuring Domain Settings: Windows

Edit the Domain_Home\bin\setDomainEnv.cmd script file as follows where Domain_Home is the home directory of your Oracle Service Bus domain:

At the top of the script, add the following OSB information, where Service_Bus_Home is the installation directory for Oracle Service Bus on your system; for example c:\oracle\gatekeeper5.1\bin

set COMMON_COMPONENTS_HOME=Services_Gatekeeper_home\oracle_common
set ALSB_HOME=Service_Bus_Home
for %%i in ("%ALSB_HOME%") do set ALSB_HOME=%%~fsi
set ALSB_DEBUG_FLAG=true
set ALSB_DEBUG_PORT=7453

Configuring Domain Settings: Linux/UNIX

Edit the Domain_Home/bin/setDomainEnv.sh script file as follows where Domain_Home is the home directory of your Oracle Service Bus domain:

At the top of the script, add the following OSB information. Note that Service_Bus_Home is the installation directory for Oracle Service Bus on your system; for example /var/oracle/gatekeeper5.1/bin

set COMMON_COMPONENTS_HOME=Services_Gatekeeper_home/oracle_common
ALSB__HOME="Services_Gatekeeper_home/Service_Bus_Home"
export ALSB_HOME
ALSB_DEBUG_FLAG="true"
export ALSB_DEBUG_FLAG
ALSB_DEBUG_PORT="7453"
export ALSB_DEBUG_PORT

Verify the Domain Configuration Settings

Follow these steps to make sure that your settings are now correct:

1. Verify that the Service Bus installation directory is defined in the domain configuration file:

   1. Open Domain_Home/config/config.xml where Domain_Home is the home directory of your Oracle Service Bus domain

   2. Verify that ALSB_INSTALL_DIR refers to the installation directory for Oracle Service bus, for example /var/oracle/osb_11.1.

2. (Windows only) Verify that your classpath matches the classpath in "Configuring Domain Settings: Windows". To view the classpath:

   1. Right click My Computer.

   2. Select Properties ->Advanced ->Environment Variables.

Configure the SOA Facades

In addition to configuring the domain and changing to the environment script, you must also configure the SOA Facades themselves. To do so, follow the information in ”Managing and Configuring SOA Facades” in Oracle Communications Services Gatekeeper System Administrator's Guide, another document in this set.