This action might not be possible to undo. Are you sure you want to continue?
Oracle SOA Suite enables services to be created, managed, and orchestrated into SOA composite applications. Composites enable you to easily assemble multiple technology components into one SOA composite application. Oracle SOA Suite plugs into heterogeneous infrastructures and enables enterprises to incrementally adopt SOA. Oracle Business Process Management Suite provides a complete set of tools for creating, executing, and optimizing business processes. This chapter includes the following sections: 1.1, "Oracle SOA Suite Components" 1.2, "Oracle SOA Suite Installation Roadmap" 1.1 Oracle SOA Suite Components Oracle SOA Suite contains the following components: Oracle Business Process Execution Language (BPEL) Process Manager (PM), with Mediator, Rules, B2B, and Human Workflow Oracle BPEL is an XML-based language for enabling task sharing across multiple enterprises using a combination of Web services. BPEL is based on the XML schema; simple objects access protocol (SOAP), and Web services description language (WSDL). Oracle BPEL Process Manager provides a framework for easily designing, deploying, monitoring, and administering processes based on BPEL standards. Oracle Business Activity Monitoring (BAM): Oracle BAM provides a framework for creating dashboards that display real-time data inflow and creating rules to send alerts under specified conditions. Oracle Business Process Management Suite (BPM): This product provides a set of tools for creating, executing, and optimizing business processes. 1.2 Oracle SOA Suite Installation Roadmap Figure 1–1 shows the directory structure of a simple Oracle SOA Suite installation on a single host, using all of the default values.
Figure 1–1 Directory Structure of Oracle SOA Suite Installation
Memory and Disk Space Requirements
The software requires a minimum of 3 GB available memory to run, but more is recommended. If you have less, separate the installation of the database, servers, and JDeveloper to different machines. If you install SOA Suite without Oracle Service Bus, you need about 4.81 GB of disk space to download the install files plus about 5.15 GB to install everything. Your database takes an additional 5 GB (or so, depending on your configuration). Oracle Service Bus will add about 1.2 GB of disk space.
Check your browser
Enterprise Manager requires Firefox 3, Safari 4+ or IE 7+. BAM requires IE 7 or 8 IE 7 without special plug-ins (there’s a Pro-search plug-in and Microsoft Internet Explorer Knowledge Base Update (KB2416400) that causes problems). IE 6 has a few UI issues. Firefox does not work.
Check your JDK
The WebLogic server installation exe is packaged with a JDK. The JDeveloper exe also comes with a JDK.
If you are going to install WebLogic server and JDeveloper on the same machine, you use the JDK from WebLogic for JDeveloper too. However, if you are going to install on separate machines, you need to have JDK 6.0 Update 24 for Windows for Developer, available at http://www.oracle.com/technetwork/java/javase/downloads/index.html
Now you have all of the files required for the installation of SOA Suite 18.104.22.168.0, except possibly the database. The first step is to confirm your database installation and install a database if necessary.
Install the database
Determine which database version you have already, if any, and then decide which database version you will use for your SOA installation. Oracle Database is the recommended database for SOA Suite deployments. Oracle Express Edition (XE) 10.2.0.1 does not meet the minimum version requirement for supported use, but will generally work in a personal development environment. You need one of XE Universal or Standard database version 10.2.0.1, or Oracle 10g database version 10.2.0.4+ or Oracle 11g database version 22.214.171.124+ or 126.96.36.199+ You may see problems with installing XE when you already have 10g installed on Windows. The Windows registry sometimes gets the database file locations confused. If you need to uninstall a database, you should follow the instructions. If you need to uninstall XE, be sure to follow these instructions Oracle Database Express Edition Installation Guide 10g Release 2 (10.2) for Microsoft Windows
Part Number B25143-03, Section 7 Deinstalling Oracle Database XE.
you must update database parameters if you have never done this for your database installation. Sometimes the shutdown/startup command fails. Set the processes parameter to >=300 as follows.When you are using Oracle XE. In that case. . The shutdown command can take a few minutes. You only have to do this once after installing. simply restart the XE service in the Control Panel/Administrative Tools/Services dialog after setting your parameters.
Install WebLogic server .
Once your database is ready. or to install the version that includes OEPE.exe (For OSB and OEPE installation) . complete the following.exe or wls1035_oepe111172_win32. Open a command window and enter cd c:\stageFMW wls1035_win32. the WebLogic server. If you have installed SOA 11g before and want to install again in the same location. See the section at the end of this document on uninstalling. You can choose whether to install WebLogic Server without OEPE. When you are ready to install. you can install the next step. you must uninstall the previous one first. depending on your use case.
click Next .When the install wizard comes up.
Select create a new Middleware Home and enter D:\Middleware_SOA .
Click Next Enter email to register for security alerts or deselect the checkbox and decline – whichever you prefer. click Next .
Select Custom. click Next .
Review installation directories (when installing OEPE. there will be a third directory Oracle Enterprise Pack for Eclipse) .
click Next Review summary .Click Next Select “Node Manager Service” as No. click Next Click Next Select “All Users” Start Menu folder.
. deselect Run Quickstart checkbox and click Done.When the install is complete.
See the section in this . you must drop your existing database schema before reinstalling or create a second schema for this installation.Install database schema using RCU Now it is time to set up the database schema. If you have installed SOA 11g before and you are not upgrading. You cannot reuse an existing schema.
come back here to configure the new schema. . Open a command window and enter the following. cd c:\stageFMW\RCU\rcuHome\BIN rcu.bat The Repository Creation Utility opens. you will run into problems that you might only realize when you start your implementation. Configure Schema Now create the new schema. you need to set the RCU_JDBC_TRIM_BLOCKS environment variable to TRUE prior to running RCU.document on uninstalling to drop an existing schema. After you drop the existing schema. set RCU_JDBC_TRIM_BLOCKS=TRUE echo %RCU_JDBC_TRIM_BLOCKS% If you don’t do this. VERY IMPORTANT NOTE!!!!!!! If you are using Oracle XE as your database.
On the welcome screen. click Next Select Create Click Next Enter the database information .
. you will see one or two warnings when you install the schema that this version is too old and is using the wrong character set.Click Next If you are using XE.
these install instructions may not match your experience. Also. Select the component SOA and BPM Infrastructure. If you choose to select other components. On the Select Components screen. you may have to increase processes in XE (you will get a message telling you what is required). The utility moves to the next page – with a slight delay.You can safely ignore these warnings for your evaluation installation. When complete. The pre-requisites are reviewed. enter DEV in the field for creating a new prefix. . click OK. If you wish to use extended character sets you must use XE Universal. Dependent schemas are selected automatically. just wait for it.
When completed.Click Next The pre-requisites for this step are checked. click OK. .
Click Next Review the tablespaces and schema owners for the components . The password welcome1 is assumed in this document. but you should choose your own secure password or a different one for each schema and be sure to record your passwords as you will need them later.Select the radio button to Use the same password for all schemas. Enter a schema password.
.When the pre-requisites for this step are completed. click OK Click Create to create the tables.
you are ready to install the SOA server. You use this path in the next command.Install SOA Suite – Base Components Once the schema has been created. Locate the JDK directory path within the installed middleware home. . The JDK location is jdk160_24.
click Next Select “Skip Software Updates” and click Next .In a command window enter cd c:\stageFMW\SOA\Disk1 setup -jreLoc D:\Middleware_SOA\jdk160_24 When the install wizard welcome screen comes up.
Wait for the pre-requisite check to complete (it’s quick!) .
Click Next On the Specify Installation Location screen. select the Middleware home: D:\Middleware_SOA Accept the default Oracle home: Oracle_SOA1 If you use a different Oracle home then adjust accordingly when Oracle_SOA1 is referenced throughout this document. .
Click Next .
Accept the default on the Application Server page and click Next Review summary Click Install Wait for the install to complete .
Click Next .
Depending on your selections.Create a SOA Domain: Configuration Instructions After the installation is complete. On UNIX operating systems: cd SOA_ORACLE_HOME/common/bin . you must configure a new WebLogic domain. Depending on the options you choose during configuration./config. An Oracle SOA Suite domain that does not contain Oracle Business Process Management cannot share the same Oracle home as an Oracle Business Process Management domain.1 Using Default Settings for Managed Servers During the configuration. After you have created a new domain. and choose the products that you want to configure in that domain. you create a domain by running the Oracle Fusion Middleware Configuration Wizard. the following Managed Servers (default names shown) are created: ■ soa_server1 . you can no longer create another domain in the same Oracle home that contains Oracle SOA Suite only. If you modify the default configuration settings.Hosts Oracle SOA ■ bam_server1 . Oracle recommends that you use the default configuration settings for these Managed Servers. If you are using Oracle WebLogic Server as your application server.cmd Configuration Log Files .1. the Oracle Fusion Middleware Configuration Wizard automatically creates Managed Servers in the domain to host the Fusion Middleware system components.Hosts Oracle BAM Managed Server properties can be configured on the Configure Managed Servers screen. this new domain will contain the Administration Server and may contain other Managed Servers. Note: Once you have configured a domain for Oracle Business Process Management.sh On Windows operating systems: cd SOA_ORACLE_HOME\common\bin config. then you will have to perform some manual configuration steps before the Fusion Middleware environment can be started. you can later extend that domain if you want to add more products to that domain. 3.
To create a log file for your configuration session. On UNIX operating systems: .0 [SOA_ORACLE_HOME] on the Select Domain Source screen: . start the Configuration Wizard and select Oracle BPM Suite .1.sh -log=log_filename On Windows operating systems: config. select Create a new WebLogic domain. When the configuration wizard welcome screen comes up. click Next 3. use the -log=log_filename parameter when you start the Configuration Wizard./config.1.1 Oracle BPM Suite To create a domain configured with Oracle BPM Suite.cmd -log=log_filename Log files of your configuration session are created in the logs directory inside your Middleware home.11.1.6.
The following templates are selected as dependencies: Oracle SOA Suite .1.0 [SOA_ORACLE_HOME] Oracle WSM Policy Manager .6.0 [oracle_common] Oracle JRF .1.0 [SOA_ORACLE_HOME] on the Select Domain Source screen: .188.8.131.52. start the Configuration Wizard and select Oracle BPM Suite for developers .184.108.40.206.11.0 [oracle_common] The following servers are created: Administration Server soa_server1 3.2 Oracle BPM Suite for Developers To create a domain configured with Oracle BPM Suite for developers.1.1.
1.0 [oracle_common] Oracle JRF .0 [oracle_common] These templates do not create an Managed Servers.220.127.116.11. start the Configuration Wizard and select Oracle SOA Suite .11. 3.1.0 [SOA_ORACLE_HOME] Oracle WSM Policy Manager .1.11. only a single Administration Server is created for the domain.1.1.0 [SOA_ORACLE_HOME] on the Select Domain Source screen: .The following templates are selected as dependencies: Oracle SOA Suite for developers .3 Oracle SOA Suite To create a domain configured with Oracle SOA Suite.1.11.11.
1.0 [SOA_ORACLE_HOME] on the Select Domain Source screen: .1.0 [oracle_common] Oracle JRF .11.4 Oracle SOA Suite for Developers To create a domain configured with Oracle SOA Suite for developers. start the Configuration Wizard and select Oracle SOA Suite for developers .18.104.22.168.11.6.0 [oracle_common] The following servers are created: Administration Server soa_server1 3.1.The following templates are selected as dependencies: Oracle WSM Policy Manager .1.
0 [SOA_ORACLE_HOME] on the Select Domain Source screen: .22.214.171.124. 126.96.36.199.0 [oracle_common] These templates do not create an Managed Servers. only a single Administration Server is created for the domain.5 Oracle Business Activity Monitoring To create a domain configured with Oracle Business Activity Monitoring.The following templates are selected as dependencies: Oracle WSM Policy Manager .1. start the Configuration Wizard and select Oracle Business Activity Monitoring .0 [oracle_common] Oracle JRF .11.6.1.
11.1.g.1.0 [oracle_common] Oracle JRF .0 [oracle_common] The following servers are created: Administration Server bam_server1 Click Next Enter the domain name.The following templates are selected as dependencies: Oracle WSM Policy Manager .1. SOAOSBPS4Domain and choose a location of your choice .1.11. e.
but you should choose your own secure password and remember it for later in the document when the password is referenced. The password welcome01 is assumed in this document.Click Next Enter user name weblogic and a password. .
.Click Next Select the Sun SDK and leave Development Mode checked (we recommend the Sun SDK for development on Windows as it provides faster startup times).
Click Next On the Configure JDBC Component Schema screen. . and then enter the property value for those components. enter the Service. you select the components that you want to change. if you used a different password when you created the schema with RCU. and Port values. With all of the checkboxes still selected. Host. select all of the components and enter welcome1 for the password in the Schema Password field. enter that password. First. Or.
Review the Schema Owner column and confirm that the values are the same as what you configured in the Configure Schema section of this document when you ran the RCU. deselect MDS Schema and select the next one. Go back and review the screen shots in that section of this document for the schema owners if you do not remember them. f. MY_ORAMDS (or as appropriate) d. Enter the Schema Owner. Enter the schema owners one-by-one by pre-pending the correct prefix to the defaulted value. Complete the following steps if the schema owners need to be updated. Next. MDS: a. look at the table.g. c. Deselect all the component checkboxes b. e.Now. e. Continue until all schema owners are entered. The data source connections are all tested. . Select MDS Schema only. Click Next.
click Next. Now you must choose whether to have your server run as a managed server or in a single server configuration. unless you want to make changes to the default configuration .If all are successful. otherwise click Previous and correct any errors. As we have chosen the developer’s configuration. there will be one admin server and one (optional) managed server for BAM. Don’t check any of the boxes here and click Next.
Click on Next .
Your server is now installed 3. 3. Click Create to create the domain. Wait for the create to finish – takes just a minute Check the box to start the admin server and Click Done. you changed this port number or specified a listen address using the WebLogic Configuration Wizard.This is the summary page for the Configuration.1 Configuring Oracle BAM with Custom Port Numbers The default port number of the Oracle BAM managed server (bam_server1) is 9001. as described in this section. If. Manually change the port number from 9001 to the new port number in the SOA_ORACLE_HOME/bam/config/BAMICommandConfig.3. you must make the following changes: 1.3 Manual Configuration for Oracle BAM Depending on your configuration options and environment. Oracle BAM may require some custom configuration steps. during configuration.xml (on UNIX operating systems) or .
xml (on Windows operating systems) file. Changes in BAMCommonConfig. it is yhryfp). The properties in these files can be modified by using the Mbeans exposed in the Oracle Enterprise Manager Fusion Middleware Control. The properties exposed through MBeans are specific to each server: Note: The folder name under oracle-bam_11. Changes in BAMWebConfig. The parameter that needs to be changed is shown below: <ADCServerPort>9001</ADCServerPort> 2. a. be aware that the name of the directory on your system may not match the name of the directory shown in the documentation.1\yhryfp\APP-INF\classes\config (on Windows operating systems) directory.1.xml: <ServerName>localhost</ServerName> <ServerPort>9001</ServerPort> 3. The components that are considered part of Java Required Files include: . Changes in BAMServerConfig. JRF consists of a number of independently developed libraries and applications that are deployed into a common location (the Oracle Common Home or oracle_common directory).1.xml: The <ApplicationURL> parameter should contain the new URL.4 Applying Java Required Files (JRF) Java Required Files (JRF) consists of those components not included in the Oracle WebLogic Server installation and that provide common functionality for Oracle business applications and application frameworks. b. When you are looking for this directory on your system.xml: <ADCServerName>localhost</ADCServerName> <ADCServerPort>9001</ADCServerPort> c.1/yhryfp/APP-INF/classes/config (on UNIX operating systems) or MW_HOME\user_projects\domains\domain_name\servers\BAM_server_name\tmp\_WL_user\oraclebam_11.SOA_ORACLE_HOME\bam\config\BAMICommandConfig.1.1 is randomly generated (in this case. Oracle BAM single-instance web application configuration information is maintained in the MW_HOME/user_projects/domains/domain_name/servers/BAM_server_name/tmp/_WL_user/oraclebam_11.
To do so: 1. Finish the domain creation or extension. and Oracle Web Services Manager. 3.xml script in your SOA_ORACLE_HOME/bin directory can be used to resolve this issue. ■ Replaces the startManagedWebLogic. When you reach the Select Optional Configuration Screen. On the Target Services to Servers or Clusters Screen. the contents of the config/soa-infra directory in your DOMAIN_HOME are overwritten by the Administration Server. Start the Configuration Wizard (see Section 3. "Starting the Oracle Fusion Middleware Configuration Wizard").6 Starting the Servers To get your deployments up and running. 2.sh (on UNIX operating systems) or startManagedWebLogic. it is not targeted to any server). The ant-soa-util.Oracle Application Development Framework. target the mds-owsm data source to the Administration Server (by default. you must start the Administration Server and various Managed Servers: . However. The script does the following: Note: The script must be run before you try to start the Administration Server or any of the Managed Servers. select Deployments and Services.1.cmd (on Windows operating systems) scripts with versions that prevent the Managed Servers from starting. Oracle Web Services. Infrastructure Security. since SOA configuration parameters are updated only on Managed Servers and on a perserver basis. Dynamic Monitoring Service. Oracle Platform Security Services. Java Object Cache. 3.4. all updates to the SOA configuration are lost when the Managed Servers are restarted if the system hosting the Administration Server does not have an updated copy. 3. MDS. 4. ■ Moves the config/soa-infra (on UNIX operating systems) or config\soa-infra (on Windows operating systems) to the DOMAIN_HOME/soa_backup/config/soa-infra (on UNIX operating systems) or DOMAIN_HOME\soa_backup\config\soa-infra (on Windows operating systems) directory. logging. If you are creating or extending a domain and JRF is the only component selected on the Select Domain Source Screen or Select Extension Source Screen. Oracle Fusion Middleware Audit Framework. you must manually apply JRF to a Managed Server or cluster.5 Protecting Updates to Your SOA Configuration When the Administration Server is started.
2. to start Oracle SOA Server on a UNIX operating system: DOMAIN_HOME/bin/startManagedWebLogic.sh (on UNIX operating systems) or startManagedWebLogic. This command also requires that you specify a server name.sh soa_server1 http://admin_host:admin_port On Windows operating systems: DOMAIN_HOME\bin\startManagedWebLogic. On UNIX operating systems: DOMAIN_HOME/startWebLogic. These managed servers must be started from the command line. To start the Administration Server.sh On Windows operating systems: DOMAIN_HOME\startWebLogic. you must also specify the URL to access your Administration Server. On UNIX operating systems: .1.cmd soa_server1 Before the managed server is started. The servers that need to be started are: ■ soa_server1 (Oracle SOA Server) ■ bam_server1 (Oracle BAM Server) For example. run the startWebLogic. If your Administration Server is using a non-default port.cmd You entered the domain name and location on the Specify Domain Name and Location Screen in the Configuration Wizard. you will be prompted for the WebLogic Server user name and password. or resides on a different host than your managed servers (in a distributed environment). On UNIX operating systems: DOMAIN_HOME/bin/startManagedWebLogic.cmd soa_server1 http://admin_host:admin_port Instead of being prompted for the Administration Server user name and password.sh (on UNIX operating systems) or startWebLogic.cmd (on Windows operating systems) script in the bin directory inside the directory where you created your domain. run the startManagedWebLogic. To start the Managed Servers.cmd (on Windows operating systems) script in the directory where you created your new domain.sh soa_server1 On Windows operating systems: DOMAIN_HOME\bin\startManagedWebLogic. These were provided on the Configure Administrator Username and Password Screen in the Configuration Wizard. you can also specify them directly from the command lime.
username=user_name -Dweblogic. regardless of its location with respect to its Administration Server.7 Starting Node Manager Node Manager is a Java utility that runs as separate process from Oracle WebLogic Server and allows you to perform common operations for a Managed Server.sh soa_server1 http://admin_host:admin_port Dweblogic.DOMAIN_HOME/bin/startManagedWebLogic. While use of Node Manager is optional. After you login to the console. use the following URL to access the Administration Server console in secure mode: https://administration_server_host:secure_administration_server_port/console ■ To access Enterprise Manager: .8 Verifying the Installation and Configuration To verify the installation.password=password On Windows operating systems: DOMAIN_HOME\bin\startManagedWebLogic. ■ Whole Server Migration.cmd soa_server1 http://admin_host:admin _port Dweblogic. For example.management. click Servers in the "Environment" area inside "Domain Configuration" section. ■ automatically restarting failed servers. ■ If you configured your Administration Server to accept SSL connection. verify that the AdminServer.username=user_name -Dweblogic. ■ Automatic Service Migration when using consensus-based leasing. bam_server1.management. 3.management. Node Manager can be used for: ■ Starting servers on remote machines (via the Console). and soa_server1 all have the status "RUNNING" in the State column. start your browser and enter the following URLs: ■ To access the Administration Server console: http://administration_server_host:administration_server_port/console 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. it provides valuable benefits if your WebLogic Server environment hosts applications with high-availability requirements. In the table on the Summary of Servers page.management.password=password - - 3.
This action might not be possible to undo. Are you sure you want to continue?