Solaris Bandwidth Manager のスキーマオブジェクト
ディレクトリスキーマは、どの情報がディレクトリに格納できるかを決定します。デフォルトのスキーマとその変更方法についての詳細は、『Sun Directory Services 3.1 管理ガイド』を参照してください。図 6-5 に、スキーマの構造を要約します。
図 6-5 Solaris Bandwidth Manager のスキーマ
表 6-2 に、各オブジェクトクラスの属性の一覧を示します。(M) は、属性が必須であることを示します。(O) は、属性が任意であることを示します。各オブジェクトの詳細については、この節の後半にあるオブジェクトクラスのアルファベット順の一覧を参照してください。各属性の詳細についても、この節の後半にある属性のアルファベット順の一覧を参照してください。
表 6-2 オブジェクトクラスの要約|
オブジェクトクラス |
属性 |
使用できる値 |
|---|---|---|
|
baConfState(M) |
valid または invalid |
|
|
commonName(M) |
共通名 |
|
|
baClConfRef(O) |
汎用設定の DN |
|
|
baTimeout(O) |
タイムアウト (秒) |
|
|
baIfName(M) |
接尾辞 _in または _out が付いたデバイス名 |
|
|
baIfRate(M) |
帯域幅 (ビット/秒) |
|
|
commonName(M) |
共通名 |
|
|
baIfNetwork(O) |
デバイス名 |
|
|
baIfActivate(O) |
enabled、stats、tos、または disabled |
|
|
none、all、または direct |
||
|
baIfNonIP(O) |
ipqos または direct |
|
|
baIfRtrMac(O) |
MAC アドレス |
|
|
baIfRtrAddr(O) |
IP アドレスまたはホスト名のリスト |
|
|
commonName(M) |
共通名 |
|
|
groupMember(M) |
IP アドレス |
|
|
networkMask(O) |
サブネットマスク (ドット形式) |
|
|
commonName(M) |
共通名 |
|
|
URL |
||
|
マスク:マッチ (バイナリ形式で示す) |
||
|
デバイス:方向 (方向は INCOMING、OUTGOING、または BOTH) |
||
|
sourceIPHost(O) |
IP アドレスまたはホスト名 |
|
|
IP アドレスまたはホスト名 |
||
|
名前:マスク |
||
|
名前:マスク |
||
|
sourceGroup(O) |
baGroup タイプの DN エントリ |
|
|
baGroup タイプの DN エントリ |
||
|
ポート番号 |
||
|
ポート番号 |
||
|
発信元:着信先 |
||
|
ANY、または /etc/protocols ファイルで定義された名前 |
||
|
ceilingRate(O) |
1:ビット/秒 (bps)、または 2:百分率 (%) |
|
|
1:ビット/秒 (bps)、または 2:百分率 (%) |
||
|
parent(O) |
クラス名 |
|
|
previous(O) |
クラス名 |
|
|
queueName(O) |
クラス名 |
|
|
1 から 7 までの整数 |
||
|
tosWrite(O) |
0 から 255 までの整数 |
|
|
commonName(M) |
共通名 |
|
|
policyName(M) |
ポリシー名 |
|
|
policyCondition オブジェクトセットへの参照 |
||
|
TRUE または FALSE |
||
|
policyAction オブジェクトセットへの参照 |
||
|
キーワードのリスト |
||
|
policyUsage(O) |
識別名 |
|
|
commonName (M) |
共通名 |
|
|
policyActionName(M) |
名前 |
|
|
policyRef(M) |
ポリシーへの参照 |
|
|
commonName (M) |
共通名 |
|
|
ポリシー条件名 |
||
|
URLmatch(O) |
URL |
|
|
baURLgroup エントリへのポインタ |
オブジェクトクラス
この節では、Solaris Bandwidth Manager で使用するオブジェクトクラスの一覧をアルファベット順に示します。
baConf
必須属性: baConfState, commonName (cn)
任意属性: baClConfRef, baTimeout
説明: Solaris Bandwidth Manager の設定全体を格納するサブツリーのトップエントリ
baIf
必須属性: baIfName, baIfRate, commonName (cn)
任意属性: baIfNetwork, baIfMulticast, baIfNonIP, baIfRtrMac, baIfRtrAddr, baIfActivate
説明: Solaris Bandwidth Manager で制御されるインタフェース用の設定パラメータを含む
baGroup
必須属性: commonName (cn), groupMember
任意属性: networkMask
説明: Solaris Bandwidth Manager で制御されるホストまたはサブネットのグループ用の設定パラメータを含む
baURLGroup
継承元: commonName (cn), URLgroupMember
説明: Solaris Bandwidth Manager で制御される URL グループ用の設定パラメータを含む
DSCondition
継承元: policyCondition
必須属性: なし
任意属性: receivedDSByteCheck
説明: サービスの差別化に関連して、動作全体に適用可能な条件を記述する
interfaceCondition
継承元: policyCondition
必須属性: なし
任意属性: interfaceName
説明: インタフェースに適用可能な条件を記述する
IProuteCondition
継承元: policyCondition
必須属性: なし
任意属性: sourceIPHost, destinationIPHost, sourceNetwork, destinationNetwork, sourceGroup, destinationGroup
説明: IP 発信元または IP 着信先に適用可能な条件を記述する
IPserviceCondition
継承元: policyCondition
必須属性: なし
任意属性: sourcePortNumberRanges, destinationPortNumberRanges, portNumberPairs, protocolNumber
説明: IP サービスに適用可能な条件を記述する
LSaction
継承元: from policyAction
必須属性: なし
任意属性: ceilingRate, guaranteedRate, parent, previous, queueName, queuePriority, tosWrite
説明: リンクの共有という文脈において、実行すべきアクションを記述する
policy
必須属性: commonName, policyName, policyConditionList, policyEnabled
任意属性: policyActionList, PolicyKeywords, policyUsage
説明: 2 つ以上のオブジェクト間の相互動作を記述する
policyAction
必須属性: commonName (cn), policyActionName
任意属性: なし
説明: ポリシーで指定されたすべての条件が満たされたときに実行されるアクションのセットを記述する
policyAux
必須属性: policyRef
任意属性: なし
説明: このオブジェクトクラスは、ポリシーをリモートユーザーエントリに関連付けるときに使用される。これは補助オブジェクトで、エントリを作成するときに他のオブジェクトクラスと連結して使用できることを意味する
policyCondition
必須属性: commonName (cn), policyConditionName
任意属性: なし
説明: ポリシーを満足するために適合すべき条件のセットを記述する。このオブジェクトクラスは、Solaris Bandwidth Manager DIT などとしては使用されない。その代わりに、このクラスから派生したオブジェクトクラスは、実際の条件を記述するエントリを作成するときに使用される。このようなオブジェクトクラスには、 DScondition、interfaceCondition、IProuteCondition、IPserviceCondition、URLCondition がある
URLcondition
継承元: policyCondition
任意属性: URLmatch, URLgroupMember
説明: URL に適用可能な条件を記述する
属性
この節では、Solaris Bandwidth Manager で使用される属性の一覧をアルファベット順に示します。属性の構文、使用できる値、属性の目的に関する簡単な説明を示します。
この節では、Solaris Bandwidth Manager に固有でない属性 (top や common name (cn) など) は示しません。
表 6-3 に、属性の構文とその定義を示します。
表 6-3 属性の構文とその定義|
属性の構文 |
構文の定義 |
|---|---|
|
bin |
バイナリを表す |
|
ces |
大文字と小文字の区別がある文字列を表す。大文字と小文字の区別がある英数字文字列 |
|
cis |
大文字と小文字の区別がない文字列を表す。大文字と小文字の区別がない英数字文字列 |
|
dn |
識別名 |
|
int |
整数 |
|
protected |
crypt(1) で暗号化された値 |
|
tel |
電話番号 |
|
utctime |
世界標準時 (Coordinated Universal Time) |
baClConfRef
使用されるクラス: baConf
説明: 汎用設定へのポインタを提供する
baConfState
使用されるクラス: baConf
説明: エントリで記述された設定内容が有効かどうか、または、現在変更中かどうかを示す。この属性の値は invalid または valid のうちの 1 つだけである。設定内容をディレクトリに保存するとき、この属性は invalid に設定される。そして、設定の以前のバージョンがすべて削除され、新しいバージョンが保存されると、この属性は再び valid に設定される
baIfActivate
使用されるクラス: baIf
説明: Solaris Bandwidth Manager が制御するインタフェースの状態を示す。この属性の値は、enabled、stats、tos、または disabled のうちの 1 つだけである。これらの値の意味については、「インタフェースの定義」を参照
baIfMulticast
使用されるクラス: baIf
説明: マルチキャストパケットが転送される方法を指定する。この属性の値は、none、all、または direct のうちの 1 つだけである。これらの値の意味については、「IP 透過モード」を参照。Solaris Bandwidth Manager が IP 透過モードで動作している場合、この属性は必須である
baIfName
使用されるクラス: baIf
説明: エントリで記述されたインタフェースのデバイス名を指定する。接尾辞 _in または _out を付けて、処理されるトラフィックの方向を示す
baIfNetwork
使用されるクラス: baIf
説明: ネットワークと通信するために使用されるデバイス名を指定する。Solaris Bandwidth Manager が IP 透過モードで動作している場合、この属性は必須である
baIfNonIP
使用されるクラス: baIf
説明: 非 IP パケットがどのように転送されるかを指定する。この属性の値は、ipqos または direct のうちの 1 つだけである。これらの値の意味については、「IP 透過モード」を参照。Solaris Bandwidth Manager が IP 透過モードで動作している場合、この属性は必須である
baIfRate
使用されるクラス: baIf
説明: エントリで記述されたインタフェースに関連する帯域幅の速度を示す。ビット/秒で入力する
baIfRtrAddr
使用されるクラス: baIf
説明: ルーターの IP アドレスまたはホスト名のリストを指定する。複数の IP アドレスを指定する場合はコンマで区切る。Solaris Bandwidth Manager が IP 透過モードで動作している場合、この属性は必須である
baIfRtrMac
使用されるクラス: baIf
説明: エントリで記述されたルーターの MAC アドレスを指定する。この値は、16 進数アドレスでも、ethers テーブルの一覧にあるホスト名でも指定できる。Solaris Bandwidth Manager が IP 透過モードで動作している場合、この属性は必須である
baTimeout
使用されるクラス: baConf
説明: 設定に関するタイムアウトを指定する。単位は秒
ceilingRate
使用されるクラス: LSaction
説明: リンクに割り振る最大帯域幅を示す。この属性の値はビット/秒 (bps) でも、帯域幅 (%) でも指定できる。ビット/秒で指定する場合、構文は 1:x となる。百分率で指定する場合、構文は 2:x となる。x は、ビット/秒または百分率の値である
destinationGroup
使用されるクラス: IProuteCondition
説明: baGroup タイプのエントリへのポインタを提供する
destinationIPHost
使用されるクラス: IProuteCondition
説明: IP 経路条件を記述するエントリで、着信先のホスト名を指定する
destinationNetwork
使用されるクラス: IProuteCondition
説明: IP 経路条件を記述するエントリで、着信先のネットワーク名を指定する
destinationPortNumberRanges
使用されるクラス: IPserviceCondition
説明: エントリが記述する条件が適用されるポート、またはポートの範囲を指定する
flowEvent
使用されるクラス: LSaction
説明: 新しいフローがクラスで検出されたときに、フロー追加イベントが生成されることを示す。この値は、サービスの品質の検索時に Directory M-bean によって使用される文字列である
groupMember
使用されるクラス: baGroup
説明: baGroup エントリが記述するグループに追加するホストまたはサブネットのアドレスを提供する
guaranteedRate
使用されるクラス: LSaction
説明: リンクに割り振る保障帯域幅を示す。この属性の値はビット/秒 (bps) でも、帯域幅 (%) でも指定できる。ビット/秒で指定する場合、構文は 1:x となる。百分率で指定する場合、構文は 2:x となる。x は、ビット/秒または百分率の値である
interfaceName
使用されるクラス: interfaceCondition
説明: エントリによって記述された条件が適用されるインタフェース名を指定する。構文は device:direction。device はローカルの用語 (hme0 や eht0 など) であり、direction は INCOMING、OUTGOING、または BOTH のうちの 1 つである
networkMask
使用されるクラス: baConf
説明: エントリで記述されたサブネットグループのサブネットマスクを指定する。サブネットマスクはドット形式で指定するか、あるいは hosts ファイルまたは networks ファイルで定義されているサブネットマスク名で指定する。ネットマスクを指定する + スタイルは使用できない。この属性が存在しない場合、エントリで記述されるグループはホストグループである。この属性は、サブネットグループを記述するのに必須である
parent
使用されるクラス: LSaction
説明: クラスの親クラス名
policyActionList
使用されるクラス: policy
説明: policyAction オブジェクトセットへの参照を提供する。policy エントリによって定義された条件がすべて満たされたとき、policyAction エントリで記述されたアクションが実行される
policyActionName
使用されるクラス: policyAction
説明: エントリで記述されたポリシーアクションのわかりやすい名前
policyConditionList
使用されるクラス: policy
説明: policyCondition オブジェクトセットへの参照を提供する。この条件セットが満たされたとき、エントリで記述されたポリシーが適用可能になる
policyConditionName
使用されるクラス: policyCondition
説明: エントリで記述されたポリシー条件のわかりやすい名前。この属性は命名属性ではないため、エントリの RDN では使用できない
policyEnabled
使用されるクラス: policy
説明: エントリで記述されたポリシーが現在有効であるかどうかを示す。この属性の値は、TRUE または FALSE のうちの 1 つだけである
policyKeywords
使用されるクラス: policy
説明: ポリシーエントリの検索時に使用できるキーワードの一覧を提供する
policyName
使用されるクラス: policy
説明: エントリで記述されたポリシーのわかりやすい名前。この属性は命名属性ではないため、エントリの RDN では使用できない
policyRef
使用されるクラス: policyAux
説明: ポリシーへの参照を提供する。この属性は、ポリシーを他のタイプのエントリ、たとえば、リモートユーザーのエントリに関連付けるときに使用される
policyUsage
使用されるクラス: policy
説明: エントリで記述されたポリシーを使用するためのガイドラインを提供する
portNumberPairs
使用されるクラス: IPserviceCondition
説明: 発信元と着信先のポートのペアを示す。構文は source:destination
previous
使用されるクラス: LSaction
説明: 現在のクラスよりも前に確認されたクラス名を指定する。前のクラスが root であった場合、この値は空白である
protocolNumber
使用されるクラス: IPserviceCondition
説明: 条件で記述されたプロトコル名を提供する。この属性の値は、ANY、または /etc/protocols ファイルで定義されているプロトコル名のうちの 1 つだけである
queueName
使用されるクラス: LSaction
説明: エントリで記述されたアクションが適用される待ち行列のクラス名を指定する
queuePriority
使用されるクラス: LSaction
説明: エントリで記述されたアクションの一部として、フローに割り当てる優先度を示す
receivedDSByteCheck
使用されるクラス: DScondition
説明: 受信したパケットの IP ヘッダー内にある差別化サービス (DS) バイトの内容に基づいて、トラフィックの条件を指定する。形式は、xxxxxxxx:xxxxxxxx という文字列である。x は 0 または 1。左側の文字列は Mask で、右側の文字列は Match である。受信したパケットの IP ヘッダー内にある DS バイトと Mask との論理積が求められ、その結果が Match と比較される。 したがって、条件は次のように表現できる。
(receivedPacketTOSbyte & Mask == Match)?
& はビット単位の論理積演算を示し、== はビット単位の比較演算を示す
Mask と Match の連結で DS バイト内の特定のバイトを比較時に無視できるため、DS バイトに基づくプロファイルを定義できる
sourceGroupRef
使用されるクラス: IProuteCondition
説明: baGroup タイプのエントリへのポインタを提供する
sourceIPHost
使用されるクラス: IProuteCondition
説明: IP 経指条件を記述するエントリで、発信元のホスト名を指定する
sourceNetwork
使用されるクラス: IProuteCondition
説明: IP 経路条件を記述するエントリで、発信元のネットワーク名を指定する
sourcePortNumberRanges
使用されるクラス: IPserviceCondition
説明: エントリで記述された条件が適用されるポートまたは、ポートの範囲を指定する
tosWrite
使用されるクラス: LSaction
説明: エントリで記述されたアクションの一部として、提供される TOS (Type of Services) を指定する。この属性の値は 0 から 255 までの整数である
URLgroupMember
使用されるクラス: baURLgroup
説明: baURLgroup エントリへのポインタを提供する
URLmatch
使用されるクラス: URLcondition
説明: エントリで記述された URL 条件用のフィルタを設定するために使用される URL を指定する。この URL にはワイルドカードを指定できる
Solaris Bandwidth Manager の命名規約
設定ファイル ba.conf を編集するか、構成ツール batool を使って、Solaris Bandwidth Manager の設定を作成してディレクトリに保存する場合、命名規約は自動的に処理されます。ディレクトリサービス内で設定を作成するときは、次の規約を守る必要があります。
-
policyNames、groupNames、および serviceNames は設定内で一意である必要がある。policyName は、設定が Solaris Bandwidth Manager で実行されるときにフィルタ名になる
-
classNames はインタフェース内で一意である必要がある。各クラスが特定のインタフェースに関連付けられるため、異なるインタフェースに関連付けられる限り、同じ名前を持つクラスが複数存在できる
- © 2010, Oracle Corporation and/or its affiliates