Skip Headers
Oracle® Web Services Manager Installation Guide
10g (10.1.3.1.0)

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

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

A Silent and Non-Interactive Installation

This appendix describes how to install Oracle Web Services Manager in silent mode. This appendix contains the following topics:

A.1 Silent Installation

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

Silent installation of Oracle WSM 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.

Use silent installation of Oracle Web Services Manager when there are similar installations on more than one computer. Additionally, use silent install when performing the Oracle WSM 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 Web Services Manager installation. In non-interactive installations, there is graphical output and users may enter input.

Non-interactive installation of Oracle Web Services Manager 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.

A.3 Preinstallation

If you have not installed Oracle Application Server on your computer, then you need to perform the following tasks:

On Windows

Create the following Registry key and value:

The Inventory_Directory is the full path to your installer files. For example:

C:\Program Files\Oracle\Inventory

On Linux

Create theoraInst.loc file before starting.

  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 install user has write permissions to this 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 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.

    On Windows:

    E:\> setup.exe -record -destinationFile newResponseFile
    
    

    On Linux:

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

    Replace newResponseFile with the full path to the response file that you want the installer to create. For example:

    Windows: C:\myWSMResponse.rsp

    Linux: /opt/oracle/myWSMResponse.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.2 Variables to Modify in the Response Files

For all installations, modify at least the following variables:

UNIX_GROUP_NAME
FROM_LOCATION
ORACLE_HOME

A.4.3 Example Response File

The following shows an example of a response file for a silent installation of Oracle Web Services Manager.


Note:

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

####################################################################
## Copyright (c) 1999, 2006 Oracle. All rights reserved.          ##
##                                                                ##
## Specify values for the variables listed below to customize     ##
## your installation.                                             ##
##                                                                ##
## Each variable is associated with a comment. The comment        ##
## identifies the variable type.                                  ##
##                                                                ##
## Please specify the values in the following format:             ##
##                                                                ##
##         Type         Example                                   ##
##         String       "Sample Value"                            ##
##         Boolean      True or False                             ##
##         Number       1000                                      ##
##         StringList   {"String value 1","String Value 2"}       ##
##                                                                ##
## The values that are given as <Value Required> need to be       ##
## specified for a silent installation to be successful.          ##
##                                                                ##
## This response file is generated by Oracle Software             ##
## Packager.                                                      ##
####################################################################
 
RESPONSEFILE_VERSION=2.2.1.0.0
 
#-------------------------------------------------------------------------------
#Product Specific Values
#Please ensure the values are proper, as these are not validated, these are used
# as is
#-------------------------------------------------------------------------------
#-------------------------------------------------------------------------------
# Default locale to be used for OWSM
# Can be one of       "en","pt_br","fr","de","it","ja","ko","zh_cn","es","zh_tw"
#-------------------------------------------------------------------------------
sDefaultLocale="en"
#-------------------------------------------------------------------------------
# App Server type,
# This is "oracle-as" for UNix
#-------------------------------------------------------------------------------
sAppServer="oracle-as"
#-------------------------------------------------------------------------------
# Version of App Server is 10.1.3 ( can be 10.1.3.1 )
#-------------------------------------------------------------------------------
sAppServerVersion="10.1.3"
#-------------------------------------------------------------------------------
# This variable indicates if a bundled OC4J is used
# If Installing on an existing OC4J home, set this value to false
#-------------------------------------------------------------------------------
bBundledOC4J=true
#-------------------------------------------------------------------------------
# This variable indicates if a bundled OC4J is used
# If Installing on an existing OC4J home, set this value to false
#-------------------------------------------------------------------------------
bDeveloperOC4J=true
#-------------------------------------------------------------------------------
# Host Name for Application Server
#-------------------------------------------------------------------------------
sASHostName=""
#-------------------------------------------------------------------------------
# Application server port
#-------------------------------------------------------------------------------
sASPort="3115"
#-------------------------------------------------------------------------------
# OC4J Admin ID
#-------------------------------------------------------------------------------
sASAdminID="oc4jadmin"
#-------------------------------------------------------------------------------
% OC4J Admin Password, in clear text
#-------------------------------------------------------------------------------
sASAdminPswd=""
#-------------------------------------------------------------------------------
# Application server Instance Name
#-------------------------------------------------------------------------------
sASInstance="home"
#-------------------------------------------------------------------------------
# Database type, current supporting only Oracle, for Unix
#-------------------------------------------------------------------------------
sDBType="Oracle"
#-------------------------------------------------------------------------------
# DB Driver type, thin/thick
#-------------------------------------------------------------------------------
sDBDriverType="thin"
#-------------------------------------------------------------------------------
# Database Host Connect String in the format: <host1>:<port1>[^<host2>:<port2>[...]]
#-------------------------------------------------------------------------------
sDBHost=""
#-------------------------------------------------------------------------------
# Database Name
#-------------------------------------------------------------------------------
sDBName=""
#-------------------------------------------------------------------------------
# Database User name
#-------------------------------------------------------------------------------
sDBUser="system"
#-------------------------------------------------------------------------------
# Database Password
#-------------------------------------------------------------------------------
sDBPswd=""
#-------------------------------------------------------------------------------
#Name       : UNIX_GROUP_NAME
#Datatype   : String
#Description: Unix group to be set for the inventory directory. Valid only in Unix platforms.
#Example: UNIX_GROUP_NAME = "install"
#-------------------------------------------------------------------------------
UNIX_GROUP_NAME="g900"
#-------------------------------------------------------------------------------
#Name       : FROM_LOCATION
#Datatype   : String
#Description: Complete path to the products.xml.
#Example: FROM_LOCATION = "../stage/products.xml"
#-------------------------------------------------------------------------------
FROM_LOCATION="../stage/products.xml"
#-------------------------------------------------------------------------------
#Name       : FROM_LOCATION_CD_LABEL
#Datatype   : String
#Description: This variable should only be used in multi-CD installations. It includes the label of the compact disk where the file "products.xml" exists. The label can be found in the file "disk.label" in the same directory as products.xml.
#Example: FROM_LOCATION_CD_LABEL = "CD Label"
#-------------------------------------------------------------------------------
FROM_LOCATION_CD_LABEL=<Value Unspecified>
#-------------------------------------------------------------------------------
#Name       : ORACLE_HOME
#Datatype   : String
#Description: Complete path of the Oracle Home.
#Example: ORACLE_HOME = "C:\OHOME1"
#-------------------------------------------------------------------------------
ORACLE_HOME=<Value Unspecified>
#-------------------------------------------------------------------------------
#Name       : ORACLE_HOME_NAME
#Datatype   : String
#Description: Oracle Home Name. Used in creating folders and services.
#Example: ORACLE_HOME_NAME = "OHOME1"
#-------------------------------------------------------------------------------
ORACLE_HOME_NAME=<Value Unspecified>
#-------------------------------------------------------------------------------
#Name       : TOPLEVEL_COMPONENT
#Datatype   : StringList
#Description: The top level component to be installed in the current session.
#Example: TOPLEVEL_COMPONENT = {"oracle.owsm.core","10.1.3.1.0"}
#-------------------------------------------------------------------------------
TOPLEVEL_COMPONENT={"oracle.owsm.core","10.1.3.1.0"}
#-------------------------------------------------------------------------------
#Name       : DEINSTALL_LIST
#Datatype   : StringList
#Description: List of components to be deinstalled during a deinstall session.
#Example: DEINSTALL_LIST = {"oracle.owsm.core","10.1.3.1.0"}
#-------------------------------------------------------------------------------
DEINSTALL_LIST={"oracle.owsm.core","10.1.3.1.0"}
#-------------------------------------------------------------------------------
#Name       : SELECTED_LANGUAGES
#Datatype   : StringList
#Description: Languages in which the components will be installed.
#Component  : oracle.owsm.core
#-------------------------------------------------------------------------------
SELECTED_LANGUAGES={"en"}
#-------------------------------------------------------------------------------
#Name       : INSTALL_TYPE
#Datatype   : String
#Description: Installation type of the component.
#Component  : oracle.owsm.core
#-------------------------------------------------------------------------------
INSTALL_TYPE="Custom"
#-------------------------------------------------------------------------------
#Name       : DEPENDENCY_LIST
#Datatype   : StringList
#Description: List of dependees that need to be installed along with this product.
#Component  : oracle.owsm.core
# For installing into an existing home please have the dependency list as
# DEPENDENCY_LIST={"oracle.owsm.supportfiles:10.1.3.1.0","oracle.jdk:1.5.0.0.5"}
#-------------------------------------------------------------------------------
DEPENDENCY_LIST={"oracle.owsm.supportfiles:10.1.3.1.0","oracle.jdk:1.5.0.0.5","oracle.oc4j_extended:10.1.3.1.0"}
#-------------------------------------------------------------------------------
#Name       : sl_HTTPProxyInfoConfig
#Datatype   : StringList
#Description: HTTP Proxy Config.
#Component  : oracle.owsm.core
#-------------------------------------------------------------------------------
sl_HTTPProxyInfoConfig={"","",""}
#-------------------------------------------------------------------------------
#Name       : nValidationHTTPProxyInfoConfig
#Datatype   : Number
#Description: Validation of Connect Information.
#Component  : oracle.owsm.core
#-------------------------------------------------------------------------------
nValidationHTTPProxyInfoConfig=0
#-------------------------------------------------------------------------------
#Name       : nValidationASInfo
#Datatype   : Number
#Description: Validation of AS Info, This is ignored if the value is 0. 
#Component  : oracle.owsm.core
#-------------------------------------------------------------------------------
nValidationASInfo=0
#-------------------------------------------------------------------------------
#Name       : nValidationDBInfo
#Datatype   : Number
#Description: Validation of Database Information. This is ignored if the Value is 0
#Component  : oracle.owsm.core
#-------------------------------------------------------------------------------
nValidationDBInfo=0

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:

On Windows

E:\> setup.exe -responseFile absolute_path_and_filename

On Linux

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

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

On Windows

E:\> setup.exe -silent -responseFile absolute_path_and_filename

On Linux

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 installActionstime_stamp.log file. Additionally, the silent installation creates the silentInstalltime_stamp.log file.

On Windows

The log files are created in the C:\Program Files\Oracle\Inventory\Logs directory.

On Linux

The log files are created in the oraInventory/logs directory.

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

The installation of OracleAS <Installation Type> was successful.

The installActionstime_stamp.log file contains specific information for each Oracle Application Server installation type.

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:

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:

On Windows

REMOVE_HOME="C:\oracle\ora_j2ee"

On Linux

REMOVE_HOME="/local_location/oracle_home"

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

On Windows

E:\> setup.exe -silent -deinstall -responseFile absolute_path_and_filename

On Linux

prompt> runInstaller -silent -deinstall -responseFile absolute_path_and_filename