Upgrades a WebLogic Workshop application version 8.1 (SP4, SP5, or SP6) to a Workshop for WebLogic, version 10.0 workspace.
Note: This command is also available as an Ant task. For more information, see upgrade Ant Task.
Note: Your version 8.1 application must have been upgraded to SP4, SP5, or SP6 before using this command.
This command exposes from the command line essentially the same functionality exposed by the import wizard when upgrading an application. (See How To: Use the Import Wizard to Upgrade Version 8.1 Applications for information on the wizard.) One exception to this support is that it is not possible with this command to specify a subset of an application to upgrade. For example, this command does not support specifying which projects to upgrade; all projects are upgraded.
As with the import wizard, this command does not delete or change the version 8.1 application.
You must use a version 1.5 implementation of the JRE. Also, the classpath must include startup.jar (see the
ECLIPSE_HOME argument description below).
java -cp %ECLIPSE_HOME%/startup.jar -Dwlw.application=%WORK_FILE% -Dweblogic.home=%WL_HOME% org.eclipse.core.launcher.Main -application com.bea.workshop.upgrade81.upgradeStarter -data %WORKSPACE% [-pluginCustomization %PREFS_FILE%]
Required. The path to the directory that contains startup.jar. By default for Workshop for WebLogic, this is:
Required. The location of WebLogic Server root folder. By default, this is:
Required. Specifies the application to upgrade. Replace WORK_FILE with the WORK file name corresponding to the WebLogic Workshop 8.1 you want to upgrade.
Required. The Eclipse plugin extension point used to execute this command.
Required. The name of the target workspace where you want the upgraded application to go. This can be any directory to which you want the version 10.0 application files generated.
Optional. Specifies a properties file to set options for upgrade. Replace PREFS_FILE with the name of a properties file containing a number of key-value pairs. See the remarks below for a list of possible properties.
The following lists the properties supported in a PREFS_FILE specified by the
com.bea.workshop.upgrade81/upgradeHarnessAbortOnError = true | false
true to have the upgrade process fail on any error. By default upgrade will attempt to continue after an error. Errors will always appear in the log file. The default is
com.bea.workshop.upgrade81/upgradeHarnessMessageLevel = INFO | WARNING | ERROR
Optional. Takes a message level setting. When not specified, upgrade will log all messages. The following values can be specified:
INFO — Display all messages. This is the default.
WARNING — Display warning, error and fatal messages. Suppress informational messages.
ERROR — Display only error and fatal messages
com.bea.workshop.upgrade81/migrateJSPPreference = true | false
true to have version 8.1 NetUI JSP tags replaced with their Beehive counterparts (where counterparts exist) as part of the upgrade process. The default is
false, in which case the tags are instead upgraded to versions of the 8.1 tags that are compatible with the version 9.x server environment.
com.bea.workshop.upgrade81/useJ2EESharedLibraries = true | false
false to have the web application libraries copied to WEB-INF/lib. The default is
true (use shared J2EE libraries).
com.bea.workshop.upgrade81/upgradeProjectImportOverwrite = true | false
true to have an existing project overwritten in the event of a project name conflict. The default is
com.bea.workshop.upgrade81/upgradeProjectImportPrefix = "PREFIX"
Specify an optional prefix prepended to all imported projects.
com.bea.workshop.upgrade81/upgraderPrefMoveResourceBundle = "true | false"
true to have files with the .properties extension moved from the web content folder to the source file folder. The default is
false (make copies instead of moving the files).
com.bea.workshop.upgrade81/upgradeHarnessReportOnly = true | false
true to generate an upgrade report, but not upgrade the application. The default is
false, meaning both report and upgrade will be performed.
com.bea.workshop.upgrade81/upgradeHarnessLogFile = LOG_FILE_LOCATION
Specify the location of the log file this command generates. The default value is WORKSPACE/.metadata/upgrade.log