7.4.1 定義ディレクトリの取り込み・内容変更・取り出し・内容比較
定義ディレクトリを新規に管理ユニットへ取り込んだり,更新した定義ディレクトリで管理ユニットにあるファイルの内容を更新したり,管理ユニットから取り出したりします。また,管理ユニットに登録済みの定義ディレクトリと内容を比較します。
- 注意事項
-
09-00より前のディレクトリ構成で作成した定義ディレクトリを管理ユニットに取り込んでいる場合,そのまま移行すると,その管理ユニットは操作できません。次の手順で09-00以降に移行してください。
-
移行する前に,管理ユニットから定義ディレクトリを取り出します。
-
取り出した定義ディレクトリはディレクトリ構成を変更します。
-
製品を移行します。
-
手順2.で構成を変更した定義ディレクトリを管理ユニットへ取り込みます。
-
- 〈この項の構成〉
(1) 管理ユニットへの定義ディレクトリの取り込み
アプリケーションサーバの定義ファイルとアプリケーションを定義ディレクトリにまとめて,管理ユニットに取り込む機能です。定義ディレクトリは,管理ユニットに属する仮想サーバ上にアプリケーションサーバを構築するための基となるファイル群です。この定義ディレクトリを新規に作成した管理ユニットに登録するときに使用します。
-
実行方法
- 実行できるユーザ
-
・仮想サーバマネージャ管理者アカウントを持つユーザ
・システム構築者アカウントを持つユーザ
- 実行するコマンドまたは呼び出し元の機能
-
vmiunitコマンドのサブコマンド「import」を実行します。
-
実行結果
指定した定義ディレクトリは,ディレクトリの構成やファイルの内容がチェックされて,問題がない場合は管理ユニットへ取り込まれます。問題がある場合はエラーとなります。
(2) 登録済みの定義ディレクトリの内容変更
管理ユニットに登録済みの定義ディレクトリの内容を変更する機能です。仮想サーバ上のアプリケーションサーバでアプリケーションを入れ替えたり,環境設定を変更したりするために,管理ユニットに登録済みのアプリケーションや定義ファイルの内容を更新した定義ディレクトリで変更するときに使用します。
-
実行方法
- 実行できるユーザ
-
・仮想サーバマネージャ管理者アカウントを持つユーザ
・システム構築者アカウントを持つユーザ
- 実行するコマンドまたは呼び出し元の機能
-
vmiunitコマンドのサブコマンド「import」を実行します。
-
実行結果
指定した定義ディレクトリは,ディレクトリの構成やファイルの内容をチェックされて,問題がない場合は管理ユニットに登録済みの定義ディレクトリが更新(上書き)されます。複数のティアを管理する管理ユニットの場合に,一部のティア別定義ディレクトリを更新すると,そのティアの定義ディレクトリだけが更新(上書き)されます。なお,ティアの構成が異なる場合は,エラーとなります。
-
注意事項
-
管理ユニットが管理するティアの構成は変更できません。ティアの構成を変更する場合は,管理ユニットを削除してから作成し直してください。
-
ティアに割り当てる仮想サーバの構成は変更できません。ctm-tierなどで仮想サーバの構成を変更する場合は,管理ユニットを削除してから作成し直してください。
-
(3) 管理ユニットからの定義ディレクトリの取り出し
管理ユニットに登録されている定義ディレクトリ(アプリケーションサーバの定義ファイルとアプリケーション)を取得する機能です。定義ディレクトリの内容を複製するときや,ほかの環境で管理ユニットを作成する際に定義ファイルやアプリケーションを流用するときに使用します。
-
実行方法
- 実行できるユーザ
-
・仮想サーバマネージャ管理者アカウントを持つユーザ
・システム構築者アカウントを持つユーザ
- 実行するコマンドまたは呼び出し元の機能
-
vmiunitコマンドのサブコマンド「export」を実行します。
-
実行結果
指定した管理ユニットに登録されている定義ディレクトリが,出力先ディレクトリにコピーされます。
(4) 登録済みの定義ディレクトリとの内容比較
管理ユニットに登録済みの定義ディレクトリと内容を比較する機能です。管理ユニットに登録されている定義ディレクトリが最新のものかどうかを確認するときに使用します。または,作成した管理ユニットに意図した定義ディレクトリが取り込まれているかどうかや,構築済みの仮想サーバに更新した定義ディレクトリのファイルを反映するとどのような影響があるかを把握したいときに使用します。
-
実行方法
- 実行できるユーザ
-
・仮想サーバマネージャ管理者アカウントを持つユーザ
・システム構築者アカウントを持つユーザ
- 実行するコマンドまたは呼び出し元の機能
-
vmiunitコマンドのサブコマンド「compare」を実行します。
-
実行結果
管理ユニットに登録済みの定義ディレクトリと,指定した定義ディレクトリが,次の条件で比較され,比較結果が取得されます。管理ユニットで複数のティアを管理している場合は,ティア別定義ディレクトリごとに比較結果が取得されます。
-
どちらのディレクトリにもファイル※があるか
-
ファイルの内容が同じか
- 注※
-
ファイル名が大文字,小文字で異なっているだけの場合は,同じファイルとして見なされます。
また,比較結果から,指定した定義ディレクトリを管理ユニットに取り込んで仮想サーバへ反映した場合に,構築済みのアプリケーションサーバの定義がどの範囲まで変更されるかが取得されます。変更範囲の意味を次の表に示します。
表7‒2 変更範囲の意味 変更範囲
意味
all
仮想サーバ上のアプリケーションサーバの定義全体が更新されます。アプリケーションサーバは再構築されます。
application
仮想サーバ上のアプリケーションサーバのアプリケーションだけが更新されます。アプリケーションサーバは再構築されません。
meta
仮想サーバマネージャ上の管理ユニットに関する設定が更新されます。仮想サーバ上のアプリケーションサーバは更新されません。
none
定義ディレクトリは更新されません。仮想サーバマネージャ上の管理ユニットと仮想サーバ上のアプリケーションサーバは更新されません。
mismatch
登録済みの定義ディレクトリとティア識別子が一致しないため,定義ディレクトリは更新されません。
-