機能説明
本コマンドは、管理対象サーバのIPMI情報をCMDBにインポートします。入力ファイルの形式は、CSV形式です。
IPMI情報のエクスポートコマンドと組み合わせて利用することにより、登録済みのIPMI情報をCMDBから取り出して編集し、再度インポートするという方法で、IPMI情報を更新/追加できます。
記述形式
swrba_ipmiimport -f 入力ファイル名 [-e 入力ファイルの文字コード] |
オプション
登録対象である、サーバのIPMI情報が記述された入力ファイル(CSV形式)を指定します。
以下に、入力ファイルの例を示します。
"192.168.0.1","192.168.1.1","user001","xe3539caeb" "192.168.0.2","192.168.1.2","user002","ex3535akft" "192.168.0.3","192.168.1.3","user001","xe359jsg35" "192.168.0.4","192.168.1.4","user002","djh847wag4" |
以下に、CSV形式の仕様を示します。
カンマ(,)でカラムを区切ります。
カラムデータに改行文字を入れることはできません。
以下に、CSV形式のカラム位置を示します。
1カラム目 | 2カラム目 | 3カラム目 | 4カラム目 | |
|---|---|---|---|---|
項目 | サーバのIPアドレス | IPMIのIPアドレス | ユーザー | パスワード |
指定例 | "192.168.0.1" | "192.168.1.1" | "user001" | "xe3539caeb" |
以下に、各カラムの定義規約を示します。
カラム | 項目 | 省略 | 省略値 | 入力内容 | チェック内容 | 条件 |
|---|---|---|---|---|---|---|
1 | IPアドレス | 不可 | － | サーバのIPアドレスを指定します。 | 入力文字数 | 1～255文字 |
文字種 | ・半角英文字(大文字／小文字の区別あり)、半角数字、半角記号 | |||||
内容 | 指定されたIPアドレスのLogicalServer-CIがCMDBに登録されていない場合は、エラー | |||||
2 | IPアドレス | 不可 | － | IPMIのIPアドレスを指定します。 | 入力文字数 | 1～255文字 |
文字種 | ・半角英文字(大文字／小文字の区別あり)、半角数字 | |||||
3 | ユーザー | 不可 | － | 認証先に対するユーザーアカウントを指定します。 | 入力文字数 | 1～255文字 |
文字種 | ・半角文字・全角文字が可能 ・空白は不可 | |||||
一意性 | 当該サーバにおいて、同じユーザーを複数登録することは不可 | |||||
4 | パスワード | 可 | － | ユーザーに対応するパスワード文字列を指定します。 パスワード文字列を省略した場合、以下の動作となります。
| 入力文字数 | 1～255文字 |
ポイント
入力ファイルに記述したIPMI情報にエラーがあった場合、エラーのあったIPMI情報だけがインポートに失敗します。その他のIPMI情報はインポートされます。
構成情報を自動収集した場合、IPv6環境のLogicalServer-CIのIPアドレスは、RFC 5952表記で格納されます。この場合、入力ファイルに指定するIPアドレスも、同様にRFC 5952表記で記載してください。その他の場合は、CMDBに登録されている表記と同じ表記で記載してください。
構成情報の自動収集については、“Systemwalker Runbook Automation 導入ガイド”の“構成情報を自動収集するための設定”を参照してください。
入力ファイルの文字コードを指定します。以下の文字コードが指定できます。
UTF-8
SJIS
EUC
本オプションを省略した場合は、入力ファイルの文字コードは以下のコードになります。
【Windows】
SJIS
【Linux】
環境変数LANGに指定された文字コード。環境変数LANGが設定されていない場合、認識できない文字コードの場合は、UTF-8になります。
復帰値
正常終了
警告終了
インポートに失敗したIPMI情報が存在する
パラメーターエラー
1、2以外のエラー
エラー内容の通知
インポートする情報にエラーがある場合は、標準エラー出力にエラー内容を通知します。
インポートに失敗したIPMI情報は、標準エラー出力に出力されたエラー情報を参考に入力データを修正し、再度本コマンドでインポートしてください。
例）複数の行にエラーがある場合は、複数行で通知します。
> swrba_ipmiimport -f importcsv.txt Error: IPMI情報の登録に失敗しました。 Detail=登録先のLogicalServer[192.168.0.1]が見つかりません。 Error: IPMI情報の登録に失敗しました。 Detail=登録先のLogicalServer[192.168.0.2]が見つかりません。 IPMI情報の登録に成功しました。 LogicalServer=192.168.0.3 IPAddress=192.168.1.3 User=user001 IPMI情報の登録に成功しました。 LogicalServer=192.168.0.4 IPAddress=192.168.1.4 User=user002 全てもしくは一部の処理の実行に失敗しました。 |
コマンド格納場所
【Windows】
[Systemwalker Runbook Automation管理サーバのインストールディレクトリ]\bin |
【Linux】
/opt/FJSVswrbam/bin |
実行に必要な権限/実行環境
【Windows】
Administrator権限が必要です。ご利用OSがWindows Server 2008以降の場合は、管理者として実行してください。
管理サーバで実行可能です。
【Linux】
システム管理者(スーパーユーザー)の権限が必要です。
管理サーバで実行可能です。
注意事項
IPMI情報は、インポートする入力ファイルの情報が、常に有効になります。
インポートするIPMI情報がすでにCMDB上に登録されている場合、本コマンドは、入力ファイルに記述されたIPMI情報でCMDB上に登録されているIPMI情報を置き換えます。
swrba_ipmiexport/ swrba_ipmiimportは、同時に1つのみ動作可能です。このため、すでにコマンドが実行中の場合、エラーになります。
Systemwalker Runbook Automationを起動した状態で本コマンドを投入してください。
セットアップ(swrba_setup)が未完了の状態で本コマンドを利用した場合、以下のエラーで失敗します。
Exception in thread "main" java.lang.NoClassDefFoundError: com/fujitsu/swpm/tool/util/NativeToolUtil |
Systemwalker Runbook Automationが未起動の状態でコマンドを利用した場合、以下のエラーで失敗します。
Error: IPMI情報の登録に失敗しました。 Detail=com.ctc.wstx.exc.WstxUnexpectedCharException: Unexpected character '"' (code 34) in DOCTYPE declaration; expected a space between public and system identifiers at [row,col {unknown-source}]: [1,50] |
本コマンドに指定した文字コードと、入力ファイルに指定した文字コードが異なっていた場合の動作は保証しません。文字コードは一致させるようにしてください。
