B Silent and Non-Interactive Installation

This appendix describes how to install Oracle Application Server in silent mode. This appendix contains the following topics:

Section B.1, "Silent Installation"
Section B.2, "Non-Interactive Installation"
Section B.3, "Preinstallation"
Section B.4, "Create the Response File"
Section B.5, "Start the Installation"
Section B.6, "Postinstallation"
Section B.7, "Security Tips for Silent and Non-Interactive Installations"
Section B.8, "Deinstallation"

B.1 Silent Installation

Silent installation eliminates the need to monitor the Oracle Application Server installation because there is no graphical output and no input by the user.

Silent installation of Oracle Application Server 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 containing variables and parameter values which provide answers to the installer prompts.

If this is a first time installation of Oracle Application Server, you must create the oraInst.loc file before starting. File creation is described in Section B.3, "Preinstallation".

Following installation of Oracle Application Server, 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.

Use silent installation of Oracle Application Server when there are similar installations on more than one computer. Additionally, use silent install when performing the Oracle Application Server installation from a remote location using the command line.

B.2 Non-Interactive Installation

Non-interactive installations also use a response file to automate the Oracle Application Server installation. In non-interactive installations, there is graphical output and users may enter input.

Non-interactive installation of Oracle Application Server 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 containing variables and parameter values which provide answers to the installer prompts. If you have not provided responses to all of the installer prompts, you need to enter information during the installation.

If this is a first time installation of Oracle Application Server, you must create the oraInst.loc file before starting. File creation is described in Section B.3, "Preinstallation".

Use non-interactive installation of Oracle Application Server when there are specific screens you want to observe during installation.

B.3 Preinstallation

Perform the following preinstallation steps:

Log in as the root user.
```
prompt> su
```
As root user, create the /var/opt/oracle directory, if it does not already exist.
```
# mkdir /var/opt/oracle
```
Create the /var/opt/oracle/oraInst.loc file. This file specifies the inventory directory that the installer will use.

Using a text editor such as vi or emacs, enter the following line in the file:
```
inventory_loc=oui_inventory_directory
```
Replace oui_inventory_directory with the full path to the directory where you want the installer to create the inventory directory. For example:
```
inventory_loc=/opt/oracle/oraInventory
```
Make sure that the oinstall operating system group has write permissions to this directory. For more information about the inventory directory and the group that owns it, see Section 2.7.1, "Create a Group for the Inventory Directory".
Create an empty /var/opt/oracle/oratab file.
```
# touch /var/opt/oracle/oratab
```
Exit from the root user.
```
# exit
```

B.4 Create the Response File

Before doing a silent or non-interactive 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.

This section includes the following topics:

Section B.4.1, "Creating Response Files from Templates"
Section B.4.2, "Creating Response Files by Using the Record Mode in the Installer"
Section B.4.3, "Example Response Files"

B.4.1 Creating Response Files from Templates

Templates for response files are available in the stage/Response directory on Disk 1 of the Oracle Application Server CD-ROM. Response file templates are available for the following installation types:

Table B-1 Response File Templates in the stage/Response Directory

Installation Type	Filename
Basic Installation	`oracle.as.j2ee.top.portalplusohs.rsp`
Advanced Installation: Oracle WebCenter Framework with Oracle HTTP Server	`oracle.as.j2ee.top.webcenterwithhttpServer.rsp`
Advanced Installation: Oracle Content Database	`oracle.as.j2ee.top.contentdatabase.rsp`
Advanced Installation: Oracle WebCenter Framework	`oracle.as.j2ee.top.webcenter.rsp`
Advanced Installation: Oracle HTTP Server	`oracle.as.j2ee.top.httpServer.rsp`

See the template files for descriptions of the parameters in the file.

Note:

For Boolean parameters, specify either "true" or "false".

B.4.2 Creating Response Files by Using the Record Mode in the Installer

You can run the 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 the installer in record mode:

Start up the installer with the -record and -destinationFile parameters.
```
prompt> /path/to/runInstaller -record -destinationFile newResponseFile
```
Replace newResponseFile with the full path to the response file that you want the installer to create. Example: /opt/oracle/myWebCenterResponse.rsp.
Enter your values in the installer screens. The installer will write these values to the file specified in the -destinationFile parameter.

When you click the Install button, the installer automatically writes all your values to the specified file. At this point, you can complete the installation on this computer, or you can exit without performing the installation.

Secure information, such as passwords, is not written to the file, so you must modify the response file before you can use it. To set the password, modify the sl_adminDialogReturn parameter. See the generated response file for a description of the parameter.

Note:

Response files created by record mode can only be used for non-interactive installations. You cannot use a response file created by record mode in a silent installation.

B.4.3 Example Response Files

The following sections shows example response files for the following Oracle Application Server installation types:

Section B.4.3.1, "Example Response File for Basic Installation"
Section B.4.3.2, "Example Response File for Advanced Installation of Oracle WebCenter Framework with Oracle HTTP Server"
Section B.4.3.3, "Example Response File for Advanced Installation of Oracle Content DB"
Section B.4.3.4, "Example Response File for Advanced Installation of Oracle WebCenter Framework"
Section B.4.3.5, "Example Response File for Advanced Installation of Oracle HTTP Server"

Note:

Be sure that you read the description of each parameter=value in the provided sample files, and edit value accordingly for your environment.

B.4.3.1 Example Response File for Basic Installation

The following shows an example of a response file for a silent installation of Oracle WebCenter Framework, Oracle Content DB, and Oracle HTTP Server as described in Chapter 4, "Basic Installation".

RESPONSEFILE_VERSION=2.2.1.0.0
UNIX_GROUP_NAME="install"
FROM_LOCATION=/mount_point/Disk1/stage/products.xml
FROM_LOCATION_CD_LABEL="LABEL1"
ORACLE_HOME="/local_location/oracle_home"
ORACLE_HOME_NAME="OHOME1"
SHOW_SPLASH_SCREEN=false
SHOW_WELCOME_PAGE=false
SHOW_INSTALL_PROGRESS_PAGE=false
SHOW_COMPONENT_LOCATIONS_PAGE=false
SHOW_CUSTOM_TREE_PAGE=false
SHOW_SUMMARY_PAGE=false
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=false
SHOW_IAS_COMPONENT_CONFIG_PAGE=false
ACCEPT_LICENSE_AGREEMENT=true
RESTART_SYSTEM=<Value Unspecified>
CLUSTER_NODES=<Value Unspecified>
 
OUI_HOSTNAME=myhost.mycompany.com
 
PreReqConfigSelections=""
n_ValidationPreReqConfigSelections=0
SELECTED_LANGUAGES={"en"}
 
TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.2.0"}
DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.2.0"}
INSTALL_TYPE="portalplusohs"
b_oneClick=true
s_asInstanceName="appserver"
s_adminName="oc4jadmin"
s_adminPassword="welcome1"
s_adminPasswordConfirm="welcome1"
b_useRemoteInstance=false
b_useLocalInstance=true
sl_adminDialogReturn={"appserver","welcome1","welcome1","YES"}
nValidationInstanceInfo=0
n_DlgClusterInfoWebValidate=0
n_DlgClusterInfoValidate=0
n_validateAdminDialogInfo=0
bMaskValidationAdminInfo=false
b_autoPortDetect=true
nValidationPortListSelect=0
sl_returnDBInfo={"dbhost.mycompany.com:1521", "welcome1", "orcl.mycompany.com"}
bMaskValidationDBValidationInfo=false
n_DBValidation=0
sl_returnSchema={"CONTENT", "CONTENT"}
n_SchemaValidation=0
bMaskSchemaValidationInfo=false
sl_returnUserRepo={"FILE_BASED","", "", "", "", "", "", "", ""}
bMaskUserRepoValidationInfo=false
n_UserRepoValidation=0
DEPENDENCY_LIST={"oracle.contentmt:10.1.3.2.0","oracle.askernel.common:10.1.3.0.0"}

B.4.3.2 Example Response File for Advanced Installation of Oracle WebCenter Framework with Oracle HTTP Server

The following shows an example of a response file for a silent installation of Oracle WebCenter Framework with Oracle HTTP Server as described in Section 5.2.2, "Installing Oracle WebCenter Framework with Oracle HTTP Server".

RESPONSEFILE_VERSION=2.2.1.0.0
UNIX_GROUP_NAME="install"
FROM_LOCATION="/mount_point/Disk1/stage/products.xml"
FROM_LOCATION_CD_LABEL="LABEL1"
ORACLE_HOME="/local_location/oracle_home"
ORACLE_HOME_NAME="OHOME1"
SHOW_SPLASH_SCREEN=false
SHOW_WELCOME_PAGE=false
SHOW_INSTALL_PROGRESS_PAGE=false
SHOW_COMPONENT_LOCATIONS_PAGE=false
SHOW_CUSTOM_TREE_PAGE=false
SHOW_SUMMARY_PAGE=false
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=false
SHOW_IAS_COMPONENT_CONFIG_PAGE=false
ACCEPT_LICENSE_AGREEMENT=true
RESTART_SYSTEM=<Value Unspecified>
CLUSTER_NODES=<Value Unspecified>
 
OUI_HOSTNAME=myhost.mycompany.com
 
PreReqConfigSelections=""
n_ValidationPreReqConfigSelections=0
SELECTED_LANGUAGES={"en"}
 
TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.2.0"}
DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.2.0"}
INSTALL_TYPE="portalplusohs"
b_oneClick=false
s_asInstanceName="appserver"
s_adminName="oc4jadmin"
s_adminPassword="welcome1"
s_adminPasswordConfirm="welcome1"
b_useRemoteInstance=false
b_useLocalInstance=true
sl_adminDialogReturn={"appserver","welcome1","welcome1","YES"}
nValidationInstanceInfo=0
n_DlgClusterInfoWebValidate=0
n_DlgClusterInfoValidate=0
n_validateAdminDialogInfo=0
bMaskValidationAdminInfo=false
szl_PortListSelect={"YES","/private/jdoe/mystaticports.ini"}
b_autoPortDetect=true
nValidationPortListSelect=0
DEPENDENCY_LIST={"oracle.iaspt:10.1.3.0.0","oracle.java.jdbc.datadirect:10.1.2.0.1","oracle.xds:10.1.3.0.0","oracle.as.welcomepages:10.1.3.0.0","oracle.askernel.common:10.1.3.0.0","oracle.iappserver.iappcore:10.1.3.0.0","oracle.options.ano.fullssl:10.1.0.2.0","oracle.apache:10.1.3.0.0"}

B.4.3.3 Example Response File for Advanced Installation of Oracle Content DB

The following shows an example of a response file for a silent installation of Oracle Content DB as described in Section 5.2.3, "Installing Oracle Content Database".

RESPONSEFILE_VERSION=2.2.1.0.0
UNIX_GROUP_NAME="install"
FROM_LOCATION="/mount_point/Disk1/stage/products.xml"
FROM_LOCATION_CD_LABEL="LABEL1"
ORACLE_HOME="/local_location/oracle_home"
ORACLE_HOME_NAME="OHOME1"
SHOW_SPLASH_SCREEN=false
SHOW_WELCOME_PAGE=false
SHOW_INSTALL_PROGRESS_PAGE=false
SHOW_COMPONENT_LOCATIONS_PAGE=false
SHOW_CUSTOM_TREE_PAGE=false
SHOW_SUMMARY_PAGE=false
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=false
SHOW_IAS_COMPONENT_CONFIG_PAGE=false
ACCEPT_LICENSE_AGREEMENT=true
RESTART_SYSTEM=<Value Unspecified>
CLUSTER_NODES=<Value Unspecified>

OUI_HOSTNAME=myhost.mycompany.com

PreReqConfigSelections=""
n_ValidationPreReqConfigSelections=0
SELECTED_LANGUAGES={"en"}
 
TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.2.0"}
DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.2.0"}
INSTALL_TYPE="contentdatabase"
b_oneClick=false
s_asInstanceName="appserver"
s_adminName="oc4jadmin"
s_adminPassword="welcome1"
s_adminPasswordConfirm="welcome1"
b_useRemoteInstance=false
b_useLocalInstance=true
sl_adminDialogReturn={"appserver","welcome1","welcome1","YES"}
nValidationInstanceInfo=0
n_DlgClusterInfoWebValidate=0
n_DlgClusterInfoValidate=0
n_validateAdminDialogInfo=0
bMaskValidationAdminInfo=false
szl_PortListSelect={"YES","/private/jdoe/mystaticports.ini"}
b_autoPortDetect=true
nValidationPortListSelect=0
sl_returnDBInfo={"dbhost.mycompany.com:10130", "welcome1", "orcl.mycompany.com"}
bMaskValidationDBValidationInfo=false
n_DBValidation=0
sl_returnSchema={"CONTENT", "CONTENT"}
n_SchemaValidation=0
bMaskSchemaValidationInfo=false
sl_returnUserRepo={"FILE_BASED","", "", "", "", "", "", "", ""}
bMaskUserRepoValidationInfo=false
n_UserRepoValidation=0
DEPENDENCY_LIST={"oracle.iaspt:10.1.3.0.0","oracle.java.jdbc.datadirect:10.1.2.0.1","oracle.xds:10.1.3.0.0","oracle.as.welcomepages:10.1.3.0.0","oracle.askernel.common:10.1.3.0.0","oracle.iappserver.iappcore:10.1.3.0.0","oracle.options.ano.fullssl:10.1.0.2.0","oracle.apache:10.1.3.0.0"}

B.4.3.4 Example Response File for Advanced Installation of Oracle WebCenter Framework

The following shows an example of a response file for a silent installation of Oracle WebCenter Framework as described in Section 5.2.4, "Installing Oracle WebCenter Framework".

RESPONSEFILE_VERSION=2.2.1.0.0
UNIX_GROUP_NAME="install"
FROM_LOCATION="/mount_point/Disk1/stage/products.xml"
FROM_LOCATION_CD_LABEL="LABEL1"
ORACLE_HOME="/local_location/oracle_home"
ORACLE_HOME_NAME="OHOME1"
SHOW_SPLASH_SCREEN=false
SHOW_WELCOME_PAGE=false
SHOW_INSTALL_PROGRESS_PAGE=false
SHOW_COMPONENT_LOCATIONS_PAGE=false
SHOW_CUSTOM_TREE_PAGE=false
SHOW_SUMMARY_PAGE=false
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=false
ACCEPT_LICENSE_AGREEMENT=true
SHOW_IAS_COMPONENT_CONFIG_PAGE=false

OUI_HOSTNAME=myhost.mycompany.com

TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.2.0"}
DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.2.0"}
PreReqConfigSelections=""
n_ValidationPreReqConfigSelections=0
INSTALL_TYPE="portal"
SELECTED_LANGUAGES={"en"}

s_asInstanceName="appserver"
s_adminPassword="welcome1"
s_adminPasswordConfirm="welcome1"
s_adminName="oc4jadmin"
b_useRemoteInstance=false
b_useLocalInstance=true
b_autoPortDetect=true
nValidationInstanceInfo=0
n_DlgClusterInfoWebValidate=0
nValidationPortListSelect=0
n_DlgClusterInfoValidate=0
n_validateAdminDialogInfo=0
sl_adminDialogReturn={"appserver","welcome1" , "welcome1" , "YES"}
bMaskValidationAdminInfo=false
b_oneClick=false
DEPENDENCY_LIST={"oracle.iaspt:10.1.3.0.0","oracle.java.jdbc.datadirect:10.1.2.0.1","oracle.xds:10.1.3.0.0","oracle.as.welcomepages:10.1.3.0.0","oracle.askernel.common:10.1.3.0.0","oracle.iappserver.iappcore:10.1.3.0.0","oracle.options.ano.fullssl:10.1.0.2.0","oracle.apache:10.1.3.0.0"}

B.4.3.5 Example Response File for Advanced Installation of Oracle HTTP Server

The following shows an example of a response file for a silent installation of Oracle WebCenter Framework as described in Section 5.2.4, "Installing Oracle WebCenter Framework".

RESPONSEFILE_VERSION=2.2.1.0.0
UNIX_GROUP_NAME="install"
FROM_LOCATION="/mount_point/Disk1/stage/products.xml"
FROM_LOCATION_CD_LABEL="LABEL1"
ORACLE_HOME="/local_location/oracle_home"
ORACLE_HOME_NAME="OHOME1"
SHOW_SPLASH_SCREEN=false
SHOW_WELCOME_PAGE=false
SHOW_INSTALL_PROGRESS_PAGE=false
SHOW_COMPONENT_LOCATIONS_PAGE=false
SHOW_CUSTOM_TREE_PAGE=false
SHOW_SUMMARY_PAGE=false
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=false
ACCEPT_LICENSE_AGREEMENT=true
SHOW_IAS_COMPONENT_CONFIG_PAGE=false

OUI_HOSTNAME=myhost.mycompany.com

TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.2.0"}
DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.2.0"}
PreReqConfigSelections=""
n_ValidationPreReqConfigSelections=0
INSTALL_TYPE="httpServer"
SELECTED_LANGUAGES={"en"}
s_asInstanceName="appserver"
s_adminPassword="welcome1"
s_adminPasswordConfirm="welcome1"
s_adminName="oc4jadmin"
b_useRemoteInstance=false
b_useLocalInstance=true
b_autoPortDetect=true
nValidationInstanceInfo=0
n_DlgClusterInfoWebValidate=0
nValidationPortListSelect=0
n_DlgClusterInfoValidate=0
n_validateAdminDialogInfo=0
sl_adminDialogReturn={"appserver","welcome1" , "welcome1" , "YES"}
bMaskValidationAdminInfo=false
b_oneClick=false
DEPENDENCY_LIST={"oracle.iaspt:10.1.3.0.0","oracle.java.jdbc.datadirect:10.1.2.0.1","oracle.xds:10.1.3.0.0","oracle.as.welcomepages:10.1.3.0.0","oracle.askernel.common:10.1.3.0.0","oracle.iappserver.iappcore:10.1.3.0.0","oracle.options.ano.fullssl:10.1.0.2.0","oracle.apache:10.1.3.0.0"}

B.5 Start the Installation

To make the installer use the response file, specify the location of the response file that you want to use as a parameter when starting the installer.

To perform a non-interactive installation:

prompt> setenv DISPLAY hostname:0.0
prompt> runInstaller -responseFile absolute_path_and_filename

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

prompt> runInstaller -silent -responseFile absolute_path_and_filename

B.6 Postinstallation

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

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

The installation of OracleAS <Installation Type> was successful.

The installActions<time_stamp>.log file contains specific information for each Oracle Application Server installation type.

B.7 Security Tips for Silent and Non-Interactive Installations

One of the pieces of information in the response file is the installation password. The password information is in clear text.

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 non-interactive installation.
If possible, remove the response files from the system after the silent or non-interactive installation is completed.

B.8 Deinstallation

You can perform a silent deinstallation of Oracle Application Server by supplying a silent deinstallation parameter to the response file you used for installation.

Modify the following parameter in your installation response file:

REMOVE_HOMES={"<ORACLE_HOME to be removed>"}

For example:

REMOVE_HOME="/local_location/oracle_home"

Note:

You still need to follow the clean up steps described in Appendix D, "Deinstallation and Reinstallation". The silent deinstallation command only replaces the step where you run the installer interactively to deinstall the instance.

To perform a silent deinstallation, use the -deinstall parameter when entering the command:

prompt> runInstaller -silent -deinstall -responseFile absolute_path_and_filename