デバイスのアクセスを混合モード
このセクションでは、付与された混合モード アクセスであるデバイス設定を制御するために使用される、オブジェクトおよびプロパティを説明します。
起動が許可されプライム ケーブル プロビジョニングで事前登録せず設定される場合、デバイスは混合モードのアクセスを指定すると見なされます。混合モード アクセスは通常、登録済みの DOCSIS モデムの背後に表示されるコンピュータなどデバイスに使用されます。登録済みの DOCSIS モデムの背後にある不明なデバイスの混合モード アクセスが有効でない場合、デバイスはデフォルトのサービス レベルを受信します。
デバイスへの混合モード アクセスを許可するには、次の操作を行います。
-
特定のタイプの不明なデバイスに混合モード ポリシーを有効化または無効化します。混合モード アクセスが有効になっているデバイスは、デフォルト設定を受信する代わりに、ポリシーに基づいて設定されます。
-
デバイスが特定の混合モード アクセスになる場合、特定のタイプの不明なデバイス用にサービス クラスを指定します。
-
デバイスが特定の混合モード アクセスになる場合、特定のタイプの不明なデバイス用に DHCP 条件を指定します。
Configuring Promiscuous Access
次の表では、デバイスの混合ポリシーを設定可能な方法について説明します。プロビジョニング グループおよびテクノロジー固有の混合モード設定は、Admin UI では使用できません。
設定範囲 |
API コールの使用 |
|
---|---|---|
ケーブル モデムのプロビジョニング グループ:たとえば、特定のプロビジョニング グループ内で登録されているケーブル モデム デバイスの背後にあるコンピュータにのみ、混合アクセスを設定できます。 |
getProvGroupDetails changeProvGroupProperties |
|
ケーブル モデムのサービス クラス オブジェクト:たとえば、特定のサービス クラスに関連付けられている DOCSIS モデムの背後にあるコンピュータにのみ、混合アクセスを設定できます。 |
addClassOfService changeClassOfServiceProperties getClassOfServiceProperties |
|
ケーブル モデムの DHCP 条件:たとえば、特定の DHCP 条件に関連付けられている DOCSIS モデムの背後にあるコンピュータにのみ、混合アクセスを設定できます。 |
addDHCPCriteria changeDHCPCriteriaProperties getDHCPCriteriaDetails |
|
テクノロジー固有デフォルト:たとえば、DOCSIS モデムのテクノロジー デフォルトを使用する DOCSIS モデムの背後にあるコンピュータに、混合アクセスを設定できます。 |
changeDefaults getDefaults |
|
システム全体のデフォルト:グローバル システム デフォルト |
changeSystemDefaults getSystemDefaults |
混合モードのアクセスとプロパティ階層
プライム ケーブル プロビジョニングのオブジェクト数で、混合モードのポリシーを設定できます。そのため、優先する設定を理解することが重要です。ポリシーがプロパティを使用して設定されている場合、プライム ケーブル プロパティ階層によりプロパティの優先順位が決定されます。特定のプロパティを持つプロパティ階層の最初のオブジェクトは、プライム ケーブル プロビジョニングに使用する値を決定します。
プライム ケーブル プロビジョニングは、デバイスのケーブル モデムのプロパティ階層で混合モード ポリシーのプロパティを検索します。たとえばコンピュータについては、プライム ケーブル プロビジョニングはケーブル モデムのプロパティ階層の混合モード ポリシー設定を検索します。これは、コンピュータのリレーとして機能します。プロパティ階層に関する詳細については、Property Hierarchy を参照してください。混合モード ポリシーの詳細については、『Properties for Configuring Promiscuous Policy』を参照してください。
(注) |
テクノロジー デフォルトを使用して混合モード ポリシーを設定する際に、プロパティはターゲット デバイス タイプではない、ケーブル モデムに関連付けられているオブジェクトのプロパティを設定する必要があります。たとえば、DOCSIS モデムの背後にあるコンピュータの混合モード アクセスを有効にするため、コンピュータのテクノロジー デフォルトではなく、DOCSIS モデムのテクノロジー デフォルトで混合モードを有効にできます。 |
混合モード ポリシー プロパティは、サービス クラス、DHCP 条件、混合モードのアクセスを各デバイス タイプに有効または無効にするか指定します。混合モードがデバイスに有効になっており、デバイスのケーブル モデム階層の検索によりサービス クラスまたは DHCP 条件プロパティ一致を検索しない場合、非混合モード アクセスのデフォルトのサービス クラスまたは DHCP 条件が使用されます。たとえば、プライム ケーブル プロビジョニングがコンピュータへの混合モード アクセスを付与するように設定されており、混合サービス クラス、DHCP 条件、または両方を検索できない場合、コンピュータのデフォルトのサービス クラス、DHCP 条件、またはその両方を使用します。
サービス クラスと DHCP 条件のデフォルトは、これらのプロパティを使用してターゲット デバイス(ケーブル モデムの代わりに)のテクノロジー デフォルトで設定されます。
-
サービス クラス:/default/classOfService
API 定数は
TechnologyDefaultsKeys.DEFAULT_CLASS_OF_SERVICE
です。 -
DHCP 条件:/default/dhcpCriteria
API 定数は
TechnologyDefaultsKeys.DEFAULT_DHCP_CRITERIA
です。
混合モードのデバイス設定の生成
混合デバイスの設定は、次の条件下で生成されます。
-
デバイスは最初にオンラインに表示され、混合アクセスが与えられます。
-
古い DPE ではそのキャッシュを設定して、特定のプロビジョニング グループの設定を要求します。
-
設定の再生成は、API コール regenConfigs 経由で、デバイスに明示的に登録されています。
-
混合アクセス デバイスのケーブル モデム デバイスの設定が再生成されます。
-
混合ポリシーへの変更(またはその他の設定変更)は、影響を受けるデバイスの設定を再生成するように、プライム ケーブル プロビジョニング設定の再生成サービス(CRS)サービスに要求します。
混合デバイスの設定が再生成するたびに、新しく設定された混合ポリシーを使用します(たとえば、サービス クラスは現在混合コンピュータで指定されています)を使用します。ただし、デバイスが混合デバイスとしてオンラインに表示された後、API 経由でサービス クラスまたは DHCP 条件が変更される場合、そこからデバイスは混合モードとは見なされず、混合ポリシーの変更の影響を受けません。デバイスが登録されていると見なされます。
混合モード ポリシーの設定のプロパティ
デバイスの混合アクセスを設定するには、プライム ケーブル プロビジョニングがサポートする特定のデバイスに関連付けられているプロパティを設定する必要があります。デバイス タイプの混合アクセスを有効または無効にすることができます。
-
有効:表 1 が説明する API コールに関連付けられた範囲内で、デバイスの混合アクセスを有効にします。
-
無効:混合アクセスを無効にします。プロパティが存在しない場合、デフォルト設定は無効です。
混合アクセスを設定するプロパティのリストについては、表 1 を参照してください。
混合ポリシー プロパティは、読み取り/書き込みおよび読み取り専用プロパティに分類されます。このセクションでは、デバイスへの混合アクセスを有効に設定する必要があり、これらのデバイスのサービス クラスまたは DHCP 条件を選択するように設定する、読み取り/書き込みおよび読み取り専用のプロパティについて説明します。
読み取り/書き込みプロパティ
(注) |
表 1 このセクションで説明されているすべてに該当する API コールについて説明します。 |
表 1 混合アクセスを有効にするために使用できるプロパティについて説明します。
プロパティ名 |
説明 |
---|---|
/promiscuousMode/enable/Computer |
ケーブル モデムのプロパティ階層に「true」または「false」のブール値を設定します。
プロパティがケーブル モデムのプロパティ階層に存在しない場合、そのようなリレーの背後にあるコンピュータの混合アクセスは許可されず、デバイスはデフォルトのアクセスを受信します。 |
API 固定値
|
|
/promiscuousMode/enable/ PacketCableMTA |
ケーブル モデムのプロパティ階層に「true」または「false」のブール値を設定します。
プロパティがケーブル モデムのプロパティ階層に存在しない場合、そのようなリレーの背後にある PacketCable MTA の混合アクセスは許可されず、デバイスはデフォルトのアクセスを受信します。 |
API 固定値
|
|
/promiscuousMode/enable/STB |
ケーブル モデムのプロパティ階層に「true」または「false」のブール値を設定します。
プロパティがケーブル モデムのプロパティ階層に存在しない場合、そのようなリレーの背後にある STB の混合アクセスは許可されず、デバイスはデフォルトのアクセスを受信します。 |
API 固定値
|
|
/promiscuousMode/有効化/CableHomeWanData |
ケーブル モデムのプロパティ階層に「true」または「false」のブール値を設定します。
プロパティがケーブル モデムのプロパティ階層に存在しない場合、そのようなリレーの背後にある WAN データ デバイスの混合アクセスは許可されず、デバイスはデフォルトのアクセスを受信します。 |
API 固定値
|
|
/promiscuousMode/enable/ CableHomeWanMan |
ケーブル モデムのプロパティ階層に「true」または「false」のブール値を設定します。
プロパティがケーブル モデムのプロパティ階層に存在しない場合、そのようなリレーの背後にある WAN-MAN デバイスの混合アクセスは許可されず、デバイスはデフォルトのアクセスを受信します。 |
API 固定値
|
|
/promiscuousMode/enable/ERouter | ケーブル モデムのプロパティ階層に「true」または「false」のブール値を設定します。
true:このようなリレーの背後にある eRouters への混合アクセスを有効にします。 false:このようなリレーの背後にある eRouters への混合アクセスを無効にします。 プロパティがケーブル モデムのプロパティ階層に存在しない場合、そのようなリレーの背後にある eRouters の混合アクセスは許可されず、デバイスはデフォルトのアクセスを受信します。 |
API 固定値
|
|
/promiscuousMode/enable/ |
有効なデバイス タイプの名前にプロパティ名を追加して、新しいデバイス タイプの混合アクセスを有効または無効にするため、このプロパティを使用します。 「true」または「false」のブール値を設定します。 |
API 固定値
|
次の表では、混合アクセス権を付与したデバイスのサービス クラスをを選択するように設定する必要がある、読み取り/書き込みプロパティについて説明します。
サービス クラス プロパティ名 |
説明 |
|
---|---|---|
/provisioning/cpeClassOfService/ Computer |
混合コンピュータに選択される既存のサービス クラス名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeClassOfService/ PacketCableMTA |
混合 PacketCable MTA に選択される既存のサービス クラス名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeClassOfService/ STB |
混合セットトップ ボックスに選択される既存のサービス クラス名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeClassOfService/ CableHomeWanMan |
混合 CableHome WAN データ デバイスに選択される既存のサービス クラス名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeClassOfService/ CableHomeWanData |
混合 CableHome WAN-MAN デバイスに選択される既存のサービス クラス名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeClassOfService/ERouter | 混合 eRouters に選択される既存のサービス クラス名を指定します。 | |
API 固定値
|
||
/provisioning/cpeClassOfService/ |
指定されたデバイス タイプのデバイスに選択される既存サービス クラスを指定します。有効なデバイス タイプ名でこのプロパティ名を使用します。このプロパティはカスタム デバイス タイプに使用できます。 |
|
API 固定値
|
次の表では、混合アクセス権を付与したデバイスの DHCP 条件をを選択するように設定する必要がある、読み取り/書き込みプロパティについて説明します。
DHCP の条件のプロパティ名 |
説明 |
|
---|---|---|
/provisioning/cpeDhcpCriteria/ Computer |
混合コンピュータに選択される既存の DHCP 条件 オブジェクト名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeDhcpCriteria/ PacketCableMTA |
混合 PacketCable MTA に選択される既存の DHCP 条件 オブジェクト名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeDhcpCriteria/STB |
混合セットアップ ボックスに選択される既存の DHCP 条件 オブジェクト名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeDhcpCriteria/ CableHomeWanData |
混合 CableHome WAN データ デバイスに選択される既存の DHCP 条件 オブジェクト名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeDhcpCriteria/ CableHomeWanMan |
混合 CableHome WAN-MAN デバイスに選択される既存の DHCP 条件 オブジェクト名を指定します。 |
|
API 固定値
|
||
/provisioning/cpeDhcpCriteria/ERouter | 混合 eRouters に選択される既存の DHCP 条件 オブジェクト名を指定します。 | |
API 固定値
|
||
/provisioning/cpeDhcpCriteria/ |
指定されたデバイス タイプのデバイスに選択される既存 DHCP 条件オブジェクトを指定します。有効なデバイス タイプ名でこのプロパティ名を使用します。このプロパティはカスタム デバイス タイプに使用できます。 |
|
API 固定値
|
読み取り専用プロパティ
次の表では、デバイスのサービス クラスと DHCP 条件を選択するように設定する必要がある、読み取り専用の混合モード プロパティについて説明します。前のセクションで指定された読み取り/書き込みプロパティと一緒に、これら読み取り専用プロパティは現在のシステム設定の決定をサポートします。
プロパティ名 |
説明 |
|||
---|---|---|---|---|
/isSystemWide/default/promiscuous |
特定のサービス クラスまたは DHCP 条件オブジェクトが、混合モード デバイスのシステム全体のデフォルトとして参照されている場合は、「True」の値を返します。 |
|||
該当する API コール getClassOfServiceProperties getDHCPCriteriaDetails |
API 固定値
|
|||
/referencedBy/deviceTypes/forPromiscuousDevices |
混合モード ポリシー プロパティの特定のサービス クラスまたは DHCP 条件オブジェクトを参照する、デバイス タイプ オブジェクト(テクノロジー)名のリストを返します |
|||
該当する API コール getClassOfServiceProperties getDHCPCriteriaDetails |
API 固定値
|
|||
/related/classesOfService |
混合モード ポリシー プロパティの特定のサービス クラスまたは DHCP 条件オブジェクトが使用される、サービス クラス オブジェクト名のリストを返します
|
|||
該当する API コール getClassOfServiceProperties getDHCPCriteriaDetails |
API 固定値
|
|||
/related/dhcpCriteria |
混合モード ポリシー プロパティで、特定サービス クラスまたは DHCP 条件オブジェクトによって使用される DHCP 条件オブジェクト名のリストを返します
|
|||
該当する API コール getClassOfServiceProperties getDHCPCriteriaDetails |
API 固定値
|
混合モード デバイスのカスタム ポリシー
上記のセクションで指定されたプロパティを使用して、デバイスに混合モード ポリシーを設定することができます。ただし、ロジックを追加する必要がある場合、拡張機能およびカスタム プロパティを使用してカスタム ロジック実装できます。カスタム プロパティは、API 経由でオブジェクト上に保存可能な新しいプロパティの定義が可能になります。
混合モード デバイス ポリシーを拡張するため、これらの拡張機能を使用できます。
-
デバイスの検出:デバイスのテクノロジー タイプを決定します(通常、DHCP 要求のデータに基づく)。拡張が検出される情報は、他の拡張機能が次に使用するデバイスの検出コンテキストに配置されます。
-
サービス レベルの選択:デバイスに適切なサービス クラスと DHCP 条件オブジェクトを選択します。混合モード ポリシーのプロパティは、混合モードのアクセス権を持つデバイスに対して、サービス クラスと DHCP 条件を決定します。
-
設定の生成:デバイスの設定を生成し、必要に応じての背後にあるデバイスにも設定を行います。サービス レベル選択の拡張機能により選択されたポリシーに基づき、ケーブル モデム背後の混合モード デバイスに設定が再生成されます。ケーブル モデム背後のデバイスに設定を再生成するデフォルトの動作を強化する場合にのみ、拡張機能を変更する必要があります。