This appendix describes how to install Oracle Web Tier from the command line in silent mode. This appendix contains the following topics:
Silent installation eliminates the need to monitor the Oracle Web Tier installation because no graphical output is displayed and no input by the user is required.
Silent installation of Oracle Web Tier is accomplished by supplying the installer with a response file and using the -silent flag on the command line. The response file is a text file containing variables and parameter values which provide answers to the installer prompts.
Note:
For UNIX users, if this is a first time installation of Oracle Web Tier you must create theoraInst.loc file before starting. Please refer to Section C.3.1, "UNIX Users: Creating the oraInst.loc File" for more information.
Following installation of Oracle Web Tier, you need to run the root.sh script as the root user. The root.sh script detects settings of environment variables and enables you to enter the full path of the local bin directory.
Note:
For Windows users, if this is a first time installation of Oracle Web Tier, you must create the registry keys before starting. Registry key creation is described in Section C.3.2, "Windows Users: Creating the Registry Key"Before doing a silent installation, you must provide information specific to your installation in a response file. The installer will fail 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 in a text editor
Table C-1 lists the response files provided in the Disk1/stage/Response (on UNIX operating systems) or Disk1\stage\Response (on Windows operating systems) directory on the installation CD-ROM:
Table C-1 Oracle Web Tier Installation and Configuration Response File Templates
| Template | Description |
|---|---|
|
|
This is the template response file that should be used if you have already installed the Oracle Web Tier software but have not yet run the Configuration Tool. The equivalent using the GUI would be running the See Section C.2.1, "Contents of the |
|
|
This is the template response file that should be used if you want to install and configure Oracle Web Tier products in one step. The equivalent using the GUI would be selecting Install and Configure option on the Select Installation Type Screen. See Section C.2.2, "Contents of the |
|
|
This is the template response file that should be used if you only want to install the software on your system. You must run the Configuration Tool (either from the command line or the GUI) later before you can begin to manage these products. The equivalent using the GUI would be selecting Install Software - Do Not Configure option on the Select Installation Type Screen. See Section C.2.3, "Contents of the |
In addition to these pre-existing response files, you can create your own response file by running the install GUI, then clicking Save on the Installation Summary Screen. You will be prompted for a name and location where you want to create this response file. After it is created, you can use it exactly as-is to replicate the installation on other systems, or modify it as needed.
Web TierConfigureOnly.rsp FileThis section shows the contents of the Disk1/stage/Response/Web TierConfigureOnly.rsp response file on a UNIX system:
[ENGINE] #DO NOT CHANGE THIS. Response File Version=1.0.0.0.0 [GENERIC] #The name of the Oracle Instance. Instance name must begin with an alphabetic character, may only contain alphanumeric characters, or the underscore (_) or hyphen (-) characters and are 4 to 30 characters long. INSTANCE_HOME=/oracle/product/11.1.1/as_1/instances/instance1 #Provide the Oracle Instance location. The Oracle Instance directory name may only contain alphanumeric , hyphen (-) , dot (.) and underscore (_) characters, and it must begin with an alphanumeric character. The total length has to be less than or equal to 128 characters. The location has to be an empty or non existing directory. INSTANCE_NAME=instance1 #If set to true, installer will auto assign ports AUTOMATIC_PORT_DETECT=true #This is required if "AUTOMATIC_PORT_DETECT" variable is set to false, absolute path of a staticports file location need to be provided with values for ports.\nThe template for staticports.ini can be found from Disk1/staget/Response directory of the shiphome. STATICPORT INI FILE LOCATION= [SYSTEM] #Set true to create a new instance and configure Oracle Process Management Notification, else skip the configuration CONFIGURE_OPMN=true #Set true to configure Oracle HTTP Server, else skip Oracle HTTP Server configuration CONFIGURE_OHS=true #Set true to configure Oracle Web Cache, else skip Oracle Web Cache configuration CONFIGURE_WEBCACHE=true #The Oracle HTTP Server (OHS) component name (required only if CONFIGURE_OHS is set to true). OHS component name must begin with an alphabetic character, may only contain alphanumeric characters, or the underscore (_) or hyphen (-) characters and are 4 to 30 characters long. OHS_COMPONENT_NAME=ohs1 #The Web Cache component name (required only if CONFIGURE_WEBCACHE is set to true). Web Cache component name must begin with an alphabetic character, may only contain alphanumeric characters, or the underscore (_) or hyphen (-) characters and are 4 to 30 characters long. WEBCACHE_COMPONENT_NAME=webcache1 #Valid passwords are 5 to 30 characters long, must begin with an alphabetic character, use only alphanumeric, underscore (_), dollar ($) or pound (#) characters and include at least one number. WEBCACHE_ADMINISTRATOR_PASSWORD=<SECURE VALUE> #The confirmation password for Web Cache administrator. WEBCACHE_ADMINISTRATOR_PASSWORD_CONFIRM=<SECURE VALUE> [APPLICATIONS] [RELATIONSHIPS] #If set to true, the instance and components will be registered with an existing weblogic server ASSOCIATE_WEBTIER_WITH_DOMAIN=true #Provide the exiting Middleware Home location. This is required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true. MIDDLEWARE_HOME=/Oracle/Middleware #Provide an existing domain host name. Required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true DOMAIN_HOST_NAME=machinename.machinedomain #Provide the existing domain port number. Required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true DOMAIN_PORT_NO=7001 #Provide the domain user name. Required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true DOMAIN_USER_NAME=weblogic #The domain user password. Required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true DOMAIN_USER_PASSWORD=<SECURE VALUE>
Web TierInstallAndConfigure.rsp FileThis section shows the contents of the Disk1/stage/Response/Web TierInstallAndConfigure.rsp response file on a UNIX system:
[ENGINE] #DO NOT CHANGE THIS. Response File Version=1.0.0.0.0 [GENERIC] #Set this to true if installation and configuration need to be done, all other required variables need to be provided. Variable "INSTALL AND CONFIGURE LATER TYPE" must be set to false if this is set to true as the variables are mutually exclusive INSTALL AND CONFIGURE TYPE=true #Set this to true if only Software only installation need to be done. If this is set to true then variable "INSTALL AND CONFIGURE TYPE" must be set to false, since the variables are mutually exclusive. INSTALL AND CONFIGURE LATER TYPE=false #Provide the Oracle Home location. The Oracle Home directory name may only contain alphanumeric , hyphen (-) , dot (.) and underscore (_) characters, and it must begin with an alphanumeric character. The total length has to be less than or equal to 128 characters. The location has to be an empty directory or a valid Web Tier Oracle Home. ORACLE_HOME=/oracle/product/11.1.1/as_1 #The name of the Oracle Instance. Instance name must begin with an alphabetic character, may only contain alphanumeric characters, or the underscore (_) or hyphen (-) characters and are 4 to 30 characters long. INSTANCE_HOME=/oracle/product/11.1.1/as_1/instances/instance1 #Provide the Oracle Instance location. The Oracle Instance directory name may only contain alphanumeric , hyphen (-) , dot (.) and underscore (_) characters, and it must begin with an alphanumeric character. The total length has to be less than or equal to 128 characters. The location has to be an empty or non existing directory. INSTANCE_NAME=instance1 #If set to true, installer will auto assign ports AUTOMATIC_PORT_DETECT=true #This is required if "AUTOMATIC_PORT_DETECT" variable is set to false, absolute path of a staticports file location need to be provided with values for ports.\nThe template for staticports.ini can be found from Disk1/staget/Response directory of the shiphome. STATICPORT INI FILE LOCATION= [SYSTEM] #Set true to create a new instance and configure Oracle Process Management Notification, else skip the configuration CONFIGURE_OPMN=true #Set true to configure Oracle HTTP Server, else skip Oracle HTTP Server configuration CONFIGURE_OHS=true #Set true to configure Oracle Web Cache, else skip Oracle Web Cache configuration CONFIGURE_WEBCACHE=true #The Oracle HTTP Server (OHS) component name (required only if CONFIGURE_OHS is set to true). OHS component name must begin with an alphabetic character, may only contain alphanumeric characters, or the underscore (_) or hyphen (-) characters and are 4 to 30 characters long. OHS_COMPONENT_NAME=ohs1 #The Web Cache component name (required only if CONFIGURE_WEBCACHE is set to true). Web Cache component name must begin with an alphabetic character, may only contain alphanumeric characters, or the underscore (_) or hyphen (-) characters and are 4 to 30 characters long. WEBCACHE_COMPONENT_NAME=webcache1 #Valid passwords are 5 to 30 characters long, must begin with an alphabetic character, use only alphanumeric, underscore (_), dollar ($) or pound (#) characters and include at least one number. WEBCACHE_ADMINISTRATOR_PASSWORD=<SECURE VALUE> #The confirmation password for Web Cache administrator. WEBCACHE_ADMINISTRATOR_PASSWORD_CONFIRM=<SECURE VALUE> [APPLICATIONS] [RELATIONSHIPS] #If set to true, the instance and components will be registered with an existing weblogic server ASSOCIATE_WEBTIER_WITH_DOMAIN=true #Provide the exiting Middleware Home location. This is required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true. MIDDLEWARE_HOME=/Oracle/Middleware #Provide an existing domain host name. Required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true DOMAIN_HOST_NAME=machinename.machinedomain #Provide the existing domain port number. Required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true DOMAIN_PORT_NO=7001 #Provide the domain user name. Required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true DOMAIN_USER_NAME=weblogic #The domain user password. Required only if ASSOCIATE_WEBTIER_WITH_DOMAIN is set to true DOMAIN_USER_PASSWORD=<SECURE VALUE>
Web TierSoftwareOnly.rsp FileThis section shows the contents of the Disk1/stage/Response/Web TierSoftwareOnly.rsp response file on a UNIX system:
[ENGINE] #DO NOT CHANGE THIS. Response File Version=1.0.0.0.0 [GENERIC] #Set this to true if installation and configuration need to be done, all other required variables need to be provided. Variable "INSTALL AND CONFIGURE LATER TYPE" must be set to false if this is set to true as the variables are mutually exclusive INSTALL AND CONFIGURE TYPE=false #Set this to true if only Software only installation need to be done. If this is set to true then variable "INSTALL AND CONFIGURE TYPE" must be set to false, since the variables are mutually exclusive. INSTALL AND CONFIGURE LATER TYPE=true #Provide the Oracle Home location. The Oracle Home directory name may only contain alphanumeric , hyphen (-) , dot (.) and underscore (_) characters, and it must begin with an alphanumeric character. The total length has to be less than or equal to 128 characters. The location has to be an empty directory or a valid Web Tier Oracle Home. ORACLE_HOME=/oracle/product/11.1.1/as_1 [SYSTEM] [APPLICATIONS] [RELATIONSHIPS]
Your response files contain certain passwords required by the installer. To find the places in the response file where passwords are required, search for the <SECURE VALUE> string and replace this value with the actual password. These passwords are stored in the response file clear text format. To minimize security issues regarding these passwords 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 installation.
If possible, remove the response files from the system after the silent installation is completed.
This section covers the pre-installation tasks that may be required before you are able to perform a silent installation.
The following topics are covered:
oraInst.loc FileThe Oracle inventory directory is used by the installer to keep track of all Oracle products installed on the computer. The inventory directory is stored in a file called oraInst.loc. If this file does not already exist on your system, you must create it before starting a silent installation. This file is used by the installer.
Log in as the root user.
prompt> su
Using a text editor such as vi or emacs, create the oraInst.loc file in the directory of your choice. The contents of the file consist of the following two lines:
inventory_loc=oui_inventory_directory inst_group=oui_install_group
Replace oui_inventory_directory with the full path to the directory where you want the installer to create the inventory directory. Then, replace oui_install_group with the name of the group whose members have write permissions to this directory.
Exit from the root user.
# exit
If you have not installed Oracle Web Tier on your computer, then you need to create the following Registry key and value:
HKEY_LOCAL_MACHINE / SOFTWARE / Oracle / inst_loc = [inventory_directory]
Replace Inventory_Directory with the full path to your installer files. For example:
C:Program Files\Oracle\Inventory
The syntax for running the installer from the command line on UNIX systems is shown below:
runInstaller [-mode] [-options] [(<CommandLinevariable=Value>)*]
On Windows systems:
setup.exe [-mode] [-options] [(<CommandLinevariable=Value>)*]
Table C-2 Installer Command Line Parameters
| Parameter | Description |
|---|---|
|
Installation Modes - Only One Mode Can be Specified |
|
|
|
Launches the installer in GUI mode. This is the default mode and is used if no mode is specified on the command line. |
|
|
Install in silent mode. The installer must be passed either a response file or command line variable value pairs. |
|
|
Launches the installer in GUI mode for deinstallation. |
|
|
Launches the installer in GUI mode but only checks the prerequisites. No software is installed. |
|
|
Launches the installer in GUI mode and performs all prerequisite and validation checking, but does not install any software. |
|
|
Performs all prerequisite and validation checking in silent mode. You must pass the installer either a response file or a series of command line variable value pairs. |
|
Installation Options |
|
|
|
Displays the usage parameters for the |
|
|
Pointer to the inventory location file. Replace file with the full path and name of the |
|
|
Pointer to the response file. Replace file with the full path and name of the response file. |
|
|
Pointer to the location where Java Runtime Environment (JRE) is installed. Replace location with the full path to the |
|
|
Specify the level of logging performed by the installer; all messages with a lower priority than the specified level will be recorded. Valid levels are:
|
|
|
Obtain debug information from the installer. |
|
|
Allow the silent installation to proceed in a non-empty directory. |
|
|
Log debugging information pertaining to disk usage. |
|
|
Log debugging information pertaining to memory usage. |
|
|
Log debugging information pertaining to time usage. This command causes the |
|
|
Windows only - the installer will wait for completion instead of spawning the Java engine and exiting. |
|
|
Messages will not be displayed to the console window. |
|
|
Ignore the results of the system prequisite checks and continue with the installation. |
|
|
Execute the system prequisite checks only, then exit. |
|
|
Specify the full path to the |
|
|
Disables all validation checking performed by the installer. |
|
|
For the GUI install, several screens have information or default values pre-populated. Specifying this option disables this behavior so that no information or values are pre-populated. |
|
Command Line Variables |
|
|
Installer Variables |
Installer variables are specified using ORACLE_HOME=/home/Oracle/Middleware/as_1 On a Windows system: ORACLE_HOME=C:\products\Oracle\Middleware\as_1 |
|
Session Variables |
Session variables are specified using |
|
Component Variables |
Component variables are specified using |
If this is the first time you are installing on your system (meaning there is no pre-existing Oracle inventory location), use the following command to perform a silent installation on a UNIX system:
./runInstaller -silent -response file -invPtrLoc file
On a Windows system:
setup.exe -silent -response file -invPtrLoc file
Below is a full example of this command on a UNIX system:
./runInstaller -silent -response /home/Oracle/response/Web TierInstallAndConfigure.rsp -invPtrLoc /home/Oracle/oraInst.loc
On a Windows system:
setup.exe -silent -response C:\products\Oracle\response\Web TierInstallAndConfigure.rsp -invPtrLoc C:\products\Oracle\oraInst.loc
If you have already installed an Oracle product on your system and do not need to specify an inventory location, then you can use a command similar to the following on a UNIX system:
./runInstaller -silent -response file
On a Windows system:
setup.exe -silent -response file
Below is a full example of this command on a UNIX system:
./runInstaller -silent -response /home/Oracle/response/Web TierInstallAndConfigure.rsp
On a Windows system:
setup.exe -silent -response C:\products\Oracle\response\Web TierInstallAndConfigure.rsp
Below is a sample output on a UNIX system from a silent install using the WebTierSoftwareOnly.rsp template:
Platform is Linux X86 32 bit Starting Oracle Universal Installer... Checking Temp space: must be greater than 80 MB. Actual 65464 MB Passed Checking swap space: must be greater than 150 MB. Actual 1590 MB Passed Preparing to launch Oracle Universal Installer from /tmp/OraInstall2009-03-26_01-50-03PM. Please wait ...[khwang@dadvmn0789 Disk1]$ Log: /scratch/khwang/oraInventory/logs/install2009-03-26_01-50-03PM.log Copyright © 1999, 2009, Oracle and/or its affiliates. All rights reserved. Reading response file.. Expected result: One of enterprise-4,enterprise-5,redhat-4,redhat-5,SuSE-10,asianux-2,asianux-3 Actual Result: redhat-4 Check complete. The overall result of this check is: Passed CertifiedVersions Check: Success. Checking for gcc-3.4.3-22.1; found gcc-3.4.6-10.0.1-i386. Passed Checking for gcc-c++-3.4.3-22.1; found gcc-c++-3.4.6-10.0.1-i386. Passed Checking for openmotif21-2.1.30-11.RHEL4.4 ; found openmotif21-2.1.30-11.0.1.RHEL4.6-i386. Passed Checking for setarch-1.6-1; found setarch-1.6-1-i386. Passed Checking for pdksh-5.2.14-30; found pdksh-5.2.14-30.6-i386. Passed Checking for sysstat-5.0.5-1; found sysstat-5.0.5-19.el4-i386. Passed Checking for gnome-libs-1:1.4.1.2.90-44.1; found gnome-libs-1:1.4.1.2.90-44.2-i386. Passed Checking for libstdc++-3.4.3-22.1 ; found libstdc++-3.4.6-10.0.1-i386. Passed Checking for libstdc++-devel-3.4.3-22.1; found libstdc++-devel-3.4.6-10.0.1-i386. Passed Checking for compat-libstdc++-296-2.96-132.7.2; found compat-libstdc++-296-2.96-132.7.2-i386. Passed Checking for compat-db-4.1.25-9; found compat-db-4.1.25-9-i386. Passed Checking for control-center-2.8.0-12; found control-center-1:2.8.0-12.rhel4.5-i386. Passed Checking for glibc-common-2.3.4-2.9; found glibc-common-2.3.4-2.41-i386. Passed Checking for binutils-2.15.92.0.2-13; found binutils-2.15.92.0.2-25-i386. Passed Checking for make-1:3.80-5; found make-1:3.80-7.EL4-i386. Passed Checking for xscreensaver-4.18-5.rhel4.2; found xscreensaver-1:4.18-5.rhel4.14.0.1-i386. Passed Check complete. The overall result of this check is: Passed Packages Check: Success. Checking for VERSION=2.6.9; found VERSION=2.6.9-78.0.0.0.1.ELxenU. Passed Checking for hardnofiles=4096; found hardnofiles=4096. Passed Checking for softnofiles=4096; found softnofiles=4096. Passed Check complete. The overall result of this check is: Passed Kernel Check: Success. Expected result: ATLEAST=2.3.4-2.19 Actual Result: 2.3.4-2.41 Check complete. The overall result of this check is: Passed GLIBC Check: Success. Expected result: 922MB Actual Result: 4000MB Check complete. The overall result of this check is: Passed TotalMemory Check: Success. Verifying data...... Copying Files... -----------20%----------40%----------60%----------80%---------100% The installation of Oracle Web Tier 11g completed successfully.