2 Understanding Oracle Fusion Middleware Concepts and Directory Structure

During the installation process, you will be asked for a variety of directory locations. This section defines each of these directories and explains the contents of each directory.

This chapter contains the following content:

2.1 Oracle Fusion Middleware Concepts

For more information about important Oracle Fusion Middleware concepts for all users, refer to Oracle Fusion Middleware Concepts.

2.2 Oracle Fusion Middleware Directory Structure

This section describes the various directories that are created when you install Oracle Fusion Middleware products.

2.2.1 Middleware Home and WebLogic Server Home Directories

All Oracle Fusion Middleware products (except for Oracle Web Tier) require the presence of an application server on your system. All Oracle Fusion Middleware products support Oracle WebLogic Server as the application server. Beginning with 11g Release 1 (11.1.1.4.0), the following products also support IBM WebSphere as the application server:

  • Oracle Application Developer

  • Oracle SOA Suite and Business Process Management Suite

The top-level directory for all Oracle Fusion Middleware products is called the Middleware home; this directory is created when Oracle WebLogic Server is installed. If you choose to use IBM WebSphere as your application server, then you must still manually create a Middleware home directory where your Oracle Fusion Middleware products will be installed.

The WebLogic Server home directory is inside the Middleware home, and is also created when Oracle WebLogic Server is installed. Figure 2-1 shows the directory structure after a typical Oracle WebLogic Server installation:

Figure 2-1 Directory Structure after an Oracle WebLogic Server Installation

Description of Figure 2-1 follows
Description of "Figure 2-1 Directory Structure after an Oracle WebLogic Server Installation"

Some of the notable directories in the Middleware home are the WebLogic Server home (wlserver_10.3), the directory for the JDK which you can use for product installations (jdk160_21), and the Oracle Coherence directory, which is used by Oracle Service Bus for its business service result caching functionality (coherence_3.6).

If you choose to use IBM WebSphere as your application server, a WebSphere home is created with the IBM WebSphere installation, but you must also manually create a Middleware home, as shown in Figure 2-2:

Figure 2-2 Directory Structure after an IBM WebSphere Installation and Middleware Home

Description of Figure 2-2 follows
Description of "Figure 2-2 Directory Structure after an IBM WebSphere Installation and Middleware Home"

The Middleware home and WebSphere home do not have any relation to each other and can be located anywhere on your system.

2.2.2 Oracle Home and Oracle Common Home Directories

Each Oracle Fusion Middleware product must be installed in its own Oracle home location. When a product is installed, two Oracle home directories are created: the product Oracle home and the Oracle Common home.

The product's software binaries will be installed into the product Oracle home; no runtime process can write to this directory.

The Oracle Common home contains the binary and library files required for the Oracle Enterprise Manager Fusion Middleware Control and Java Required Files (JRF). There can be only one Oracle Common home within each Middleware home.

Both the product Oracle home (in the example shown in Figure 2-3, the SOA Oracle home) and Oracle Common home directories must reside inside an existing Middleware home directory:

Figure 2-3 Directory Structure with Oracle Home Directories

Description of Figure 2-3 follows
Description of "Figure 2-3 Directory Structure with Oracle Home Directories"

2.2.2.1 Creating the Product Oracle Home

The product Oracle home directory can be created in the following ways:

  • Before running the installation, you can create your Oracle home directory on your system. Remember that the Oracle home must reside inside the Middleware home directory, and it must also be an empty directory. Then, when you run the installer and are asked to provide the location of your Oracle home, you can specify the directory you have created.

  • While running the installer, you can specify the name of a new directory. This directory will automatically be created for you by the installer and will be located inside the Middleware home directory.

2.2.2.2 Creating the Oracle Common Home

The Oracle Common home directory is created in the following ways:

2.2.2.3 Checking Port Numbers Across Multiple Oracle Homes

Each product requires its own Oracle home directory. If you are creating an environment where you will have multiple products (and therefore, multiple Oracle home directories), Oracle recommends that you use the staticports.ini file, so that you will have a record of all the ports that are in use on your system to help avoid conflicts.

To use the staticports.ini file, select Specify Ports using Configuration file on the Configure Ports screen during installation.

2.2.3 WebLogic Server Domain

After a product is installed, it can be configured into a WebLogic Server domain. See Oracle Fusion Middleware Concepts for more information about WebLogic Server domains.

During configuration, on the "Specify Domain Name and Location" screen, you will be asked for the location where you want to store data for your domains and applications. Specifically, you will be asked for:

  • Domain name

  • Domain location

  • Application location

The domain location and domain name together are referred to as the domain home. For example, on a UNIX operating system, if you specified /home/Oracle/Middleware/domains as your domain location and soa_domain as your domain name, the domain home would be /home/Oracle/Middleware/domains/soa_domain.

The application location and domain name together are referred to as the application home. For example, on a Windows operating system, if you specified C:\Oracle\Middleware\applications as your application location, then the application home would be C:\Oracle\Middleware\applications\soa_domain.

Note that a directory with the specified domain name is created in both the specified domain location and application location.

The domain home and application home can be created anywhere on your system. When you run the Configuration Wizard, the default location for the domain home is user_projects/domains under the Middleware home. The default location for the application home is user_projects/applications, also under the Middleware home. It is recommended that you create your domain home and application home outside of both the Middleware home and Oracle home directories, so that in the event you need to patch either the Middleware home or Oracle home, your domain and application information would remain untouched.

For more information about domain configuration, see the Installation Guide for your product. For recommendations about configuring a domain in an enterprise production environment, see the Enterprise Deployment Guide for your product.

Figure 2-4 Directory Structure after a WebLogic Server Domain is Created

Description of Figure 2-4 follows
Description of "Figure 2-4 Directory Structure after a WebLogic Server Domain is Created"

2.2.4 Multiple Products with Multiple WebLogic Server Domains

If you install multiple products and choose to create a separate domain for each product, then your directory structure would look something like the one shown in Figure 2-5:

Figure 2-5 Directory Structure with Multiple Oracle Fusion Middleware Products

Description of Figure 2-5 follows
Description of "Figure 2-5 Directory Structure with Multiple Oracle Fusion Middleware Products"

Notice that each product has its own Oracle home directory. To differentiate among all the product Oracle home directories, the install guides typically refer to each Oracle home by product name; for example, the Oracle home for Oracle SOA Suite is referred to as the SOA Oracle home, while the Oracle home for Oracle WebCenter Suite is referred to as the WebCenter Oracle home.

2.2.4.1 Notes for Creating Multiple Domains

If you choose to create multiple domains on a single machine, make sure that each domain has a unique name. When you are running the Configuration Wizard to create and configure your domains, be sure to specify a unique domain name on the "Specify Domain Name and Location" screen. For example, in Figure 2-5, the WebCenter domain might have the name wc_domain, while the SOA domain could be called soa_domain. Refer to the product installation guides for more information.

When you are configuring multiple domains, you must also make sure that the Administration Server and Managed Servers in each domain use a unique port number. There is no provision for checking port numbers across multiple domains, so you will have to keep track of this manually.

To customize the Administration Server port number, select Administration Server on the "Select Optional Configuration" screen in the Configuration Wizard. This will cause the Configure the Administration Server screen to appear, on which you can specify the Administration Server port number.

To customize the Managed Server port numbers, select Managed Servers, Clusters and Machines on the "Select Optional Configuration" screen in the Configuration Wizard. This will cause the Configure Manager Servers screen to appear, on which you can specify the port numbers for your managed servers.

2.2.4.2 Additional Information for Multiple Products and Multiple Domains

For more information about multiple products and multiple domains, refer to the following documentation:

2.2.5 Extending an Existing Domain

During installation and configuration, you may chose to extend an existing domain rather than creating a new domain. Extending a domain means that you add products and funtionality to an existing domain. If, for example, you first install Oracle SOA Suite to create a new domain, then install Oracle WebCenter while choosing to extend the existing Oracle SOA Suite domain, then your topology would look like the one shown in Figure 2-6:

Figure 2-6 Directory Structure with Multiple Oracle Fusion Middleware Products in a Single Domain

Description of Figure 2-6 follows
Description of "Figure 2-6 Directory Structure with Multiple Oracle Fusion Middleware Products in a Single Domain"

In essence, you are adding the products and functionality of Oracle WebCenter Suite to the existing Oracle SOA Suite domain.

2.2.6 Oracle Instance and WebLogic Server Domain

Figure 2-7 shows the directory structure when two products are installed, but one product (Oracle SOA Suite) is configured in a WebLogic Server domain (because it consists of Java components) while the other product (Oracle WebTier) is configured in an Oracle Instance (because it consists of system components):

Figure 2-7 Directory Structure with an Oracle Instance and a WebLogic Server Domain

Description of Figure 2-7 follows
Description of "Figure 2-7 Directory Structure with an Oracle Instance and a WebLogic Server Domain"

Fore more information about Java components and system components, refer to "Understanding Key Oracle Fusion Middleware Concepts" in Oracle Fusion Middleware Administrator's Guide.