Skip Headers

Oracle® Application Server Installation Guide 10g Release 3 (10.1.3) for Linux x86 B25217-01 |
| Home | Contents | Index

Previous | Next |

# A Silent and Non-Interactive Installation

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

- Section A.1, "Silent Installation"

- Section A.2, "Non-Interactive Installation"

- Section A.3, "Preinstallation"

- Section A.4, "Create the Response File"

- Section A.5, "Start the Installation"

- Section A.6, "Postinstallation"

- Section A.7, "Security Tips for Silent and Non-Interactive Installations"

- Section A.8, "Deinstallation"

## A.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 A.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.

## A.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 A.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 non-interactive installation of Oracle Application Server when there are specific screens you want to observe during installation.

## A.3 Preinstallation

1. Log in as the root user.

       prompt> su

2. As root user, create the `/var/opt/oracle` directory, if it does not already exist.

       # mkdir /var/opt/oracle

3. 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.6.1, "Create a Group for the Inventory Directory".

4. Create an empty `/var/opt/oracle/oratab` file.

       # touch /var/opt/oracle/oratab

5. Exit from the root user.

       # exit

## A.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.

### A.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 A-1 Response File Templates in the stage/Response Directory

Installation Type | Filename
--- | ---
Integrated Web Server, J2EE Server and Process Management | `oracle.as.j2ee.top.allProducts.rsp`
J2EE Server and Process Management | `oracle.as.j2ee.top.core.rsp`
Web Server and Process Management | `oracle.as.j2ee.top.httpServer.rsp`
Oracle TopLink | `oracle.as.j2ee.top.toplink.rsp`

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

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

### A.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:

1. 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/myJ2EEResponse.rsp`.

2. 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.

### A.4.3 Variables to Modify in the Response Files

For all installation types, modify the following variables:

    UNIX_GROUP_NAME
    FROM_LOCATION
    ORACLE_HOME

For the J2EE Server and Process Management install type, modify the following variables:

    szl_PortListSelect
    sl_DlgClusterInfoReturn
    sl_AdminInstanceSettingsSelections
    b_autoPortDetect
    sl_adminDialogReturn

For the Web Server and Process Management install type, modify the following variables:

    szl_PortListSelect
    szl_InstanceInformation
    sl_DlgClusterInfoWebReturn
    b_autoPortDetect

For the Integrated Web Server, J2EE Server and Process Management install type, modify the following variables:

    szl_PortListSelect
    sl_DlgClusterInfoWebReturn
    sl_AdminInstanceSettingsSelections
    b_autoPortDetect
    sl_adminDialogReturn

### A.4.4 Example Response Files

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

- Section A.4.4.1, "Example Response File for Standalone J2EE Server and Process Management"

- Section A.4.4.2, "Example Response File for Web Server and Process Management"

- Section A.4.4.3, "Example Response File for Integrated Web Server, J2EE Server and Process Management"

- Section A.4.4.4, "Example Response File for Oracle TopLink"

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

#### A.4.4.1 Example Response File for Standalone J2EE Server and Process Management

The following shows an example of a response file for a silent installation of standalone instance of J2EE Server and Process Management as described in Section 5.2.2, "Installing J2EE Server and Process Management".

    RESPONSEFILE_VERSION=2.2.1.0.0
    UNIX_GROUP_NAME="install"
    FROM_LOCATION="/mount_point/Disk1/stage/products.xml"
    FROM_LOCATION_CD_LABEL="LABEL1"
    NEXT_SESSION_RESPONSE=<Value Unspecified>
    ORACLE_HOME="/local_location/oracle_home"
    ORACLE_HOME_NAME="OHOME1"
    TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.0.0"}
    DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.0.0"}
    SHOW_SPLASH_SCREEN=true
    SHOW_WELCOME_PAGE=false
    SHOW_COMPONENT_LOCATIONS_PAGE=false
    SHOW_CUSTOM_TREE_PAGE=false
    SHOW_SUMMARY_PAGE=true
    SHOW_INSTALL_PROGRESS_PAGE=true
    SHOW_REQUIRED_CONFIG_TOOL_PAGE=true
    SHOW_CONFIG_TOOL_PAGE=true
    SHOW_XML_PREREQ_PAGE=true
    SHOW_RELEASE_NOTES=true
    SHOW_END_OF_INSTALL_MSGS=true
    SHOW_ROOTSH_CONFIRMATION=true
    SHOW_END_SESSION_PAGE=true
    SHOW_EXIT_CONFIRMATION=true
    NEXT_SESSION=true
    NEXT_SESSION_ON_FAIL=true
    SHOW_DEINSTALL_CONFIRMATION=true
    SHOW_DEINSTALL_PROGRESS=true
    ACCEPT_LICENSE_AGREEMENT=true
    RESTART_SYSTEM=<Value Unspecified>
    CLUSTER_NODES=<Value Unspecified>
    OUI_HOSTNAME=<Value Unspecified>
    REMOVE_HOMES=<Value Unspecified>
    COMPONENT_LANGUAGES={"en"}
    INSTALL_TYPE="core"
    szl_PortListSelect={"YES","/private/jdoe/mystaticports.ini"}
    szl_InstanceInformation=<Value Unspecified>
    sl_DlgClusterInfoWebReturn=<Value Unspecified>
    sl_DlgClusterInfoReturn={"YES","NO","225.0.0.20","8001"}
    sl_AdminInstanceSettingsSelections={"true"}
    s_asInstanceName=<Value Unspecified>
    s_adminPassword=<Value Unspecified>
    b_useLocalInstance=<Value Unspecified>
    b_autoPortDetect=false
    sl_adminDialogReturn={"appserver","oc4jadmin","welcome1","welcome1","OHOME1",""}
    nValidationInstanceInfo=<Value Unspecified>
    n_DlgClusterInfoWebValidate=<Value Unspecified>
    nValidationPortListSelect=<Value Unspecified>
    n_DlgClusterInfoValidate=<Value Unspecified>
    n_validateAdminDialogInfo=<Value Unspecified>

#### A.4.4.2 Example Response File for Web Server and Process Management

The following shows an example of a response file for a silent installation of Web Server and Process Management as described in Section 5.2.3, "Installing Web Server and Process Management".

    RESPONSEFILE_VERSION=2.2.1.0.0
    UNIX_GROUP_NAME="install"
    FROM_LOCATION="/mount_point/Disk1/stage/products.xml"
    FROM_LOCATION_CD_LABEL="LABEL1"
    NEXT_SESSION_RESPONSE=<Value Unspecified>
    ORACLE_HOME="/local_location/oracle_home"
    ORACLE_HOME_NAME="OHOME1"
    TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.0.0"}
    DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.0.0"}
    SHOW_SPLASH_SCREEN=true
    SHOW_WELCOME_PAGE=false
    SHOW_COMPONENT_LOCATIONS_PAGE=false
    SHOW_CUSTOM_TREE_PAGE=false
    SHOW_SUMMARY_PAGE=true
    SHOW_INSTALL_PROGRESS_PAGE=true
    SHOW_REQUIRED_CONFIG_TOOL_PAGE=true
    SHOW_CONFIG_TOOL_PAGE=true
    SHOW_XML_PREREQ_PAGE=true
    SHOW_RELEASE_NOTES=true
    SHOW_END_OF_INSTALL_MSGS=true
    SHOW_ROOTSH_CONFIRMATION=true
    SHOW_END_SESSION_PAGE=true
    SHOW_EXIT_CONFIRMATION=true
    NEXT_SESSION=true
    NEXT_SESSION_ON_FAIL=true
    SHOW_DEINSTALL_CONFIRMATION=true
    SHOW_DEINSTALL_PROGRESS=true
    ACCEPT_LICENSE_AGREEMENT=true
    RESTART_SYSTEM=<Value Unspecified>
    CLUSTER_NODES=<Value Unspecified>
    OUI_HOSTNAME=<Value Unspecified>
    REMOVE_HOMES=<Value Unspecified>
    COMPONENT_LANGUAGES={"en"}
    INSTALL_TYPE="httpServer"
    szl_PortListSelect={"YES","/private/jdoe/mystaticports.ini"}
    szl_InstanceInformation={"appserver"}
    sl_DlgClusterInfoWebReturn={"NO","",""}
    sl_DlgClusterInfoReturn=<Value Unspecified>
    sl_AdminInstanceSettingsSelections=<Value Unspecified>
    s_asInstanceName=<Value Unspecified>
    s_adminPassword=<Value Unspecified>
    b_useLocalInstance=<Value Unspecified>
    b_autoPortDetect=false
    sl_adminDialogReturn=<Value Unspecified>
    nValidationInstanceInfo=<Value Unspecified>
    n_DlgClusterInfoWebValidate=<Value Unspecified>
    nValidationPortListSelect=<Value Unspecified>
    n_DlgClusterInfoValidate=<Value Unspecified>
    n_validateAdminDialogInfo=<Value Unspecified>
    s_group=<Value Unspecified>
    OPTIONAL_CONFIG_TOOLS=<Value Unspecified>

#### A.4.4.3 Example Response File for Integrated Web Server, J2EE Server and Process Management

The following shows an example of a response file for a silent installation of Integrated Web Server, J2EE Server and Process Management as described in Section 5.2.4, "Installing Integrated Web Server, J2EE Server and Process Management".

    RESPONSEFILE_VERSION=2.2.1.0.0
    UNIX_GROUP_NAME="install"
    FROM_LOCATION="/mount_point/Disk1/stage/products.xml"
    FROM_LOCATION_CD_LABEL="LABEL1"
    NEXT_SESSION_RESPONSE=<Value Unspecified>
    ORACLE_HOME="/local_location/oracle_home"
    ORACLE_HOME_NAME="OHOME1"
    TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.0.0"}
    DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.0.0"}
    SHOW_SPLASH_SCREEN=true
    SHOW_WELCOME_PAGE=false
    SHOW_COMPONENT_LOCATIONS_PAGE=false
    SHOW_CUSTOM_TREE_PAGE=false
    SHOW_SUMMARY_PAGE=true
    SHOW_INSTALL_PROGRESS_PAGE=true
    SHOW_REQUIRED_CONFIG_TOOL_PAGE=true
    SHOW_CONFIG_TOOL_PAGE=true
    SHOW_XML_PREREQ_PAGE=true
    SHOW_RELEASE_NOTES=true
    SHOW_END_OF_INSTALL_MSGS=true
    SHOW_ROOTSH_CONFIRMATION=true
    SHOW_END_SESSION_PAGE=true
    SHOW_EXIT_CONFIRMATION=true
    NEXT_SESSION=true
    NEXT_SESSION_ON_FAIL=true
    SHOW_DEINSTALL_CONFIRMATION=true
    SHOW_DEINSTALL_PROGRESS=true
    ACCEPT_LICENSE_AGREEMENT=true
    RESTART_SYSTEM=<Value Unspecified>
    CLUSTER_NODES=<Value Unspecified>
    OUI_HOSTNAME=<Value Unspecified>
    REMOVE_HOMES=<Value Unspecified>
    COMPONENT_LANGUAGES={"en"}
    INSTALL_TYPE="allProducts"
    szl_PortListSelect={"YES","/private/jdoe/mystaticports.ini"}
    szl_InstanceInformation=<Value Unspecified>
    sl_DlgClusterInfoWebReturn={"YES","225.0.0.20","8001"}
    sl_DlgClusterInfoReturn=<Value Unspecified>
    sl_AdminInstanceSettingsSelections={"false"}
    s_asInstanceName=<Value Unspecified>
    s_adminPassword=<Value Unspecified>
    b_useLocalInstance=<Value Unspecified>
    b_autoPortDetect=false
    sl_adminDialogReturn={"appserver","oc4jadmin","welcome1","welcome1","OHOME1",""}
    nValidationInstanceInfo=<Value Unspecified>
    n_DlgClusterInfoWebValidate=<Value Unspecified>
    nValidationPortListSelect=<Value Unspecified>
    n_DlgClusterInfoValidate=<Value Unspecified>
    n_validateAdminDialogInfo=<Value Unspecified>
    s_group=<Value Unspecified>
    OPTIONAL_CONFIG_TOOLS=<Value Unspecified>

#### A.4.4.4 Example Response File for Oracle TopLink

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

    RESPONSEFILE_VERSION=2.2.1.0.0
    UNIX_GROUP_NAME="install"
    FROM_LOCATION="/mount_point/Disk1/stage/products.xml"
    FROM_LOCATION_CD_LABEL="LABEL1"
    NEXT_SESSION_RESPONSE=<Value Unspecified>
    ORACLE_HOME="/local_location/oracle_home"
    ORACLE_HOME_NAME="OHOME1"
    TOPLEVEL_COMPONENT={"oracle.as.j2ee.top","10.1.3.0.0"}
    DEINSTALL_LIST={"oracle.as.j2ee.top","10.1.3.0.0"}
    SHOW_SPLASH_SCREEN=true
    SHOW_WELCOME_PAGE=false
    SHOW_COMPONENT_LOCATIONS_PAGE=false
    SHOW_CUSTOM_TREE_PAGE=false
    SHOW_SUMMARY_PAGE=true
    SHOW_INSTALL_PROGRESS_PAGE=true
    SHOW_REQUIRED_CONFIG_TOOL_PAGE=true
    SHOW_CONFIG_TOOL_PAGE=true
    SHOW_XML_PREREQ_PAGE=true
    SHOW_RELEASE_NOTES=true
    SHOW_END_OF_INSTALL_MSGS=true
    SHOW_ROOTSH_CONFIRMATION=true
    SHOW_END_SESSION_PAGE=true
    SHOW_EXIT_CONFIRMATION=true
    NEXT_SESSION=true
    NEXT_SESSION_ON_FAIL=true
    SHOW_DEINSTALL_CONFIRMATION=true
    SHOW_DEINSTALL_PROGRESS=true
    ACCEPT_LICENSE_AGREEMENT=true
    RESTART_SYSTEM=<Value Unspecified>
    CLUSTER_NODES=<Value Unspecified>
    OUI_HOSTNAME=<Value Unspecified>
    REMOVE_HOMES=<Value Unspecified>
    COMPONENT_LANGUAGES={"en"}
    INSTALL_TYPE="toplink"
    szl_PortListSelect=<Value Unspecified>
    szl_InstanceInformation=<Value Unspecified>
    sl_DlgClusterInfoWebReturn=<Value Unspecified>
    sl_DlgClusterInfoReturn=<Value Unspecified>
    sl_AdminInstanceSettingsSelections=<Value Unspecified>
    s_asInstanceName=<Value Unspecified>
    s_adminPassword=<Value Unspecified>
    b_useLocalInstance=<Value Unspecified>
    b_autoPortDetect=<Value Unspecified>
    sl_adminDialogReturn=<Value Unspecified>
    nValidationInstanceInfo=<Value Unspecified>
    n_DlgClusterInfoWebValidate=<Value Unspecified>
    nValidationPortListSelect=<Value Unspecified>
    n_DlgClusterInfoValidate=<Value Unspecified>
    n_validateAdminDialogInfo=<Value Unspecified>

## A.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

## A.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.

See Also: Appendix D, "Configuration Assistants"

## A.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.

## A.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 C, "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