Hitachi

Hitachi IT System Configuration Manager リファレンス

csdmideploy（マスターイメージのデプロイ）

〈このページの構成〉

形式

csdmideploy {-i マスターイメージID|-n マスターイメージ[.セクション]} [-k パスワードアクセスキー] [-r] [-c]

ページの先頭へ

機能

指定したマスターイメージに属する仮想ホストのデプロイ，および仮想ホストにインストールされているミドルウェアのセットアップを行い，業務システムを構築します。

定義パラメータ変更対象のミドルウェアがCosminexusの場合，定義パラメータを変更する際に，Cosminexusに反映されているリソースアダプタや業務アプリケーションのバックアップ／リストアを実施し，変更前のリソースアダプタや業務アプリケーションを引き継ぎます。

このコマンドを実行可能な業務システムのstatusについては，「表1-5　業務システムのStatusと実行可能な運用コマンドの関係(1/2)」，および「表1-6　業務システムのStatusと実行可能な運用コマンドの関係(2/2)」を参照してください。

ページの先頭へ

実行可能ユーザ

PaaS提供者，PaaS利用者が実行できます。

ページの先頭へ

オプション

-i

マスターイメージIDを指定します。

マスターイメージID：<符号なし整数>1〜99999999の範囲

-n

マスターイメージ名を指定します。セクションを定義している場合には同時に指定してください。

マスターイメージ名：〜<英数字記号>1〜32文字

セクション：〜<英数字記号>1〜32文字

-k

csdmisetpasswordコマンドで指定したパスワードアクセスキーを指定します。

仮想ホストのパスワードを，コンポーネントテンプレートファイルに記載済みの初期パスワードからcsdmisetpasswordコマンドで変更した場合に指定してください。仮想ホストにアクセスする際に，csdmisetpasswordコマンドで登録したパスワードを復号するために必要となります。

同一業務システム内では同一の値を指定してください。

パスワードアクセスキー：<英数字と#-@()>1〜255文字

-r

Cosminexusセットアップ時に，セットアップ対象の仮想サーバグループがすでに管理ユニットに登録されている場合，自動的に仮想サーバグループを管理ユニットから削除します。

仮想ホスト上のミドルウェアがCosminexus以外の場合はこのオプションを指定していても無視します。

-c

仮想ホスト上のCosminexusの定義反映を行う際に，リソースアダプタや業務アプリケーションのバックアップ／リストアを抑止します。

-cオプションを指定した場合，仮想ホスト上のCosminexusの定義がISCMに登録されたCosminexusの定義で上書きされるため，仮想ホスト上のリソースアダプタや業務アプリケーションの再構築が必要になります。

仮想ホスト上のミドルウェアがCosminexus以外の場合はこのオプションを指定していても無視します。

ページの先頭へ

戻り値

値

意味

0

正常終了しました。

0以外

異常終了しました。

ページの先頭へ

実行例

C:\Program Files\Hitachi\uCSD\mgr\bin>csdmideploy -n mi01
KFUD15054-I 業務システムの構築を受け付けました。マスターイメージID=3

ページの先頭へ

注意事項

  1. このコマンドは非同期で実行されるため，このコマンドの実行状態はcsdmilsコマンドで業務システムstatusを確認してください。業務システムstatusは，「表1-36　業務システムのStatus一覧」を参照してください。

    また，このコマンドの完了状態を確認する場合は，メッセージログを参照してください。

    メッセージログの詳細については，マニュアル「Hitachi IT System Configuration Manager メッセージ」を参照してください。

    ＜メッセージログ例＞

    [図データ]

  2. 一時ディレクトリ作成

    このコマンド実行時に，仮想ホストに作業用の一時ディレクトリを作成します。

    ディレクトリ構成は次のようになります。

    表1‒55　作業用の一時ディレクトリの構成

    ディレクトリ名/ファイル名

    説明

    /tmp/※1，※6

    csd_tmp/

    def/

    定義格納ディレクトリ/※2

    OS・ミドルウェア定義兼用の格納ディレクトリ

    patch/

    パッチファイルディレクトリ/※2

    OS・ミドルパッチ兼用の格納ディレクトリ

    setup/

    セットアップスクリプトディレクトリ/※2

    ミドルセットアップスクリプト用の格納ディレクトリ

    jp1im-agt/

    JP1/IM連携機能用格納ディレクトリ/

    JP1/IM連携機能で使用する格納ディレクトリ

    ミドルセットアップUOCで転送を行います。

    csd_backup/※3

    application/

    app<通番>.ear

    業務アプリケーションのバックアップファイル<通番>は「0，左3桁詰め」の値(001〜)

    backup_list.txt

    バックアップファイルとアプリケーション名の対応情報ファイル

    resource_adapter/

    res<通番>.rar

    リソースアダプタのバックアップファイル<通番>は「0，左3桁詰め」の値(001〜)

    backup_list.txt

    バックアップファイルとリソースアダプタ名の対応情報ファイル

    Linuxの場合：csd_hosts_copy.sh

    Windowsの場合：csd_hosts_copy.bat

    Linuxの場合：hostsコピー用シェルスクリプト

    Windowsの場合：hostsコピー用バッチファイル

    Windowsの場合：%SystemRoot%\hitachi\CMALib\uCSD\※4，※5

    リモートホスト操作（ファイル転送やコマンド実行）で使用する一時ディレクトリ
    注

    Linuxの場合のディレクトリ構成です。Windowsの場合は，パス区切り文字を"\"に読み替えてください。

    注※1

    定義deploy.remote.tmppath（Windowsの場合はdeploy.remote.tmppath.win）によって変更できます。なお，Windowsの場合は，"%SystemRoot%\Temp\"です。

    注※2

    コンポーネントテンプレートファイル，またはマスターイメージ定義ファイルで指定したディレクトリ

    注※3

    uCosminexus Application Serverに反映されているリソースアダプタや業務アプリケーションのバックアップファイルを格納するディレクトリです。

    次の条件を満たす場合に作成します。

    ・対象の仮想ホストでCosminexusを使用する

    ・csdmideployコマンドに-cオプションを指定しないで実行する

    ・対象仮想ホストのuCosminexus Application Serverにリソースアダプタまたは業務アプリケーションが反映済み

    注※4

    ミドルセットアップUOCで次のメソッドを実行する場合，対象のリモートホスト上に一時ディレクトリを作成します。

    ・IRemoteHostConnectorクラスのputFile()メソッド

    ・IRemoteHostConnectorクラスのgetFile()メソッド

    ・IRemoteHostConnectorクラスのexecCommand()メソッド

    注※5

    一時ディレクトリ下にファイルおよびディレクトリを作成しないでください。作成した場合，ISCM処理が失敗することがあります。

    注※6

    OSがLinux，かつOSが初期設定の場合，cronデーモンが実行するスクリプトによって，/tmp配下に格納されている一定期間アクセスがないファイルが自動的に削除されます。

    トラブルシュートのため，コマンドがエラー終了した場合は，一時ディレクトリが削除される前にバックアップを取得してください。

    • 定義deploy.remote.tmppathまたはdeploy.remote.tmppath.winで指定したディレクトリ下にISCMは作業ディレクトリ”csd_tmp”を作成します。作業ディレクトリと同一名称のファイル，ディレクトリを作成しないでください。また，deploy.remote.tmppath.win配下にはファイル名が”csd_”からはじまるファイルまたはディレクトリを作成しないでください。作成した場合，ISCMによって削除されます。ISCMによって削除できなかった場合にはISCM処理が失敗します。

    • ISCM処理中にエラーとなった場合，定義deploy.remote.tmppathまたはdeploy.remote.tmppath.winで指定したディレクトリ下に作業ディレクトリが残ることがあります。次にcsdmideployコマンドまたはcsdmiupdateコマンドを入力したときに，ISCMが作業ディレクトリを削除してコマンド処理を続行します。該当業務システムが処理中の場合は，作業ディレクトリを削除しないでください。該当業務システムが処理中かどうかは，csdmilsコマンドを実行して調べることができます。

  3. Cosminexusを含む業務システムデプロイ時の注意事項

    Cosminexusを含む業務システムに対してcsdmideployコマンドを実行した際に，ISCMに仮想サーバマネージャ管理者アカウントが未登録の場合，「表1-56　デプロイ処理の流れ」のVMデプロイの前にKFUD25082-Eメッセージを出力し，コマンドがエラー終了します。エラー終了した場合の対策については，マニュアル「Hitachi IT System Configuration Manager メッセージ」の「KFUD25082-E」に記載の対処を参照してください。

デプロイ処理の流れを次に示します。

表1‒56　デプロイ処理の流れ

カテゴリ

処理実行順※3

機能

ISCMの動作

実行条件

補足

デプロイ

1

VMデプロイ

−

−

−

ハイパーバイザ種別がVMwareで，かつ，デプロイ対象の仮想ホストに複数のNICが存在する場合，そのうちのどれか1つのIPアドレスがhostsファイル※4に記載されます。

どのNICのIPアドレスが記載されるかは不定です。

ハイパーバイザ種別がHVMの場合は，hostsファイルの更新は行いません。

仮想ホストデプロイを行うテンプレートを基に生成された仮想ホストだけ実施します。

OS更新

2

OS定義転送

OS定義転送

コンポーネントテンプレートで記載しているOS定義を転送先ディレクトリ※1配下へ転送

OS更新パッチで未適用のパッチが1つ以上存在する場合

OS更新パッチ適用だけを実施したい場合でも定義は必ず転送します。

3

OS更新

（OS更新パッチ）

（ファイルセット転送，OS更新用パッチ実行）

OS定義配置

転送済みOS定義をディレクトリへコピー

−

4

OS更新パッチ適用

OS更新用パッチを実行

−

hosts

5

hostsファイル転送

hostsファイルのバックアップ

詳細は「2.3.11　hosts_templateファイル」を参照してください。

−

−

hostsファイルの作成

−

−

hostsファイルの転送

−

−

ミドルセットアップ

6

ミドル定義転送

ミドル定義転送※2

コンポーネントテンプレートで記載しているミドルウェア定義を転送先ディレクトリ※1配下へ転送

ミドルウェアのステータスが“notsetup”，“failed(setup)”，“failed(update)”の場合

−

7

ミドルセットアップ

ミドル定義配置※2

転送済みミドル定義をディレクトリへコピー

−

8

ミドルセットアップ

ミドルセットアップスクリプトを実行

−

ミドル更新

9

ミドル定義転送

ミドル定義転送※2

転送先ディレクトリ※1配下へミドルウェア定義ファイルを転送

ミドル更新パッチで未適用のパッチが1つ以上存在する場合

ミドル更新パッチ適用だけを実施したい場合でも定義は必ず転送します。

10

ミドル更新（ミドル更新パッチ）

（ファイルセット転送，ミドル更新用パッチ実行）

ミドル定義配置※2

転送済みミドル定義をディレクトリへコピー

−

11

ミドル更新パッチ適用

ミドル更新用パッチを実行

−

ミドルセットアップUOC

12

デプロイ時に実行されるミドルセットアップUOC

デプロイ時に実行されるミドルセットアップUOCを実行

−

ミドルセットアップUOCが定義されている場合

−
注※1　定義“deploy.remote.tmppath.win”で示したディレクトリパス

ミドルウェアがCosminexus時のミドル定義転送（#6，#9）は仮想サーバマネージャで決められたディレクトリパスへ仮想サーバマネージャによって転送されます。

注※2　対象のミドルウェアがCosminexusの場合には，仮想サーバマネージャで定義の転送および配置を行います。

注※3　複数のホストに対してデプロイ処理を行う場合は，次の処理が完了するタイミングで処理の待ち合わせを行います。

  • カテゴリ：hosts　処理実行順：5

  • カテゴリ：ミドル更新　処理実行順：11

注※4　仮想ホストを構築するための仮想イメージテンプレートに付随するhostsファイル（Linuxの場合：/etc/hosts，Windowsの場合：%SystemRoot%\System32\drivers\etc\hosts）を指します。

  1. デプロイおよび仮想サーバセットアップ時の注意事項

    • csdmideployコマンド実行によって作成される仮想サーバマネージャの管理ユニット名は「”u”+マスターイメージID（0，左8桁詰め）+コンポーネントID（0，左5桁詰め）」というルールで作成されます。※

      例：マスターイメージIDが111でコンポーネントIDが11の仮想ホストをデプロイする場合で作成する管理ユニット名は「u0000011100011」となります。

      注※　http-tier + j2ee-tier構成の場合は，http-tierのコンポーネントIDが使用されます。

    • ミドルセットアップスクリプト，パッチスクリプトなどのシェルスクリプトには応答待ちとなるようなコマンド形式を記述することはできません。ただし，mvコマンドの場合，-fオプションを付けて応答待ちにならないコマンド形式であれば記述できます。

    • hostsファイル作成を行うデプロイを実行した場合の実行結果確認方法は，「2.3.11　hosts_templateファイル」を参照してください。

  2. 仮想サーバマネージャで配布するファイル構成

    仮想サーバマネージャが配布用に必要とするアプリケーションサーバの定義ディレクトリ構成の一部を次に示します。定義ディレクトリ構成の詳細はCosiminexusのマニュアルを参照してください。

    PaaS提供者は，このファイル構成を作ってコンポーネントテンプレートに登録します。

    <定義ディレクトリ>

      ├vmi
  │ ├tier.properties※1
  │ └tierlb.properties※2
  ├hook
  │ └pre-setup
  │

    注※1　LBを使用する場合は，このファイル中に「lb.use = :unit:」を指定する必要があります。

    注※2　ISCMのミドルウェア定義ファイル生成で作成されるファイルです。このファイルをPaaS提供者が配置した場合，ミドルウェア定義ファイル生成時にISCMが上書きします。

ページの先頭へ

商品名称に関する表示

All Rights Reserved. Copyright (C) 2014, 2016, Hitachi, Ltd.