C Silent Installation and Deinstallation for Oracle Forms and Reports

This appendix describes how to install and deinstall Oracle Forms and Reports from the command line in silent mode. This appendix contains the following topics:

C.1 Understanding Silent Installation and Deinstallation

You can use the Oracle Universal Installer's silent installation mode to bypass the graphical user interface and supply the necessary information in a response file. This method is most useful when installing the same product multiple times on multiple hosts. By using a response file, you can automate the installation of a product for which you know the installation parameters.

For information about silent installation and deinstallation and response files, refer to "Silent Oracle Fusion Middleware Installation and Deinstallation" in the Oracle Fusion Middleware Installation Planning Guide.

C.2 Using Oracle Forms and Reports Response Files

Before doing a silent installation, you must provide information specific to your installation in a response file. A response file is a specification file containing information you normally fetch through the Oracle Universal Installer user interface during an interactive installation session. Each answer is stored as a value for a variable identified in the response file. For example, values for Oracle home or installation type can be set automatically within the response file. Response files are text files that you can create or edit in any text editor.

The installer will fail if you attempt an installation using a response file that is not configured correctly. Oracle recommends creating your response file by first 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.

Response file templates for Oracle Forms and Reports are provided in the Disk1/stage/Response (on UNIX operating systems) or Disk1\stage\Response (on Windows operating systems) directory where you unpacked the archive file in Section 2.1.5, "Obtaining the Oracle Fusion Middleware Software".

C.2.1 Using the Installation Response Files for Oracle Forms and Reports

Table C-1 lists the installation response file templates provided for Oracle Forms and Reports.

Table C-1 Oracle Forms and Reports Installation and Configuration Response File Templates

Template Description

configure_only.rsp

Use this response file template if you have already installed the software on your system, and now need to configure the components and create or extend a domain or expand a cluster.

The equivalent using the GUI would be to run the configuration tool as described in Section 2.4.6, "Running the Configuration Tool for Oracle Forms and Reports".

See Section C.2.1.1, "Using the configure_only.rsp Response File Template" for more information.

install_only.rsp

Use this response file template to install but not configure the software on your system. After doing so, you should run a silent configuration using the configure_only.rsp template to configure the components.

The equivalent using the GUI would be selecting Install Software - Do Not Configure option on the Installation Type screen.

See Section C.2.1.2, "Using the install_only.rsp Response File Template" for more information.

install_and_configure.rsp

Use this response file template to install and configure the software on your system.

The equivalent using the GUI would be selecting Install and Configure option on the Installation Type.

See Section C.2.1.3, "Using the install_and_configure.rsp Response File Template" for more information.


C.2.1.1 Using the configure_only.rsp Response File Template

Table C-2 describes the parameters found in the configure_only.rsp response file template. The parameters are listed in the order in which they appear in the response file; note that they do not necessarily follow the order of the installation screens as seen in graphical mode.

Table C-2 Parameters in the configure_only.rsp Response File

Corresponding SCreen Parameter Description

Configuration Type

CONFIGURE_FOR_DEVELOPMENT

CONFIGURE_FOR_DEPLOYMENT

Specify true for the configuration method you want to use. Development mode does not include Oracle HTTP Server or Oracle Enterprise Manager. Deployment mode includes Oracle HTTP Server and Oracle Enterprise Manager. These are mutually exclusive parameters, so the option you do not choose must be set to false.

Security Updates

MYORACLESUPPORT_USERNAME

MYORACLESUPPORT_PASSWORD

Provide your My Oracle Support user name and password if you want to receive the latest product information and security updates.

DECLINE_SECURITY_UPDATES

Set this parameter to true if you want to decline receiving security updates. By default, this parameter is set to false.

SECURITY_UPDATES_VIA_MYORACLESUPPORT

If you specify values for MYORACLESUPPORT_USERNAME and MYORACLESUPPORT_PASSWORD, this parameter must be set to true.

PROXY_HOST

PROXY_PORT

PROXY_USER

PROXY_PWD

Provide the proxy server information if you use a proxy server in your environment.

COLLECTOR_SUPPORTHUB_URL

The URL of the Oracle Configuration Manager Repeater. The format is:

http://repeater_host:repeater_port

or

https://repeater_host:repeater_port

Installation Location

MW_HOME

Specify the full path to the Middleware home directory.

WL_HOME

Specify the full path to the WebLogic home directory.

ORACLE_HOME

Specify the full path to the Oracle home directory.

INSTANCE_HOME

Specify the full path to the Instance home directory.

INSTANCE_NAME

Specify the Instance name. The default name is asinst_1.

Select Domain

CREATE_DOMAIN

EXTEND_DOMAIN

EXPAND_CLUSTER

Specify true for the method you want to use to associate your components with a WebLogic Server domain. These are mutually exclusive parameters, so the two options you do not choose must be set to false.

By default, CREATE_DOMAIN is set to true.

DOMAIN_NAME

Name of the domain you want to create (for the Create Domain option).

DOMAIN_LOCATION

Full path to the directory you want to contain the domain. This is the Domain home directory. During installation, a directory with the specified DOMAIN_NAME will be created inside the DOMAIN_LOCATION. For example, if you set the following:

DOMAIN_NAME=customDomain
DOMAIN_LOCATION=/home/exampleLocation

The Domain home location that will be created is:

/home/exampleLocation/customDomain

If no DOMAIN_LOCATION is specified, the Domain home will be created in the following default location:

On UNIX operating systems:

MW_HOME/user_projects/domains/DOMAIN_NAME

On Windows operating systems:

MW_HOME\user_projects\domains\DOMAIN_NAME

DOMAIN_HOSTNAME

Name of the system where your domain or cluster resides.

DOMAIN_PORT

Port number where your domain or cluster can be accessed.

ADMIN_USER_NAME

Name of the Administration user. The default name is weblogic.

ADMIN_PASSWORD

Password for the Administration user.

ADMIN_CONFIRM_PASSWORD

Confirm the password for the Administration user (for the Create Domain option).

Configure Ports

AUTOMATIC_PORT_DETECT

STATICPORT INI FILE LOCATION

Set AUTOMATIC_PORT_DETECTION to true if you want the installer to automatically configure port numbers.

If you want to configure port numbers manually, set AUTOMATIC_PORT_DETECTION to false and provide the full path to a manual port configuration file (for example, staticports.ini) in the STATICPORT INI FILE LOCATION parameter.

Proxy Details

DO NOT USE PROXY SETTINGS

ENABLE PROXY

Set these two parameters accordingly depending on whether or not you want to use a proxy server.

PROXY HOST NAME

PROXY PORT NO

PROXY BY PASS ADDRESS

If you want to use a proxy server (DO NO USE PROXY SETTING=false and ENABLE PROXY=true), specify the proxy server details using these three parameters.

Application Identity Store

USE_OID

Specify whether or not you want to use Application Level Identity Store. If so, set this parameter to true (the same as selecting Use Application Level Identity Store on the Application Identity Store screen.

OID_HOST

OID_PORT

OID_USERNAME

OID_PASSWORD

If you are using Application Level Identity Store, provide the connection credentials to your Oracle Internet Directory server.

The default user name is set to cn=orcladmin.

OID_USE_SSL

Set this parameter to true if you want to configure SSL connections to your Oracle Internet Directory server; if not, set it to false.

Access Control

USE_SSO

USE_OAM

Specify whether you want to use Oracle Single Sign-On 10g or Oracle Access Manager 11g with your Oracle Internet Directory. Set the corresponding parameter to true, and set the other one to false.

If you set USE_OAM=true, you must also specify values for the OAM_HOST, OAM_PORT, OAM_USERNAME and OAM_PASSWORD parameters.

OAM_HOST

Enter the host name where your Administration Server is running.

OAM_PORT

Enter the port number of your Administration Server.

OAM_USERNAME

Enter the Administrator user name. The default name is weblogic.

OAM_PASSWORD

Enter the Administrator user password.

OAM_USE_SSL

Set this parameter to true if you want to configure secure connections to your Oracle Access Manager server; if not, set it to false.

Configure Components

CONFIGURE_FORMS

CONFIGURE_FORMS_BUILDER

Set CONFIGURE_FORMS to true if you want to configure Oracle Forms.

Set CONFIGURE_FORMS_BUILDER to true if you want to configure Oracle Forms Builder. Note that if you choose to configure Oracle Forms Builder, CONFIGURE_FORMS must be set to true as Oracle Forms Builder is dependent on Oracle Forms.

CONFIGURE_REPORTS

CONFIGURE_REPORTS_BUILDER

Set CONFIGURE_REPORTS to true if you want to configure Oracle Reports.

Set CONFIGURE_REPORTS_BUILDER to true if you want to configure Oracle Reports Builder. Note that if you choose to configure Oracle Reports Builder, CONFIGURE_REPORTS must be set to true as Oracle Reports Builder is dependent on Oracle Reports.

CONFIGURE_OHS

Set this parameter to true if you want to configure Oracle HTTP Server.

ENTERPRISE_MANAGEMENT

Set this parameter to true if you want to configure Oracle Enterprise Manager Fusion Middleware Control.


C.2.1.2 Using the install_only.rsp Response File Template

Table C-3 describes the parameters found in the install_only.rsp response file template. The parameters are listed in the order in which they appear in the response file; note that they do not necessarily follow the order of the installation screens as seen in graphical mode.

Table C-3 Parameters in the install_only.rsp Response File

Corresponding SCreen Parameter Description

Installation Type

INSTALL AND CONFIGURE TYPE

INSTALL AND CONFIGURE LATER TYPE

Specify true for the installation method you want to use. These are mutually exclusive parameters, so the option you do not choose must be set to false.

By default, INSTALL AND CONFIGURE LATER TYPE is set to true.

Installation Location

MW_HOME

Specify the full path to the Middleware home directory.

ORACLE_HOME

Specify the full path to the Oracle home directory.

Security Updates

MYORACLESUPPORT_USERNAME

MYORACLESUPPORT_PASSWORD

Provide your My Oracle Support user name and password if you want to receive the latest product information and security updates.

DECLINE_SECURITY_UPDATES

Set this parameter to true if you want to decline receiving security updates. By default, this parameter is set to false.

SECURITY_UPDATES_VIA_MYORACLESUPPORT

If you specify values for MYORACLESUPPORT_USERNAME and MYORACLESUPPORT_PASSWORD, this parameter must be set to true.

PROXY_HOST

PROXY_PORT

PROXY_USER

PROXY_PWD

Provide the proxy server information if you use a proxy server in your environment.


C.2.1.3 Using the install_and_configure.rsp Response File Template

Table C-4 describes the parameters found in the install_and_configure.rsp response file template. The parameters are listed in the order in which they appear in the response file; note that they do not necessarily follow the order of the installation screens as seen in graphical mode.

Table C-4 Parameters in the install_and_configure.rsp Response File

Corresponding SCreen Parameter Description

Software Updates

SPECIFY_DOWNLOAD_LOCATION

SOFTWARE_UPDATES_DOWNLOAD_LOCATION

Set the SPECIFY_DOWNLOAD_LOCATION parameter to true if you want to specify the location where software updates can be downloaded.

Then, specify the directory on your local system that contains the updates using the SOFTWARE_UPDATES_DOWNLOAD_LOCATION parameter.

SKIP_SOFTWARE_UPDATES

Set this parameter to true if you do not want the installer to check for software updates.

Installation Type

INSTALL AND CONFIGURE TYPE

INSTALL AND CONFIGURE LATER TYPE

Specify true for the installation method you want to use. These are mutually exclusive parameters, so the option you do not choose must be set to false.

By default, INSTALL AND CONFIGURE TYPE is set to true.

Installation Location

MW_HOME

Specify the full path to the Middleware home directory.

WL_HOME

Specify the full path to the WebLogic home directory.

ORACLE_HOME

Specify the full path to the Oracle home directory.

INSTANCE_HOME

Specify the full path to the Instance home directory.

INSTANCE_NAME

Specify the Instance name. The default name is asinst_1.

Configuration Type

CONFIGURE_FOR_DEVELOPMENT

CONFIGURE_FOR_DEPLOYMENT

Specify true for the configuration method you want to use. Development mode does not include Oracle HTTP Server or Oracle Enterprise Manager. Deployment mode includes Oracle HTTP Server and Oracle Enterprise Manager. These are mutually exclusive parameters, so the option you do not choose must be set to false.

Select Domain

CREATE_DOMAIN

EXTEND_DOMAIN

EXPAND_CLUSTER

Specify true for the method you want to use to associate your components with a WebLogic Server domain. These are mutually exclusive parameters, so the two options you do not choose must be set to false.

By default, CREATE_DOMAIN is set to true.

DOMAIN_NAME

Name of the domain you want to create (for the Create Domain option).

DOMAIN_LOCATION

Full path to the directory you want to contain the domain. This is the Domain home directory. During installation, a directory with the specified DOMAIN_NAME will be created inside the DOMAIN_LOCATION. For example, if you set the following:

DOMAIN_NAME=customDomain
DOMAIN_LOCATION=/home/exampleLocation

The Domain home location that will be created is:

/home/exampleLocation/customDomain

If no DOMAIN_LOCATION is specified, the Domain home will be created in the following default location:

On UNIX operating systems:

MW_HOME/user_projects/domains/DOMAIN_NAME

On Windows operating systems:

MW_HOME\user_projects\domains\DOMAIN_NAME

DOMAIN_HOSTNAME

Name of the system where your domain or cluster resides.

DOMAIN_PORT

Port number where your domain or cluster can be accessed.

ADMIN_USER_NAME

Name of the Administration user. The default name is weblogic.

ADMIN_PASSWORD

Password for the Administration user.

ADMIN_CONFIRM_PASSWORD

Confirm the password for the Administration user (for the Create Domain option).

Security Updates

MYORACLESUPPORT_USERNAME

MYORACLESUPPORT_PASSWORD

Provide your My Oracle Support user name and password if you want to receive the latest product information and security updates.

DECLINE_SECURITY_UPDATES

Set this parameter to true if you want to decline receiving security updates. By default, this parameter is set to false.

SECURITY_UPDATES_VIA_MYORACLESUPPORT

If you specify values for MYORACLESUPPORT_USERNAME and MYORACLESUPPORT_PASSWORD, this parameter must be set to true.

PROXY_HOST

PROXY_PORT

PROXY_USER

PROXY_PWD

Provide the proxy server information if you use a proxy server in your environment.

COLLECTOR_SUPPORTHUB_URL

The URL of the Oracle Configuration Manager Repeater. The format is:

http://repeater_host:repeater_port

or

https://repeater_host:repeater_port

Configure Ports

AUTOMATIC_PORT_DETECT

STATICPORT INI FILE LOCATION

Set AUTOMATIC_PORT_DETECTION to true if you want the installer to automatically configure port numbers.

If you want to configure port numbers manually, set AUTOMATIC_PORT_DETECTION to false and provide the full path to a manual port configuration file (for example, staticports.ini) in the STATICPORT INI FILE LOCATION parameter.

Application Identity Store

USE_OID

Specify whether or not you want to use Application Level Identity Store. If so, set this parameter to true (the same as selecting Use Application Level Identity Store on the Application Identity Store screen.

OID_HOST

OID_PORT

OID_USERNAME

OID_PASSWORD

If you are using Application Level Identity Store, provide the connection credentials to your Oracle Internet Directory server.

The default user name is set to cn=orcladmin.

OID_USE_SSL

Set this parameter to true if you want to configure SSL connections to your Oracle Internet Directory server; if not, set it to false.

Access Control

USE_SSO

USE_OAM

Specify whether you want to use Oracle Single Sign-On 10g or Oracle Access Manager 11g with your Oracle Internet Directory. Set the corresponding parameter to true, and set the other one to false.

If you set USE_OAM=true, you must also specify values for the OAM_HOST, OAM_PORT, OAM_USERNAME and OAM_PASSWORD parameters.

OAM_HOST

Enter the host name where your Administration Server is running.

OAM_PORT

Enter the port number of your Administration Server.

OAM_USERNAME

Enter the Administrator user name. The default name is weblogic.

OAM_PASSWORD

Enter the Administrator user password.

OAM_USE_SSL

Set this parameter to true if you want to configure secure connections to your Oracle Access Manager server; if not, set it to false.

Configure Components

CONFIGURE_FORMS

CONFIGURE_FORMS_BUILDER

Set CONFIGURE_FORMS to true if you want to configure Oracle Forms.

Set CONFIGURE_FORMS_BUILDER to true if you want to configure Oracle Forms Builder. Note that if you choose to configure Oracle Forms Builder, CONFIGURE_FORMS must be set to true as Oracle Forms Builder is dependent on Oracle Forms.

CONFIGURE_REPORTS

CONFIGURE_REPORTS_BUILDER

Set CONFIGURE_REPORTS to true if you want to configure Oracle Reports.

Set CONFIGURE_REPORTS_BUILDER to true if you want to configure Oracle Reports Builder. Note that if you choose to configure Oracle Reports Builder, CONFIGURE_REPORTS must be set to true as Oracle Reports Builder is dependent on Oracle Reports.

CONFIGURE_OHS

Set this parameter to true if you want to configure Oracle HTTP Server.

ENTERPRISE_MANAGEMENT

Set this parameter to true if you want to configure Oracle Enterprise Manager Fusion Middleware Control.


C.2.2 Using the Deinstallation Response Files for Oracle Forms and Reports

Table C-5 lists the installation response file templates provided for Oracle Forms and Reports.

Table C-5 Oracle Forms and Reports Deinstallation Response File Templates

Template Description

deinstall_managed_instance.rsp

Use this response file template to remove managed instances on your system. These managed instances must be removed before you remove the Oracle home.

The equivalent using the GUI would be starting the deinstaller and selecting the Deinstall ASInstances managed by WebLogic Domain option on the Select Deinstallation Type.

See Section C.2.2.1, "Using the deinstall_managed_instances.rsp File" for more information.

deinstall_unmanaged_instance.rsp

Use this response file template to remove unmanaged instances on your system. These unmanaged instances must be removed before you remove the Oracle home.

The equivalent using the GUI would be starting the deinstaller and selecting the Deinstall Unmanaged ASInstances option on the Select Deinstallation Type.

See Section C.2.2.2, "Using the deinstall_unmanaged_instances.rsp File" for more information.

deinstall_oh.rsp

Use this response file template to remove the Oracle home. Make sure you have already removed all managed and unmanaged instances that use this Oracle home before you remove the Oracle home.

The equivalent using the GUI would be starting the deinstaller and selecting the Deinstall Oracle Home option on the Select Deinstallation Type.

See Section C.2.2.3, "Using the deinstall_oh.rsp File" for more information.


In addition to these pre-existing response files, you can create your own response file by running the deinstaller GUI, then clicking Save on the Deinstallation Summary (Managed Instance) 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 deinstallation on other systems, or modify it as needed.

C.2.2.1 Using the deinstall_managed_instances.rsp File

Table C-6 describes the parameters found in the deinstall_managed_instances.rsp response file template.

Table C-6 Parameters in the deinstall_managed_instances.rsp Response File

Corresponding SCreen Parameter Description

Select Deinstallation Type

DEINSTALL_IN_ASINSTANCE_MODE

OH_HOME_DEINSTALL

DOMAIN_MANAGED_ASINSTANCE_DEINSTALL

UNMANAGED_ASINSTANCE_DEINSTALL

Specify true for the DEINSTALL_IN_ASINSTANCE_MODE and DOMAIN_MANAGED_ASINSTANCE_DEINSTALL parameters.

Make sure that OH_HOME_DEINSTALL and UNMANAGED_ASINSTANCE_DEINSTALL are both set to false.

Specify WebLogic Domain Detail

DOMAIN_HOST_NAME

Specify the name of the system on which your WebLogic domain resides.

DOMAIN_PORT_NO

Specify the Administration Server port number. The default port number is 7001.

DOMAIN_USER_NAME

Specify the Administration Server user name.

DOMAIN_USER_PASSWORD

Specify the password for the user.

Select Managed Instance

MANAGED_INSTANCE_LIST

Specify the list of managed instances you want to remove in the following format.

For a single instance:

InstanceName^LocationOfInstance

For multiple instances, separate each instance with a dollar sign ($):

InstanceName1^LocationOfInstance1$InstanceName2^LocationOfInstance2

C.2.2.2 Using the deinstall_unmanaged_instances.rsp File

Table C-7 describes the parameters found in the deinstall_unmanaged_instances.rsp response file template.

Table C-7 Parameters in the deinstall_unmanaged_instances.rsp Response File

Corresponding SCreen Parameter Description

Select Deinstallation Type

DEINSTALL_IN_ASINSTANCE_MODE

OH_HOME_DEINSTALL

DOMAIN_MANAGED_ASINSTANCE_DEINSTALL

UNMANAGED_ASINSTANCE_DEINSTALL

Specify true for the DEINSTALL_IN_ASINSTANCE_MODE and UNMANAGED_ASINSTANCE_DEINSTALL parameters.

Make sure that OH_HOME_DEINSTALL and DOMAIN_MANAGED_ASINSTANCE_DEINSTALL are both set to false.

Specify Instance Location

ASINSTANCE_LOCATION_TEXTFIELD

Specify the full path to your unmanaged instance.


C.2.2.3 Using the deinstall_oh.rsp File

Table C-7 describes the parameters found in the deinstall_oh.rsp response file template.

Table C-8 Parameters in the deinstall_oh.rsp Response File

Corresponding SCreen Parameter Description

Select Deinstallation Type

DEINSTALL_IN_ASINSTANCE_MODE

OH_HOME_DEINSTALL

DOMAIN_MANAGED_ASINSTANCE_DEINSTALL

UNMANAGED_ASINSTANCE_DEINSTALL

Specify true for the DEINSTALL_IN_ASINSTANCE_MODE and OH_HOME_DEINSTALL parameters.

Make sure that UNMANAGED_ASINSTANCE_DEINSTALL and DOMAIN_MANAGED_ASINSTANCE_DEINSTALL are both set to false.


Note that there is no parameter to specify the Oracle home you want to deinstall; the deinstaller will only remove the Oracle home from where it was started.