WASPreUpgrade コマンド

WebSphere® Application Server バージョン 9.0 の WASPreUpgrade コマンドは、以前にインストールされたバージョンの WebSphere Application Server の構成を、マイグレーション固有のバックアップ・ディレクトリーに保存します。

場所

コマンド・ファイルは バージョン 9.0 app_server_root/bin ディレクトリーにあり、このディレクトリーから実行する必要があります。

構文

[Linux][AIX][HP-UX][Solaris]
WASPreUpgrade.sh backupDirectory 
                 currentWebSphereDirectory
                 [-properties properties_file_name]
                 [-traceString trace_spec [-traceFile file_name ]]
                 [-machineChange true | false]
                 [-oldProfile profile_name]
                 [-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
                 [-username < user name >]
                 [-password < password >]
                 [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
                 [-requireEmbeddedDBMigration true | false]
                 [-keepDmgrEnabled true | false]
                 [-allowSameRelease < true | false >]
[Windows]
WASPreUpgrade.bat backupDirectory 
                  currentWebSphereDirectory
                  [-properties properties_file_name]
                  [-traceString trace_spec [-traceFile file_name ]]
                  [-machineChange true | false]
                  [-oldProfile profile_name]
                  [-workspaceRoot profile1=user_workspace_folder_name_1;profile2=user_workspace_folder_name_2]
                  [-username < user name >]
                  [-password < password >]
                  [-javaoption < -Xms...m > -javaoption < -Xmx...m > ]
                  [-requireEmbeddedDBMigration true | false]
                  [-keepDmgrEnabled true | false]
                  [-allowSameRelease < true | false >]

パラメーター

このコマンドには、以下のパラメーターがあります。

backupDirectory
これは必須パラメーターで、最初に指定する必要があります。 値 backupDirectory は、コマンド・スクリプトが構成を保存したディレクトリーの名前を指定します。
問題の回避: WAS_INSTALL および USER_INSTALL のルート・ディレクトリーは、 WebSphere Application Server バックアップ・ディレクトリーの場所としては無効なディレクトリーです。

これは、WASPostUpgrade コマンドが構成を読み取るディレクトリーでもあります。

ディレクトリーが存在しない場合は、WASPreUpgrade コマンド・スクリプトが作成します。

currentWebSphereDirectory
これは必須パラメータであり、指定する2番目のパラメータでなければならない。 これは、マイグレーションがサポートされている WebSphere Application Server バージョン 7.0 以降 の任意のエディションにすることができます。

この currentWebSphereDirectory 値には、ソース・インストールのインストール・ルート・ディレクトリの名前を指定します。 WebSphere Application Server インストールのルート・ディレクトリの名前を指定します。

-プロパティー
これはオプション・パラメーターです。 properties_file_name 値は、 WASPreUpgrade などのマイグレーション・ツールがどのように動作するのかを定義するパラメーター・プロパティーを含むプロパティー・ファイルへのパスを指定します。

コマンド行でほとんどのオプション・パラメーターを指定する代わりに、マイグレーション・プロパティー・ファイルにパラメーター・プロパティーを定義できます。 パラメーターがプロパティー・ファイルとコマンド行の両方で指定されている場合、コマンド行で指定されたパラメーターが優先されます。

注: -properties パラメーター自体や -username および -passwordなど、特定のパラメーターをプロパティー・ファイルに指定することはできません。 プロパティーとして定義できないパラメーターのリストについては、 app_server_root/bin ディレクトリー内のテンプレート migration.properties ファイルを参照してください。
-traceString
これはオプション・パラメーターです。 値 trace_spec は、 収集するトレース情報を指定します。

すべてのトレース情報を収集するには、 "*=all=enabled" (引用符を付けて) を指定します。

-traceString または -traceFile パラメーターを指定しないと、 コマンドはデフォルトでトレース・ファイルを作成し、そのファイルを backupDirectory/logs ディレクトリーに配置します。

-traceFile
これはオプション・パラメーターです。 値 file_name は、 トレース情報の出力ファイルの名前を指定します。

-traceString または -traceFile パラメーターを指定しないと、 コマンドはデフォルトでトレース・ファイルを作成し、そのファイルを backupDirectory/logs ディレクトリーに配置します。

-machineChange
これは、オペレーティング・システムおよびマシンの境界をまたいだマイグレーションに使用されるオプション・パラメーターです。 true に指定すると、このパラメーターは、 WebSphere Application Server インストール済み環境またはプロファイル・フォルダー階層の外部に保管されている項目をバックアップすることによって、マイグレーション時に物理ハードウェアを変更するためのサポートを提供します。 false に指定すると、 WebSphere Application Server インストール・フォルダーまたはプロファイル・フォルダーの下に保管されているファイルのみが、マイグレーション時にバックアップ・ディレクトリーにコピーされます。

デフォルトは false です。

この値が false の場合、マイグレーションでは、新旧の WebSphere Application Server インストール済み環境が、ファイル・システムへの共有アクセス権限を持つ同じ物理マシン上にあると想定されます。 したがって、WebSphere ディレクトリーの外部にあるファイルは、共有ファイルであり、共有することができます。 。 WebSphere Application Server-machineChange が false の場合、ツリー外のファイルをバックアップディレクトリにコピーしません。 マイグレーション・ウィザードを使用する場合には、false しか指定できません。 -machineChange=false を選択した場合、同じ物理ハードウェアで WASPostUpgrade コマンドを実行する必要があります。

別のマシンまたはファイル・システムで WASPostUpgrade コマンドを実行する予定の場合には、-machineChange=true を指定して WASPreUpgrade コマンドを実行する必要があります。 -machineChange=true, マイグレーションを選択すると、マイグレーションバックアップディレクトリに追加のサブディレクトリ (/migrated/) が作成されます。 WebSphere Application Server を作成します。 WASPostUpgrade コマンドを実行すると、これらのファイルは、新規マシン上の元のパスに戻されます。

パフォーマンスの考慮事項:

ファイル・システム (ファイル・ストア) リポジトリーを指定して構成されたサービス統合バス (SIB)・バスを使用してマイグレーションを行う場合、マイグレーション・ヒープおよびマイグレーション・バックアップ・ディレクトリーに追加スペースが必要になることがあります。 それぞれのバスには、ログ、一時スペース、およびリポジトリーの 3 つのファイル・ストア値があります。 これら 3 つのファイルのサイズは異なりますが、それぞれの大きさは 100 MB から 500 MB までです。 マイグレーションが実行されると、アップグレード前プロセス中に WebSphere Application Server ツリー内にあるすべてのファイル・ストアがバックアップされます。 そのため、ファイル・システムに十分なスペースが必要です。 事後アップグレード・プロセス時に宛先ロケーションに既にファイル・ストアがある場合、マイグレーションにより、ロールバックをサポートするためにメモリー内のファイル・ストアのバックアップが取られます。

-machineChange=true を指定して WASPreUpgrade コマンドを実行し、共有ファイル・ストア・オブジェクトを含むバックアップ・ディレクトリーが生成されると、事後アップグレード・プロセスでメモリー不足例外が発生することがあります。これは、デフォルトの最大ヒープが小さすぎて、ロールバックをサポートするためのファイル・ストアのバックアップが収まらないことが原因です。 この問題を解決するには、以下の 3 つの作業のいずれかを実行してください。
  • システム・ロケーションにあるファイル・ストアが有効な場合、WASPostUpgrade コマンドを実行する前にバックアップ・ディレクトリーからファイル・ストアのコピーを削除します。

    WASPostUpgrade コマンドを実行する前に、移行バックアップ・ディレクトリから /migrated/ サブディレクトリ全体を削除することで、実質的にアップグレード前のバックアップを -machineChange=true から -machineChange=false に変換する。

  • バックアップ・ディレクトリーにあるファイル・ストアのコピーが有効な場合、宛先ロケーションにあるファイル・ストアを削除します。

    これによってロールバック・サポートが変更され、宛先ファイルが存在しなくなり、マイグレーション時にメモリー内のスペースを占有しなくなります。

  • ロールバック・サポートが必要であり、バックアップ・ディレクトリー内のファイルとファイル・システム内のファイルの両方が必要な場合は、事後アップグレード・プロセスの最大ヒープ・サイズの値を増やして、競合するすべての SIB ファイルをサポートできる大きさにします。
-oldProfile
これは、 WebSphere Application Serverの前のバージョンから特定のインスタンスまたはプロファイルをマイグレーションするために使用されるオプション・パラメーターです。
-workspaceRoot
これはオプション・パラメーターです。 値 user_workspace_folder_name_x は、1 つ以上のプロファイルに対して管理コンソールでカスタマイズした「マイ・タスク」設定のロケーションを指定します。
-username
これはオプション・パラメーターです。 値 user name は、現在の WebSphere Application Server インストール済み環境の管理ユーザー名を指定します。
以下の条件が該当する場合、これは必須パラメーターです。
  • デプロイメント・マネージャーをマイグレーションしている。
  • ソース・インストールで管理セキュリティーまたはグローバル・セキュリティーが有効である。
  • マイグレーション元の WebSphere Application Server インストール済み環境がバージョン 8.0 以降である。
-password
これはオプション・パラメーターです。 値 password は、現在の WebSphere Application Server インストール済み環境の管理パスワードを指定します。
以下の条件が該当する場合、これは必須パラメーターです。
  • デプロイメント・マネージャーをマイグレーションしている。
  • ソース・インストールで管理セキュリティーまたはグローバル・セキュリティーが有効である。
  • マイグレーション元の WebSphere Application Server インストール済み環境がバージョン 8.0 以降である。
-javaoption
これはオプション・パラメーターです。 このパラメーターを使用して、 WASPreUpgrade コマンドによって使用される Java™ ヒープのメモリー・サイズを指定します。

値「-Xms...m」は、開始ヒープ・サイズを示すために指定するパラメーターです。 「...」を置き換えます。 使用する予定のサイズ (メガバイト単位) を指定します。 例えば、初期ヒープ・サイズを 128 MB にする場合には、このパラメーターに -javaoption -Xms128m と指定します。

値「-Xmx...m」は、最大ヒープ・サイズを示すために指定するパラメーターです。 「...」を置き換えます。 使用するサイズ (メガバイト単位) を指定します。 例えば、最大ヒープ・サイズを 1024 MB にする場合には、このパラメーターに -javaoption -Xmx1024m と指定します。

-requireEmbeddedDBMigration
これは、組み込みデータベースをマイグレーションするためのオプション・パラメーターです。

値が true として指定された場合は、組み込みデータベースのマイグレーション時に発生するすべての例外で、WASPreUpgrade コマンドが失敗します。 値が false として指定された場合は、組み込みデータベースのマイグレーション時に発生するすべての例外がトレース・ファイルに記録され、WASPreUpgrade コマンドは続行されます。

デフォルト値は true です。

-keepDmgrEnabled
これは、デプロイメント・マネージャー・プロファイルのマイグレーションに使用されるオプション・パラメーターです。

WASPreUpgrade が実行されると、デプロイメント・マネージャー・プロファイルは停止されます。 デフォルトでは、デプロイメント・マネージャーは停止されたままになります。 値を true に設定すると、WASPreUpgrade は、コマンドの実行が終了する前にデプロイメント・マネージャーを開始します。

デフォルト値は false です。

[9.0.5.11 以降]-allowSameRelease
[9.0.5.11 以降]このパラメーターはオプションです。 このパラメーターを trueに設定すると、 WebSphere Application Server バージョン 9.0 プロファイルを、ある WebSphere Application Server バージョン 9.0 インストール済み環境から別のインストール済み環境に (別のマシン上のインストール済み環境にも) マイグレーションすることができます。 -allowSameRelease パラメーターが trueに設定されている場合、 WASPostUpgrade コマンドの -clone パラメーターを trueに設定する必要があります。

ロギング

WASPreUpgrade ツールは、 実行中に画面に状況を表示します。 また、このツールは広範囲にわたるロギング情報のセットを、 backupDirectory ディレクトリーに作成された WASPreUpgrade.time_stamp.log ファイルに保存します。 ここで、backupDirectory は、backupDirectory パラメーターに指定された値です。 テキスト・エディターを使用して、WASPreUpgrade.time_stamp.log ファイルを 表示することができます。

マイグレーション済みリソース

WASPreUpgrade は、 すべてのリソースを保存しますが、classes ディレクトリー内のエンティティーはマイグレーションしません。

マイグレーションにより、 以下のファイルが backupDirectory ディレクトリーに保存されます。
  • classes
  • config
  • properties