3 Installing and Configuring Oracle Fusion Middleware

This chapter provides an overview about how to install and configure Oracle Fusion Middleware and how to start and stop Oracle Fusion Middleware processes.

This chapter contains the following topics:

• Overview of the Procedures in This Chapter
• Installing and Configuring Oracle Fusion Middleware
• Starting and Stopping Servers, Components, and Applications
• Learn More

3.1 Overview of the Procedures in This Chapter

This chapter describes how to use the installation and configuration tools to create the following:

• Using the Oracle Fusion Middleware Metadata Repository Creation Utility, you create the necessary schemas in an existing database.
• Using Oracle WebLogic Server Installer, you create a Middleware home, which contains an Oracle WebLogic Server home.
• Using the installer, you create an Oracle home containing the binaries for Oracle SOA Suite.
• Using Oracle WebLogic Server Configuration Wizard, you create and configure:
  • An Oracle WebLogic Server domain
  • An Oracle WebLogic Server Administration Server
  • An Oracle WebLogic Server Managed Server in which Oracle SOA Suite is deployed
  • An Oracle WebLogic Server Managed Server in which Oracle Business Activity Monitoring is deployed

  Figure 3-1 shows the domain with the Administration Server and Managed Servers.

  Figure 3-1 Oracle WebLogic Server Domain with Administration Server and Managed Servers

  3.2 Installing and Configuring Oracle Fusion Middleware

  The following are the general steps you need to take to install and configure Oracle Fusion Middleware:

  1. Many components, such as Oracle SOA Suite, require a database-based metadata repository. If you are installing these components, you must have an existing database. Then, you use RCU to create a repository in the database. Section 3.2.1 provides information about using RCU. For some installation types and components, you can use a file-based repository to store product metadata. The file-based repository is created during installation.
  2. Install Oracle WebLogic Server. See Section 3.2.2.
  3. Install other Oracle Fusion Middleware products. See Section 3.2.3.
  4. Configure Oracle WebLogic Server and other Oracle Fusion Middleware products. See Section 3.2.4.

  3.2.1 Creating the Oracle Metadata Repository

  Most components require a database-based repository. In those cases, you must use the Oracle Fusion Middleware Metadata Repository Creation Utility (RCU) to create the metadata repository in an existing database. You use RCU to create schemas to hold configuration information for particular components, and optionally, for overall configuration information.

  In addition, you can use RCU to create a particular type of repository, the MDS Repository, which contains metadata for certain types of deployed applications. Those applications include custom Java applications developed by your organization and some Oracle Fusion Middleware Java components, such as Oracle B2B.

  The following components do not require a database-based repository. They can store their configuration information in a file-based repository:

  • Oracle HTTP Server
  • Oracle Web Cache
  • Oracle Web Services Manager
  • The appendix "Metadata Repository Schemas" in the Oracle Fusion Middleware Administrator's Guide for a list of schemas created for each component
  • Oracle Fusion Middleware Repository Creation Utility User's Guide for information about using RCU
  • For information about which versions of Oracle databases are supported, and other prerequisites, see:

  The procedure in this section assumes that you have an existing Oracle Database and that you have installed RCU.

  Oracle recommends that all metadata repositories reside on a database at the same site as the components to minimize network latency issues.

  To create a metadata repository:

  Invoke RCU, using the following command:

  (UNIX) RCU_HOME/bin/rcu (Windows) RCU_hOME\bin\rcu.bat

  • Database Type: Select the type of database. This example assumes that you are using an Oracle Database.
  • Host Name: Enter the host name for the computer where the database is installed, for example: myhost.example.com .
  • Port: Enter the port number, for example: 1521 .
  • Database Name: Enter the Service Identifier (SID) for the database.
  • Username: Enter a user name for the database which is assigned the SYSDBA role, for example: SYS .
  • Password: Enter the password for the user.
  • Role: Select SYSDBA.

  Now, you have created a database-based metadata repository and have populated it with the required schemas.

  3.2.2 Installing Oracle WebLogic Server

  You use the Oracle WebLogic Server installation program to install Oracle WebLogic Server. For the scenarios in this book, accept the default values in the installer, creating a new Middleware home.

  When the installation completes, you have a Middleware home and a WebLogic Server home. By default, the Middleware home is:

  (UNIX) user_home/Oracle/Middleware (Windows) user_home\Oracle\Middleware

  3.2.3 Installing Additional Oracle Fusion Middleware Components

  You use the installer to install, and, in some cases, to optionally configure Oracle Fusion Middleware.

  For the procedures in this book, use the Oracle SOA Suite install type. Refer to the Oracle Fusion Middleware Installation Guide for Oracle SOA Suite . To make it easier to complete the procedures in this book, note the following on the Specify Installation Location page:

  For Oracle Middleware Home, specify the Middleware home directory that was created when you installed Oracle WebLogic Server. For example, if your Middleware home is /scratch/oracle/Oracle/Middleware , then specify the following:

  /scratch/oracle/Oracle/Middleware

  Oracle_SOA1

  3.2.4 Configuring Oracle Fusion Middleware Components

  You can configure some components, such as Oracle HTTP Server or Oracle Web Cache, when you install them. For other components, such as Oracle WebLogic Server, Oracle SOA Suite, or Oracle WebCenter, you must configure the components using the Oracle Fusion Middleware Configuration Wizard.

  To configure Oracle WebLogic Server and Oracle SOA Suite:

  Invoke the Configuration Wizard, which is located in the following directory:

  (UNIX) ORACLE_HOME_for_component/common/bin/config.sh (Windows) ORACLE_HOME_for_component\common\bin\config.cmd

  • In the Welcome screen, select Create a new WebLogic domain.
  • In the Select Domain Source screen, select Oracle SOA Suite, Oracle Enterprise Manager, and Oracle Business Activity Monitoring. This automatically also selects Oracle JRF, and Oracle WSM Policy Manager.
  • In the Specify Domain Name screen, specify SOA_domain for the name of the domain and take the default for the domain location, as shown in the following figure:
    Description of the illustration config_wiz.gif

  • Select all of the schemas.
  • For Vendor, select Oracle.
  • For Driver, select Oracle's Driver (Thin) for Service connections; Versions:9.0.1,9.2.0,10,11.
  • For Schema Owner, do not enter anything if the schemas listed in the table are correct. Each data source uses the user name specified in the table. If you need to change the schema owner, select each schema individually, then change the owner name.
  • If you used the same password for all schemas when you created the schemas, enter the password in Schema Password. Alternatively, you can specify different passwords for each data source by entering them in the password column of the table.
  • With all of the schemas selected, for DBMS/Service , enter the SID of the database.
  • With all of the schemas selected, for Host Name, enter the host name of the database.
  • With all of the schemas selected, for Port, enter the listening port of the database.

  The following figure shows the Configure JDBC Component Schema page:

  Admin Server URL: http://hostname.domainname.com:7001

  Now, you have created a domain, including an Administration Server and two Managed Servers, soa_server1 and bam_server1.

  MW_HOME/user_projects/domains/SOA_domain/bin/startWeblogic.sh

  MW_HOME/user_projects/domains/SOA_domain/bin/startManagedWebLogic.sh soa_server1 http://hostname:7001

  When the configuration completes and you have started the Administration Server and the Managed Servers, you can view and manage Oracle Fusion Middleware using the graphical user interfaces or command-line tools. For example, to use Fusion Middleware Control to view and managed your environment, enter the Admin Server URL you noted from the Creating Domain screen, with /em appended. For example:

  http://hostname.domainname:port/em

  By default, the port is 7001.

  You can extend a domain to include the templates for other components by using the Configuration Wizard. For example, you can extend a domain that was initially created to support Oracle SOA Suite so that it can now also support Oracle WebCenter or Oracle HTTP Server. For more information, see Section 9.2.

  For information about using the tools to view and manage Oracle Fusion Middleware, see:

  • For graphical user interfaces: Section 2.1.1 and Section 2.1.2.
  • For command-line tools: Section 2.1.3.

  For more information about configuring components, see the Installation Guide for that component.

  3.3 Setting Up Environment Variables

  When you installed Oracle Fusion Middleware, you were logged in to your operating system as a particular user. You should always log in as this user to manage your installation because this user has permission to view and modify the files in your installation's Oracle home.

  To use Oracle Fusion Middleware, you must set environment variables as shown in the following tables:

  • Table 3-1, "Environment Variables for Linux and UNIX"
  • Table 3-2, "Environment Variables for Windows"

  Table 3-1 Environment Variables for Linux and UNIX

  hostname : display_number . screen_number

  Beginning with Oracle Application Server 10g, very few tools, such as oidadmin , require the DISPLAY variable.

  On Solaris, ensure that the value contains the following directory:

  $ORACLE_HOME/lib32

  On Linux and HP-UX, ensure that the value contains the following directory:

  $ORACLE_HOME/lib

  On IBM AIX, ensure that this environment variable is not set.

  (IBM AIX only) LIBPATH

  If the calling application is a 32-bit application, ensure that the value contains the following directory:

  $ORACLE_HOME/lib32

  If the calling application is a 64-bit application, ensure that the value contains the following directory:

  $ORACLE_HOME/lib

  (Solaris only) LD_LIBRARY_PATH_64

  Ensure that the value contains the following directory:

  $ORACLE_HOME/lib

  (HP-UX only) SHLIB_PATH

  Ensure that the value contains the following directory:

  $ORACLE_HOME/lib32

  Set to the full path of the installation's Middleware home. Do not use a trailing slash in the definition. The following example shows the full path:

  /scratch/Oracle/Middleware

  Setting this is useful if you have only one Oracle Home in your environment or you will be working with just that one Oracle home. Set to the full path of the Oracle home. Do not use a trailing slash in the definition. The following example shows the full path:

  /scratch/Oracle/Middleware/ORACLE_HOME_SOA1

  Optional. Setting this is useful if you have only one Oracle instance in your environment or you will be working with just that one instance. Set to the full path of an Oracle instance. Do not use a trailing slash in the definition. The following example shows the full path of a Web Tier installation:

  scratch/Oracle/Middleware/WebTier/instances/instance1

  Ensure that the value contains the following directory, which contains basic commands used by all installations:

  $ORACLE_COMMON_HOME/bin

  When you start to work with specific components, you may want to add additional directories to your path, as recommended by the component documentation.

  Ensure that the value contains the following directory:

  MW_HOME/jdkn 

  Ensure that the value contains the following directory:

  $ORACLE_HOME/lib:MW_HOME/jdkn/lib

  Table 3-2 shows the environment variables for Windows.

  Table 3-2 Environment Variables for Windows

  Set to the full path of the installation's Middleware home. Do not use a trailing slash in the definition. The following example shows the full path:

  C:\oracle\Middleware

  Setting this is useful if you have only one Oracle Home in your environment or you will be working with just that one Oracle home. Set to the full path of the Oracle home. Do not use a trailing backslash in the definition. The following example shows the full path:

  C:\oracle\Middleware\ORACLE_SOA1

  The value is automatically set during installation.

  Optional. Setting this is useful if you have only one Oracle instance in your environment or you will be working with just that one instance. Set to the full path of an Oracle instance. Do not use a trailing backslash in the definition. The following example shows the full path of a Web Tier installation:

  C:\oracle\Middleware\WebTier\instances\instance1

  Ensure that the value contains the following directory, which contains basic commands used by all installations:

  ORACLE_COMMON_HOME\bin

  Ensure that the value contains the following directory:

  MW_HOME\jdkn 

  Ensure that the value contains the following directory:

  ORACLE_HOME\lib:MW_HOME\jdkn\lib

  Set to your temp directory, for example, C:\temp.

  Set to your temp directory, for example, C:\temp.

  3.4 Starting and Stopping Servers, Components, and Applications

  You can start and stop servers, components, and applications using the command line, the Oracle WebLogic Server Administration Console, or Fusion Middleware Control. The following topics describe how to start and stop these entities using Fusion Middleware Control, the command line, or both:

  • Starting and Stopping Oracle WebLogic Server Administration Server
  • Starting and Stopping Oracle WebLogic Server Managed Servers
  • Configuring Node Manager to Start Managed Servers
  • Starting and Stopping Components
  • Starting and Stopping Applications
  • Starting and Stopping Fusion Middleware Control
  • Starting and Stopping Oracle Management Agent

  3.4.1 Starting and Stopping Oracle WebLogic Server Administration Server

  You can start and stop Oracle WebLogic Server Administration Servers using the WLST command line. When you start or stop the Administration Server, you also start or stop the processes running in the Administration Server, including the WebLogic Server Administration Console and Fusion Middleware Control.

  To start an Oracle WebLogic Server Administration Server, use the following script:

  MW_HOME/user_projects/domains/domain_name/bin/startWebLogic.sh -Dweblogic.management.username=weblogic -Dweblogic.management.password=password -Dweblogic.system.StoreBootIdentity=true

  To stop an Oracle WebLogic Server Administration Server, use the following script:

  MW_HOME/user_projects/domains/domain_name/bin/stopWeblogic.sh username password [admin_url]

  3.4.2 Starting and Stopping Oracle WebLogic Server Managed Servers

  Fusion Middleware Control and the Oracle WebLogic Server Administration Console use Node Manager to start Managed Servers. If you are starting a Managed Server that does not contain Oracle Fusion Middleware products other than Oracle WebLogic Server, you can start the servers using the procedure in this section.

  However, if the Managed Server contains other Oracle Fusion Middleware products, such as Oracle SOA Suite, Oracle WebCenter, or Oracle JRF, you must first configure Node Manager, as described in Section 3.4.3.

  To start or stop a Managed Server using Fusion Middleware Control:

  1. From the navigation pane, expand the farm, then WebLogic Domain, and then the domain.
  2. Select the Managed Server.
  3. From the WebLogic Server menu, select Control, then Start Up or Shut Down.

  To start a Managed Server:

  MW_HOME/user_projects/domains/domain_name/bin/startManagedWebLogic.sh server_name admin_url username password 

  To stop a Managed Server:

  MW_HOME/user_projects/domains/domain_name/bin/stopManagedWeblogic.sh username password admin_url 

  3.4.3 Configuring Node Manager to Start Managed Servers

  If a Managed Server contains other Oracle Fusion Middleware products, such as Oracle SOA Suite, Oracle WebCenter, or Oracle JRF, the Managed Servers environment must be configured to set the correct classpath and parameters. This environment information is provided through the start scripts, such as startWebLogic and setDomainEnv, which are located in the domain directory.

  If the Managed Servers are started by Node Manager, (as is the case when the servers are started by the Oracle WebLogic Server Administration Console or Fusion Middleware Control), Node Manager must be instructed to use these start scripts so that the server environments are correctly configured. Specifically, Node Manager must be started with the property StartScriptEnabled=true .

  There are several ways to ensure that Node Manager starts with this property enabled. As a convenience, Oracle Fusion Middleware provides the following script, which adds the property StartScriptEnabled=true to the nodemanager.properties file:

  (UNIX) ORACLE_COMMON_HOME/common/bin/ setNMProps.sh. (Windows) ORACLE_COMMON_HOME\common\bin\setNMProps.cmd

  For example, on Linux, execute the setNMProps script and start Node Manager:

  ORACLE_COMMON_HOME/common/bin/setNMProps.sh MW_HOME/wl_server_n/server/bin/startNodeManager.sh

  When you start Node Manager, it reads the nodemanager.properties file with the StartScriptEnabled=true property, and uses the start scripts when it subsequently starts Managed Servers. Note that you need to run the setNMProps script only once.

  3.4.4 Starting and Stopping Components

  You can start and stop a component from the dynamic target menu in Fusion Middleware Control.

  To start or stop Java components, such as Oracle Business Activity Monitoring:

  1. From the navigation pane, expand the farm.
  2. Expand the component type, such as BAM, then select the component.
  3. From the dynamic target menu, choose Control, then Start Up or Shut Down.

  To start or stop restart system components, such as Oracle HTTP Server:

  1. From the navigation pane, expand the farm and then the installation type, such as Web Tier .
  2. Select the component, such as ohs1.
  3. From the dynamic target menu, choose Control, then Start Up or Shut Down.

  To start and stop Java components:

  startApplication(appName, [options]) stopApplication(appName, [options])

  To start and stop system components:

  opmnctl startproc ias-component=component opmnctl stopproc ias-component=component opmnctl restartproc ias-component=component 

  3.4.5 Starting and Stopping Applications

  You can start or stop an application deployed in Oracle Fusion Middleware from the Application Deployment menu of Fusion Middleware Control.

  To start or stop an application:

  1. From the navigation pane, expand Application Deployment.
  2. Select the application.
  3. From the Application Deployment menu, choose Control, then Start Up or Shut Down.

  startApplication(appName, [options]) stopApplication(appName, [options])

  3.4.6 Starting and Stopping Fusion Middleware Control

  If Fusion Middleware Control is configured for a domain, it is automatically started or stopped when you start or stop an Oracle WebLogic Server Administration Server, as described in Section 3.4.1.

  3.4.7 Starting and Stopping Oracle Management Agent

  Oracle Management Agent is designed specifically for monitoring Oracle Fusion Middleware system components, such as Oracle HTTP Server and Oracle Web Cache.

  To start Oracle Management Agent, use the following command:

  opmnctl startproc ias-component=EMAGENT

  To stop Oracle Management Agent, use the following command:

  opmnctl stopproc ias-component=EMAGENT

  3.5 Learn More

  For more information about the topics covered in this chapter, see:

  • Oracle Fusion Middleware Repository Creation Utility User's Guide
  • Oracle Fusion Middleware Installation Planning Guide
  • "Starting and Stopping Oracle Fusion Middleware" in the Oracle Fusion Middleware Administrator's Guide