17 Extending the Domain with Oracle B2B
The Oracle B2B and Healthcare distribution includes the software required to configure Oracle B2B or Oracle SOA for Healthcare.
Note:
Healthcare in a WebLogic Domain option was deprecated in Fusion Middleware 12.2.1.4.0 and is removed from 14.1.2 release. Therefore, the chapter titled Extending the Domain with Oracle SOA Suite for Healthcare Integration is no longer included in this guide. This chapter covers the procedure to include B2B only.
- Variables Used When Configuring Oracle B2B
As you perform the tasks in this chapter, you reference the directory variables that are listed in this section. - Support for Reference Configuration in Oracle B2B
Oracle B2B supports both SOA classic domains and SOA Reference Configuration domains. There is a specific B2B template when B2B is added to a classic SOA domain (the B2B classic template), and a specific B2B template when B2B is added to a Reference Configuration SOA domain (B2B Reference Configuration template). - Prerequisites for Extending the SOA Domain to Include Oracle B2B
Before you extend the current domain, ensure that your existing deployment meets the prerequisites specified in this section. - Installing Oracle B2B for an Enterprise Deployment
Use the following sections to install the Oracle Fusion Middleware Infrastructure software in preparation for configuring a new domain for an enterprise deployment. - Running the Configuration Wizard to Extend for Oracle B2B
To extend the domain to include Oracle B2B, refer to the following sections. - Propagating the Extended Domain to the Domain Directories and Machines
After you have extended the domain with the B2B instances, and have restarted the Administration Server on SOAHOST1, you must propagate the domain changes to the domain directories and machines. - Starting the B2B Suite Components
For configuration changes and start scripts to be effective, you must start the WLS_SOA server to which B2B has been added. Since B2B extends an already existing SOA system, the Administration Server and the respective Node Managers are already running in SOAHOST1 and SOAHOST2. - Updating the B2B Instance Identifier for Transports
To set up File, FTP, or Email transports in a high availability environment, set theb2b.HAInstance
property to true. - Configuring the Web Tier for the Extended Domain
Configure the web server instances on the web tier so that the instances route to the proper clusters in the SOA domain. - Adding the B2BAdmin Role to the SOA Administrators Group
Before you validate the Oracle B2B configuration on the Managed Servers, add theB2BAdmin
administration role to the enterprise deployment administration group (SOA Administrators
). - Validating Access to Oracle B2B Through the Load Balancer
Use the following steps to verify that the appropriate routing and failover is working from the load balancer to the HTTP Server instances to the B2B Suite Components on the Oracle SOA Suite Managed Server. - Replacing Connect Strings with the Appropriate TNS Alias
Oracle recommends using TNS Alias in the connection strings used by FMW components instead of repeating long JDBC strings across multiple connections pools. - Backing Up the Configuration
It is an Oracle best practices recommendation to create a backup after you successfully configure a domain or at another logical point. Create a backup after you verify that the installation so far is successful. This is a quick backup for the express purpose of immediate restoration in case of problems in later steps.
Parent topic: Configuring the Enterprise Deployment
Variables Used When Configuring Oracle B2B
As you perform the tasks in this chapter, you reference the directory variables that are listed in this section.
The values for several directory variables are defined in File System and Directory Variables Used in This Guide.
-
ORACLE_HOME
-
ASERVER_HOME
-
MSERVER_HOME
-
WEB_DOMAIN_HOME
-
JAVA_HOME
In addition, you reference the following virtual IP (VIP) addresses that are defined in Physical and Virtual IP Addresses Required by the Enterprise Topology:
-
ADMINVHN
Actions in this chapter are performed on the following host computers:
-
SOAHOST1
-
SOAHOST2
-
WEBHOST1
-
WEBHOST2
Parent topic: Extending the Domain with Oracle B2B
Support for Reference Configuration in Oracle B2B
Oracle B2B supports both SOA classic domains and SOA Reference Configuration domains. There is a specific B2B template when B2B is added to a classic SOA domain (the B2B classic template), and a specific B2B template when B2B is added to a Reference Configuration SOA domain (B2B Reference Configuration template).
Parent topic: Extending the Domain with Oracle B2B
Prerequisites for Extending the SOA Domain to Include Oracle B2B
Before you extend the current domain, ensure that your existing deployment meets the prerequisites specified in this section.
-
Back up the installation. If you have not yet backed up the existing Fusion Middleware Home and domain, Oracle recommends backing it up now.
To back up the existing Fusion Middleware Home and domain, see Performing Backups and Recoveries in the SOA Enterprise Deployments.
-
There is an existing WL_HOME and SOA ORACLE_HOME (binaries) installed in previous chapters on a shared storage and available from SOAHOST1 and SOAHOST2.
-
Node Manager, Admin Server, SOA Servers, and WSM Servers exist and have been configured as described in previous chapters to run a SOA system.
-
You do not need to run RCU to load additional schemas for B2B, these are part of the SOA repository and were loaded into the DB in the SOA chapter.
-
You do not need to create an additional cluster because B2B components are added to the previously created SOA_cluster.
Parent topic: Extending the Domain with Oracle B2B
Installing Oracle B2B for an Enterprise Deployment
Use the following sections to install the Oracle Fusion Middleware Infrastructure software in preparation for configuring a new domain for an enterprise deployment.
- Starting the Oracle B2B and Healthcare Installer on SOAHOST1
- Navigating the Oracle B2B Installation Screens
- Installing the Software on Other Host Computers
- Verifying the B2B or Healthcare Installation
Parent topic: Extending the Domain with Oracle B2B
Starting the Oracle B2B and Healthcare Installer on SOAHOST1
To start the installation program, perform the following steps.
When the installation program appears, you are ready to begin the installation. See Navigating the Installation Screens for a description of each installation program screen.
Parent topic: Installing Oracle B2B for an Enterprise Deployment
Navigating the Oracle B2B Installation Screens
Table 17-1 provides description of each installation program screen.
Table 17-1 Oracle B2B Install Screens
Screen | Description |
---|---|
On UNIX operating systems, if this is the first time you are installing any Oracle product on this host, this screen appears. Specify the location where you want to create your central inventory. Make sure that the operating system group name selected on this screen has write permissions to the central inventory location. For more information about the central inventory, see Understanding the Oracle Central Inventory in Installing Software with the Oracle Universal Installer. Note: Oracle recommends that you configure the central inventory directory on the products shared volume. Example: You may also need to execute the |
|
This screen introduces you to the product installer. |
|
Use this screen to automatically search My Oracle Support for available patches or automatically search a local directory for patches that you’ve already downloaded for your organization. |
|
Use this screen to specify the location of your Oracle home directory. For more information about Oracle Fusion Middleware directory structure, see Selecting Directories for Installation and Configuration in Planning an Installation of Oracle Fusion Middleware. |
|
Use this screen to select the type of installation and consequently, the products and feature sets that you want to install. Select B2B NOTE: The topology in this document does not include the examples, Oracle strongly recommends that you do not install the examples into a production environment. |
|
This screen verifies that your system meets the minimum necessary requirements. If there are any warning or error messages, you can refer to one of the following documents in Roadmap for Verifying Your System Environment in Installing and Configuring the Oracle Fusion Middleware Infrastructure. |
|
Use this screen to verify the installation options that you selected. If you want to save these options to a response file, click Save Response File and provide the location and name of the response file. Response files can be used later in a silent installation situation. For more information about silent or command-line installation, see Using the Oracle Universal Installer in Silent Mode in Installing Software with the Oracle Universal Installer. Click Install to begin the installation. |
|
This screen allows you to see the progress of the installation. Click Next when the progress bar reaches 100% complete. |
|
Review the information on this screen, then click Finish to dismiss the installer. |
Parent topic: Installing Oracle B2B for an Enterprise Deployment
Installing the Software on Other Host Computers
If you have configured a separate shared storage volume or partition for SOAHOST2, then you must also install the software on SOAHOST2. For more information, see Shared Storage Recommendations When Installing and Configuring an Enterprise Deployment.
Note that the location where you install the Oracle home (which contains the software binaries) varies, depending upon the host. To identify the proper location for your Oracle home directories, refer to the guidelines in File System and Directory Variables Used in This Guide.
Parent topic: Installing Oracle B2B for an Enterprise Deployment
Verifying the B2B or Healthcare Installation
After you complete the installation, you can verify it by successfully completing the following tasks.
Parent topic: Installing Oracle B2B for an Enterprise Deployment
Reviewing the Installation Log Files
Review the contents of the installation log files to make sure that no problems were encountered. For a description of the log files and where to find them, see Understanding Installation Log Files in Installing Software with the Oracle Universal Installer.
Parent topic: Verifying the B2B or Healthcare Installation
Viewing the Contents of Your Oracle Home
You can also view the contents of your Oracle home by using the viewInventory
script. See Viewing the contents of an Oracle home in Installing Software with the
Oracle Universal Installer.
Parent topic: Verifying the B2B or Healthcare Installation
Running the Configuration Wizard to Extend for Oracle B2B
To extend the domain to include Oracle B2B, refer to the following sections.
Parent topic: Extending the Domain with Oracle B2B
Starting the Configuration Wizard
Note:
SSL store customizations were added to the
setUserOverridesLate.sh
in the domain creation chapter. Any
customizations added to this file are preserved when a domain is extended and
are carried over to remote servers when using the pack
and unpack commands.
However, if you added any additional customizations to the
setDomainEnv.sh
script in the domain (such as custom
libraries, JAVA command line options for starting the servers or environment
variables), those will be overwritten by the configuration wizard when you
extend the domain. Add all the startup parameters that apply to all servers in a
domain to the setUserOverridesLate.sh
file. This will preserve
them across extensions.
To start the Configuration Wizard:
Navigating the Configuration Wizard Screens for Oracle B2B
Follow the instructions in this section to extend the domain for Oracle B2B.
Note:
This procedure assumes that you are extending an existing domain. If your needs do not match the instructions given in the procedure, ensure that you make your selections accordingly, or refer to the supporting documentation for additional details.
Domain creation and configuration includes the following tasks:
-
Task 1, "Selecting the Domain Type and Domain Home Location"
-
Task 3, "Providing the GridLink Oracle RAC Database Connection Details"
-
Task 6, "Reviewing Your Configuration Specifications and Configuring the Domain"
-
Task 7, "Writing Down Your Domain Home and Administration Server URL"
- Task 1 Selecting the Domain Type and Domain Home Location
-
On the Configuration Type screen, select Update an existing domain.
In the Domain Location field, select the value of the
ASERVER_HOME
variable, which represents the complete path to the Administration Server domain home you created in Creating the Initial Infrastructure Domain for an Enterprise Deployment.For more information about the directory location variables, see File System and Directory Variables Used in This Guide
Tip:
More information about the other options on this screen can be found in Configuration Type in Creating WebLogic Domains Using the Configuration Wizard.
- Task 2 Selecting the Configuration Template
-
On the Templates screen, make sure Update Domain Using Product Templates is selected, then select the following templates:
-
Oracle B2B Reference Configuration [soa]
In addition, the following additional templates should already be selected, because they were used to create the initial domain and extend it to SOA:
-
Basic Weblogic Server Domain [wlserver]
-
Oracle SOA Suite Reference Configuration [soa]
-
Oracle Enterprise Manager [em]
-
Oracle WSM Policy Manager [oracle_common]
-
Oracle JRF [oracle_common]
-
WebLogic Coherence Cluster Extension [wlserver]
Note:
If you are extending B2B on a Classic SOA domain, you need to select the B2B classic extension template. To select the B2B Classic extension template:
-
Oracle B2B - 14.1.2.0 [soa]
Tip:
More information about the options on this screen can be found in Templates in Creating WebLogic Domains Using the Configuration WizardCreating WebLogic Domains Using the Configuration Wizard.
-
- Task 3 Providing the GridLink Oracle RAC Database Connection Details
-
All fields are pre-populated because you already configured the domain to reference the Fusion Middleware schemas that are required for the Infrastructure domain. B2B uses the existing data sources for SOA and no new data sources need to be added to the domain.
Note:
Any custom data sources that were created before the extension will show up before this screen. Check the Datasources row and click Next. The test data source screen will verify its validity.
Click Next.
- Task 4 Testing the JDBC Connections
-
On the Test JDBC Data Sources screen, confirm that all connections were successful.
The connections are tested automatically. The Status column displays the results. If all connections are not successful, click Previous to return to the previous screen and correct your entries.
Click Next when all the connections are successful.
- Task 5 Selecting Advanced Configuration
-
To complete domain configuration for the topology, do not select any additional options on the Advanced Configuration screen and Click Next. B2B applications and required artifacts will be targeted automatically to the existing SOA servers
- Task 6 Reviewing Your Configuration Specifications and Configuring the Domain
-
The Configuration Summary screen contains the detailed configuration information for the domain you are about to extend. Review the details of each item on the screen and verify that the information is correct.
If you need to make any changes, you can go back to any previous screen , either by using the Back button or by selecting the screen in the navigation pane.
Click Update to execute the domain extension.
In the Configuration Progress screen, click Next when it finishes.
Tip:
More information about the options on this screen can be found in Configuration Summary in Creating WebLogic Domains Using the Configuration Wizard.
- Task 7 Writing Down Your Domain Home and Administration Server URL
-
The Configuration Success screen will show the following items about the domain you just configured:
-
Domain Location
-
Administration Server URL
You must make a note of both items as you will need them later; the domain location is needed to access the scripts used to start the Administration Server, and the URL is needed to access the Administration Server.
Click Finish to dismiss the configuration wizard.
-
- Task 8 Start the Administration Server
-
Start the Administration Server to ensure the changes you have made to the domain have been applied.
Propagating the Extended Domain to the Domain Directories and Machines
After you have extended the domain with the B2B instances, and have restarted the Administration Server on SOAHOST1, you must propagate the domain changes to the domain directories and machines.
The following table summarizes the steps required to propagate the changes to all the domain directories and machines.
Task | Description | More Information |
---|---|---|
Pack up the Extended Domain on SOAHOST1 |
Use the When you pack up the domain, create a template jar file called |
|
Unpack the Domain in the Managed Servers Directory on SOAHOST1 |
Unpack the template jar file in the Managed Servers directory on SOAHOST1 local storage. |
Unpacking the Domain in the Managed Servers Domain Directory on SOAHOST1 |
Unpack the Domain on SOAHOST2 |
Unpack the template jar file in the Managed Servers directory on the SOAHOST2 local storage. |
Parent topic: Extending the Domain with Oracle B2B
Starting the B2B Suite Components
For configuration changes and start scripts to be effective, you must start the WLS_SOA server to which B2B has been added. Since B2B extends an already existing SOA system, the Administration Server and the respective Node Managers are already running in SOAHOST1 and SOAHOST2.
To start the added B2B components, start the SOA managed servers:
-
Enter the following URL in a browser to display the Fusion Middleware Control login screen:
https://ADMINVHN:9002/em
Note:
If you have already configured web tier, usehttps://admin.example.com:445/em
.In this example:
Replace ADMINVHN with the host name assigned to the ADMINVHN Virtual IP address in Identifying and Obtaining Software Downloads for an Enterprise Deployment.
Port 9002 is the typical Administration port used for the Remote Console and Fusion Middleware Control. However, you should use the actual URL that was displayed at the end of the Configuration Wizard session when you created the domain.
-
In the Domain Structure window, expand the Environment node, then select Servers.
The Summary of Servers page appears.
-
Click the Control tab.
-
Select WLS_SOA1 from the Servers column of the table.
Note:
SOA servers depend on the policy access service to be functional. This dependency implies that the WSM-PM servers in the domain need to be reachable before the SOA servers are started. -
Click Start.
-
Repeat steps 2 through 5 for WLS_SOA2.
Parent topic: Extending the Domain with Oracle B2B
Updating the B2B Instance Identifier for Transports
To set up File, FTP, or Email transports in a high availability environment, set the b2b.HAInstance
property to true.
To do this follow these steps:
Parent topic: Extending the Domain with Oracle B2B
Configuring the Web Tier for the Extended Domain
Configure the web server instances on the web tier so that the instances route to the proper clusters in the SOA domain.
- Configuring Oracle HTTP Server for Oracle B2B
Make the following modifications to the Oracle HTTP Server instance configuration files to ensure that the Oracle HTTP Server instances in the web tier can route Oracle B2B requests correctly to the Oracle B2B software on the Oracle SOA Suite cluster.
Parent topic: Extending the Domain with Oracle B2B
Configuring Oracle HTTP Server for Oracle B2B
Make the following modifications to the Oracle HTTP Server instance configuration files to ensure that the Oracle HTTP Server instances in the web tier can route Oracle B2B requests correctly to the Oracle B2B software on the Oracle SOA Suite cluster.
To enable Oracle HTTP Server to route requests to Oracle B2B Console and to Oracle B2B services:
Parent topic: Configuring the Web Tier for the Extended Domain
Adding the B2BAdmin Role to the SOA Administrators Group
Before you validate the Oracle B2B configuration on the Managed Servers, add the B2BAdmin
administration role to the enterprise deployment administration group (SOA Administrators
).
To perform this task, refer to Configuring Roles for Administration of Oracle SOA Suite Products.
Parent topic: Extending the Domain with Oracle B2B
Validating Access to Oracle B2B Through the Load Balancer
Use the following steps to verify that the appropriate routing and failover is working from the load balancer to the HTTP Server instances to the B2B Suite Components on the Oracle SOA Suite Managed Server.
Parent topic: Extending the Domain with Oracle B2B
Replacing Connect Strings with the Appropriate TNS Alias
Oracle recommends using TNS Alias in the connection strings used by FMW components instead of repeating long JDBC strings across multiple connections pools.
For more information about how to use TNS alias in your Datasources, see Using TNS Alias in Connect Strings in the Common Configuration and Management Tasks for an Enterprise Deployment chapter.
Parent topic: Extending the Domain with Oracle B2B
Backing Up the Configuration
It is an Oracle best practices recommendation to create a backup after you successfully configure a domain or at another logical point. Create a backup after you verify that the installation so far is successful. This is a quick backup for the express purpose of immediate restoration in case of problems in later steps.
The backup destination is the local disk. You can discard this backup when the enterprise deployment setup is complete. After the enterprise deployment setup is complete, you can initiate the regular deployment-specific Backup and Recovery process. See Performing Backups and Recoveries for an Enterprise Deployment.
Parent topic: Extending the Domain with Oracle B2B