A.1.1 Starting the Upgrade Assistant with Additional Parameters (Optional)

Table A-1 lists the command-line parameters you can use while running the Upgrade Assistant in the GUI mode. The following example shows the usage of these parameters on your respective operating system:

On UNIX operating systems:

Change directory to ORACLE_HOME/oracle_common/upgrade/bin

Enter the command: ./ua -help

On Windows operating systems:

Change directory to ORACLE_HOME\oracle_common\upgrade\bin

Enter the command: ua.bat -help

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 A-1 Upgrade Assistant GUI Command Line Parameters

Parameter	Required or Optional Parameter?	Description
-logLevel	Optional.	Logging level. Select one of the following: TRACE NOTIFICATION WARNING ERROR INCIDENT_ERROR The default logging level is NOTIFICATION. Note: When troubleshooting, consider setting the -logLevel to TRACE so that more information will be logged. If additional information is not needed, change the logLevel as the Upgrade Assistant's log files can become very large when -logLevel TRACE is used. Note: TRACE messages are not included in the Upgrade Assistant Log File Viewer. To view TRACE messages you must use another tool.
-logDir	Optional. Note: If you have installed the Upgrade Assistant in a read-only directory, you must specify this parameter to ensure the log directory is writable. If the log directory is read-only, the Upgrade Assistant will fail.	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
-threads	Optional	Identify the number of threads available for concurrent schema upgrades or readiness checks of the schemas. The value must be a positive integer in the range 1 to 8. Default is 4 threads.
-readiness	Required for Readiness Check	Performs the upgrade readiness check without performing any actual examines or upgrades. Schemas and configuration are checked. Note: -readiness option may not appear on the command line with -examine option. For more information, see Performing the Readiness Check
-help	Optional.	Prints all the command-line options to the console.