A Editing the upgrade.rsp Response File for Upgrading Oracle Management Service and Oracle Management Repository in Silent Mode

This appendix describes the following:

Parameters to Edit in the upgrade.rsp File for Upgrading Oracle Management Service and Oracle Management Repository in Silent Mode

Table A-1 describes the parameters you must update in the upgrade.rsp response file for upgrading end-to-end (normal upgrade) the Oracle Management Service (OMS) and Oracle Management Repository (Management Repository) in silent mode.

Note:

The following parameters are not required and can be ignored from the upgrade.rsp response file:

JVM_DIAGNOSTICS_TABLESPACE_LOCATION, DATABASE_HOSTNAME, LISTENER_PORT and SERVICENAME_OR_SID.

Table A-1 Editing the Parameters of the upgrade.rsp File for Upgrading the OMS and Management Repository in Silent Mode

Parameter Name Applicable Upgrade Approach Data Type Are Double Quotes Required for the Value? Description

UNIX_GROUP_NAME

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

The UNIX group name that the user belongs to.

Example: UNIX_GROUP_NAME="dba"

This parameter is required only when central inventory does not exist.

INVENTORY_LOCATION

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

The inventory location absolute path.

Example: INVENTORY_LOCATION="/u01/oracle/oraInventory"

This parameter is required only when central inventory does not exist, and if the OMS you are upgrading was installed using the invPtrLoc argument.

INSTALL_UPDATES_SELECTION

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

By default, this parameter value is set to "skip" indicating that the software updates will not be skipped.

STAGE_LOCATION

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

The location where the software updates are staged and available.

This parameter is only used if INSTALL_UPDATES_SELECTION is set to "staged".

If you want to download the software updates during the installation, set INSTALL_UPDATES_SELECTION="download", and provide the following parameters: MYORACLESUPPORT_USERNAME_FOR_SOFTWAREUPDATES and MYORACLESUPPORT_PASSWORD_FOR_SOFTWAREUPDATES.

MYORACLESUPPORT_USERNAME_FOR_SOFTWAREUPDATES

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

If you want to download the software updates during the installation, set INSTALL_UPDATES_SELECTION="download", and provide the following parameters: MYORACLESUPPORT_USERNAME_FOR_SOFTWAREUPDATES and MYORACLESUPPORT_PASSWORD_FOR_SOFTWAREUPDATES.

MYORACLESUPPORT_PASSWORD_FOR_SOFTWAREUPDATES

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

If you want to download the software updates during the installation, set INSTALL_UPDATES_SELECTION="download", and provide the following: MYORACLESUPPORT_USERNAME_FOR_SOFTWAREUPDATES and MYORACLESUPPORT_PASSWORD_FOR_SOFTWAREUPDATES.

ORACLE_MIDDLEWARE_HOME_LOCATION

Applicable only to normal upgrade (upgrade end-to-end).

Not applicable to software-only upgrade.

Comment out this parameter when performing software-only upgrade.

String

Yes

The middleware home location where Oracle WebLogic Server, Java Development Kit (JDK) and oracle homes get installed.

Example: ORACLE_MIDDLEWARE_HOME_LOCATION="/u01/software/em24/mwhome"

The middleware location requires write permission in the specified directory or folder.

Note: Ensure the number of characters in the middleware home path does not exceed 70 characters for Unix platform and 25 characters for Windows platform.

For example, the Windows middleware home path C:\Oracle\MW\EM containing only 15 characters is acceptable. However, the path: C:\OracleSoftware\OracleMiddleware\OracleEnterpriseManager\OMS\newrelease\mwhome which contains more than 25 characters is not acceptable for Windows platforms.

The Middleware home should be used only for Enterprise Manager. No other Oracle Fusion Middleware products or components should get installed in the same Middleware home.

ORACLE_INSTANCE_HOME_LOCATION

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

By default, gc_inst is considered as the OMS Instance Base directory for storing all OMS-related configuration files, and by default, it is created outside the Middleware home.

  • To accept the default location and the directory name, leave the parameter blank.

  • To have a custom location and a custom directory name, enter the absolute path to the custom location leading up to the custom directory name.

    Example: ORACLE_INSTANCE_HOME_LOCATION="/u01/software/em24/gc_inst"

Important: If you are installing on an NFS-mounted drive and creating the OMS instance base directory (gc_inst) on that NFS-mounted drive, then after you install, move the lock files from the NFS-mounted drive to a local file system location. Modify the lock file location in the httpd.conf file to map to a location on a local file system. For instructions, refer to Moving Lock Files from an NFS-Mounted Drive to a Local File System Location.

OLD_BASE_DIR

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

The old middleware home that you want to upgrade. It's the middleware home where the OMS is currently installed and present.

This parameter is applicable when ONE_SYSTEM=true is provided.

ORACLE_HOSTNAME

Not applicable to normal upgrade as well as software-only upgrade.

Comment out this parameter.

String

Yes

Not applicable.

Current host name where the installer is invoked.

By default, the fully qualified hostname of the machine will be taken automatically. There's no need to provide this value in the response file when upgrading.

This value may be provided only for TWO_SYSTEM upgrade which it's deprecated.

This value should NOT be provided for ONE_SYSTEM upgrade.

The ORACLE_HOSTNAME parameter value should be provided only if you want to configure with a different hostname.

ONE_SYSTEM

Applicable to normal upgrade as well as software-only upgrade.

Boolean

No

By default, it's set to true.

The true value indicates ONE_SYSTEM upgrade.

The false value indicates TWO_SYSTEM upgrade which it's deprecated.

AGENT_BASE_DIR

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

The agent home location outside of OMS path where the agent will be upgraded. Agent is upgraded as part of the OMS upgrade.

Example: AGENT_BASE_DIR="/u01/software/em24/agentbasedir"

OLD_DATABASE_CONNECTION_DESCRIPTION

Not applicable to normal upgrade as well as software-only upgrade.

Comment out this parameter.

String

Yes

The old repository connect descriptor.

Applicable only for two-system upgrade, when setting ONE_SYSTEM=false.

OLD_DATABASE_SYSMAN_PASSWORD

Not applicable to normal upgrade as well as software-only upgrade.

Comment out this parameter.

String

Yes

Old Repository SYSMAN password required only for TWO_SYSTEM system upgrade which it's deprecated.

WLS_ADMIN_SERVER_USERNAME

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

Enter the Weblogic server user name.

WLS_ADMIN_SERVER_PASSWORD

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

Enter the Weblogic admin server password.

WLS_ADMIN_SERVER_CONFIRM_PASSWORD

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

Confirm the Weblogic admin server password.

NODE_MANAGER_PASSWORD

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

Enter the Node Manager Password.

NODE_MANAGER_CONFIRM_PASSWORD

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

Confirm the Node Manager Password.

JVM_DIAGNOSTICS_TABLESPACE_LOCATION

Not applicable to normal upgrade as well as software-only upgrade.

Therefore, comment out this parameter.

String

Yes

Not applicable for upgrade.

DATABASE_HOSTNAME

Not applicable to normal upgrade as well as software-only upgrade.

Therefore, comment out this parameter.

String

Yes

Hostname of the Repository database.

Not required for upgrade. Value is autopopulated.

LISTENER_PORT

Not applicable to normal upgrade as well as software-only upgrade.

Therefore, comment out this parameter.

String

Yes

Listener port on which the Repository database is running.

Not required for upgrade. Value is autopopulated.

SERVICENAME_OR_SID

Not applicable to normal upgrade as well as software-only upgrade.

Therefore, comment out this parameter.

String

Yes

Service name (SID) of the Repository database.

Not required for upgrade. Value is autopopulated.

SYS_PASSWORD

Applicable to normal upgrade, software-only upgrade, and additional OMS upgrade.

String

Yes

The SYS database user password used to create the repository schema.

dbUser

Applicable to normal upgrade (upgrade end-to-end), software-only upgrade, and additional OMS upgrade.

String

Yes

The database user name that creates the repository schema during the upgrade process. This is the non-SYS database user (a database user other than the SYS user).

The dbUser parameter value cannot be SYS.

Naming convention: User name should start with the SYSMAN_ prefix.

For example: dbUser=SYSMAN_ADMIN

If the user doesn't exist, the upgrade process creates the new user in the Repository database.

This parameter is only required if INSTALL_WITH_NON_SYS_USER = true.

dbPassword

Applicable to normal upgrade, software-only upgrade, and additional OMS upgrade.

String

Yes

The password of the database user that creates the repository schema. This is the non-SYS database user password.

This parameter is only required if INSTALL_WITH_NON_SYS_USER = true.

SYSMAN_PASSWORD

Applicable to normal upgrade, software-only upgrade, and additional OMS upgrade.

String

Yes

The SYSMAN user password.

EMPREREQ_AUTO_CORRECTION

Applicable to normal upgrade as well as software-only upgrade.

Boolean

No

It specifies if the EM prerequisites check uses the auto correction option.

Example: EMPREREQ_AUTO_CORRECTION=false

INSTALL_WITH_NON_SYS_USER

Applicable to normal upgrade as well as software-only upgrade.

Boolean

No

It specifies if the upgrade is being performed using a database user different than SYS. This user is also known as non-SYS user.

For example: INSTALL_WITH_NON_SYS_USER=true

If this parameter is set to true, you also need to provide the dbUser and dbPassword parameters (the user name and password of the non-SYS user).

The dbUser parameter value cannot be SYS and should always start with SYSMAN_.

Is_oneWaySSL Applicable to normal (end-to-end) upgrade as well as software-only upgrade. Boolean No

Applicable for one-way SSL configuration.

Set it to true if the repository database is configured with one-way SSL.

Example: Is_oneWaySSL=true

If Is_oneWaySSL=true is set, then the TRUSTSTORE_LOCATION and TRUSTSTORE_PASSWORD parameters must also be provided.

TRUSTSTORE_LOCATION Applicable to normal (end-to-end) upgrade as well as software-only upgrade. String Yes

Applicable for one-way or two-way SSL configuration (Is_oneWaySSL=true or Is_twoWaySSL=true)

It specifies the absolute location of TrustStore Wallet file.

TRUSTSTORE_PASSWORD Applicable to normal (end-to-end) upgrade as well as software-only upgrade. String Yes

Applicable for one-way or two-way SSL configuration (Is_oneWaySSL=true or Is_twoWaySSL=true)

It specifies the TrustStore Wallet password.

Is_twoWaySSL Applicable to normal (end-to-end) upgrade as well as software-only upgrade. Boolean   Applicable for two-way SSL configuration.

Set it to true if repository database is configured with Two way SSL.

Example: Is_twoWaySSL=true

If Is_twoWaySSL=true is set, KEYSTORE_LOCATION, KEYSTORE_PASSWORD, TRUSTSTORE_LOCATION and TRUSTSTORE_PASSWORD parameters must also be provided.

KEYSTORE_LOCATION Applicable to normal (end-to-end) upgrade as well as software-only upgrade. String  

Applicable for two-way SSL configuration.

Absolute location of KeyStore wallet file.

KEYSTORE_LOCATION Applicable to normal (end-to-end) upgrade as well as software-only upgrade. String  

Applicable for two-way SSL configuration.

KeyStore wallet password.

REPOSITORY_BACKUP_DONE

Applicable to normal upgrade as well as software-only upgrade.

Not applicable to additional OMS upgrade.

Comment out this parameter for additional OMS upgrade.

Boolean

No

Applicable for ONE_SYSTEM upgrade scenario from 10.2.0.5/11.1/12.1.0.1.0 /12.1.0.2.0/12.1.0.3.0 -> 12.1.0.4.0.

As a prerequisite, you must back up the Management Repository before you start upgrading your Enterprise Manager system.

If you have already taken a backup, then set this parameter to true. Otherwise, take a backup immediately, then set this parameter to true, and then proceed with the upgrade operation.

For example: REPOSITORY_BACKUP_DONE=false

PLUGIN_SELECTION

Applicable to normal upgrade as well as software-only upgrade.

String

Yes

List of new plug-ins to be deployed during upgrade.

All plug-ins deployed to the old Enterprise Manager system will be automatically upgraded/migrated based on the availability of newer version of plug-in software.

The string list contains a list of strings and each string is the PLUGIN_ID of the desired plug-in.

(DVD)/Disk1/plug-ins has list of plug-ins that are shipped as part of DVD.

If you want to install 12.1.0.4.0_oracle.sysman.empa_2000_0.opar, pass PLUGIN_SELECTION={"oracle.sysman.empa"}

For example: PLUGIN_SELECTION={'oracle.sysman.empa'}

b_upgrade

Applicable to normal upgrade as well as software-only upgrade.

Boolean

No

Set it to b_upgrade=true

EM_INSTALL_TYPE

Applicable to normal upgrade as well as software-only upgrade.

String

No

Set it to EM_INSTALL_TYPE="NOSEED"