機能説明
Systemwalker Software Configuration Managerが管理するサーバ情報を登録、更新、削除、および、一覧表示します。
ServerView Resource OrchestratorまたはOpenStackのサーバに対して、登録、更新、および、削除の操作を行うことはできません。
記述形式
【Windows】
swcfmg_server.exe |
【Linux】
swcfmg_server |
オプション
指定されたサーバ情報ファイルに記載された内容で、サーバ情報を登録します。
サーバ情報ファイルはCSV形式です。サーバ情報ファイルの詳細については、「2.2.5 サーバ情報ファイル」を参照してください。
指定されたサーバ情報ファイルに記載された内容で、サーバ情報を更新します。
サーバ情報ファイルはCSV形式です。サーバ情報ファイルの詳細については、「2.2.5 サーバ情報ファイル」を参照してください。
サーバIDまたはIPアドレスを指定し、登録済みのサーバを削除します。サーバIDまたはIPアドレスは‘,'(カンマ)で区切って複数指定できます。
本コマンド、およびswcfmg_define_serverinfo(管理対象サーバ情報定義コマンド)で登録されたサーバ情報をCSV形式で出力します。
-file “出力ファイルパス”が省略された場合、情報はコマンドの標準出力に出力されます。
指定したファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。
エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保証します。
下記オプションを指定することで、出力するサーバ情報を絞り込むことができます。指定しなかった場合、本コマンド、およびswcfmg_define_serverinfo(管理対象サーバ情報定義コマンド)で登録されたすべてのサーバ情報が出力されます。
出力するサーバのサーバ名を指定します。
出力するサーバのサーバグループIDを指定します。
出力するサーバのサイトIDを指定します。以下のサイトIDを指定することができます。-allを指定した場合、すべてのサイトのサーバ情報を出力します。
OpenStack : OpenStackのサーバ
ROR : ServerView Resource Orchestratorのサーバ
Direct : 手動登録のサーバ
下記のオプションを指定することで、出力フォーマットを指定することができます。
本オプションを省略した場合または-siteオプションを指定した場合、サーバ情報をCSV形式で出力します。出力ファイルの詳細については、本オプションを省略した場合は「2.2.5 サーバ情報ファイル」、-siteオプションを指定した場合は「2.4.2 サイトサーバ情報ファイル」を参照してください。-getserveridオプションを指定した場合、サーバのサーバIDのみを出力します。
ファイルの文字コードを指定します。
以下の文字コードが指定できます。半角英大文字で指定します。
【Windows】
SJIS
【Linux】
UTF-8
EUC
本オプションを省略した場合、本コマンドの実行環境の文字コードで動作します。
接続テストを実施します。本オプションを指定した場合、サーバ情報の登録、および、更新後に、接続テストを行います。本オプションを省略した場合、接続テストを行いません。接続テストについては、「1.2.11 swcfmg_connectiontest(接続テストコマンド)」を参照してください。
本オプションを指定した場合、 サーバ情報が“サーバグループID”で昇順に表示されます。"lplatform-id"は、旧オプションです。新規に利用する場合は、"servergroup-id"をご利用ください。
復帰値
復帰値 | 意味 |
---|---|
0 | 正常終了しました。 |
10 | パラメーター異常です。 |
20 | 指定された入出力ファイルパスのエラーです。 |
30 | 指定された文字コードに誤りがあります。 |
50 | ファイルの記述に誤りがあります。 |
70 | 指定されたIPアドレスは存在しません。 |
80 | 接続テストに失敗しました。 |
81 | ServerView Resource Orchestratorが管理するサーバグループ、または、サーバに対しては操作できません。 |
100 | Systemwalker Software Configuration Manager は起動していません。 |
101 | 同時実行できないコマンドが実行されています。 |
102 | コマンド実行権限がありません。 |
103 | ディレクトリサービスの接続に失敗しました。 |
110 | 書き込みエラーです。 |
200 | セットアップされていません。 |
255 | システムエラーです。 |
コマンド格納場所
管理サーバ
【Windows】
[Systemwalker Software Configuration Managerインストールディレクトリ]\SWCFMGM\bin |
【Linux】
/opt/FJSVcfmgm/bin |
実行に必要な権限/実行環境
【Windows】
Administrator権限が必要です。ご利用OSがWindows Server 2008以降の場合は、管理者として実行してください。
管理サーバで実行可能です。
【Linux】
システム管理者(スーパーユーザー)のみが実行できます。
管理サーバで実行可能です。
注意事項
本コマンドの登録・更新・削除は同時に実行する事はできません。コマンド実行中に他のコマンドを実行すると、排他エラーとなります。
Systemwalker Software Configuration Managerが起動した状態で本コマンドを実行してください。
ServerView Resource OrchestratorまたはOpenStackのサーバに対して、更新、および、削除の操作を行うことはできません。
サーバ情報は、サーバ情報ファイルに従って新規登録されます。
“IPアドレス”は、製品内で一意になるように指定してください。また、ServerView Resource OrchestratorまたはOpenStackと連携時は、ServerView Resource OrchestratorおよびOpenStackのサーバも含めて一意になるように指定してください。
ServerView Resource Orchestratorが管理するサーバグループにサーバを追加することはできません。
本コマンドに指定した文字コードと、サーバ情報ファイルに指定した文字コードが異なっていた場合の動作は保証しません。文字コードは一致させるようにしてください。
登録済のサーバ情報を修正する場合は、一覧表示したファイルを編集し、編集したファイルを更新の入力ファイルとすることお勧めします。
ServerView Resource OrchestratorまたはOpenStackのサーバに対して、更新を行うことはできません。
Systemwalker Software Configuration Managerで利用する必要がなくなったサーバ情報は、本コマンドを使用して情報を削除してください。
ServerView Resource OrchestratoまたはOpenStackのサーバを削除することはできません。
サーバ情報が登録されていない場合は、ヘッダー情報だけを出力します。
#ipaddress,server-name,servergroup-id,host-name,os-type,os-architecture,os-name |
ServerView Resource OrchestratorまたはOpenStackのサーバも含めて表示する場合は、-allオプションを指定してください。
サーバ情報ファイルに誤りがある場合は、サーバ情報の登録・更新を中止します。トレースログに以下のようなエラーメッセージを出力します。
CFMGC20005 ファイルの記述に誤りがあります。[行番号:n][原因:原因] |
[原因] には、以下のどれかが出力されます。
メッセージ | 意味 |
---|---|
Number of elements. | 該当行の要素の数を見直してください。 |
The specified elements are invalid. () | 該当行の“()”内の要素に不正な値が入力されています。正しい値を入力してください。入力できる値については、「2.2.5 サーバ情報ファイル」を参照してください。 |
The specified elements cannot be changed. () | 該当行の“()”内の要素は、変更できません。 |
Mandatory elements are not specified. | 該当行の必須項目を入力してください。 |
The same Server is specified in another line. | 該当行までに、同じIPアドレスが記載されています。 |
The specified Server group does not exist. | 該当行の“servergroup-id”に相当するサーバグループが存在しません。存在するサーバグループのサーバグループIDを指定してください。 |
The Server has already been registered. | 該当行のサーバ情報は、既に登録されています。 |
The specified server does not exist. | 該当行の“ipaddress”に相当するサーバ情報は存在しません。存在するサーバのIPアドレスを指定してください。 |
The Server cannot be operated. | 該当行のサーバ情報は、ServerView Resource OrchestratorまたはOpenStackのサーバです。本コマンドにより更新を行うことができません。 |
The Server cannot be added to the specified Server group. | 該当行の“servergroup-id”に相当するサーバグループは、ServerVIew Resource OrchestratorまたはOpenStackのサーバグループです。本コマンドで、このサーバグループにサーバを追加することはできません。 |
使用例
登録
【Windows】
swcfmg_server.exe -add -file C:\work\serverinfo.csv |
【Linux】
swcfmg_server -add -file /tmp/serverinfo.csv |
更新
【Windows】
swcfmg_server.exe -update -file C:\work\serverinfo.csv |
【Linux】
swcfmg_server -update -file /tmp/serverinfo.csv |
削除
【Windows】
swcfmg_server.exe -delete -ip 192.168.1.1,192.168.1.2 |
【Linux】
swcfmg_server -delete -ip 192.168.1.1,192.168.1.2 |
一覧表示
【Windows】
swcfmg_server.exe -list -file C:\work\serverinfo.csv |
【Linux】
swcfmg_server -list -file /tmp/serverinfo.csv |
実行結果/出力形式
一覧表示
標準出力
#ipaddress,server-name,servergroup-id,host-name,os-type,os-architecture,os-name 192.168.1.1,開発サーバ1,UB5IFK3AT@Direct,kaihatsu1,Windows,x64,Windows Server 2008 R2 192.168.1.2,開発サーバ2,YFEFI9P7Q@Direct,kaihatsu2,Windows,x64,Windows Server 2008 R2
ファイル出力
CFMGC30151 サーバ情報管理コマンドが正常に終了しました。
なお、出力したCSVファイルの先頭行には、以下のヘッダー情報が付加されます。
#ipaddress,server-name,servergroup-id,host-name,os-type,os-architecture,os-name