upgradeStarter Command

Upgrades a WebLogic Workshop application version 8.1 (SP4, SP5, or SP6) to a Workshop for WebLogic, version 9.2 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.

Environment

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).

Syntax

java -cp 
    %ECLIPSE_HOME%/startup.jar 
    -Dwlw.application=%WORK_FILE%
    -Dweblogic.home=%WL_HOME% 
    org.eclipse.core.launcher.Main
    -application com.bea.wlw.upgrade.upgradeStarter
    -data %WORKSPACE%
    [-pluginCustomization %PREFS_FILE%]

Arguments

ECLIPSE_HOME

Required. The path to the directory that contains startup.jar. By default for Workshop for WebLogic, this is:

BEA_HOME/workshop92/eclipse

-Dweblogic.home=WL_HOME

Required. The location of WebLogic Server root folder. By default, this is:

BEA_HOME/weblogic92

-Dwlw.application=WORK_FILE

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.

-application com.bea.wlw.upgrade.upgradeStarter

Required. The Eclipse plugin extension point used to execute this command.

-data WORKSPACE

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 9.2 application files generated.

[-pluginCustomization PREFS_FILE]

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.

Remarks

The following lists the properties supported in a PREFS_FILE specified by the -pluginCustomization argument.

com.bea.wlw.upgrade/upgradeHarnessAbortOnError = true | false
Specify 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 false.
com.bea.wlw.upgrade/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.wlw.upgrade/migrateJSPPreference = true | false
Specify 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.wlw.upgrade/useJ2EESharedLibraries = true | false
Specify false to have the web application libraries copied to WEB-INF/lib. The default is true (use shared J2EE libraries).
com.bea.wlw.upgrade/upgradeProjectImportOverwrite = true | false
Specify true to have an existing project overwritten in the event of a project name conflict. The default is false.
com.bea.wlw.upgrade/upgradeProjectImportPrefix = "PREFIX"
Specify an optional prefix prepended to all imported projects.

com.bea.wlw.upgrade/upgraderPrefMoveResourceBundle = "true | false"
Specify 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.wlw.upgrade/upgradeHarnessReportOnly = true | false
Specify 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.wlw.upgrade/upgradeHarnessLogFile = LOG_FILE_LOCATION
Specify the location of the log file this command generates. The default value is WORKSPACE/.metadata/upgrade.log