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

This appendix describes the following:

A.1 Parameters to Edit in the upgrade.rsp File for Upgrading the OMS and Management Agent in Silent Mode

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

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 Needed for the Values? Description

UNIX_GROUP_NAME

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

String

Yes

(Required only when central inventory does not exist) Enter the name of the UNIX group you belong to.

For example, "dba".

INVENTORY_LOCATION

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

String

Yes

(Required only when central inventory does not exist and if the OMS you are upgrading was installed using the invPtrLoc argument) Enter the absolute path to the Central Inventory.

For example, "/u01/software/oraInventory".

SECURITY_UPDATES_VIA_MYORACLESUPPORT

Applicable only to normal upgrade.

Not applicable to software-only upgrade.

Therefore, comment out this parameter for software-only upgrade.

Boolean

Yes

  • Enter TRUE if you want to download and install security updates. Then, enter the credentials for the following parameters in double quotes:

    MYORACLESUPPORT_USERNAME

    MYORACLESUPPORT_PASSWORD

  • Enter FALSE if you do not want to download and install security updates:

DECLINE_SECURITY_UPDATES

Applicable only to normal upgrade.

Not applicable to software-only upgrade.

Therefore, comment out this parameter for software-only upgrade.

Boolean

No

  • Enter TRUE if you want to decline the security updates. In this case, you should have entered FALSE for SECURITY_UPDATES_VIA_MYORACLESUPPORT.

  • Enter FALSE if you do not want to decline the security updates. In this case, you should have entered TRUE for SECURITY_UPDATES_VIA_MYORACLESUPPORT.

INSTALL_UPDATES_SELECTION

Applicable only to normal upgrade.

Not applicable to software-only upgrade.

Therefore, comment out this parameter for software-only upgrade.

String

Yes

By default, this parameter is set to "skip" indicating that the software updates will not be installed during installation.

  • If you want to install the software updates from My Oracle Support, then set this parameter to "download". Then, enter the credentials for the following parameters in double quotes:

    MYORACLESUPPORT_USERNAME_FOR_SOFTWAREUPDATES

    MYORACLESUPPORT_PASSWORD_FOR_SOFTWAREUPDATES

  • If you want to install the software updates from a staged location, then set this parameter to "staged". Then, for the STAGE_LOCATION parameter, enter the absolute path, which leads to the Updates directory where the software updates are available, in double quotes.

    For this option, as a prerequisite, you must have already downloaded the software updates. For instructions, see Oracle Enterprise Manager Cloud Control Advanced Installation and Configuration Guide.

ORACLE_MIDDLEWARE_HOME_LOCATION

Applicable only to normal upgrade.

Not applicable to software-only upgrade.

Therefore, comment out this parameter for software-only upgrade.

String

Yes

Upgrade to 13c Release 1 is an out-of-place upgrade, therefore you must enter a new middleware home where the installer can automatically install Oracle WebLogic Server 12c Release 1 (12.1.3.0) and Java Development Kit (JDK) 1.7.0_80. Ensure that the middleware location has write permission.

For example, /u01/software/em13c/oraclehome.

Note: Ensure that the Middleware home you enter here is used only for Enterprise Manager Cloud Control. Ensure that no other Oracle Fusion Middleware products or components are installed in the same Middleware home.

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

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

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.

    For example, /u01/software/em13c/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 Section 5.1.10.1.

OLD_BASE_DIR

Applicable to normal upgrade as well software-only upgrade.

String

Yes

Enter the base directory of the OMS you want to upgrade. This is essentially the middleware home where the OMS home is present.

ORACLE_HOSTNAME

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

ONE_SYSTEM

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

Boolean

No

By default, this parameter is set to TRUE.

AGENT_BASE_DIR

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

OLD_DATABASE_CONNECTION_DESCRIPTION

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

OLD_DATABASE_SYSMAN_PASSWORD

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

WLS_ADMIN_SERVER_USERNAME

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

WLS_ADMIN_SERVER_PASSWORD

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

WLS_ADMIN_SERVER_CONFIRM_PASSWORD

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

NODE_MANAGER_PASSWORD

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

NODE_MANAGER_CONFIRM_PASSWORD

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

WLS_ADMIN_SERVER_PASSWORD

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

String

Yes

Enter the password for the WebLogic user account.

JVM_DIAGNOSTICS_TABLESPACE_LOCATION

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

DATABASE_HOSTNAME

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

LISTENER_PORT

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

SERVICENAME_OR_SID

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

Therefore, comment out this parameter.

String

Yes

Not applicable.

SYS_PASSWORD

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

Not applicable to additional OMS upgrade.

Therefore, comment out this parameter for additional OMS upgrade.

String

Yes

Enter the SYS user account's password

SYSMAN_PASSWORD

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

Not applicable to additional OMS upgrade.

Therefore, comment out this parameter for additional OMS upgrade.

String

Yes

Enter the SYSMAN user account's password.

REPOSITORY_BACKUP

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

Not applicable to additional OMS upgrade.

Therefore, comment out this parameter for additional OMS upgrade.

Boolean

No

As a prerequisite, you must back up the Management Repository before you start upgrading your Enterprise Manager system. If you have taken a backup, then set this parameter to TRUE. Otherwise, set it to FALSE

DISABLE_DDMP_JOBS

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

Not applicable to additional OMS upgrade.

Therefore, comment out this parameter for additional OMS upgrade.

Boolean

No

If you have to stop the Enterprise Manager system for postupgrade maintenance, then set this parameter to TRUE to disable the DDMP jobs. If you do not plan to stop the Enterprise Manager system for postupgrade maintenance, and hence do not want to disable the DDMP jobs, then set this parameter to FALSE.

PLUGIN_SELECTION

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

String List

Yes

(A comma-separated list of plug-in names, where the plug-in names must be in double quotes)

By default, all plug-ins deployed on the OMS are automatically upgraded when newer versions exist or migrated when newer versions do not exist. Also, new plug-ins are deployed when the plug-ins being upgraded have new dependencies or when there are any new default plug-ins introduced with a release.

You might have a deprecated plug-in in your environment that can be upgraded to a plug-in version that is supported only in 13c Release 1 but not in any of the future releases. If such a deprecated plug-in exists, then evaluate your and decide whether or not you want to proceed with the upgrade of such plug-ins.

If you want to install any of the other optional plug-ins, then enter the names of those plug-ins for this parameter.

Again, if you list any deprecated plug-ins that will be supported only in 13c Release 1 but not in any of the future releases, then evaluated your selection and decide whether or not you want to proceed with the deployment.

For example,

If you want to install 13.1.1.0.0_oracle.sysman.empa_2000_0.opar and 13.1.1.0.0_oracle.sysman.vt_2000_0.opar, then enter the plug-in IDs in the following way:

PLUGIN_SELECTION={"oracle.sysman.empa","oracle.sysman.vt"}

If you want to install any plug-in that is not available in the software kit, then follow these steps:

  1. Manually download the required plug-ins from the following location:

    http://www.oracle.com/technetwork/oem/extensions/index.html

    In addition, if you want to download any partner or customer plug-ins, then download from the following location:

    https://apex.oracle.com/pls/apex/f?p=53891:1

  2. Invoke the installer with the following parameter, and pass the location where the plug-ins have been downloaded.

    ./em13100_<platform>.bin PLUGIN_LOCATION=<absolute_path_to_plugin_software_location>

    If you want to enter the names of any deprecated plug-in that is supported only in 13c Release 1 but not in any of the future releases, then evaluate your choice and decide whether or not you want to proceed with the deployment of such plug-ins.

CONFIGURE_SHARED_LOCATION_BIP

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

Not applicable to additional OMS upgrade.

Therefore, comment out this parameter for software-only upgrade.

Boolean

No

If you are upgrading an OMS that already has Oracle BI Publisher installed and configured in a shared location, then set this parameter to FALSE.

However, if you are upgrading an OMS that does not already have Oracle BI Publisher installed, or if you are upgrading an OMS that has Oracle BI Publisher installed but not configured in a shared location, then set this parameter to TRUE, and configure a shared location for Oracle BI Publisher.

The shared storage location will act as a common location for storing the report catalog and associated management information for the first OMS you are installing now and also for the additional OMS you plan to install in the future.

Identify a shared location that you can use for Oracle BI Publisher. If you do not have an existing shared location, create a new one and ensure that it is visible on the host where you are installing the first OMS and also on other hosts where you plan to install additional OMS instances.

At upgrade time, for the installation to be successful, you can reserve approximately 400 MB of hard disk space for the shared directory. However, Oracle recommends that you scale it to at least 10 GB eventually, and ensure that it can be extended further in the future because the space utilization increases over a period of time as you install additional plug-ins and create more reports.

CLUSTER_LOCATION

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

Not applicable to additional OMS upgrade.

Therefore, comment out this parameter for software-only upgrade.

String

Yes

Set this only if the CONFIGURE_SHARED_LOCATION_BIP parameter is set to TRUE.

Specify the path leading up to the /cluster directory on the shared storage location where Oracle BI Publisher scheduler storage can be maintained for Oracle BI Publisher to operate in a high-availability environment. For example, /u01/software/examplehost/BIP/cluster.

CONFIG_LOCATION

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

Not applicable to additional OMS upgrade.

Therefore, comment out this parameter for software-only upgrade.

String

Yes

Set this only if the CONFIGURE_SHARED_LOCATION_BIP parameter is set to TRUE.

Specify the path leading up to the /config directory on the shared storage location where Oracle BI Publisher repository and configuration files can be stored. For example, /u01/software/examplehost/BIP/config.

ENABLE_BI_PUBLISHER

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

Not applicable to additional OMS upgrade.

Therefore, comment out this parameter for software-only upgrade.

Boolean

No

Enable or disable the installed and configured Oracle BI Publisher. Enabling Oracle BI Publisher starts the software and keeps it ready for use within the Enterprise Manager system. Disabling Oracle BI Publisher leaves the software as it is without starting it.

To enable Oracle BI Publisher, set this parameter to TRUE. To disable, set this parameter to FALSE.