SOA Domain Installation Guide
SOA Domain Installation Guide
SOA Domain Installation Guide
<<draft>>
Project Name:
Project Reference
Number:
Interface ID:
Interface Name:
Integration Tool:
Document Version:
Date:
Project Manager:
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Table of contents
1. INTRODUCTION...............................................................................................5
1.1.
1.2.
Document Purpose..............................................................................5
Scope.....................................................................................................5
2. REFERENCED DOCUMENTS.........................................................................5
3. ORACLE STANDALONE SOA SUITE 11G INSTALLATION STEPS............5
3.1.
3.2.
Only
3.3.
3.4.
3.4.1.
3.5.
3.5.1.
3.5.2.
3.6.
3.6.1.
Configuring Oracle SOA Suite 11g and Creating a WebLogic SOA Suite Domain
(CM Team only).................................................................................................................... 12
3.7.
3.7.1.
3.7.2.
3.7.3.
7.5.
7.5.1.
7.5.2.
7.6.
7.6.1.
7.6.2.
8. ADDING DATASOURCES..............................................................................29
9. ADDING CONNECTION FACTORIES FOR DB ADAPTER..........................32
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Date
0.1
0.2
03/10/2011
07/18/2011
0.3
07/29/2011
0.4
0.5
0.6
0.7
0.8
08/03/2011
08/04/2011
08/10/2011
09/07/2011
09/12/2011
0.9
1.0
10/20/2011
11/07/2011
Description
Author/Editor
Initial Draft
Added Section 5 for Cisco AD Integration and
Application Role configuration
Added Section 6,7 for Adding Data-sources and
Connection Factories
Included BPEL Deployment section
Added section 5.4 for OWSM configuration
Added iServices deployment steps
Update AD configuration after lookup issues
Updated Data-source configuration with database
details
Section 7.4.2: Added credential information for ATA
Section 16: Added PP and Prod deployment steps
Rajendra Naik
Ravi Singh
Ravi Singh
Venkata Meda
Ravi Singh
Venkata Meda
Ravi Singh
Ravi Singh
Ravi Singh
Venkat Meda
APPROVALS
Signatures on this page indicate agreement with document content. Changes requested after
sign-off will undergo a process for assessment, authorization, and communication.
Name
Role
Signoff Date
Remarks
REVIEWERS
Signatures on this page indicate agreement with document content after review.
Name
Shishir Jain
Role
Srinivas Rao
Delivery Head
Architecture Board
Signoff Date
Remarks
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
1. INTRODUCTION
1.1.
Document Purpose
The purpose of this document is to provide installation steps for Oracle SOA
Suite 11g (11.1.1.4.0) in clustered environment.
1.2.
Scope
This document covers the steps involved in the setting up the environment for
Oracle SOA Suite 11g, deploy SOA services, configure CISCO LDAP and
deploying the iServices applications in the new cluster.
2. REFERENCED DOCUMENTS
Item
Title
Uri
Oracle Guides
http://download.oracle.com/docs/cd/E17904
_01/doc.1111/e13925/overview.htm
the
You need to install the following softwares in the same order as below.
Note: While doing remote installation, your machine/laptop requires Cygwin X-windows
Client or similar client for linux environment.
3.1.
Install Database DBA Only
If you don't already have an Oracle database installed, install database with following
configuration or higher.
Oracle Database 10g Enterprise Edition Release 10.2.0.4.0 - 64bit
CHARACTERSET =AL32UTF8
RAM - 8GB minimum, preferred 16 GB or more
CPU 4 cores or more
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
3.2.
Create Schemas using Repository Creation Utility (RCU)
DBA Only
Oracle SOA Suite and Oracle BAM require that certain schemas exist in your Oracle
database prior to installation. You must run Repository Creation Utility (RCU) to create
the schemas in the database.
Download RCU 11.1.1.4.0
http://www.oracle.com/technetwork/middleware/soasuite/downloads/index.html
Follow the instructions below to start RCU and create the schemas:
1. Start RCU from the RCU_HOME/bin (on Linux operating systems) or
RCU_HOME\bin (on Windows operating systems) directory:
On Linux operating systems:
./rcu
2. Welcome Screen
Click Next.
3. Create Repository Screen
Select Create.
Click Next.
4. Database Connection Details Screen
Select "Oracle Database" in the Database Type field, then provide the
following credentials to connect:
o
Host Name: Specify the name of the machine on which your database
resides in the format host.domain.com.
For Oracle RAC databases, specify the Virtual IP name or one of the
node names as the host name. For example:
ora-node1-vip.mycompany.com
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Port: Specify the database listener port number. The default port
number for Oracle databases is 1521.
If you do not know the listen port number for your database, you can
check the portlist.ini file, which is located in the
ORACLE_HOME/install (on UNIX operating systems) or
ORACLE_HOME\install (on Windows operating systems) directory on
the machine where the database is located.
Database Name: Specify the service name for the database. Typically,
the service name is the same as the global database name.
If you are unsure what the service name for your database is, you can
obtain it from the SERVICE_NAMES parameter in the database's
initialization parameter file. If the initialization parameter file does not
contain the SERVICE_NAMES parameter, then the service name is the
same as the global database name, which is specified in the DB_NAME
and DB_DOMAIN parameters.
For Oracle RAC databases, specify the service name of one of the
nodes in this field. For example: sales.mydomain.com.
o
o
o
Click Next. A "Checking Prerequisites" screen will appear. If there are errors,
some details about the error will be displayed on the Database Connection
Details Screen. Fix the error messages and click Next again.
After the checking is complete with no errors, click OK to dismiss the screen.
5. Select Components Screen
In the table that lists the available components, select SOA and BPM
Infrastructure. All of the product schemas within this component, including all
the dependent schemas, are automatically selected.
Table 1 Required Schemas for Oracle SOA Suite on Oracle Databases
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Component
Schema Owner
SOA Infrastructure
prefix_SOAINFRA
Dependencies
prefix_MDS
(Metadata Services)
prefix_ORASDPM
prefix_MDS
(Metadata Services)
prefix_ORASDPM
prefix_ORASDPM
prefix_MDS
(User Messaging)
(User Messaging)
(Metadata Services)
Note:
You must remember or make a note of these schema names and the prefix value
from this screen; you will need them later when you are configuring your products.
You will need to provide the schema name in the format prefix_schemaname.
Click Next. A "Checking Prerequisites" screen will appear. If there are errors,
some details about the error will be displayed near the bottom of the screen.
Fix the error messages and click Next again.
After the checking is complete with no errors, click OK to dismiss the screen.
6. Schema Passwords Screen
Near the top of the screen, select Use same password for all schemas.
In the Password field, enter your password. Enter your password again in the
Confirm Password field.
Note:
You must remember or make a note of the schema passwords from this screen; you
will need them later when you are configuring your products.
Click Next.
7. Map Tablespaces Screen
Click Next. A "Creating Tablespaces" screen will appear. If there are errors,
some details about the error will be displayed on the Map Tablespaces Screen.
Fix the error messages and click Next again.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
After the tablespaces are created with no errors, click OK to dismiss the
screen.
8. Summary Screen
Click Create. A "CREATE" screen will appear. If there are errors, some details
about the error will be displayed on the Summary Screen. Fix the error
messages and click Next again.
After the schemas are created with no errors, click OK to dismiss the screen.
9. Completion Summary Screen
Click Close.
3.3.
Install 64 bit JRockit SDK for 64 bit OS (CM Team Only)
If you are using 64 bit OS, then you need to install 64 bit JRockit SDK. Download the
SDK from Oracle downloads page. Download the OS compatible version. E.g. RHEL 5.4
64 bit
3.4.
Install WebLogic Server 10.3.4 (CM Team Only)
Oracle SOA Suite requires an Oracle WebLogic Server on your system. If you do not
already have one, follow the instructions in this section to install Oracle WebLogic Server.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Specify the desired location of your new Middleware home directory. If this
directory already exists on your system, it must be an empty directory. If this
directory does not already exist, then it will be created for you.
Note:
You must remember or make a note this location; you will be asked for it later when
you are installing Oracle SOA Suite.
Click Next.
6. Register for Security Updates Screen
Select whether or not you want to receive the latest product and security
updates. If you choose not to receive anything, you will be asked to verify
your selection before continuing.
Click Next.
7. Choose Install Type Screen
Select Typical.
Click Next.
8. Choose Product Installation Directories Screen
Specify the desired location for your WebLogic Server home directory.
Click Next.
9. Choose Shortcut Location (Windows only)
If you are installing on a Windows system, you will be asked to specify a
location where you would like Windows to create a shortcut to Oracle
products.
Click Next.
10. Installation Summary Screen
Click Next.
11. Installation Progress Screen
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Note:
Starting the installer as root user is not supported.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
The installer requires the full path to the location of a Java Runtime
Environment (JRE) on your system. When you installed Oracle WebLogic
Server, a JRE was installed on your system. You can use this location (the
location of the jre directory) to start the installer. The default location for the
JRE is MW_HOME/jdk160_18 (on UNIX operating systems) or
MW_HOME\jdk160_18 (on Windows operating systems), where MW_HOME is the
Middleware home directory.
On 64-bit platforms, the JRE location is the JAVA_HOME you used to install
Oracle WebLogic Server.
3.5.2.
Installation Screens
This will be your Oracle home directory. Runtime components cannot write
to this directory.
Note:
For the remainder of this document, this directory will be referred to as your SOA
Oracle home to avoid any confusion with the Oracle home directories of other
Oracle Fusion Middleware products.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
After you have successfully installed your software, you can configure Oracle
SOA Suite components using the Oracle Fusion Middleware Configuration
Wizard. This Configuration Wizard is located in the
SOA_ORACLE_HOME/common/bin (on UNIX operating systems) or
SOA_ORACLE_HOME\common\bin (on Windows operating systems) directory.
1. Start the Configuration Wizard.
On UNIX operating systems:
./config.sh
If you are using a 32-bit operating system, Oracle JRockit SDK is installed
as part of the Oracle WebLogic installation. This is the JDK that the
Configuration Wizard will use by default. If you want to invoke the
Configuration Wizard with the Sun JDK, do the following prior to starting
the Configuration Wizard:
1. Set the JAVA_HOME environment variable to the location of the Sun
JDK. For example, you can set it to the Sun JDK that was installed
with Oracle WebLogic Server in the MW_HOME/jdk160_18 (on
UNIX operating systems) or MW_HOME\jdk160_18 (on Windows
operating systems) directory.
2. Set the JAVA_VENDOR environment variable to "Sun."
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
2. Welcome Screen
Select Create a New WebLogic Domain.
Click Next.
3. Select Domain Source Screen
Select Generate a domain configured automatically to support the
following products, then select the products that should be configured in
this domain. For Oracle SOA Suite installation, select:
o
o
Domain name: The name of the domain you want to create. The
default name is base_domain.
Domain location: The absolute path to the directory where this
domain should be created. The default location is
MW_HOME/user_projects/domains (on UNIX operating systems)
or MW_HOME\user_projects\domains (on Windows operating
systems).
Application location: The absolute path to the directory where
applications created in this domain should reside. The default
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
User name: The name of the administrator for this domain. The
default name is weblogic.
User password: The administrator's password.
Click Next.
4.
5.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
After all of the information that is common to all data sources has been
specified, then you will need to select individual or smaller groups of data
sources and enter information that is specific to them (for example, the
schema owner).
Table 1 Required Schemas for Oracle SOA Suite on Oracle Databases
Component
Schema Owner
SOA Infrastructure
prefix_SOAINFRA
Dependencies
prefix_MDS
(Metadata Services)
prefix_ORASDPM
prefix_MDS
(Metadata Services)
prefix_ORASDPM
prefix_ORASDPM
prefix_MDS
(User Messaging)
(User Messaging)
(Metadata Services)
Review the table on this screen and identify which fields you need to
modify:
o
o
o
Vendor: Select the vendor for your database from the drop-down
list.
Driver: Select the driver type from the drop-down list.
Schema Owner: Specify the schema owner for the schema; this is
the name of the schema for this component in the following
format:
prefix_schema-name
Password: Specify the password for the schema. You specified this
password on the Schema Passwords Screen when creating the
schemas using RCU.
DBMS/Service: Specify the service name for your database. This
is the database on which the schema resides.
Host Name: Specify the name of the machine where your database
is running.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Click Next.
6.
7.
8.
Configuration Summary
Verify the information on this screen. Use the navigation pane on the left
or the Previous button if you want to return to a previous screen to alter
some portion of the configuration.
If everything is correct, click Create.
9.
3.7.
Verify Server Configuration (CM Only)
This section contains general information that will help you verify your installation and
configuration. Some components may require custom or manual configuration, and this
information is also included in this section:
3.7.1.
To get your deployments up and running, you must start the Administration
Server and various Managed Servers:
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
You entered the domain name and location on the Specify Domain
Name and Location Screen in the configuration wizard.
2. To start the Managed Servers, run the startManagedWebLogic.sh
(on UNIX operating systems) or startManagedWebLogic.cmd (on
Windows operating systems) script in the bin directory inside the
directory where you created your domain.
This command also requires that you specify a server name. The
servers that need to be started are:
o
soa_server1
On Windows systems:
startManagedWebLogic.cmd soa_server1
Before WebLogic Server is started, you will be prompted for the WebLogic
Server username and password. These were provided on the Configure
Administrator Username and Password Screen in the configuration wizard.
Note:
If this is the first time that both Oracle SOA Server and Oracle BAM Server are being
started after installation and configuration, you must make sure that your startup of
Oracle SOA Server is complete before starting Oracle BAM Server.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
If you do not know the names of the managed servers that need to be started,
you can view the contents of the following file on UNIX operating systems:
MW_HOME/user_projects/domains/domain_name/startManagedWebLogic
_readme.txt
On Windows systems:
MW_HOME\user_projects\domains\domain_name\startManagedWebLogic
_readme.txt
Or, you can access the Administration Server console at the following URL:
http://host:admin_server_port/console
Supply the username and password that you specified on the Configure
Administrator Username and Password Screen of the Configuration Wizard.
Then, navigate to Environment > Servers to see the names of your managed
servers.
3.7.2.
Starting Node Manager on a machine that hosts Managed Servers allows you
to start and stop the Managed Servers remotely using the Administration
Console or the command line. Node Manager can also automatically restart a
Managed Server after an unexpected failure.
To start Node Manager:
1. On UNIX operating systems, run the
MWHome/oracle_common/common/bin/setNMProps.sh
script.
script.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
script.
3.7.3.
This information was visible on the Creating Domain Screen (the last
screen) of the Configuration Wizard.
You will be prompted for the username and password credentials that
you specified on the Configure Administrator Username and Password
Screen of the Configuration Wizard.
You will be prompted for the username and password credentials that
you specified on the Configure Administrator Username and Password
Screen of the Configuration Wizard.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
7. SECURITY
7.1.
Integration with Cisco AD Weblogic (CM only)
For Weblogic to authenticate and authorize against Cisco AD a new authenticator
needs to be added to the default realm using the following configuration:
1. Go to the directory $DOMAIN_HOME/config
2. Open the xml configuration file config.xml for editing.
3. Append the below xml element <sec:authentication-provider> as a child element
in the first place/order within the <realm> element.
<sec:authentication-provider xsi:type="wls:active-directory-authenticatorType">
<sec:name>ciscoADAuthenticator</sec:name>
<sec:control-flag>SUFFICIENT</sec:control-flag>
<wls:propagate-cause-for-login-exception>false</wls:propagate-cause-for-login-exception>
<wls:host>ds.cisco.com</wls:host>
<wls:user-name-attribute>sAMAccountName</wls:user-name-attribute>
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
<wls:principal>CN=iportalprod.gen,OU=Generics,OU=Cisco Users,DC=cisco,DC=com</wls:principal>
<wls:user-base-dn>OU=Cisco Users,DC=cisco,DC=com</wls:user-base-dn>
<wls:credential-encrypted>csgita2z4</wls:credential-encrypted>
<wls:user-from-name-filter>(&amp;(sAMAccountName=%u)(objectclass=user)
(objectCategory=person))</wls:user-from-name-filter>
<wls:group-base-dn>OU=Standard,OU=Cisco Groups,DC=cisco,DC=com</wls:group-base-dn>
</sec:authentication-provider>
4. The values of user-base and group-base elements in the above xml, need to be
modified as per the environment.
5. All the Weblogic servers need to be restarted to reflect the changes.
7.2.
Integration with Cisco AD OPSS (CM Only)
For OPSS (Oracle Platform Security Services) to authenticate and authorize against the
Ciscos AD (Active Directory) the following configuration steps need to be followed:
1. Go to the directory $DOMAIN_HOME/config/fmwconfig
2. Open the xml configuration file jps-config.xml for editing.
3. Ensure that the below element for <ServiceProvider> is present under
<ServiceProviders>. If not, add it.
<serviceProvider
class="oracle.security.jps.internal.idstore.ldap.LdapIdentityStoreProvider"
name="idstore.ldap.provider" type="IDENTITY_STORE">
<description>LDAP-based IdentityStore Provider</description>
4. Locate the Service Instance for the provider "idstore.ldap.provider" under
<ServiceInstances>. If any LDAP is already configured OR if this element is not
present add a new instance using the below element. Ensure that the below
element is added.
<serviceInstance name="idstore.AD" provider="idstore.ldap.provider">
<property name="username.attr" value="sAMAccountName"/>
<property name="user.login.attr" value="sAMAccountName"/>
<property name="subscriber.name"
value="CN=iportalprod.gen,OU=Generics,OU=Cisco Users,DC=cisco,DC=com"/>
<property name="idstore.type" value="ACTIVE_DIRECTORY"/>
<property name="cleartext.ldap.credentials"
value="CN=iportalprod.gen,OU=Generics,OU=Cisco Users,DC=cisco,DC=com:csgita2z4"/>
<property name="ldap.url" value="ldap://ds.cisco.com:389"/>
<extendedProperty>
<name>user.object.classes</name>
<values>
<value>top</value>
<value>person</value>
<value>inetorgperson</value>
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
<value>organizationalperson</value>
<value>orcluser</value>
<value>orcluserv2</value>
<value>ctCalUser</value>
</values>
</extendedProperty>
<extendedProperty>
<name>user.search.bases</name>
<values>
<value>OU=Cisco Users,DC=cisco,DC=com</value>
</values>
</extendedProperty>
<extendedProperty>
<name>group.search.bases</name>
<values>
<value>OU=Standard,OU=Cisco Groups,DC=cisco,DC=com</value>
</values>
</extendedProperty>
</serviceInstance>
5. The values of <user.search.bases> and <group.search.bases> elements in the
above xml, need to be modified as per the environment.
6. Locate the <jpsContext> element with name default inside <jpsContexts>. Add
an element <serviceInstanceRef ref="idstore.AD"/> as a child. Ensure that it
looks like below:
<jpsContexts default="default">
<jpsContext name="default">
<serviceInstanceRef ref="credstore"/>
<serviceInstanceRef ref="keystore"/>
<serviceInstanceRef ref="policystore.xml"/>
<serviceInstanceRef ref="audit"/>
<serviceInstanceRef ref="idstore.AD"/>
<serviceInstanceRef ref="trust"/>
<serviceInstanceRef ref="pdp.service"/>
</jpsContext>
7. Delete the instance reference for idstore.ldap.
8. All the SOA servers need to be restarted to reflect the changes.
7.3.
Creating Application Role and Adding Users/Groups from AD
Create 2 Application Role with name SOMT and ITOPS using the steps below:
1. Open EM (Enterprise Manager) using admin login
2. Locate the Domain in left-hand pane under Weblogic Domains
3. Right Click on Domain and browse to Security -> Application Roles
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
6. Add the Roles, Groups or Users from sections below on same page.
7. Add the user iportalprod.gen to Roles = {SOAAdmin, SOAOperator,
BPMWorkflowAdmin} roles on SOA-INFRA application.
7.4.
Configuring OWSM for securing Web-Services
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
7.4.1.
Follow the steps below to create a user to authenticate
for the Web-Services.
1. Open Weblogic console with Admin login
2. Go to Security Realms -> myrealm and choose Users and Groups tab.
3. Create
a
local
user
password=omsmanager10
with
username=omsmanager
with
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
7.4.2.
Below steps are required to create Security Credentials
for OWSM
1. Open EM (Enterprise Manager) using admin login
2. Locate the IServicesClusterDomain in left-hand pane under Weblogic
Domains
3. Right click on domain and go-to Security->Credentials
4. Ensure that there is a map with name oracle.wsm.security present. If
not, create it.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
7.5.
GM eBonding Http Basic Authentication (DEMO Env)
7.5.1.
Follow the steps below to create a user to authenticate
for the Web-Services.
Go to Security Realms -> myrealm and choose Users and Groups tab
Click on New
Create a New User Page comes up and
Enter the following:
Name: gmebond
Description:
GM eBonding project username
Password:
gmebond123
Confirm password:
gmebond123
7.5.2.
Below steps are required to create Security Credentials
for OWSM
Key: [gmebond.credentials].
Username/Passwords: gmebond/gmebond123
7.6.
GM eBonding Http Basic Authentication (Pre-Prod and Prod
Env)
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
7.6.1.
Follow the steps below to create a user to authenticate
for the Web-Services.
Go to Security Realms -> myrealm and choose Users and Groups tab
Click on New
Create a New User Page comes up and
Enter the following:
Name: gmebond
Description:
GM eBonding project username
Password:
c!3C0W33#x
Confirm password:
c!3C0W33#x
7.6.2.
Below steps are required to create Security Credentials
for OWSM
Key: [gmebond.credentials].
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
8. ADDING DATASOURCES
For deployed J2EE and SOA applications to interact with external databases, a datasource needs to be created using Weblogic Console.
Follow the below steps for adding a new data-source (e.g. for COSM database):
4.
5.
6.
7.
8. Choose the correct Driver per database configuration (Check with DBA)
For Development/Sandbox choose Thin XA as shown below and click Next.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
9. Set the database details like (Database SID, IP Address, Port, Username and
Password) as shown below and click Next.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
10. Verify all the details at this Page, test the setup by clicking on Test Configuration and
Click Finish.
11. Repeat the steps 1-7 for BLiS datasource configuration. Ensure that the JNDI name
for cosm data-source is jdbc/eis/cosmDB and BLiS data-source is
jdbc/eis/DHDLDB
12. Add the below mentioned 3 data-sources. Please double check these details for each
environment. These are good for SOA SandBox only.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Open the list of connection pools again (as in step 3) and click on the newly created
eis/DB/COSMConn as shown below
8. In the property page set the JNDI name of the data-source i.e. jdbc/eis/cosmDB as
configured in previous section. Click Save.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
9. Repeat the steps 1-8 for adding another connection factory for BLiS. Ensure that the
JNDI name is eis/DB/DHDLConnection and it points to the BLiS data-source with
JNDI name jdbc/eis/DHDLDB as created in previous section.
10. Create the following 3 connection factories. Refer to section 7-12 for more details:
eis/DB/DHDLConnection
eis/DB/BlisCOMConnection
eis/DB/ODSConnection
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Oracle Installer can be used to install Oracle JDeveloper Studio 11.1.1.x.x, the
ADF Runtime, and Oracle WebLogic Server 11g Release 1 (10.3.4) on your
system.
Oracle Installer is available in the following forms:
10.1.
SOA Extensions for JDeveloper (Developer only)
Install the SOA Extension using the JDeveloper Update Center. From the JDeveloper
menu choose Help > Check for Updates. In the Update Wizard, select Search Update
Centers and ensure Oracle Fusion Middleware Products is checked (screenshot).
Then ensure that Oracle SOA Composite Editor is checked ( screenshot, your version
may not match the screenshot exactly). The SOA Extension is approximately 200 MB.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Edit/ Configure the Properties as below (Use applicable property values) and SAVE.
(Following are Mandatory properties setting up User Messaging successfully.
Common Configuration :
Sender Address AND Default Sender Address : Address of Sender
(EMAIL:sender@example.com, EMAIL:sender@example2.com)
MailAccessProtocol ------ IMAP
ReceiveFolder ----- INBOX
OutGoingMailServerPort ---- 25 (Default)
OutGoingDefaultFromAddr --- FromEmailAddress@cisco.com
OutGoingUserName --- (Your applicable user name)
OutGoingPassword ----- useClearTextPassword and enter password
IncomingMailServer ---- mail.cisco.com
Incoming Port ---- 143 (default port)
IncomingMailServerSSL false (default)
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Select in EM
1> SOA --- Soa-Infra --- Soa Infrastructure --- SOA Administration --- WorkFlow
Notification Properties --- Here change FROM Address and Reply TO, Actionable
Email address as well. Also click More WorkflowNotification Configuration/ check
Properties. Configure the Sender, Receiver information here
2> SOA --- Soa-Infra --- Soa Infrastructure --- SOA Administration --- WorkFlow Task
Service Properties -- More WorkFlow Task Service Properties configuration.
Configure / Check the Sender / Receiver properties.
If Human Task is configured to send emails to all users in Role, then all users within that specified
role would receive emails from Human Task.
PingWeb.war.rar
Raise the remedy ticket to run the DB scripts for COM DB. CVS Location for script is \soaservices\database-scripts\COMScripts\COM_SCHEMA_SCRIPTS.sql
Add the following entries in the soabuild.properteis file if not exist for the new
environment with environment specific values. <env> is like qa, uat, sandbox, prod, etc
a. <env>.serverURL=http://<host>:<port>
b. <env>.server=<host>
c. <env>.port=<port>
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
d.
e.
f.
g.
<env>.overwrite=true
<env>.user=weblogic
<env>.password=XXXXX
<env>.mdsurl=jdbc:oracle:thin:@<MDS DB host>:<DB
Port>:<service name>
h. <env>.mdsuser=SOA_MDS
i. <env>.mdspassword=XXXXXX
j. <env>.mdsinfra=soa-infra
k. <env>.forceDefault=true
l. <env>.TrailRunURL=http://sjhdde156.corp.webex.com:90
00 (Will provide by dev team)
m. <env>.CreateCVSDBUrl=sjdbbe310.corp.webex.com:143
13:bhdl (dev team will provide)
n. <env>.CreateCVSDBUser=cosm1
o. <env>.CreateCVSDBPassword=Webex_123
Then start the deploying services into the new environment.
a. First replace the following environment variable in the
soabuild.properteis file deployment.plan.environment
to environment like dev, sandbox, uat, qa
b. Then deploy the SOA applications by calling the following
targets in the same order mentioned bellow.
deployDVMEBO
build.CommonSOAApp
build.PartyMgmtSOAApp
build.AccountMgmtSOAApp
build.BOSSOAApp
build.CommonFaultHandlerSOAApp
build.OrderMgmtSOAApp
build.ProvisionMgmtSOAApp
build.PostOrderFulfillment
build.TrialRunSOAApp
build.OMSSOAApp
build.OrderProcessingMediatorSOAApp
build.CaseMgmtSOAApp
15.1.
Manula deployment of SOA Extension jar files
This sections explains the deploying the java code (Fault Policies jar) file to SOA
extension folder.
This is one time requirement only. After run first time, not required this step in future
deployments. Just copy the FaultPolicy.jar file after the build to the oracle.soa.ext_11.1.1
folder and restart the soa servers.
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Set the ANT_HOME & JAVA_HOME (ant wont be available in the soa folder.
We need to copy the ant to this VM)
Run the following command $ANT_HOME/bin/ant
15.2.
Patch deployment for Large File Size
o
This sections explains the patch deployment that is required for large file size
support. Without this, the BPEL processes like OrderMgmtSOAProject will not
get deployed.
Error - SCAC-50012
Patch Number - 11066656
Metalink note ID 1299247.1
Patch file is attached.
p11066656_111140_Generic.zip
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
Please add the following to httpd.conf of the Apache web server which does the load
balancing:
For Pre-Prod:
Replace sjisbe381 host port with the actual Pre-prod secondary VIP.
ProxyPass /soa-infra/services/default/CaseMgmtSOAProject/ReceiveTicket_B2BHTTP
http://sjisbe381:21011/soa-infra/services/default/CaseMgmtSOAProject/ReceiveTicket_B2BHTTP
RequestHeader set SOAPAction "Send"
ProxyPassReverse /soa-infra/services/default/CaseMgmtSOAProject/ReceiveTicket_B2BHTTP
http://sjisbe381:21011/soa-infra/services/default/CaseMgmtSOAProject/ReceiveTicket_B2BHTTP
For Prd:
Replace sjisbe381 host port with the actual Prod secondary VIP.
ProxyPass /soa-infra/services/default/CaseMgmtSOAProject/ReceiveTicket_B2BHTTP
http://sjisbe381:21011/soa-infra/services/default/CaseMgmtSOAProject/ReceiveTicket_B2BHTTP
RequestHeader set SOAPAction "Send"
ProxyPassReverse /soa-infra/services/default/CaseMgmtSOAProject/ReceiveTicket_B2BHTTP
http://sjisbe381:21011/soa-infra/services/default/CaseMgmtSOAProject/ReceiveTicket_B2BHTTP
drop
down
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
drop
down
drop
down
drop
down
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
c. Select GMTicketInBoundQueue
d. Under Settings for GMTicketInBoundQueue, click on the
DeliveryFailure.
e. Enter the following:
i. Redelivery Delay Override: 300000
ii. Redelivery Limit: 2
iii. Expiration Policy: Redirect
iv. Expiration Logging Format: <Do not enter anything in the
box>
v. Error Destination: GMTicketErrorQueue
f. Click on Save
6. Configure Redelivery for the GMTicketOutBoundQueue
a. Navigate to the following:
Domain Structure->Services->Messaging->JMS Modules
b. Click on SOAJMSModule
c. Select GMTicketInBoundQueue
d. Under Settings for GMTicketInBoundQueue, click on the
DeliveryFailure.
e. Enter the following:
i. Redelivery Delay Override: 300000
ii. Redelivery Limit: 2
iii. Expiration Policy: Redirect
iv. Expiration Logging Format: <Do not enter anything in the
box>
v. Error Destination: GMTicketOutBoundErrorQueue
f. Click on Save
tab
text
tab
text
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
This section explains the custom changes in the new Weblogic (10.4) server for deploying
the applications.
20.1.
Classpath changes in weblogic-application.xml file.
The following changes needs to be added in weblogic-applications.xml in META-INF
folder in the ear file for the following applications
o XML Fragment to add in weblogic-application.xml file
AccountInqAppV2
AccountMgmtAppV2
PaymentMgmtAppV2
PaymentInqAppV2
OrderMgmtAppV2
CatalogMgmtAppv2
EventApp
SalesConnectorApp
SiteInquiryApp
SubscriptionMgmtApp
SystemCatalogApp
20.2.
Forbidden issue
In setDomain.sh
o
o
-Dproperties.server.url=sjisde804v.corp.webex.com
APPLCN_PROPERTY_LOC="/home/iservices10/apps/a
pplications/dynamic-loading/
-Dapplication.resource.location=$
{APPLCN_PROPERTY_LOC}
-Dproperties.server.url=<LB URL>
20.3.
Change publishing folder
ORACLE SOA SUITE 11G & OSB 11G SETUP QUICK REFERENCE GGUIDE
-----------------------------------------------------------------------------------------------------------------------------------------------------------------
/home/httpd/soa/public_html
20.4.
Weblogic User-Profile Changes
Create users, groups & Roles in Weblogic Admin Console as per the following xls
document.
weblogicusers-org.xl
sx
20.5.
Changing iservices.properties file