Skip Headers
Oracle® Content Database Installation Guide
10g Release 1 (10.2.0.0.0) for HP-UX PA-RISC (64-Bit)

Part Number B31416-01
Go to Documentation Home
Home
Go to Book List
Book List
Go to Table of Contents
Contents
Go to Index
Index
Go to Feedback page
Contact Us

Go to previous page
Previous
Go to next page
Next
View PDF

6 Silent Installation of the Oracle Content DB Middle Tier

This chapter discusses silent and noninteractive installation of Oracle Content DB.

This chapter includes the following topics:

6.1 Introduction to Oracle Content DB Noninteractive Installations

Oracle Content DB features the following two noninteractive methods of installation:

6.1.1 Silent Installation of Oracle Content DB Middle Tier

Silent installation eliminates the need to monitor the Oracle Content DB installation because there is no graphical output and no input by the user. It is accomplished by supplying Oracle Universal Installer with a response file and specifying the -silent flag on the command line.

You can use silent installation of Oracle Content DB when you want similar installations on more than one computer. Additionally, you can use silent installation when performing the Oracle Content DB installation from a remote location using the command line.

The response file used in a silent installation is a text file. Oracle Universal Installer uses variables and values specified in the response file to provide answers to all of its user prompts. Therefore, you must include responses for all of the prompts in the response file.

If this is a first-time installation of Oracle Content DB, you must manually create the following two files before starting installation:

  • oraInst.loc

  • oratab

These files are used by Oracle Universal Installer during the installation.


See Also:


After any silent Oracle Content DB installation, you must run the root.sh script, which detects settings of environment variables and enables you to enter the full path of the local bin directory.

6.1.2 Noninteractive Installation of Oracle Content DB Middle Tier

Noninteractive installations of Oracle Content DB display a graphical output. If you have not provided responses to all of the user prompts, you may need to enter information during the installation.

Noninteractive installation of Oracle Content DB is also accomplished by supplying the Oracle Universal Installer with a response file, but without specifying the -silent flag on the command line. Oracle Universal Installer uses the variables and values contained in the response file to provide answers to some or all of its user prompts.

If this is a first-time installation of Oracle Content DB, you must manually create oraInst.loc and oratab files before starting the installation. These text files are used by Oracle Universal Installer during the installation.

After any noninteractive Oracle Content DB installation, you must run the root.sh script, which detects settings of environment variables and enables you to enter the full path of the local bin directory.

Use noninteractive installation of Oracle Content DB when there are specific screens you want to observe during installation.

6.2 Silent or Noninteractive Installation Requirements

The installation requirements for these types of installations are the same as those described in Chapter 4, "Preinstallation Requirements for Oracle Content DB Middle Tier".

6.3 Creating Files for Silent and Noninteractive Installation

If the oraInst.loc and oratab files do not exist on your computer, you must create them before starting silent installation of Oracle Content DB. They are used by Oracle Universal Installer during silent installation.

These two files must be created in the /var/opt/oracle directory.

6.3.1 Creating the oraInst.loc File

As the root user, create the oraInst.loc file in the /var/opt/oracle directory. Ensure that the file has read and write permissions set for the oracle user, because this user performs the installation. The oraInst.loc file must have the following text input:

inst_group=oracle_user_group
inventory_loc=ORACLE_BASE/oraInventory

In this text input, inventory_loc is the location for inventory files and ORACLE_BASE is the absolute directory path. For example, if your ORACLE_BASE is /private2/oracle, the content of the file is:

inst_group=oracle_user_group
inventory_loc=/private2/oracle/oraInventory

Note:

If inventory_loc is not located in your Oracle home, you must ensure that the directory where it is located has read and write permissions set for oracle_user_group.

6.3.2 Creating the oratab File

As the root user, create the oratab file in the /var/opt/oracle directory. Ensure that the file is empty and has read and write permissions for the oracle user, because this user performs the installation.

6.4 Response Files

Before performing a silent or noninteractive installation, you must provide information specific to your installation in a response file. Oracle Universal Installer fails if you attempt an installation using a response file that is not configured correctly. Response files are text files that you can create or edit with a text editor.

The Oracle Content DB Media Pack provides a template for the Oracle Universal Installer response file.

Response files are located in the /response directory on Disk 1 of the Oracle Content DB Media Pack. You must edit the response file according to your requirements for silent or noninteractive installation.

To use a response file, first copy it from the DVD to your system, as follows:

  1. Go to the /response directory on the first DVD of the Oracle Content DB Media Pack.

  2. Copy the contentdb.rsp file to your system hard drive.

This section includes the following topics:

6.4.1 Editing a Response File

Use any text editor to edit the response file to include information specific to your system. The response file text identifies information that you must provide.

You must specify values for variables in your response file. Each variable listed in the response file is associated with a comment, which identifies the variable type. For example:

string = "Sample Value"
Boolean = True or False
Number = 1000
StringList = {"StringValue 1", "String Value 2"}

The values that are given as <Value Required> must be specified for silent installation.

Delete the given sample values in the response file and enter your specific values before starting the Oracle Content DB installation.

6.4.2 Creating a Response File Using the Record Mode in the Installer

You can run Oracle Universal Installer in record mode to save your inputs to a file that you can use later as a response file. This feature is useful if you need to perform the same installation on different computers.

To run Oracle Universal Installer in record mode:

  1. Start Oracle Universal Installer with the -record and -destinationFile parameters, as follows:

    prompt> /path/to/runInstaller -record -destinationFile new_response_file
    
    

    Replace new_response_file with the full path to the response file that you want Oracle Universal Installer to create, such as /tmp/contendb.rsp.

  2. Enter the values for the Oracle Universal Installer screens. Oracle Universal Installer writes these values to the file specified in the -destinationFile parameter.

When you get to the Summary screen, Oracle Universal Installer automatically writes all the values that you supplied to the specified file. At this point, you can complete the installation on this computer, or you can exit without performing the installation.

6.4.3 Specifying a Response File and Starting the Installation

Before you specify a response file, ensure that all the values in the response file are correct.

To set up Oracle Universal Installer to use the response file at the time of installation, specify the location of the response file as a parameter when starting Oracle Universal Installer, as follows:

prompt> ./runInstaller -responseFile absolute_path_to_file_name

In a noninteractive installation, set the DISPLAY environment variable, as described in "DISPLAY", and specify the location of the response file that you want to use as a parameter when starting the installer.

To perform a noninteractive installation:

prompt> ./runInstaller -responseFile absolute_path_and_file_name

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

prompt> ./runInstaller -silent -responseFile absolute_path_and_file_name

The success or failure of the noninteractive installation is logged in the installActions.log file. The success or failure of the silent installation is logged in the silentInstall.log file. Both log files are created in subdirectory logs in the logs directory, under the oraInventory directory, during installation and typically contain timestamps in their file names.

For example:

installActions2006-07-28_11-35-45AM.log


Caution:

During installation, response files may be copied to subdirectories under $ORACLE_HOME to install some Oracle Content DB components. When the installation completes successfully, these copies are removed. If the installation fails, however, these copies may not be removed. In both cases, if you have provided passwords or other sensitive information in your response files, Oracle recommends that you ensure their security and, if needed, delete any copies of the response files that remain in your file system.

6.5 Running the root.sh Script

You must run the root.sh script after performing a silent or noninteractive installation. For a noninteractive Oracle Content DB installation, if you have not set the SHOW_ROOTSH_CONFIRMATION parameter in the response file to FALSE, you will be prompted to run the root.sh script.


Note:

After the silent or noninteractive installation is complete, view the log files (located in the logs directory, under the oraInventory directory) to see if any errors occurred during the installation.

This section includes the following topics:

6.5.1 root.sh and Silent Installation

During any silent Oracle Content DB installation, you are not prompted to run the root.sh script. You must run the root.sh script after the silent installation.

To run the root.sh script:

  1. Log in as the root user.

  2. Run the root.sh script located in the Oracle home directory.

    # $ORACLE_HOME/root.sh
    
    

    In this command, $ORACLE_HOME is the absolute directory path.

  3. Exit the root user.

This section includes the following topics:

6.5.1.1 Starting Oracle HTTP Server After Silent Installation

During silent installation, Oracle Universal Installer attempts to start Oracle HTTP Server. However, Oracle HTTP Server does not start until the root.sh script is run. Ignore any error messages generated because of the inability to start Oracle HTTP Server.

After running the root.sh script, restart Oracle HTTP Server, as follows:

$ORACLE_HOME/opmn/bin/opmnctl stopproc ias-component=HTTP_Server$ORACLE_HOME/opmn/bin/opmnctl startproc ias-component=HTTP_Server

6.5.1.2 Using Oracle HTTP Server on a Different Port

To use Oracle HTTP Server on a port number that lower than 1024, do not run the root.sh script. Instead, run the following script as the root user:

$ORACLE_HOME/Apache/Apache/bin/root_sh_append.sh

In the preceding command, $ORACLE_HOME is the absolute directory path.

The root_sh_append.sh script sets the necessary permissions for the Oracle HTTP Server to be run on a port lower than 1024.

6.5.2 root.sh and Noninteractive Installation

During noninteractive installation of Oracle Content DB, Oracle Universal Installer prompts you to run the root.sh script.

To run the root.sh script:

  1. Log in as the root user.

  2. Run the root.sh script located in the Oracle home directory.

    # $ORACLE_HOME/root.sh
    
    

    In this command, $ORACLE_HOME is the absolute directory path.

  3. Exit the root user.

For noninteractive installation, after the Finished running generic part of the root.sh script and Now product-specific root actions will be performed messages display, exit the root user and return to the current installation screen.

The root.sh script detects the following:

  • Settings of the ORACLE_OWNER, ORACLE_HOME, and ORACLE_SID environment variables.

  • Full path of the local bin directory. You can accept the default or change to a different local bin directory.

6.6 Postinstallation Tasks

The success or failure of the noninteractive 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 $ORACLE_BASE/oraInventory/oui_inventory/logs directory.

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

The installation of Oracle Content DB was successful.

The installActions.log file contains specific information for each Oracle Content DB installation.

6.7 Security Tips for Silent and Noninteractive Installations

One of the pieces of information in the response file is the installation password. The password information is not encrypted.

To minimize security issues regarding the password in the response file, follow these guidelines:

6.8 Error Handling

If the silent or noninteractive installation fails, you must deinstall the Oracle Content DB middle tier, then reinstall it. See Appendix G, "Deinstalling the Oracle Content DB Middle Tier" for complete instructions on how to deinstall the Oracle Content DB middle tier.

Response File Error Handling

Oracle Universal Installer or most of the configuration assistants validate the response file at run time. If the validation fails, the noninteractive installation or configuration process ends. Oracle Universal Installer treats values for parameters that are of the wrong context, format, or type as if no value was specified in the file. Variables that are outside any section are also ignored.

6.9 Silent Deinstallation of Oracle Content DB

If your silent or noninteractive installation fails, you must completely deinstall any files remaining from your Oracle Content DB installation attempt.


See Also:

Appendix G, "Deinstalling the Oracle Content DB Middle Tier"for deinstallation instructions

You can perform a silent deinstallation of Oracle Content DB by supplying a silent deinstallation parameter to the response file you used for installation. Add the following parameter to your installation response file:

REMOVE_HOMES={"ORACLE_HOME_to_be_removed"}

To perform a silent deinstallation, use the -silent parameter when you enter the following command:

prompt> ./runInstaller -silent -responseFile absolute_path_and_file_name