ネットワーク構成情報のXML定義は以下のとおりです。
ネットワークデバイスを個別作成する場合のXML定義
<?xml version="1.0" encoding="utf-8"?> <Netdevice ip="管理IPアドレス" name="機器名"> <Location>ロケーション</Location> <Types> <Type>種別</Type> </Types> <Maintenance>保守モード</Maintenance> <AutoConfiguration>ネットワークデバイスの自動設定の可否</AutoConfiguration> <DeviceInfo> <SysObjectId>sysObjectID</SysObjectId> <Vendor>ベンダー名</Vendor> <ProductName>装置名</ProductName> <ModelName>モデル名</ModelName> <Firmware>ファームウェア</Firmware> </DeviceInfo> <Redundancy group_id="グループID"></Redundancy> <MgmtInfos> <Snmps> <ReadCommunity>コミュニティー名</ReadCommunity> </Snmps> <LoginInfos> <LoginInfo auth_type="認証情報の管理方法" authority="管理者権限" check="アカウント確認"> <IpAddress>接続先IPアドレス</IpAddress> <Port>接続先ポート番号</Port> <Tenant>テナント名</Tenant> <User>アカウント</User> <Password>パスワード</Password> <PrivilegedPassword>管理者パスワード</PrivilegedPassword> <PasswordEncryption>パスワードの暗号化</PasswordEncryption> </LoginInfo> </LoginInfos> <Monitoring method="監視方法"> <Interval>監視間隔</Interval> <RetryCount>リトライ回数</RetryCount> <Timeout>タイムアウト時間</Timeout> </Monitoring> <MgmtURL>Web管理画面URL</MgmtURL> </MgmtInfos> <Ports> <Port name="ポート名"> <Description>ポートの概要</Description> <PhysicalState>通信状態</PhysicalState> <Link ip="結線先機器の管理IPアドレス" port="結線先のポート名" kind="結線先機器の種別" /> </Port> </Ports> </Netdevice> |
複数のネットワークデバイスを一括作成する場合のXML定義
<?xml version="1.0" encoding="utf-8"?> <NetConfig> <Netdevices> <Mode>登録モード</Mode> <Netdevice ip="管理IPアドレス" name="機器名"> <Location>ロケーション</Location> <Types> <Type>種別</Type> </Types> <Maintenance>保守モード</Maintenance> <AutoConfiguration>ネットワークデバイスの自動設定の可否</AutoConfiguration> <DeviceInfo> <SysObjectId>sysObjectID</SysObjectId> <Vendor>ベンダー名</Vendor> <ProductName>装置名</ProductName> <ModelName>モデル名</ModelName> <Firmware>ファームウェア</Firmware> </DeviceInfo> <Redundancy group_id="グループID"></Redundancy> <MgmtInfos> <Snmps> <ReadCommunity>コミュニティー名</ReadCommunity> </Snmps> <LoginInfos> <LoginInfo auth_type="認証情報の管理方法" authority="管理者権限" check="アカウント確認"> <IpAddress>接続先IPアドレス</IpAddress> <Port>接続先ポート番号</Port> <Tenant>テナント名</Tenant> <User>アカウント</User> <Password>パスワード</Password> <PrivilegedPassword>管理者パスワード</PrivilegedPassword> <PasswordEncryption>パスワードの暗号化</PasswordEncryption> </LoginInfo> </LoginInfos> <Monitoring method="監視方法"> <Interval>監視間隔</Interval> <RetryCount>リトライ回数</RetryCount> <Timeout>タイムアウト時間</Timeout> </Monitoring> <MgmtURL>Web管理画面URL</MgmtURL> </MgmtInfos> <Ports> <Port name="ポート名"> <Description>ポートの概要</Description> <PhysicalState>通信状態</PhysicalState> <Link ip="結線先機器の管理IPアドレス" port="結線先のポート名" kind="結線先機器の種別" /> </Port> </Ports> </Netdevice> </Netdevices> <Links> <Link> <Devices> <Device ip="機器1の管理IPアドレス" kind="機器1の種別"> <Port>機器1の接続ポート名</Port> </Device> <Device ip="機器2の管理IPアドレス" kind="機器2の種別"> <Port>機器2の接続ポート名</Port> </Device> </Devices> </Link> </Links> </NetConfig> |
要素名 | 説明 | 取り得る値、または例 | 指定要否 | exportでの出力 | ||
---|---|---|---|---|---|---|
個別登録時 | 個別変更時 | 一括登録時 | ||||
ネットワーク構成情報(NetConfig) | ネットワーク構成情報の集合 | - | 不可 | 不可 | 必須 | ○ |
ネットワークデバイス情報 (Netdevices) | ネットワークデバイス情報の集合 | 1つ以上のNetdeviceタグを指定します。 複数台のネットワーク機器を同時にネットワークデバイスとして登録する場合は省略できません。 | 不可 | 不可 | 可 | ○ (*1) |
登録モード (Mode) | 登録モード (省略可) | ネットワークデバイスの登録モードを指定します。 以下のどちらかを指定します。
省略時は、"add"が指定されます。 | 不可 | 不可 | 可 | × |
管理IPアドレス (Netdevice ip) | ネットワークデバイスの管理IPアドレス | IPv4アドレスを指定します。 | 必須 | 可 | 必須 | ○ |
機器名 (Netdevice name) | ネットワークデバイスの名称 (省略可) | 半角英数字、アンダースコア("_")、ハイフン("-")およびピリオド(".")で構成された32文字以内の文字列を指定します。 省略時は、SNMPで取得した標準MIBのsysNameの値が指定されます。 | 可 | 可 | 可 | ○ |
ロケーション (Location) | ロケーション (省略可) | 半角英数字、アンダースコア("_")およびハイフン("-")で構成された32文字以内の文字列を指定します。 省略時は、SNMPで取得した標準MIBのsysLocationの値が指定されます。 | 可 | 可 | 可 | ○ (*2) |
種別情報 (Types) | 種別情報の集合 (省略可) | 1つ以上のTypeタグを指定します。 | 可 | 可 | 可 | ○ (*1) |
種別 (Type) | ネットワークデバイスの種別 (省略可) | ネットワークデバイスの種別を指定します。 以下のどちらかを指定します。
ここで、"Firewall"を指定したネットワークデバイスがネットワークプールへの登録対象になります。 | 可 | 可 | 可 | ○ (*2) |
保守モード (Maintenance) | 保守モードの設定 (省略可) | 保守モードの状態を指定します。 以下のどちらかを指定します。
省略時は、"false"が指定されます。 | 可 | 可 | 可 | ○ |
ネットワークデバイスへの自動設定 (AutoConfiguration) | ネットワークデバイスへの自動設定 (省略可) | ネットワークデバイスへの自動設定の状態を指定します。 以下のどちらかを指定します。
省略時は、"true"が指定されます。 | 可 | 可 | 可 | × |
機器情報 (DeviceInfo) | 機器情報 | ネットワークデバイスのモデル定義、およびSNMPで自動収集した情報です。 | - | - | - | ○ |
SysObjectId (SysObjectId) | SysObjectId | 数値・ドット形式のOIDが指定されます。 SNMPで自動収集するため、指定する必要はありません。 | - | - | - | ○ |
ベンダー名 (Vendor) | ベンダー名 | 文字列が指定されます。 ネットワークデバイスのモデル定義に基づいて設定されるため、指定する必要はありません。 | - | - | - | ○ |
装置名 (ProductName) | 装置名(製品名) | 文字列が指定されます。 ネットワークデバイスのモデル定義に基づいて設定されるため、指定する必要はありません。 | - | - | - | ○ |
モデル名 (ModeName) | モデル名 | 文字列が指定されます。 ネットワークデバイスのモデル定義に基づいて設定されるため、指定する必要はありません。 | - | - | - | ○ |
ファームウェア (Firmware) | ファームウェアまたはIOSバージョン | 文字列が指定されます。 SNMPで自動収集するため、指定する必要はありません。 | - | - | - | ○ |
グループID (Redundancy group_id) | グループID (省略可) | 先頭半角英数字で、半角英数字、アンダースコア("_")およびハイフン("-")で構成された32文字以内の文字列を指定します。 同じグループIDに所属するネットワークデバイスは、同じベンダー名と装置名にしてください。 | 可 | 可 | 可 | ○ (*2) |
管理情報 (MgmtInfos) | 管理情報の集合 | 1つ以上のSnmpsタグ、LoginInfoタグなどを指定します。 | 必須 | 可 | 必須 | ○ |
SNMP情報 (Snmps) | SNMP情報の集合 | 1つのReadCommunityタグを指定します。 | 必須 | 可 | 必須 | ○ |
コミュニティー名 (ReadCommunity) | コミュニティー名 | 半角英数字、アンダースコア("_")およびハイフン("-")で構成された32文字以内の文字列を指定します。 | 必須 | 可 | 必須 | ○ |
ログイン情報 (LoginInfos) | ログイン情報の集合 (省略可) | 1つ以上のLoginInfoタグを指定します。 | 可 | 可 | 可 | ○ (*1) |
認証情報の管理方法 (LoginInfo auth_type) | 認証情報の管理方法 (省略可) | 認証情報の管理方法を指定します。 ネットワークデバイス内で管理する場合、"local password"を指定します。 省略時は、自動的に指定されます。 | 可 | 可 | 可 | ○ (*3) |
管理者権限 (LoginInfo authority) | 管理者権限の有無 (省略可) | アカウントの権限を指定します。 アカウントが利用者権限の場合、"user"を指定します。 省略時は、自動的に指定されます。 | 可 | 可 | 可 | ○ (*3) |
アカウント確認 (LoginInfo check) | アカウント情報の確認有無 (省略可) | 登録時または変更時にアカウント情報を確認するかを指定します。 以下のどちらかを指定します。
省略時は、"false"が指定されます。 | 可 | 可 | 可 | × |
接続先IPアドレス (IpAddress) | 接続先IPアドレス (省略可) | IPv4形式のIPアドレスを指定します。 ネットワークデバイスへの自動設定時の接続先IPアドレスに、管理IPアドレス以外のIPアドレスを設定する場合に指定します。 省略時は、管理IPアドレスが指定されます。 | 可 | 可 | 可 | ○ (*3) |
接続先ポート番号 (Port) | 接続先への接続プロトコルのポート番号 (省略可) | 1~65535までの整数を指定します。 アカウント確認に"true"が指定されている場合、指定されているアカウントとパスワードを利用して接続確認を行うネットワーク機器のポート番号を指定します。 なお、接続確認はtelnetプロトコルを利用して行います。 省略時は、"23"が指定されます。 | 可 | 可 | 可 | ○ (*3) |
テナント名 (Tenant) | テナント名 (省略可) | 先頭半角英数字で、半角英数字、アンダースコア("_")およびハイフン("-")で構成された32文字以内の文字列を指定します。 グローバルプールに登録する場合、省略できます。 | 可 | 可 | 可 | ○ (*3) |
アカウント (User) | 接続時のアカウント | 半角英数字、アンダースコア("_")およびハイフン("-")で構成された32文字以内の文字列を指定します。 | 必須 | 可 | 必須 | ○ (*3) |
パスワード (Password) | 接続時のパスワード | 半角英数字、アンダースコア("_")およびハイフン("-")で構成された32文字以内の文字列を指定します。 | 必須 | 可 | 必須 | ○ (*3) |
管理者パスワード (PrivilegedPassword) | 管理者パスワード (省略可) | 半角英数字、アンダースコア("_")およびハイフン("-")で構成された32文字以内の文字列を指定します。 | 可 | 可 | 可 | ○ (*3) |
パスワードの暗号化 (PasswordEncryption) | パスワードの暗号化有無 (省略可) | ネットワークデバイスのパスワードが暗号化されているかを指定します。 以下のどちらかを指定します。
省略時は、"false"が指定されます。 なお、初回登録時は平文でパスワードを入力するため、"false"を指定してください。 | 可 | 可 | 可 | ○ (*3) |
監視情報 (Monitoring) | 監視情報 (省略可) | 監視情報のタグを指定します。 | 可 | 可 | 可 | ○ |
監視方法 (Monitoring method) | 監視方法 (省略可) | ネットワークデバイスの監視方法について指定します。 以下のどれかを指定します。
省略時は、"1"が指定されます。 | 可 | 可 | 可 | ○ |
監視間隔 (Interval) (*5) | 監視間隔(秒) (監視方法の変更時は、省略不可) | 1~600までの整数を指定します。 省略時は、"300"が設定されます。 | 可 | 可 | 可 | ○ |
リトライ回数 (RetryCount) (*5) | リトライ回数 (監視方法の変更時は、省略不可) | 1~10までの整数を指定します。 省略時は、"3"が指定されます。 | 可 | 可 | 可 | ○ |
タイムアウト時間 (Timeout) (*5) | タイムアウト時間(秒) (監視方法の変更時は、省略不可) | 1~300までの整数を指定します。 省略時は、"30"が指定されます。 | 可 | 可 | 可 | ○ |
Web管理画面URL (MgmtURL) | Web管理画面のURL (省略可) | URLを指定します。 省略時は、"http://管理IPアドレス/"が指定されます。 なお、Web管理機能が提供されているネットワーク機器の場合だけ意味を持ちます。 | 可 | 可 | 可 | ○ |
ポート情報 (Ports) | ポート情報の集合 | 1つ以上のPortタグが指定されます。 | - | - | - | ○ (*1) |
ポート名 (Port name) | ポート名 | SNMPで取得した標準MIBのifNameの値が指定されます。 SNMPで自動収集するため、指定する必要はありません。 | - | - | - | ○ |
ポートの概要 (description) | ポートの概要 | SNMPで取得した標準MIBのifDescrの値が指定されます。 SNMPで自動収集するため、指定する必要はありません。 | - | - | - | ○ |
通信状態 (PhysicalState) | 通信状態 | SNMPで取得した回線速度と通信モードが指定されます。 指定形式:回線速度(MB)/通信モード 通信モードには、以下のどれかが指定されます。
SNMPで自動収集するため、指定する必要はありません。 | - | - | - | ○ |
結線先の管理IPアドレス (Link ip) | 結線先機器の管理IPアドレス | IPv4形式のIPアドレスが指定されます。 | - | - | - | ○ (*2) |
結線先のポート名 (Link port) | 物理インターフェースの結線先のポート名 | ネットワークデバイスの標準MIBのifNameに設定されているポート名が指定されます。 | - | - | - | ○ (*2) |
結線先機器の種別 (Link kind) | 結線先機器の種別 | 結線先の機器の種別が指定されます。 以下のどちらかが指定されます。
| - | - | - | ○ (*2) |
結線情報 (Links) (*6) | 結線情報の定義 (省略可) | 1つ以上のLinkタグで構成されます。 <Links><Link></Link></Links> | 不可 | 不可 | 可 | ○ (*1) |
結線 (Link) | 結線の定義 (結線情報を指定時は、省略不可) | 1つのDevicesタグを指定します。 | 不可 | 不可 | 可 | ○ (*1) |
機器情報 (Devices) | 機器情報の定義 (結線の指定時は、省略不可) | 2つのDeviceタグを指定します。 | 不可 | 不可 | 可 | ○ (*1) |
機器の管理IPアドレス (Device ip) | 機器の管理IPアドレス | IPv4形式のIPアドレスを指定します。 | 不可 | 不可 | 必須 | ○ |
機器の種別 (Device kind) | 機器の種別 (省略可) | 機器の種別を指定します。 以下のどちらかを指定します。
省略時は、"netdevice"が指定されます。 | 不可 | 不可 | 可 | ○ |
機器の接続ポート名 (Port) | 機器の接続ポート名 | 文字列を指定します。
物理L-Serverの場合、「導入ガイド CE」の「4.2.3.5 管理対象サーバへの事前設定」で決定したラックマウント型サーバまたはタワー型サーバの場合のNIC番号を指定します。 例 「導入ガイド CE」の「4.2.3.5 管理対象サーバへの事前設定」で、ラックマウント型サーバの背面の左端のNIC番号を"1"と決定した場合、ここでは"1"を指定してください。 | 不可 | 不可 | 必須 | ○ |
-: 登録または変更時に指定する必要はありません。自動設定などによって補完される要素です。ネットワーク構成情報をエクスポートした場合に通知されます。
○: ネットワーク構成情報のexport時に出力される要素です。
×: ネットワーク構成情報のexport時に出力されない要素です。
*1: 要素の配下のタグが定義されている場合だけ出力される要素です。
*2: 要素に対して値が設定されている場合だけ出力される要素です。
*3: ログイン情報が設定されている場合だけ出力される要素です。ログイン情報が設定されていない場合、省略時の値が存在する要素は省略値が出力されます。
*4: 以下の条件を満たしているネットワークデバイスだけアカウント確認が行われます。
ベンダー名 | 機種名 | プロンプトの種類 | プロンプト文字 |
---|---|---|---|
Fujitsu | SR-X IPCOM EX | ログインプロンプト | Login: |
パスワードプロンプト | Password: | ||
コマンドプロンプト | 任意の文字列# | ||
任意の文字列> | |||
Cisco | Catalyst ASA | ログインプロンプト | Username: |
パスワードプロンプト | Password: | ||
コマンドプロンプト | 任意の文字列# | ||
任意の文字列> |
コマンドプロンプトでは、任意の文字列に続く"#"または">"までをプロンプト文字として扱います。
*5: 特別な要件がある場合だけ、値を設定してください。
*6: Cisco ASAと隣接するネットワークデバイスの間の結線情報は、登録する必要がありません。
*7: ネットワークデバイスの標準MIBのifNameが不明な場合、snmpwalkコマンドなどで確認できます。
>snmpwalk -v 1 -c [SNMPコミュニティー名] [IPアドレス] ifName <RETURN> |
例
1つのネットワークデバイスを作成する場合
<?xml version="1.0" encoding="utf-8"?> <Netdevice ip="192.168.5.11" name="Firewall01"> <Location>B1F</Location> <Types> <Type>Firewall</Type> </Types> <Maintenance>false</Maintenance> <AutoConfiguration>true</AutoConfiguration> <Redundancy group_id="1"></Redundancy> <MgmtInfos> <Snmps> <ReadCommunity>public</ReadCommunity> </Snmps> <LoginInfos> <LoginInfo auth_type="local password" authority="admin" check="true"> <Tenant>TenantA</Tenant> <User>user</User> <Password>password</Password> <PrivilegedPassword>root_password</PrivilegedPassword> <PasswordEncryption>false</PasswordEncryption> </LoginInfo> </LoginInfos> <Monitoring method="3"> <Interval>300</Interval> <RetryCount>5</RetryCount> <Timeout>60</Timeout> </Monitoring> <MgmtURL>https://192.168.5.11</MgmtURL> </MgmtInfos> </Netdevice> |
複数のネットワークデバイスを一括作成する場合
<?xml version="1.0" encoding="utf-8"?> <NetConfig> <Netdevices> <Mode>add</Mode> <Netdevice ip="192.168.5.11" name="Switch1"> <Location>B1F</Location> <Types> <Type>L2-Switch</Type> </Types> <Maintenance>false</Maintenance> <AutoConfiguration>true</AutoConfiguration> <Redundancy group_id="1"></Redundancy> <MgmtInfos> <Snmps> <ReadCommunity>public</ReadCommunity> </Snmps> <LoginInfos> <LoginInfo auth_type="local password" authority="admin" check="true"> <User>user</User> <Password>password</Password> <PrivilegedPassword>root_password</PrivilegedPassword> <PasswordEncryption>false</PasswordEncryption> </LoginInfo> </LoginInfos> <Monitoring method="3"> <Interval>300</Interval> <RetryCount>5</RetryCount> <Timeout>60</Timeout> </Monitoring> <MgmtURL>https://192.168.5.11</MgmtURL> </MgmtInfos> </Netdevice> <Netdevice ip="192.168.5.10" name="Firewall1"> <Location>B1F</Location> <Types> <Type>Firewall</Type> </Types> <Maintenance>false</Maintenance> <AutoConfiguration>true</AutoConfiguration> <Redundancy group_id="2"></Redundancy> <MgmtInfos> <Snmps> <ReadCommunity>public</ReadCommunity> </Snmps> <LoginInfos> <LoginInfo auth_type="local password" authority="admin" check="true"> <Tenant>TenantA</Tenant> <User>user</User> <Password>password</Password> <PrivilegedPassword>root_password</PrivilegedPassword> <PasswordEncryption>false</PasswordEncryption> </LoginInfo> </LoginInfos> <Monitoring method="3"> <Interval>300</Interval> <RetryCount>5</RetryCount> <Timeout>60</Timeout> </Monitoring> <MgmtURL>https://192.168.5.10:82</MgmtURL> </MgmtInfos> </Netdevice> </Netdevices> <Links> <Link> <Devices> <Device ip="192.168.1.1" kind="netdevice"> <Port>LAN0.1</Port> </Device> <Device ip="192.168.1.2" kind="netdevice"> <Port>Fa2/1</Port> </Device> </Devices> </Link> <Link> <Devices> <Device ip="192.168.1.3" kind="netdevice"> <Port>Fa2/2</Port> </Device> <Device ip="192.168.1.4" kind="server"> <Port>1</Port> </Device> </Devices> </Link> </Links> </NetConfig> |