upgradeStarter コマンド

WebLogic Workshop バージョン 8.1 (SP4、SP5、または SP6) のアプリケーションを Workshop for WebLogic バージョン 9.2 のワークスペースにアップグレードします。

注意 : このコマンドは Ant タスクとしても使用できます。詳細については、「upgrade Ant タスク」を参照してください。

注意 : このコマンドを使用する前に、バージョン 8.1 のアプリケーションを SP4、SP5、または SP6 にアップグレードしておく必要があります。

このコマンドは、アプリケーションのアップグレード時に [インポート] ウィザードによって提供される機能と本質的に同じ機能をコマンドラインから提供します。ウィザードについては、「[インポート] ウィザードを使用してバージョン 8.1 のアプリケーションをアップグレードするには」を参照してください。例外として、このコマンドではアプリケーションの一部を指定してアップグレードすることはできません。たとえば、このコマンドではアップグレードするプロジェクトの指定はサポートされていません。すべてのプロジェクトがアップグレードされます。

[インポート] ウィザードと同様に、このコマンドでもバージョン 8.1 のアプリケーションに対する削除や変更は行われません。

環境

バージョン 1.5 の JRE 実装を使用する必要があります。また、クラスパスに startup.jar を含める必要があります。下記の ECLIPSE_HOME 引数の説明を参照してください。

構文

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%]

引数

ECLIPSE_HOME

必須。startup.jar が格納されているディレクトリへのパス。Workshop for WebLogic のデフォルトは次のとおりです。

BEA_HOME/workshop92/eclipse

-Dweblogic.home=WL_HOME

必須。WebLogic Server のルート フォルダの場所。デフォルトは次のとおりです。

BEA_HOME/weblogic92

-Dwlw.application=WORK_FILE

必須。アップグレードするアプリケーションを指定します。WORK_FILE を、アップグレードする WebLogic Workshop 8.1 アプリケーションに対応する WORK ファイル名に置き換えてください。

-application com.bea.wlw.upgrade.upgradeStarter

必須。このコマンドの実行に使用される Eclipse プラグイン拡張ポイント。

-data WORKSPACE

必須。アップグレードされたアプリケーションの移動先となる対象ワークスペースの名前。バージョン 9.2 のアプリケーション ファイルの生成先となるディレクトリを自由に指定できます。

[-pluginCustomization PREFS_FILE]

省略可能。アップグレード オプションを設定するためのプロパティ ファイルを指定します。PREFS_FILE を、キーと値のペアを格納しているプロパティ ファイル名に置き換えてください。指定できるプロパティのリストについては、以下の「備考」を参照してください。

備考

以下に、-pluginCustomization 引数で指定される PREFS_FILE でサポートされているプロパティを示します。

• com.bea.wlw.upgrade/upgradeHarnessAbortOnError = true | false

  エラーが発生したらアップグレード プロセスを中止する場合には、true を指定します。デフォルトでは、エラー発生後もアップグレードの継続が試みられます。エラーは常にログ ファイルに記録されます。デフォルトは false です。

• com.bea.wlw.upgrade/upgradeHarnessMessageLevel = INFO | WARNING | ERROR

  省略可能。記録されるメッセージ レベルを指定します。指定されない場合は、すべてのメッセージがログに記録されます。以下の値を指定できます。

  INFO - すべてのメッセージが表示されます。この値がデフォルトです。

  WARNING - 警告メッセージ、エラー メッセージ、および致命的なメッセージが表示されます。情報メッセージは表示されません。

  ERROR - エラー メッセージと致命的なメッセージのみが表示されます。

• com.bea.wlw.upgrade/migrateJSPPreference = true | false

  アップグレード プロセスの一部として、バージョン 8.1 の NetUI JSP タグをそれに対応する Beehive タグに置き換える場合には、true を指定します。デフォルトは false です。この場合、これらのタグはバージョン 8.1 のタグのまま、バージョン 9.x のサーバ環境と互換性のあるバージョンにアップグレードされます。

• com.bea.wlw.upgrade/useJ2EESharedLibraries = true | false

  Web アプリケーション ライブラリを WEB-INF/lib にコピーする場合には、false を指定します。デフォルトは true です (共有 J2EE ライブラリが使用されます)。

• com.bea.wlw.upgrade/upgradeProjectImportOverwrite = true | false

  プロジェクト名の衝突が発生したときに既存のプロジェクトを上書きする場合には、true を指定します。デフォルトは false です。

• com.bea.wlw.upgrade/upgradeProjectImportPrefix = "PREFIX"

  インポートされたすべてのプロジェクトに付加するプレフィックスを指定します (省略可能)。

• com.bea.wlw.upgrade/upgraderPrefMoveResourceBundle = "true | false"

  .properties 拡張子の付いたファイルを Web コンテンツ フォルダからソース ファイル フォルダに移動する場合には、true を指定します。デフォルトは false です (ファイルは移動されず、コピーが作成されます)。

• com.bea.wlw.upgrade/upgradeHarnessReportOnly = true | false

  アップグレード レポートを生成するが、アプリケーションをアップグレードしない場合には、true を指定します。デフォルトは false です (レポート生成とアップグレードの両方が実行されます)。

• com.bea.wlw.upgrade/upgradeHarnessLogFile = LOG_FILE_LOCATION

  このコマンドによって生成されるログ ファイルの場所を指定します。デフォルト値は、WORKSPACE/.metadata/upgrade.log です。

関連トピック

upgrade Ant タスク

[インポート] ウィザードを使用してバージョン 8.1 のアプリケーションをアップグレードするには

概要 : WebLogic Workshop 8.1 からのアップグレード

WebLogic Workshop 8.1 からバージョン 9.2 へのアップグレード時における変更点