Oracle® Content Database Installation Guide 10g Release 1 (10.2.0.0.0) for AIX 5L Based Systems (64-Bit) Part Number B31417-01 |
|
|
View PDF |
This chapter discusses silent and noninteractive installation of Oracle Content DB.
This chapter includes the following topics:
Oracle Content DB features the following two noninteractive methods of installation:
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.
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.
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".
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 /etc
directory.
As the root
user, create the oraInst.loc
file in the /etc
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: Ifinventory_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 . |
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:
Go to the /response
directory on the first DVD of the Oracle Content DB Media Pack.
Copy the contentdb.rsp
file to your system hard drive.
This section includes the following topics:
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.
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:
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
.
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.
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. |
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 thelogs directory, under the oraInventory directory) to see if any errors occurred during the installation. |
This section includes the following topics:
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.
Log in as the root
user.
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.
Exit the root
user.
This section includes the following topics:
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
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.
During noninteractive installation of Oracle Content DB, Oracle Universal Installer prompts you to run the root.sh
script.
Log in as the root
user.
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.
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.
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.
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:
Set the permissions on the response files so that they are readable only by the operating system user who will be performing the silent or noninteractive installation.
If possible, remove the response files from the system after the silent or noninteractive installation is complete, or clear the password entries.
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.
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