This chapter describes how to run the Oracle Fusion Middleware Upgrade Assistant from the command-line interface (CLI).
You can use the optional command-line interface arguments, documented in this chapter, to upgrade your Oracle Fusion Middleware 11g and 12.1.2 components to Oracle Fusion Middleware 12c (12.1.3). In addition, a response file can be generated to automate some of the upgrade tasks.
This chapter contains the following sections:
The following examples show the optional arguments that can be used when you launch the Upgrade Assistant graphical user interface:
Change directory to ORACLE_HOME
/oracle_common/upgrade/bin
./ua [-logLevel <log_level>] [-logDir <log_directory>]
Change directory to ORACLE_HOME
\oracle_common\upgrade\bin
ua.bat [-logLevel <log_level>] [-logDir <log_directory>]
Refer to Table 2-1 for a description of the command line arguments available when you are invoking the Upgrade Assistant graphical user interface from your operating system's command line.
Note:
If you get an Xlib error when starting the Oracle Upgrade Assistant such as "Failed to connect to server", "Connection refused by server", or "Can't open display", then you must set the DISPLAY environment variable and restart the Upgrade Assistant as described in Setting the DISPLAY Environment Variable.Table 2-1 Optional Upgrade Assistant GUI Command Line Parameters
Parameter | Required or Optional Parameter? | Description |
---|---|---|
|
Optional. |
Logging level. Select one of the following:
The default logging level is NOTIFICATION. NOTE: Consider setting the |
|
Optional. |
Change the default location of upgrade log files and temporary files. You must specify an existing, writable directory where Upgrade Assistant will create log files and temporary files. On UNIX operating systems, the default locations are: ORACLE_HOME/oracle_common/upgrade/logs ORACLE_HOME/oracle_common/upgrade/temp On Windows operating systems, the default locations are: ORACLE_HOME\oracle_common\upgrade\logs ORACLE_HOME\oracle_common\upgrade\temp |
|
Optional. |
View all of the command line options. |
This section describes how you can upgrade supported Oracle Fusion Middleware components in a silent mode using a response file. The response file collects all the information that you have entered through the Upgrade Assistant's graphical user interface screens, and performs exactly the same function that the Upgrade Assistant wizard performs.
The Save Response File option on the Upgrade Summary screen creates a file that uses the information you have already provided in the Upgrade Assistant screens. The response file enables you to use the saved information instead of manually entering data through the Upgrade Assistant wizard screens.
Once you select the Save Response File option, 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 upgrade options on other systems, or modify it as needed. For more information, see Using the Response File to Upgrade Fusion Middleware.
To perform upgrades using a response file from the command-line interface (CLI), use the following command:
Change directory to ORACLE_HOME
/oracle_common/upgrade/bin
./ua -response <response_file> [-examine] [-logLevel <log_level>] [-logDir <log_directory>]
Change directory to ORACLE_HOME
\oracle_common\upgrade\bin
Execute the following:
ua.bat -response <response_file> [-examine] [-logLevel <log_level>] [-logDir <log_directory>]
Refer to Table 2-2 for a description of the command line arguments available when you are using a response file to upgrade.
Table 2-2 Upgrade Assistant Silent Mode Command Line Parameters
Parameter | Required or Optional Parameter? | Description |
---|---|---|
|
Required. |
File containing inputs required to perform an upgrade. This file can be generated from inputs entered when the Upgrade Assistant is run in graphical mode. |
|
Optional. |
If this option is present, Upgrade Assistant will perform the examine phase but WILL NOT perform any actual upgrades. |
|
Optional. |
Logging level. Select one of the following:
The default logging level is NOTIFICATION. NOTE: Consider setting the |
|
Optional. |
Change the default location of upgrade log files and temporary files. You must specify an existing, writable directory where Upgrade Assistant will create log files and temporary files. On UNIX operating systems, the default locations are: ORACLE_HOME/oracle_common/upgrade/logs ORACLE_HOME/oracle_common/upgrade/temp On Windows operating systems, the default locations are: ORACLE_HOME\oracle_common\upgrade\logs ORACLE_HOME\oracle_common\upgrade\temp |
|
Optional. |
View all of the command line options. |
For more information on troubleshooting a failed upgrade, see Chapter 3, "Troubleshooting Your Upgrade".