4
Silent and Non-Interactive Installation

This chapter guides you through the silent and non-interactive installation of Oracle9i Application Server Release 2 (9.0.3) (Oracle9iAS 9.0.3). The topics include:

• Introduction

• Requirements

• Preinstallation

• Create the Response File

• Start the Installation

• Postinstallation

• Response File Parameter Definitions

4.1 Introduction

Oracle9iAS 9.0.3 features two methods of non-interactive installation:

• Silent Installation

• Non-Interactive Installation

4.1.1 Silent Installation

Silent installation of Oracle9iAS 9.0.3 is accomplished by supplying the Oracle Universal Installer with a response file and specifying the -silent flag on the command line. The response file is a text file.

The installer uses the variables and parameter values contained in the response file to provide answers to all of the installer prompts. You include responses for all of the installer prompts in the response file. Silent installation displays no graphical output.

If this is the first silent installation of Oracle9iAS 9.0.3, you must create a response file before starting. File creation is described in Section 4.3, "Preinstallation". File parameters are described in Section 4.7, "Response File Parameter Definitions".

Following installation of Oracle9iAS 9.0.3, you need to run the root.sh script. The root.sh script detects settings of environmental variables and allows you to enter the full path of the local bin directory.

Use silent installation of Oracle9iAS 9.0.3 when there are similar installations on more than one computer. Additionally, use silent install when performing the Oracle9iAS 9.0.3 installation from a remote location using the command line. Silent installation eliminates the need to monitor the Oracle9iAS 9.0.3 installation because there is no graphical output and no input by the user.

Note: The installer will fail if you attempt a silent session without appropriately configuring a response file.

4.1.2 Non-Interactive Installation

Non-interactive installation of Oracle9iAS 9.0.3 is also accomplished by supplying the Oracle Universal Installer with a response file but without specifying the -silent flag on the command line. The response file is a text file. The installer uses the variables and parameter values contained in the response file to provide answers to some or all of the installer user prompts. There is graphical output and if you have not provided responses to all of the installer prompts, you may need to enter information during the installation.

If this is a first non-interactive installation of Oracle9iAS 9.0.3, you must create a response file before starting. File creation is described in Section 4.3, "Preinstallation". File parameters are described in Section 4.7, "Response File Parameter Definitions".

Following installation of Oracle9iAS 9.0.3, you need to run the root.sh script. The root.sh script detects settings of environmental variables and allows you to enter the full path of the local bin directory.

Use non-interactive installation of Oracle9iAS 9.0.3 when there are specific screens you want to observe during installation. Additionally, you can use non-interactive installation when performing the Oracle9iAS 9.0.3 installation from a remote location using the command line.

See Also: Section 2.5.3.2, "DISPLAY" for more information about remote installation.

4.2 Requirements

For a complete list of Oracle9iAS 9.0.3 installation requirements, refer to Chapter 2, "Getting Started".

4.3 Preinstallation

If the oraInst.loc file does not exist on your computer, you must create the file before starting the silent and non-interactive installation of Oracle9iAS 9.0.3.

The oraInst.loc file is typically stored in the /var/opt/oracle/ directory. The file is used by the Oracle Universal Installer during installation.

As the root user, create the oraInst.loc file in the /var/opt/oracle/ directory. The oracle group is the group performing the installation.

Enter the following line of text in the orainst.loc file:

inventory_loc=/full_path/oui_inventory

The oraInst.loc file specifies inventory_loc location for inventory files. If the oraInst.loc file is not located in your Oracle home, make sure the file has read and write permission for the oracle group.

See Also: Chapter 2, "Getting Started"

4.4 Create the Response File

Before silent or non-interactive installation you must provide information specific to your installation.

You must create a response file using any text editor or use the templates available in the stage/Response directory on Disk1 of your Oracle9iAS 9.0.3 product CD-ROM. The response file you use must match the examples shown. Each type of Oracle9iAS 9.0.3 installation uses the response parameters listed below:

[SESSION]
UNIX_GROUP_NAME="your_unix_group_name"
FROM_LOCATION="/mount_point/stage/products.jar"
FROM_LOCATION_CD_LABEL="Oracle9i Application Server 9.0.3.0.0"
ORACLE_HOME="ORACLE_HOME"
ORACLE_HOME_NAME="ORACLE_HOME_NAME"
SHOW_SPLASH_SCREEN=true
SHOW_WELCOME_PAGE=false
SHOW_COMPONENT_LOCATIONS_PAGE=false
SHOW_CUSTOM_TREE_PAGE=false
SHOW_SUMMARY_PAGE=false
SHOW_INSTALL_PROGRESS_PAGE=true
SHOW_REQUIRED_CONFIG_TOOL_PAGE=false
SHOW_OPTIONAL_CONFIG_TOOL_PAGE=false
SHOW_RELEASE_NOTES=false
SHOW_ROOTSH_CONFIRMATION=false
SHOW_END_SESSION_PAGE=false
SHOW_EXIT_CONFIRMATION=false
NEXT_SESSION=false
NEXT_SESSION_ON_FAIL=false
SHOW_DEINSTALL_CONFIRMATION=false
SHOW_DEINSTALL_PROGRESS=true

Note: Oracle recommends specifying either "true" or "false" for Boolean parameters.

See Also: Section 4.7, "Response File Parameter Definitions"

4.4.1 Oracle9iAS 9.0.3 Without Oracle9iAS Single Sign-On

The following text shows the parameter definitions for installation of Oracle9iAS 9.0.3 without Oracle9iAS Single Sign-On:

[oracle.iappserver.iapptop_9.0.3.0.0]
   szl_InstanceInformation={"iASInstanceName", "iASInstancePassword", 
   "iASInstancePassword"}
   b_configureCalypso=true
   SSOselectStatus="N"
   SSOport="sso_port"
   SSOhost="sso_hostname.domain"
   SHOW_IAS_COMPONENT_CONFIG_PAGE=false
   nValidationOID=0
   nValidationInstanceInfo=0
   nValidationCoreSSO=0

See Also: Section 4.7, "Response File Parameter Definitions"

4.4.2 Oracle9iAS 9.0.3 With Oracle9iAS Single Sign-On

The following text shows the parameter definitions for installation of Oracle9iAS 9.0.3 with Oracle9iAS Single Sign-On:

[oracle.iappserver.iapptop_9.0.3.0.0]
   OIDport="oid_port"
   OIDhost="oid_hostname.domain"
   szl_OIDUserOutput={"cn=orcladmin", "oid_password"}
   szl_InstanceInformation={"iASInstanceName", 
   "iASInfrastructureInstancePassword", "iASInfrastructureInstancePassword"}
   b_configureCalypso=true
   SSOselectStatus="Y"
   SSOport="sso_port"
   SSOhost="sso_hostname.domain"
   SHOW_IAS_COMPONENT_CONFIG_PAGE=false
   nValidationOID=0
   nValidationInstanceInfo=0
   nValidationCoreSSO=0

See Also: Section 4.7, "Response File Parameter Definitions"

Note: The Oracle9iAS Infrastructure 9.0.2 ORACLE_HOME/install/portlist.ini and ORACLE_HOME/config/ias.properties files show port assignments.

4.5 Start the Installation

To make the installer use the response file at install time, open a command prompt window and specify the location of the response file that you wish to use as a parameter when starting the installer.

To perform a non-interactive installation session:

prompt> setenv DISPLAY ias_hostname:0.0
prompt> ./runInstaller -responseFile path/responsefile

To perform a completely silent installation session, use the -silent parameter:

prompt> setenv DISPLAY ias_hostname:0.0
prompt> ./runInstaller -silent -responseFile path/responsefile

See Also: Chapter 2.6.4, "Starting Oracle Universal Installer"

4.6 Postinstallation

The success or failure of the non-interactive and silent installations is logged in the installActions.log file. Additionally, the silent installation creates the silentInstall.log file. The log files are created in the oraInventory directory during installation.

The silentInstall.log file contains the following line if your installation was successful:

The installation of Oracle9iAS Installation_Type was successful.

The installActions.log file contains specific information for each Oracle9iAS 9.0.3 installation. The following sections show information specific to each type of Oracle9iAS 9.0.3 installation:

• Oracle9iAS 9.0.3 without Oracle9iAS Single Sign-On

• Oracle9iAS 9.0.3 with Oracle9iAS Single Sign-On

  See Also: Section 2.6.3, "Oracle Universal Installer oraInventory Directory"

4.6.1 Oracle9iAS 9.0.3 without Oracle9iAS Single Sign-On

The installActions.log file contains the following information for successful Oracle9iAS 9.0.3 without Oracle9iAS Single Sign-On installation:

Configuration tool Java Security Configuration Assistant succeeded
Configuration tool HTTP Server Configuration Assistant succeeded
Configuration tool OC4J Configuration Assistant succeeded
Configuration tool BC4J Configuration Assistant succeeded
Configuration tool Clickstream Collector Agent Configuration Assistant succeeded
Configuration tool Oracle9iAS Web Cache Configuration Assistant succeeded
Configuration tool Oracle9iAS Instance Configuration Assistant succeeded
Configuration tool OC4J Instance Configuration Assistant succeeded
Configuration tool OPMN Configuration Assistant succeeded
Configuration tool Enterprise Manager Web Site Configuration Assistant succeeded
Configuration tool DCM Repository Backup Assistant succeeded

Note: Enterprise Manager Web Site Configuration Assistant and Distributed Configuration Management (DCM) Repository Backup Assistant success messages appear during installation of Oracle9iAS 9.0.3.

4.6.2 Oracle9iAS 9.0.3 with Oracle9iAS Single Sign-On

The installActions.log file contains the following information for successful Oracle9iAS 9.0.3 with Oracle9iAS Single Sign-On installation:

Configuration tool Infrastructure Use Configuration Assistant succeeded
Configuration tool Java Security Configuration Assistant succeeded
Configuration tool HTTP Server Configuration Assistant succeeded
Configuration tool OC4J Configuration Assistant succeeded
Configuration tool BC4J Configuration Assistant succeeded
Configuration tool Clickstream Collector Agent Configuration Assistant succeeded
Configuration tool Oracle9iAS Web Cache Configuration Assistant succeeded
Configuration tool Oracle9iAS Instance Configuration Assistant succeeded
Configuration tool OC4J Instance Configuration Assistant succeeded
Configuration tool OPMN Configuration Assistant succeeded
Configuration tool Enterprise Manager Web Site Configuration Assistant succeeded
Configuration tool DCM Repository Backup Assistant succeeded

Note: Enterprise Manager Web Site Configuration Assistant and DCM Repository Backup Assistant success messages appear during installation of Oracle9iAS 9.0.3.

4.7 Response File Parameter Definitions

The section describes the parameters used for silent and non-interactive installation.

UNIX_GROUP_NAME: The name of the UNIX group performing the installation.

FROM_LOCATION: The location of the Oracle9iAS 9.0.3 installation CD-ROM.

FROM_LOCATION_CD_LABEL: The label of the Oracle9iAS 9.0.3 installation CD-ROM.

ORACLE_HOME: The installation location of your Oracle home.

ORACLE_HOME_NAME: The name of your Oracle home for your Oracle9iAS 9.0.3 installation. The ORACLE_HOME_NAME must be unique for each Oracle9iAS 9.0.3 installation.

See Also: Section 2.5.3.1, "ORACLE_HOME"

SHOW Screens: For a silent installation leave these parameters at <Value Unspecified>. For a non-interactive installation, choose which screens will be seen (true) and not seen (false).

szl_OIDUserOutput: Set this parameter if you are pointing your Oracle9iAS 9.0.3 installation to an existing Oracle Internet Directory 9.0.2.

Add the following values for Oracle9iAS 9.0.3 installation:

• cn=orcladmin: Assumes orcladmin is the Oracle Internet Directory 9.0.2 user, in your existing Oracle Internet Directory 9.0.2 instance.

• oid_password: The password for the orcladmin, in the Oracle Internet Directory 9.0.2 instance.

OIDport: The port used by your existing Oracle Internet Directory 9.0.2 instance. Refer to the ORACLE_HOME/install/portlist.ini file in the Oracle9iAS Infrastructure 9.0.2 Oracle home to find the actual port number. This value must match the value specified in the oid_port in szl_OIDUserOutput parameter.

OIDhost: The host name and domain for your existing Oracle Internet Directory 9.0.2 instance. This value must match the value specified in the oid_hostname.domain in szl_OIDUserOutput parameter.

SSOport: The port used by your existing Oracle9iAS Single Sign-On instance. Refer to the install/portlist.ini file in the Oracle9iAS Infrastructure 9.0.2 Oracle home to find the actual port number. This value must match the value specified for sso_port in the szl_SSOUserOutput parameter.

SSOhost: The host name and domain of your existing Oracle9iAS Single Sign-On instance. This value must match the value specified for sso_hostname.domain in the szl_SSOUserOutput parameter.

szl_InstanceInformation: Specify the following values:

• Instance Name for this Oracle9iAS 9.0.3 installation instance.

• Instance Password for this Oracle9iAS 9.0.3 installation instance.
  • If this is the first Oracle9iAS 9.0.3 on your computer you must specify a password.

  • If you are installing Oracle9iAS 9.0.3, and an existing Oracle9iAS 9.0.3 or Oracle9iAS 9.0.2 installation is on your computer, then you must use the same password created for the previous installation.

    See Also: Section 2.5.3.1, "ORACLE_HOME" Oracle9i Application Server 9.0.2 Installation Guide

szl_RepositoryUserInput: Set this parameter if you have more than one Oracle9iAS Infrastructure 9.0.2 database registered in Oracle Internet Directory 9.0.2. In that case, specify the following values:

• inf_hostname: The host name of your Oracle9iAS Infrastructure 9.0.2 Installation.

• inf_dbport: The port of your Oracle9iAS Infrastructure 9.0.2 Database.

• inf_SID: The SID of your Oracle9iAS Infrastructure 9.0.2 Database.

• inf_GlobalDBName: The Global Database Name of your Oracle9iAS Infrastructure 9.0.2 Database.

SSOselectStatus: Set this parameter for Oracle9iAS 9.0.3 installation. Specify one of the following values:

• "Y": if you are configuring the installation with Oracle9iAS Single Sign-On

• "N": if you are not configuring with Oracle9iAS Single Sign-On

b_configureCalypso: Use this boolean parameter to specify whether (true, by default) or not (false) you want to launch the Oracle9iAS Web Cache Configuration Assistant at the end of the installation.

Mandatory Settings: The following parameter values, where required, must be specified exactly as shown:

SHOW_IAS_COMPONENT_CONFIG_PAGE=false
nValidationInstanceInfo=0
nValidationOID=0
nValidationCoreSSO=0