2 Installing and Configuring Oracle9iAS CC Using the Gold Image

This chapter describes how to install and configure an Oracle9i Application Server Certified Configuration (Oracle9iAS CC) from the gold image.

Oracle9i Application Server components are pre-installed and pre-configured in the gold image. When you install and configure Oracle9iAS CC using the gold image, the installation and configuration time is significantly less than the installation and configuration time when using the product CD-ROMs. The installation from the gold image saves you time when deploying Oracle9i Application Server.

This chapter contains the following sections:

Prerequisites for Installation and Configuration
Two-Tier Deployment
Single-Tier Deployment
J2EE and Web Cache Deployment without Infrastructure
Postconfiguration
Applying the opca Patch
Starting the Infrastructure Database in Archive Log Mode
Handling Configuration Failures

Prerequisites for Installation and Configuration

Ensure you meet the following prerequisites before you install and configure Oracle9iAS CC.

When you perform the first gold image installation, the system needs to be clean with no previous Oracle homes configured or Oracle processes running.

Access to the Gold Image

Before installing using the gold image, you must make the gold image stage area accessible on your system. You can mount the gold image stage area from a remote machine using nfs, or copied onto the local machine and extracted in the location described below.

Oracle9iAS CC expects the gold image stage area to be made available in the /stage/ias902 directory. If you want to put the gold image in another directory, you must set the CC_STAGE_AREA environment variable to that location, as follows:

# CC_STAGE_AREA=/mystage/gold
# export CC_STAGE_AREA

Required Information for Installation and Configuration

You will need the following information before installing and configuring Oracle9iAS CC:

4-letter customer ID
instance type (’t’ for test, ’d’ for development, or ’p’ for production)
install type (singletier, midtier, or dbtier)

Note:

The system will prompt you to log in as the root user to start installation, configuration, or cloning. However, internally, the system performs all the operations as a normal operating system user (not the root user) who owns or will own the Oracle software except when it is mandatory to perform operations as the root user.

After you complete the installation and configuration of Oracle9iAS CC, you must perform maintenance and management operations using a normal operating system user who is the owner of a particular Oracle home, unless otherwise required by the base product itself.

Two-Tier Deployment

A two-tier deployment involves deploying the following components:

On the database-tier:

Infrastructure database

On the middle-tier:

Infrastructure mid-tier - Oracle Internet Directory (OID) and Single Sign-On (SSO) server
Complete Oracle9i Application Server mid-tier (Up to Oracle9iAS Business Intelligence and Oracle9iAS Forms Services) plus Oracle Internet File System (CM_SDK), and Oracle Application Interconnect (OAI).

Note:

You must first configure the Infrastructure database on the database-tier, then the Infrastructure mid-tier on the middle-tier before configuring other components.

Installing Database-Tier Components

Install database-tier components using the following:

Log in as the root user on the database-tier.
Change directories to the gold image stage area using the following command:
```
# cd /<stage area/Disk0
```

Run the install.sh script with the following options:

# ./install.sh -goldimage -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=dbtier

This installs the Infrastructure database.

Example 2-1 Deriving $ORACLE_BASE and User ID of the Installation Owner on the Database-Tier

For example, if the customer ID is ‘orcl’ and the instance type is ‘p’ for production, then the Infrastructure database will be installed in the /porcls/oracle directory and owned by user orporcls.

Installing Middle-Tier Components

Install the middle-tier components using the following:

Log in as the root user on the middle-tier.
Change directories to the gold image stage area using the following command:
```
# cd /<stage area/Disk0
```

Run the install.sh script with the following options:

# ./install.sh -goldimage -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=midtier

This installs the Infrastructure mid-tier and Oracle9i Application Server middle-tier in their respective Oracle homes.

Example 2-2 Deriving $ORACLE_BASE and User ID of the Installation Owner on the Middle-Tier

For example, if the customer ID is ‘orcl’ and the instance type is ‘p’, then:

Infrastructure mid-tier (oidsso) will be installed in the /porcls/idm directory and owned by user iaporclo
Oracle9i Application Server mid-tier will be installed in the /porclo/ias directory and owned by user iaporclo

Configuring Infrastructure Database on the Database-Tier

This section details configuring the Infrastructure database Oracle home on the database-tier in the /XYYYYs/oracle/product/infra_902 directory. Configure Infrastructure database on the database-tier using the following instructions:

Log in as the root user on the database-tier.
Set up your environment by sourcing the /etc/ora_cc_env file using the following commands:
```
# . /etc/ora_cc_env
# cd $ORACLE_CC_ROOT/ias/902
```
Set the DISPLAY variable to a valid X server.
Run the config.sh script in one of the following ways:
- Using interactive mode
- Using an input file

Configuring Infrastructure Database Using Interactive Mode

Use the following command to configure the Infrastructure database in interactive mode:

# ./config.sh -goldimage

The configuration tool will start configuration by requesting information about the instance that you want to configure.

Configuring Infrastructure Database Using An Input File

Use the following procedure to configure the Infrastructure database with input parameters (except passwords) specified in parameter file:

Copy the $ORACLE_CC_ROOT/clone/config/clone_src.properties file to another file, such as config_inputfile.
Edit the config_inputfile file and specify the parameters needed for the specific configuration you need to carry out.

Note:
The system will not accept the passwords in the input file for security reasons. It will prompt you for passwords during interactive mode when you run the config.sh script.

Run the config.sh script as follows:

# ./config.sh -goldimage -propfile  <propfile name>

If any parameter is missing or incorrect, the config.sh will print out an error message and will not continue with the configuration. The user can correct the error in the input file and re-run the configuration.

The Infrastructure database will be configured and will be brought up at the end of configuration.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

To verify that the Infrastructure database is correctly installed and configured, log in to the system as the user who owns the Infrastructure database Oracle home. Source the profile and choose this Oracle home. Log in to the Infrastructure database as the SYS user. The login should be successful.

Configuring Infrastructure Mid-Tier on the Middle-Tier

Note:

You must configure the Infrastructure database on the database-tier before you configure the Infrastructure mid-tier on the middle-tier.

This section details configuring the Infrastructure mid-tier Oracle home on the middle-tier in the /XYYYYs/idm/product/infra_902 directory. Configure Infrastructure mid-tier on the middle-tier using the following:

Log in as the root user on the middle-tier.
Set up your environment by sourcing the /etc/ora_cc_env file using the following commands:
```
# . /etc/ora_cc_env
# cd $ORACLE_CC_ROOT/ias/902
```
Set the DISPLAY variable to the valid X server.
Run the config.sh script in one of the following ways:
- Using interactive mode
- Using an input file

Configuring Infrastructure Mid-Tier Using Interactive Mode

Use the following command to configure Infrastructure mid-tier in interactive mode:

# ./config.sh -goldimage

The configuration tool will start configuration by requesting information about the instance that you want to configure.

Configuring Infrastructure Mid-Tier Using An Input File

Use the following procedure to configure the Infrastructure middle-tier with input parameters (except passwords) specified in parameter file:

Copy the $ORACLE_CC_ROOT/clone/config/clone_src.properties file to another file, such as config_inputfile.
Edit the config_inputfile file and specify the parameters needed for the specific configuration you need to carry out. The config_inputfile file contains descriptions and default values for each parameter.

Note:
The system will not accept the passwords in the input file for security reasons. It will prompt you for passwords during interactive mode when you run the config.sh script.
Run the config.sh script with the appropriate options to configure Oracle9iAS CC.
```
# ./config.sh -goldimage -propfile  <propfile name>
```
If any parameter is missing or incorrect, the config.sh will print out an error message and will not continue with the configuration. The user can correct the error in the input file and re-run the configuration.

The Infrastructure mid-tier will be configured and will be brought up at the end of configuration.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

To verify that the Infrastructure mid-tier is correctly installed and configured, go to the URL, http://<hostname>.<domainname>:7777/oiddas. Log in as the orcladmin user with the password as specified during configuration. The login should be successful.

Configuring Oracle9i Application Server Mid-Tier Components on the Middle-Tier

Note:

before you configure Oracle9i Application Server mid-tier components on the middle-tier, you must have the following configured:

Infrastructure database on the database-tier
Infrastructure mid-tier on the middle-tier

This section details configuring the Oracle homes for the Oracle9i Application Server mid-tier components in the /XYYYYo/ias/product/iasmt_902 directory.

Configure Oracle9i Application Server mid-tier components on the middle-tier by using the following steps:

Log in as the root user on the middle-tier.
Set up your environment by sourcing the /etc/ora_cc_env file using the following commands:
```
# . /etc/ora_cc_env
# cd $ORACLE_CC_ROOT/ias/902
```
Set the DISPLAY variable to the valid X server.
Run the config.sh script in one of the following ways:
- Using interactive mode
- Using an input file

Configuring Oracle9i Application Server Mid-Tier Components Using Interactive Mode

To configure the Oracle9i Application Server mid-tier components, use the following commands depending on the components you need to configure:

For all Oracle9i Application Server mid-tier components (J2EE, Web Cache, Wireless, and Portal), run the following command:
```
# ./config.sh -goldimage
```
The configuration tool will start configuration by listing all unconfigured Oracle homes.
Select an Oracle home from the list.
Select one of the following configuration options:
- J2EE and Web Cache with Infrastructure
- Portal and Wireless
- Business Intelligence and Forms

Configuring Oracle9i Application Server Mid-Tier Components Using An Input File

To configure the Oracle9i Application Server mid-tier components, use the following procedure to configure Oracle9iAS CC with input parameters (except passwords) specified in the parameter file:

Copy the $ORACLE_CC_ROOT/clone/config/clone_src.properties file to another file, such as config_inputfile.
Edit the config_inputfile file and specify the parameters needed for the specific configuration you need to carry out.

Note:
The system will not accept the passwords in the input file for security reasons. It will prompt you for passwords during interactive mode when you run the config.sh script.
Run the config.sh script with the appropriate options to configure Oracle9iAS CC. For example, to configure E-mail, use the following command:
```
# ./config.sh -goldimage -propfile  <propfile name>
```
If any parameter is missing or incorrect, the config.sh will print out an error message and will not continue with the configuration. The user can correct the error in the input file and re-run the configuration.

The Oracle9i Application Server mid-tier components will be configured and will be brought up at the end of configuration.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

To verify that the Oracle9i Application Server middle-tier Portal component is correctly installed and configured, go to the URL, http://<hostname>.<domainname>:7778/pls/portal. Click on the Login link and log in as ‘portal’ with the password specified during configuration. The login should be successful.

Note:

You must perform the steps in "Postconfiguration" to complete the deployment.

Single-Tier Deployment

A single-tier deployment involves installing and configuring all the components on a single node. The following components are configured:

Complete Infrastructure that includes the Infrastructure database, Oracle Internet Directory Server (OID), and Oracle9iAS Single Sign-On (SSO) Server.
Complete Oracle9i Application Server mid-tier components (Up to Business Intelligence and Forms install types) Plus Oracle Internet File System (Oracle9iFS), and Oracle Application InterConnect (OAI).

Installing Components on the Single-Tier

Install components on the single-tier using the following:

Log in as the root user on the single-tier.
Change directories to the gold image stage area, using the following command:
```
# cd /<stage area/Disk0
```

Run the install.sh script with the following options:

# ./install.sh -goldimage -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=singletier

This installs Infrastructure and Oracle9i Application Server components in their respective Oracle homes.

Example 2-3 Deriving $ORACLE_BASE and User ID of the Installation Owner on the Single-Tier

For example, if the customer ID is ‘orcl’ and the instance type is ‘d’, then:

Infrastructure will be installed in the /dorcls/oracle directory and owned by user, iadorclo.
Oracle9i Application Server mid-tier components will be installed in the /dorclo/ias directory and owned by user, iadorclo.

Configuring Infrastructure on the Single-Tier

Configure Infrastructure on the single-tier using the following:

Log in as the root user on the single-tier.
Set up your environment by sourcing the /etc/ora_cc_env file using the following commands:
```
# . /etc/ora_cc_env
# cd $ORACLE_CC_ROOT/ias/902
```
Set the DISPLAY variable to the valid X server.
Run the config.sh script in one of the following ways:
- Using interactive mode
- Using an input file

Configuring Infrastructure on the Single-Tier Using Interactive Mode

Use the following command to configure Infrastructure in interactive mode:

# ./config.sh -goldimage

The configuration tool will start configuration by requesting information about the instance that you want to configure.

Configuring Infrastructure on the Single-Tier Using An Input File

Use the following procedure to configure Infrastructure with input parameters (except passwords) specified in parameter file:

Copy the $ORACLE_CC_ROOT/clone/config/clone_src.properties file to another file, such as config_inputfile.
Edit the config_inputfile file and specify the parameters needed for the specific configuration you need to carry out.

Note:
The system will not accept the passwords in the input file for security reasons. It will prompt you for passwords during interactive mode when you run the config.sh script.
Run the config.sh script with the appropriate options to configure Oracle9iAS CC.
```
# ./config.sh -goldimage -propfile  <propfile name>
```
If any parameter is missing or incorrect, the config.sh will print out an error message and will not continue with the configuration. The user can correct the error in the input file and re-run the configuration.

The Infrastructure will be configured and will be brought up at the end of configuration.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

To verify that the Infrastructure is correctly installed and configured, go to the URL, http://<hostname>.<domainname>:7777/oiddas. Log in as the orcladmin user with the password as specified during configuration. The login should be successful.

Configuring Oracle9i Application Server Mid-Tier Components on the Single-Tier

Configure Oracle9i Application Server mid-tier components on the single-tier using the following:

Log in as the root user on the single-tier.
Set up your environment by sourcing the /etc/ora_cc_env file using the following commands:
```
# . /etc/ora_cc_env
# cd $ORACLE_CC_ROOT/ias/902
```
Set the DISPLAY variable to the valid X server.
Run the config.sh script in one of the following ways:
- Using interactive mode
- Using an input file

Configuring Oracle9i Application Server Mid-Tier Components on the Single-Tier Using Interactive Mode

To configure the Oracle9i Application Server mid-tier components, use the following commands depending on the components you need to configure:

For all Oracle9i Application Server mid-tier components (J2EE, Web Cache, Wireless, and Portal), run the following command:
```
# ./config.sh -goldimage
```
The configuration tool will start configuration by listing all unconfigured Oracle homes.
Select an Oracle home from the list.
Select one of the following configuration options:
- J2EE and Web Cache with Infrastructure
- Portal and Wireless
- Business Intelligence and Forms

Configuring Oracle9i Application Server Mid-Tier Components on the Single-Tier Using An Input File

Use the following procedure to configure Oracle9i Application Server mid-tier components with input parameters (except passwords) specified in parameter file:

Copy the $ORACLE_CC_ROOT/clone/config/clone_src.properties file to another file, such as config_inputfile.
Edit the config_inputfile file and specify the parameters needed for the specific configuration you need to carry out.

Note:
The system will not accept the passwords in the input file for security reasons. It will prompt you for passwords during interactive mode when you run the config.sh script.
Run the config.sh script with the appropriate options to configure Oracle9iAS CC. For example, to configure all the mid-tier components, use the following command:
```
# ./config.sh -goldimage -propfile  <propfile name>
```
If any parameter is missing or incorrect, the config.sh will print out an error message and will not continue with the configuration. The user can correct the error in the input file and re-run the configuration.

The Oracle9i Application Server mid-tier components will be configured and will be brought up at the end of configuration.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

Note:

You must perform the steps in "Postconfiguration" to complete the deployment.

J2EE and Web Cache Deployment without Infrastructure

This type of deployment involves installing and configuring only J2EE and Web Cache in a single Oracle home.

Installing Components for J2EE and Web Cache Deployment

Install components on the single-tier using the following:

Log in as the root user on the single-tier.
Change directories to the gold image stage area using the following command:
```
# cd /<stage area/Disk0
```

Run the install.sh script with the following options:

# ./install.sh -goldimage -custid=<4 letter customer id> -instancetype={t|d|p} -installtype=j2eewc_no_infra

This installs Oracle9i Application Server mid-tier components.

Configuring J2EE and Web Cache

Configure Infrastructure on the single-tier using the following:

Log in as the root user.
Set up your environment by sourcing the /etc/ora_cc_env file using the following commands:
```
# . /etc/ora_cc_env
# cd $ORACLE_CC_ROOT/ias/902
```
Set the DISPLAY variable to the valid X server.
Run the config.sh script in one of the following ways:
- Using interactive mode
- Using an input file

Configuring J2EE and Web Cache Using Interactive Mode

Use the following command to configure Infrastructure in interactive mode:

# ./config.sh -goldimage

Configuring J2EE and Web Cache Using An Input File

Use the following procedure to configure Infrastructure with input parameters (except passwords) specified in parameter file:

Copy the $ORACLE_CC_ROOT/clone/config/clone_src.properties file to another file, such as config_inputfile.
Edit the config_inputfile file and specify the parameters needed for the specific configuration you need to carry out.
Note that the passwords in the input file will not be honored because of security reasons. You will be prompted for passwords during interactive mode when you run the config.sh script.
Run the config.sh script with the appropriate options to configure Oracle9iAS CC.
```
# ./config.sh -goldimage -propfile  <propfile name>
```
If any parameter is missing or incorrect, the config.sh will print out an error message and will not continue with the configuration. The user can correct the error in the input file and re-run the configuration.

The Infrastructure will be configured and will be brought up at the end of configuration.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

Configuring Oracle9i Application Server Mid-Tier Components on the Single-Tier

Configure Oracle9i Application Server mid-tier components on the single-tier using the following:

Log in as the root user on the single-tier.
Set up your environment by sourcing the /etc/ora_cc_env file using the following commands:
```
# . /etc/ora_cc_env
# cd $ORACLE_CC_ROOT/ias/902
```
Set the DISPLAY variable to the valid X server.
Run the config.sh script in one of the following ways:
- Using interactive mode
- Using an input file

Configuring Oracle9i Application Server Mid-Tier Components on the Single-Tier Using Interactive Mode

Use one of the following commands depending on the components you need to configure:

For all mid-tier components, run the following command:
```
# ./config.sh -goldimage
```

The configuration tool will start configuration by requesting information about the instance that you want to configure.

Configuring Oracle9i Application Server Mid-Tier Components on the Single-Tier Using An Input File

Use the following procedure to configure Oracle9i Application Server mid-tier components with input parameters (except passwords) specified in parameter file:

Copy the $ORACLE_CC_ROOT/clone/config/clone_src.properties file to another file, such as config_inputfile.
Edit the config_inputfile file and specify the parameters needed for the specific configuration you need to carry out.

Note:
The system will not accept the passwords in the input file for security reasons. It will prompt you for passwords during interactive mode when you run the config.sh script.
Run the config.sh script with the appropriate options to configure Oracle9iAS CC. For example, to configure all the mid-tier components, use the following command:
```
# ./config.sh -goldimage -propfile  <propfile name>
```
If any parameter is missing or incorrect, the config.sh will print out an error message and will not continue with the configuration. The user can correct the error in the input file and re-run the configuration.

The Oracle9i Application Server mid-tier components will be configured and will be brought up at the end of configuration.

Verifying Configuration

Check the configuration log file located in the $ORACLE_CC_ROOT/logs/config directory for any errors.

Note:

You must perform the steps in "Postconfiguration" to complete the deployment.

Postconfiguration

You must complete the following postconfiguration tasks.

Removing Old Partner Applications

If you used the gold image to deploy your Oracle9iAS CC, then use the following to remove old partner applications on the system. This fix is not required for the deployments installed and configured from the Product CD-ROMs.

Log into the Oracle9iAS Single Sign-On (SSO) Server at:
```
http://<hostname:<port/pls/orasso
```
Click SSO Server Administration.
Click Administer Partner Applications.
In the Edit/Delete Partner Application section, delete the following old partner applications:
```
Oracle Portal (portal)
ogolds_infraoidsso.<hostname.<domainname
ogoldo_iasmt.<hostname.<domainname
wireless_deviceportal
```
If there are two application entries with the same name (for example, wireless_deviceportal), then use the following procedure to identify the old application:
1. Click on the Edit icon against the partner application.
2. Note the ID of the application in the Edit Partner Application page.
  
  The application ID with the lesser value is the old partner application

Refreshing ONS Configuration

You must perform these steps in the following sequence.

For Two-Tier Deployment

Use the following to refresh the ONS configuration for a two-tier deployment:

In the Infrastructure database Oracle home on the database-tier, update the ias.properties file in the $ORACLE_HOME/config directory with the proper host name values for the following entries:
- SSOhost
- OIDhost
Run the following command in the Infrastructure mid-tier Oracle home on the middle-tier system:
```
$ $ORACLE_HOME/dcm/bin/dcmctl listinstances
```
This command updates the $ORACLE_HOME/opmn/conf/ons.conf file with the IP addresses of the database-tier and middle-tier systems.

Verify that the ons.conf file contains the IP addresses of the database-tier and middle-tier systems only.
Run the following command in the Infrastructure database Oracle home on the database-tier system. This command updates the $ORACLE_HOME/opmn/conf/ons.conf file with the IP addresses of the database-tier and middle-tier systems.
```
$ $ORACLE_HOME/dcm/bin/dcmctl listinstances
```
Verify that the ons.conf file contains the IP addresses of the database-tier and middle-tier systems only.

You must now stop and start services in all Oracle homes. See "Starting and Stopping Oracle9iAS Services" in Appendix A for details.

For Single-Tier Deployment

Use the following to refresh the ONS configuration for a single-tier deployment:

Run the following command in the Infrastructure Oracle home. This command updates the $ORACLE_HOME/opmn/conf/ons.conf file with the IP addresses of the current system.
```
$ $ORACLE_HOME/dcm/bin/dcmctl listinstances
```
Verify that the ons.conf file contains the IP addresses of the current system.

You must now stop and start services in all Oracle homes. See "Starting and Stopping Oracle9iAS Services" in Appendix A for details.

Applying the opca Patch

Run the following command to apply the opca patch:

$cp /admin/mwcc/patch/portal/ptlasst.csh <ORACLE_HOME>/assistants/opca

In the example above the <ORACLE_HOME> variable is the path to the Oracle9i Application Server mid-tier Oracle home.

Starting the Infrastructure Database in Archive Log Mode

Perform the following procedure to start the Infrastructure database in archive log mode:

Stop all the instances.
Log in as the user who owns the Oracle home that has the Infrastructure database.
Use the following command to set the environment:
```
$ . $ORACLE_HOME/profile.iascc_env
```
Select the $ORACLE_HOME that has the Infrastructure database.

Run the following commands:

$ . sqlplus ’/as sysdba’
SQL> startup mount;
SQL> alter database archivelog;
SQL> alter database opent;
SQL> shutdown immediate;
SQL> exit

Start all the instances.

Handling Configuration Failures

Refer to Appendix C, " Troubleshooting" for handling failures during configuration. If the failure requires you to reinstall the software, follow instructions in Appendix D, " Oracle9i Application Server Certified Configuration Deinstallation" to remove your existing installation.