An Oracle infrastructure topology refers to a specific Oracle implementation. Each topology consists of one or more installation modules that install such services as the Metadata Repository (MR), the Oracle Internet Directory (OID), and the Single Sign-On (SSO) module.
The Oracle App Server 10g plug-in includes the following Oracle installation modules. Each module is provided as a component within the N1 Grid SPS.
MRInstaller – The MRInstaller module contains the database that is used as the metadata repository. This module also installs the OID. Most other modules depend on the MRInstaller module.
IDInstaller – The IDInstaller module is the security module. This module contains the HTTP server for single sign-on and delegated administration services and OC4J (Oracle Application Server Containers for J2EE) for single sign-on and delegated administration services. This module depends on the MRInstaller module.
J2EESSOInstaller – The J2EESSOInstaller module contains the HTTP server, the OC4J module, and the web cache. This module depends on the MRInstaller module.
J2EESSONWCInstaller – The J2EESSONWCInstaller module contains the HTTP server and J2EE without web cache. This module depends on the MRInstaller module.
BIInstaller – The BIInstaller module contains the business components, such as forms and personalization. This module depends on the MRInstaller module.
PWInstaller – The PWInstaller module contains a subset of the BIInstaller module. This module installs portal and wireless. This module depends on the MRInstaller module.
J2EEInstaller – The J2EEInstaller module is a standalone J2EE component with OC4J and web cache. This component is the only component that can be used to create clusters. This is the only module that does not depend on the MRInstaller module.
To deploy any Oracle App Server 10g topology, you install software on one or more systems. The Oracle Application Server silent installer can only install software in one system at the time. Therefore, to install a complex topology that involves several systems, you sequentially install Oracle modules on one machine at a time.
Before you deploy any Oracle topology, you must create several session variables. Make sure that you set the password flag according to the third column of Table 4–1. Any password must have at least five characters, one of which must be numeric. In addition, passwords cannot contain a hyphen (-).
If the name of the host on which you plan to install the MRInstaller component contains a hyphen, you must redefine the variable globalDBName to remove the hyphen. Any name that is registered in the Internet Directory cannot contain a hyphen. Therefore, avoid hyphens in your variable definitions. See the Oracle documentation for details.
To define a session variable, click Session Variables at the top of the browser interface.
Table 4–1 Session Variables
Variable name |
Description |
Password flag |
---|---|---|
sysPass |
Password for sys user of metadata repository database |
Y |
systemPass |
Password for system user of metadata repository database |
Y |
sourceImage |
Full path (visible by all remote agents) to Disk1 of the installation source |
N |
MRInstallerPWD |
Password for MR module |
Y |
IDinstallerPWD |
Password for ID module |
Y |
J2EEInstallerPWD |
Password for J2EE module | |
J2EESSOInstallerPWD |
Password for J2EESSO module |
Y |
J2EESSONWCInstallerPWD |
Password for J2EESSONWC module |
Y |
BIInstallerPWD |
Password for BI module |
Y |
PWInstallerPWD |
Password for PW module |
Y |
OIDhost |
Host name for the system on which the Oracle Internet Directory resides |
N |
OIDdomain |
Domain for the system on which the Oracle Internet Directory resides |
N |
Upon completion of this task, each target host has the following components:
A J2EEInstaller component
A J2EEHT virtual host that is associated with the J2EEInstaller component
An Oc4jHolder component that is installed inside the J2EEHT virtual host
An Oc4jHolderHT virtual host that is associated with the Oc4jHolder component
An Oc4jInstance component that is installed inside the Oc4jHolderHT virtual host
An Oc4jInstanceHT virtual host that is associated with the Oc4jInstance component
Create the session variables.
For this topology, you need to create only the sourceImage and J2EEInstallerPWD session variables.
In the Common Tasks section of the N1 Grid SPS browser interface, select Oracle App Server 10g.
In the J2EE & Web Cache Topology section of the Oracle App Server 10g Common Tasks page, click Install.
On the Plans Details page, click Run.
Choose variables to use for the J2EEInstaller component.
To use an existing variables set, select a name from the drop-down menu in the J2EEInstaller component row of the Plan Parameters table.
To create a new variables set, click Select from List in the J2EEInstaller component row of the Plan Parameters table.
Click Create Set.
Type a name for the variables set.
If a component already exists on this host for which the default value for ORACLE_HOME_NAME is used, define a value for the variable ORACLE_HOME_NAME.
Two components installed in the same physical host cannot have the same ORACLE_HOME_NAME.
Save the variables set.
Select the variables set that you just saved from the drop-down menu in the J2EEInstaller component row of the Plan Parameters table.
To use a holder name other than the default, choose variables to use for the Oc4jHolder component.
To use an instance name other than the default, choose variables to use for the Oc4jInstance component.
To select the target host, click Select from List and choose the target host.
To install the component in several systems at the same time, select more than one target host from the list.
Verify that the target host set is not selected.
The checkbox in front of the target host set should be empty. Otherwise, the plan will try to install in the host set plus the hosts you selected in the previous step
Click Run Plan (includes preflight).
Upon successful completion of the plan, all instances will be running.
Upon completion of this task, each target host has the following components:
An MRInstaller component on the target host that you selected for the plan
An IDInstaller component on the specified host
A J2EESSONWCInstaller component on the specified host
A J2EESSOInstaller component on the specified host
A J2EEHT virtual host that is associated with the J2EESSOInstaller component
An Oc4jHolder component that is installed inside the J2EEHT virtual host
An Oc4jHolderHT virtual host that is associated with the Oc4jHolder component
An Oc4jInstance component that is installed inside the Oc4jHolderHT virtual host
An Oc4jInstanceHT virtual host that is associated with the Oc4jInstance component
Create the session variables.
In the Common Tasks section of the N1 Grid SPS browser interface, select Oracle App Server 10g.
In the J2EE & Web Cache with Identify Management Topology section of the Oracle App Server 10g Common Tasks page, click Install.
Click Run.
Choose variables to use for the MRInstaller component in this plan.
To use an existing variables set, select a name from the drop-down menu in the MRInstaller component row of the Plan Parameters table.
To create a new variables set, click Select from List in the MRInstaller component row of the Plan Parameters table.
Click Create Set.
Type a name for the variables set.
If a component already exists on this host for which the default value for ORACLE_HOME_NAME is used, define a value for the variable ORACLE_HOME_NAME.
Two components installed in the same physical host cannot have the same ORACLE_HOME_NAME.
Define a value for the variable szIdentityAdminContext.
Save the variables set.
Select the variables set that you just saved from the drop-down menu in the MRInstaller component row of the Plan Parameters table.
Repeat step 5 to redefine ORACLE_HOME_NAME for the IDInstaller, J2EESSOInstaller, and J2EESSONWCInstaller components, if needed.
To use a holder name other than the default, choose variables to use for the Oc4jHolder component.
To use an instance name other than the default, choose variables to use for the Oc4jInstance component.
To select the target host, click on Select from List and choose the target host.
Select one host on which you want the MRInstaller component to be installed.
Type the name of the hosts on which you want to install the IDInstaller, J2EESSOInstaller, and J2EESSONWCInstaller components
Use one host for each component.
Place each component on a separate host.
Verify that the target host set is not selected.
The checkbox in front of the target host set should be empty. Otherwise, the plan will try to install in the host set plus the hosts you selected in the previous step
Click Run Plan (includes preflight).
Upon successful completion of the plan, all instances will be running.
Upon completion of this task, each target host has the following components:
An MRInstaller component on the target host that you selected for the plan
An IDInstaller component on the specified host
A J2EESSONWCInstaller component on the specified host
A J2EESSOInstaller component on the specified host
A J2EEHT virtual host that is associated with the J2EESSOInstaller component
An Oc4jHolder component that is installed inside the J2EEHT virtual host
An Oc4jHolderHT virtual host that is associated with the Oc4jHolder component
An Oc4jInstance component that is installed inside the Oc4jHolderHT virtual host
An Oc4jInstanceHT virtual host that is associated with the Oc4jInstance component
A BIInstaller component in the specified host
Create the session variables.
In the Common Tasks section of the N1 Grid SPS browser interface, select Oracle App Server 10g.
In the Business Intelligence and Forms Topology section of the Oracle App Server 10g Common Tasks page, click Install.
Click Run.
Choose variables to use for the MRInstaller component in this plan.
To use an existing variables set, select a name from the drop-down menu in the MRInstaller component row of the Plan Parameters table.
To create a new variables set, click Select from List in the MRInstaller component row of the Plan Parameters table.
Click Create Set.
Type a name for the variables set.
If a component already exists on this host for which the default value for ORACLE_HOME_NAME is used, define a value for the variable ORACLE_HOME_NAME.
Two components installed in the same physical host cannot have the same ORACLE_HOME_NAME.
Define a value for the variable szIdentityAdminContext.
Save the variables set.
Select the variables set that you just saved from the drop-down menu in the MRInstaller component row of the Plan Parameters table.
Repeat step 5 to redefine ORACLE_HOME_NAME in IDInstaller, J2EESSONWCInstaller, J2EESSOInstaller, and BIInstaller components, if needed
To use a holder name other than the default, choose variables to use for the Oc4jHolder component.
To use an instance name other than the default, choose variables to use for the Oc4jInstance component.
To select the target host, click on Select from List and choose the target host.
Select one host on which you want the MRInstaller component to be installed.
Verify that the target host set is not selected.
The checkbox in front of the target host set should be empty. Otherwise, the plan will try to install in the host set plus the hosts you selected in the previous step
In the Plan Variables section of the page, type the name of the hosts on which you want to install the IDInstaller, J2EESSONWCInstaller, J2EESSOInstaller, and BIInstaller components.
Use only one host for each component.
Place each component on a separate host.
Click on Run Plan (includes preflight)
Upon successful completion of the plan, all instances will be running.
Upon completion of this task, each target host has the following components:
An MRInstaller component on the target host that you selected for the plan
An IDInstaller component on the specified host
A J2EESSONWCInstaller component on the specified host
A J2EESSOInstaller component on the specified host
A J2EEHT virtual host that is associated with the J2EESSOInstaller component
An Oc4jHolder component that is installed inside the J2EEHT virtual host
An Oc4jHolderHT virtual host that is associated with the Oc4jHolder component
An Oc4jInstance component that is installed inside the Oc4jHolderHT virtual host
An Oc4jInstanceHT virtual host that is associated with the Oc4jInstance component
A PWInstaller component on the specified host
Create the session variables.
In the Common Tasks section of the N1 Grid SPS browser interface, select Oracle App Server 10g.
In the Portal and Wireless Topology section of the Oracle App Server 10g Common Tasks page, click Install.
Click Run.
Choose variables to use for the MRInstaller component in this plan.
To use an existing variables set, select a name from the drop-down menu in the MRInstaller component row of the Plan Parameters table.
To create a new variables set, click Select from List in the MRInstaller component row of the Plan Parameters table.
Click Create Set.
Type a name for the variables set.
If a component already exists on this host for which the default value for ORACLE_HOME_NAME is used, define a value for the variable ORACLE_HOME_NAME.
Two components installed in the same physical host cannot have the same ORACLE_HOME_NAME.
Define a value for the variable szIdentityAdminContext.
Save the variables set.
Select the variables set that you just saved from the drop-down menu in the MRInstaller component row of the Plan Parameters table.
Repeat step 5 to redefine ORACLE_HOME_NAME in the IDInstaller, J2EESSONWCInstaller, J2EESSOInstaller, and PWInstaller components, if needed
To use a holder name other than the default, choose variables to use for the Oc4jHolder component.
To use an instance name other than the default, choose variables to use for the Oc4jInstance component.
To select the target host, click on Select from List and choose the target host.
Select one host on which you want the MRInstaller component to be installed.
Verify that the target host set is not selected.
The checkbox in front of the target host set should be empty. Otherwise, the plan will try to install in the host set plus the hosts you selected in the previous step
In the Plan Variables section of the page, type the name of the hosts on which you want to install the IDInstaller, J2EESSONWCInstaller, J2EESSOInstaller, and PWInstaller components.
Use only one host for each component.
Place each component on a separate host.
Click Run Plan (includes preflight).
Upon successful completion of this plan, all instances will be running.
By default, the global database name in the MRInstaller uses the host name. If your host name includes a hyphen, you need to change the global database name to remove that hyphen. This change affects several variables in several components.
Table 4–2 Global Database Name Variables
Component |
Variable |
Default |
Changed Example |
---|---|---|---|
MRInstaller |
globalDBName |
:[dbSid].:[dbHost] |
:[dbSid].SP |
J2EESSOInstaller |
szl_ClusterRepository |
{":[OIDFQN]:1521::[SID].:[OIDFQN]::[SID].:[OIDFQN]"}, where [OIDFQN] is derived from :[OIDhost].:[OIDdomain] |
{":[OIDFQN]:1521::[SID].SP::[SID].SP"} |
J2EESSONWCInstaller |
szl_ClusterRepository |
{":[OIDFQN]:1521::[SID].:[OIDFQN]::[SID].:[OIDFQN]"} |
{":[OIDFQN]:1521::[SID].SP::[SID].SP"} |
BIInstaller |
szl_RepositoryUserInput |
{":[OIDFQN]:1521::[SID].:[OIDFQN]::[SID].:[OIDFQN]"} |
{":[OIDFQN]:1521::[SID].SP::[SID].SP"} |
PWInstaller |
szl_RepositoryUserInput |
{":[OIDFQN]:1521::[SID].:[OIDFQN]::[SID].:[OIDFQN]"} |
{":[OIDFQN]:1521::[SID].SP::[SID].SP"} |
By default, the identity management feature (IDInstaller component) is the only topology that uses SSL for secure communication. To enable the J2EESSOInstaller, J2EESSONWCInstaller, BIInstaller, or PWInstaller components to use SSL, change the szOIDwithSSLStatus variable to Y. When you do this, you also need to change the value for the OIDport variable to :[InternetDirectorySSLPort].
The following list shows the relationship between the two variables:
OIDport=":[InternetDirectorySSLPort]"
OIDport=":[InternetDirectoryPort]"
To undeploy a topology, you uninstall the appropriate topology.
In the Common Tasks section of the N1 Grid SPS browser interface, select Oracle App Server 10g.
In the appropriate Infrastructure Tasks Topology section of the Oracle App Server 10g common tasks page, click Uninstall.
The Components Details page displays for this topology.
On the Components Details page, click the Run action next to default:uninstall.
On the Plans Details Run page, select the host from which you want to undeploy the topology.
Click Run Selected Installations.
The Plans Details Run page reappears with information about the specific host.
To confirm that you want to uninstall this topology, click Run Plan (includes preflight).
When the topology is uninstalled, all the components that are part of that topology are uninstalled.
You can also import an Oracle topology from your datacenter into the provisioning system.
Upon completion of this task, components in N1 Grid SPS will represent your topology.
Identify the topology that you want to import.
Follow the appropriate deployment procedure for the topology that you want to install.
For more information, see Deploying Oracle Topologies.
Create variable sets for the components and define variables so that they match what you have installed.
Set the value for Full Install to FALSE.
Most of the infrastructure plans give you the option for full install and uninstall. When you set this variable to FALSE, the N1 Grid SPS software performs the plan at the provisioning software level without doing the Oracle portion. You can then import clusters using Create and Join, and you can import OC4J instances by running Create OC4J.
Click Run Plan (includes preflight).
You can change one of the installed topologies by adding components to it. For example, you might want to install more J2EESSOInstaller components to a J2EE & Web Cache Topology, or you might want to add a BIInstaller to a J2EE & Web Cache with Identity Management Topology.
Upon completion of this task, the selected component is installed in the host that you selected. The selected component is associated with an MRInstaller component. This new component will be uninstalled automatically when you uninstall the MRInstaller component with which the selected component is associated.
In the Application Deployment section of the N1 Grid SPS browser interface, click Components.
If needed, select Change Folder and go to /com/sun/oracle10g_AS.
From the Components page, select the component that you want to add to a topology.
Under component procedures, run the default install.
Select the physical host on which you want to install the component.
Provide the name of the physical host that has the MRInstaller component.
Provide the ORACLE_HOME_NAME value for the host that has the MRInstaller component.
Click Run Plan (includes preflight).
If your system goes down unexpectedly, or if some other event causes your J2EE & Web Cache or J2EE & Web Cache with Identity Management topology to stop, you can start those topologies through the plug-in.
When you start the J2EE & Web Cache or J2EE & Web Cache with Identity Management topology, the top-level component checks the status of any dependent sub-components. If the sub-component is not started, the start control starts the sub-component.
For the Business Intelligence and Forms topology and the Portal and Wireless topology, you have to start the individual components separately. Specifically, you have to start the BIInstaller or PWInstaller component, as well as the applicable J2EESSOInstaller and J2EESSONWCInstaller components.
In the Application Deployment section of the N1 Grid SPS browser interface, click Components.
If needed, select Change Folder and go to /com/sun/oracle10g_AS.
From the Components page, click the J2EESSOInstaller or J2EESSONWCInstaller component that you want to start.
Under component procedures, run the Start control.
Select the physical host on which you want to start the component.
Click Run Plan (includes preflight).