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:
For more information about important Oracle Fusion Middleware concepts for all users, refer to Oracle Fusion Middleware Concepts.
This section describes the various directories that are created when you install Oracle Fusion Middleware products.
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
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
The Middleware home and WebSphere home do not have any relation to each other and can be located anywhere on your system.
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
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.
The Oracle Common home directory is created in the following ways:
Installing Oracle Application Developer. For more information, see the Oracle Fusion Middleware Installation Guide for Application Developer.
Installing any Oracle Fusion Middleware product. The directory oracle_common
is automatically created inside the Middleware home directory.
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.
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
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
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.
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.
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
In essence, you are adding the products and functionality of Oracle WebCenter Suite to the existing Oracle SOA Suite 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
Fore more information about Java components and system components, refer to "Understanding Key Oracle Fusion Middleware Concepts" in Oracle Fusion Middleware Administrator's Guide.