Systemwalker Software Configuration Manager リファレンスガイド

1.2.6 swcfmg_server（サーバ情報管理コマンド）

機能説明

Systemwalker Software Configuration Managerが管理するサーバ情報を登録、更新、削除、および、一覧表示します。

ServerView Resource Orchestratorが管理するサーバに対して、登録、更新、および、削除の操作を行うことはできません。

記述形式

【Windows】

swcfmg_server.exe
{ -add -file “サーバ情報ファイルのパス” [-e “文字コード”] [-t]   |
  -update -file “サーバ情報ファイルのパス” [-e “文字コード”] [-t]  |
  -delete -ip “IPアドレス”,…  |
  -list [ -file “出力ファイルパス”] [-e“文字コード”] [-sort lplatform-id] [-all] }

【Linux】

swcfmg_server
{ -add -file “サーバ情報ファイルのパス” [-e “文字コード”] [-t]   |
  -update -file “サーバ情報ファイルのパス” [-e “文字コード”] [-t]  |
  -delete -ip “IPアドレス”,…  |
  -list [ -file “出力ファイルパス”] [-e“文字コード”] [-sort lplatform-id] [-all] }

オプション

-add -file “サーバ情報ファイルのパス”

指定されたサーバ情報ファイルに記載された内容で、サーバ情報を登録します。

サーバ情報ファイルはCSV形式です。サーバ情報ファイルの詳細については、「2.2.5 サーバ情報ファイル」を参照してください。

-update -file “サーバ情報ファイルのパス”

指定されたサーバ情報ファイルに記載された内容で、サーバ情報を更新します。

サーバ情報ファイルはCSV形式です。サーバ情報ファイルの詳細については、「2.2.5 サーバ情報ファイル」を参照してください。

-delete -ip “IPアドレス”,・・・

IPアドレスを指定し、登録済みのサーバを削除します。IPアドレスは‘,'（カンマ）で区切って複数指定できます。

-list [-file “出力ファイルパス”]

本コマンド、および、swcfmg_define_serverinfo(管理対象サーバ情報定義コマンド)で登録されたサーバ情報をCSV形式で出力します。

-file “出力ファイルパス”が省略された場合、情報はコマンドの標準出力に出力されます。

指定したファイルが存在しない場合はファイルを新規作成し、存在する場合は既存のファイルへ上書きします。

エラーのため、ファイル出力できなかった場合、新規作成時は、新たなファイルは作成しません。既存ファイルへの上書きの場合は、既存ファイルを保証します。

出力ファイルの詳細については、「2.2.5 サーバ情報ファイル」を参照してください。

-e “文字コード”

ファイルの文字コードを指定します。

以下の文字コードが指定できます。半角英大文字で指定します。

【Windows】

• SJIS

【Linux】

• UTF-8

• EUC

本オプションを省略した場合、本コマンドの実行環境の文字コードで動作します。

-t

接続テストを実施します。本オプションを指定した場合、サーバ情報の登録、および、更新後に、接続テストを行います。本オプションを省略した場合、接続テストを行いません。接続テストについては、「1.2.8 swcfmg_connectiontest（接続テストコマンド）」を参照してください。

-all

本コマンド、および、swcfmg_define_serverinfo(管理対象サーバ情報定義コマンド)で登録されたサーバ情報だけではなく、ServerView Resource Orchestratorが管理するサーバ情報も含めて出力します。

-sort lplatform-id

本オプションを指定した場合、 サーバ情報が“L-Platform ID”で昇順に表示されます。

復帰値

復帰値	意味
0	正常終了しました。
10	パラメーター異常です。
20	指定された入出力ファイルパスのエラーです。
30	指定された文字コードに誤りがあります。
50	ファイルの記述に誤りがあります。
70	指定されたIPアドレスは存在しません。
80	接続テストに失敗しました。
81	ServerView Resource Orchestratorが管理するL-Platform、または、サーバに対しては操作できません。
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が管理するサーバに対して、更新、および、削除の操作を行うことはできません。

登録時の注意事項

• サーバ情報は、サーバ情報ファイルに従って新規登録されます。

• “IPアドレス”は、製品内で一意になるように指定してください。また、ServerView Resource Orchestratorと連携時は、ServerView Resource Orchestratorで登録された管理するサーバも含めて一意になるように指定してください。

• ServerView Resource Orchestratorが管理するL-Platformにサーバを追加することはできません。

• 本コマンドに指定した文字コードと、サーバ情報ファイルに指定した文字コードが異なっていた場合の動作は保証しません。文字コードは一致させるようにしてください。

更新時の注意事項

• 登録済のサーバ情報を修正する場合は、一覧表示したファイルを編集し、編集したファイルを更新の入力ファイルとすることお勧めします。

• ServerView Resource Orchestratorが管理するサーバに対して、更新を行うことはできません。

削除時の注意事項

• Systemwalker Software Configuration Managerで利用する必要がなくなったサーバ情報は、本コマンドを使用して情報を削除してください。

• ServerView Resource Orchestratorが管理するサーバを削除することはできません。

一覧表示時の注意事項

• サーバ情報が登録されていない場合は、ヘッダ情報だけを出力します。

  #ipaddress,server-name,lplatform-id,host-name,os-type,os-architecture,os-name

• ServerView Resource Orchestratorが管理するサーバも含めて表示する場合は、-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 L-Platform does not exist.	該当行の“lplatform-id”に相当するL-Platformが存在しません。存在するL-PlatformのL-Platform IDを指定してください。
  The Server has already been registered.	該当行のサーバ情報は、既に登録されています。
  The specified server does not exist.	該当行の“ipaddress”に相当するサーバ情報は存在しません。存在するサーバのIPアドレスを指定してください。
  The Server cannot be operated.	該当行のサーバ情報は、ServerView Resource Orchestartorが管理するサーバです。本コマンドにより更新を行うことができません。
  The Server cannot be added to the specified L-Platform.	該当行の“lplatform-id”に相当するL-Platformは、ServerVIew Resource Orchestratorが管理するL-Platformです。本コマンドで、このL-Platformにサーバを追加することはできません。

使用例

• 登録

  【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,lplatform-id,host-name,os-type,os-architecture,os-name
  192.168.1.1,開発サーバ1,tenant1-CFMG-2JHV3DDBF,kaihatsu1,Windows,x64,Windows Server 2008 R2
  192.168.1.2,開発サーバ2,tenant1-CFMG-S97LT3315,kaihatsu2,Windows,x64,Windows Server 2008 R2

  ファイル出力

  CFMGC30151 サーバ情報管理コマンドが正常に終了しました。

  なお、出力したCSVファイルの先頭行には、以下のヘッダ情報が付加されます。

  #ipaddress,server-name,lplatform-id,host-name,os-type,os-architecture,os-name