3.16.10 データベースライブラリ

構成管理データベース(Configuration Management Data Base)は、以降CMDBと表記します。

CMDBに格納されている構成要素(Configuration Item)は、以降CIと表記します。

クラス名

Swrba_CMDB

メソッド一覧

メソッド	意味
String get_info(String searchxpath, String xpath, String hostname, String username, String password, String execusername, String execpassword, String ostype)	特定の構成要素を取得します。取得に成功した場合、構成要素をXML形式の文字列で出力します。取得に失敗した場合、例外を返します。
String set_info(String searchxpath, String xpath, String content, String hostname, String username, String password, String execusername, String execpassword, String ostype)	特定の構成要素を更新します。更新に成功した場合、"Success"を返します。更新に失敗した場合、例外を返します。
Integer return_code()	構成要素の取得・更新結果の復帰値を返します。

入力情報

searchxpath       特定の構成要素を取得・更新するための条件式を指定します。
xpath             特定の構成要素から属性情報を取得・更新するための条件式を指定します。
content           更新する内容を指定します。
hostname          構成要素を取得・更新依頼するホスト名もしくはIPアドレスを指定します。
username          構成要素を取得・更新依頼するホストへSSHを利用して接続するユーザー名を指定します。
                  ファイル転送基盤を利用して接続する場合は、接続ユーザー名は以下のようになり
                  変更できません。このため、ユーザー名を指定しても無効になります。
                  ・業務サーバがWindowsの場合: システムユーザー
                  ・業務サーバがLinuxの場合: root
password          構成要素を取得・更新依頼するホストへSSHを利用して接続するユーザーのパスワードを指定
                  します。
                  ファイル転送基盤を利用して接続する場合は、パスワードを指定しても無効になります。
execusername      構成要素を取得・更新するユーザー名を指定します。
                  hostnameに指定したホストがWindowsで、ファイル転送基盤を利用して接続する場合は、
                  システムユーザーで実行します。このため、ユーザー名を指定しても無効になります。
execpassword      本ライブラリではexecpasswordの値を使用しません。
                  execpasswordの値を指定した場合、無効となります。
ostype            構成要素を取得・更新依頼するホストのOS種別を指定します。
                  Windows、Linuxを指定します。

注意事項

本ライブラリは、hostnameに管理サーバ以外の情報を入力した場合、ファイル転送基盤またはSSHを利用して動作を実現しています。少なくともどちらか片方では通信可能となるように設定してください。各通信方法の注意事項については、“3.17 各通信方法の注意事項”を参照してください。
管理サーバ以外のサーバに存在する構成管理データベースに格納されている構成要素を取得・更新する場合、構成管理データベースが存在するサーバに作業用ファイルを格納するフォルダ(ディレクトリ)が必要となります。構成管理データベースが存在するサーバの環境変数“SWRBA_CMDB_WORK_HOME”に作業用ファイルを格納するフォルダ(ディレクトリ)のパスを指定してください。
各入力情報には、半角カナ文字および以下の記号は使用しないでください。半角カナ文字および以下の記号を使用すると、メソッドの実行に失敗する場合があります。
“～”、“￡”、“―”、“∥”、“￠”、“￢”、“￣”、“￥”、“〃”
業務サーバにRBAエージェントが未導入の場合は、searchxpathに日本語を指定すると操作結果は保証されません。日本語を指定する場合は業務サーバにRBAエージェントを導入してください。
管理サーバのインストールパスに空白文字を入力した場合、本ライブラリを利用した操作結果は保証されません。本ライブラリを利用して運用操作部品を作成する場合は、管理サーバのインストールパスに空白文字を含めないでください。

格納場所

Windows

<インストールパス>\SWRBAM\rbaope\bin\parts\lib\

standard\swrba_cmdb.rb

Linux

/opt/FJSVswrbam/rbaope//bin/parts/lib/standard/swrba_cmdb.rb

3.16.10 データベースライブラリ

3.16.10.1 構成管理データベース