- Cisco Unified SIP Proxy ソフトウェアの 使用方法
- Cisco Unified SIP Proxy Release 8.5 の マニュアル ロードマップ
- Cisco Unified SIP Proxy モジュール EXEC コマンド
- Cisco Unified SIP Proxy EXEC コマンド
- Cisco Unified SIP Proxy コンフィギュレー ション コマンド
- Cisco Unified SIP Proxy SIP コマンド
- Cisco Unified SIP Proxy SIP サーバ コマンド
- Cisco Unified SIP Proxy RADIUS サーバ コマンド
- Cisco Unified SIP Proxy トリガー コマンド
- Cisco Unified SIP Proxy ルート コマンド
- Cisco Unified SIP Proxy ポリシー コマンド
- Cisco Unified SIP Proxy アカウンティング コマンド
- Cisco Unified SIP Proxy セキュリティ コマンド
- Cisco Unified SIP Proxy のモジュール コマンド
- 索引
Cisco Unified SIP Proxy Release 8.5 CLI コマンド リファレンス
偏向のない言語
この製品のマニュアルセットは、偏向のない言語を使用するように配慮されています。このマニュアルセットでの偏向のない言語とは、年齢、障害、性別、人種的アイデンティティ、民族的アイデンティティ、性的指向、社会経済的地位、およびインターセクショナリティに基づく差別を意味しない言語として定義されています。製品ソフトウェアのユーザーインターフェイスにハードコードされている言語、RFP のドキュメントに基づいて使用されている言語、または参照されているサードパーティ製品で使用されている言語によりドキュメントに例外が存在する場合があります。シスコのインクルーシブランゲージに対する取り組みの詳細は、こちらをご覧ください。
翻訳について
このドキュメントは、米国シスコ発行ドキュメントの参考和訳です。リンク情報につきましては、日本語版掲載時点で、英語版にアップデートがあり、リンク先のページが移動/変更されている場合がありますことをご了承ください。あくまでも参考和訳となりますので、正式な内容については米国サイトのドキュメントを参照ください。
- Updated:
- 2012年3月1日
章のタイトル： Cisco Unified SIP Proxy SIP サーバ コマンド
- server-group sip element-retries
- server-group sip global-load-balance
- server-group sip global-ping
- server-group sip group
- element ip-address（SIP サーバ グループ）
- element reference
- failover-resp-code
- lb-type
- ping（SIP サーバ グループ）
- server-group sip retry-after
- server-group sip ping-options
- method（SIP サーバ グループ ping オプション）
- ping-type
- timeout
- show status server-group sip
Cisco Unified SIP Proxy SIP サーバ コマンド
•
server-group sip element-retries
• server-group sip global-load-balance
• server-group sip global-ping
– element ip-address（SIP サーバ グループ）
– lb-type
• server-group sip retry-after
• server-group sip ping-options
– method（SIP サーバ グループ ping オプション）
– timeout
server-group sip element-retries
すべての SIP サーバ グループでグループ要素の再試行回数を設定するには、Cisco Unified SIP Proxy コンフィギュレーション モードで server-group sip element retries コマンドを使用します。デフォルト値に戻すには、このコマンドの no 形式を使用します。
server-group sip element retries { tcp | tls | udp } number-of-retries
no server-group sip element retries { tcp | tls | udp }
構文の説明
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
要素がダウンしたと見なされるまでに、指定されたプロトコルを通じてサーバ グループ要素に要求を送信しようとする場合の、失敗の最大回数を設定するには、このコマンドを使用します。試行が失敗する原因は、タイムアウトまたはネットワーク エラーが考えられます。
例
次の例では、UDP の再試行値を 5 に設定する方法を示します。
次の例では、UDP の再試行値をデフォルト値に設定する方法を示します。
関連コマンド
|
|
|
|---|---|
server-group sip global-load-balance
すべての SIP サーバ グループのロード バランシング アルゴリズムを設定するには、Cisco Unified SIP Proxy コンフィギュレーション モードで server-group sip global-local-balance コマンドを使用します。ロード バランシング アルゴリズムをすべてのグローバル SIP サーバ グループのデフォルト値に戻すには、このコマンドの no 形式を使用します。
server-group sip global-load-balance { call-id | highest-q | request-uri | to-uri | weight }
no server-group sip global-load-balance
構文の説明
同じ q-value を持つ他の要素の重みに対して、その重みに比例して要素が選択されるよう指定します。この値を適用できるのは、重み付けに基づくルーティングが実装されている場合だけです。 |
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
メッセージがサーバ グループに転送されると、要求を処理するために、最も高い q-value を持つ使用可能な要素が選択されます。使用可能な複数の要素が同一の最も高い q-value を共有している場合、選択されたロード バランシング アルゴリズムにより、これらの要素のいずれがネクストホップになるのかが決定されます。
複数の要素が同一の最も高い q-value に割り当てられている場合、リストの次の要素が使用される前に、最初の要素が最大負荷容量に達します。このカスケーディング ロード バランシング動作のために、すべてのサーバ グループ要素の q-value が異なる場合には、highest-q アルゴリズムだけを使用することを推奨します。
ハッシュ アルゴリズム（ request-uri 、 call-id 、または to-uri ）のいずれかを使用する場合、ハッシュ アルゴリズムが決定論的であっても、キーの値に基づいてこれらの要素にわたって負荷が分散されます。ハッシュ アルゴリズムにより選択される要素が別のサーバ グループへの参照である場合、選択手順もそのサーバ グループに再帰的に適用されます。
（注） すべての SIP サーバ グループのロード バランシング アルゴリズムを決定するには、このコマンドを使用します。このコマンドの設定後に、SIP サーバ グループ コンフィギュレーション モードで lb-type コマンドを使用して、特定の SIP サーバ グループのロード バランシング アルゴリズムを変更できます。
例
次の例では、すべてのグローバルな SIP サーバ グループのロード バランシング アルゴリズムを call-id に基づくように設定する方法を示します。
次の例では、すべてのグローバルな SIP サーバ グループのロード バランシング アルゴリズムを要求 URI に基づくように設定する方法を示します。
次の例では、すべてのグローバルな SIP サーバ グループのロード バランシング アルゴリズムをデフォルト値（要求 URI）に設定する方法を示します。
関連コマンド
|
|
|
|---|---|
server-group sip global-ping
すべての SIP サーバ グループのグローバル ping をイネーブルにするには、Cisco Unified SIP Proxy コンフィギュレーション モードで server-group sip global-ping コマンドを使用します。すべての SIP サーバ グループのグローバル ping をディセーブルにするには、このコマンドの no 形式を使用します。
no server-group sip global-ping
構文の説明
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
ping メカニズムを通じてグローバルに、サーバ グループ要素ステータスのモニタリングをイネーブルまたはディセーブルにするには、このコマンドを使用します。ping オプションは server-group sip ping-options コマンドを使用して設定します。
例
次の例では、SIP サーバ グループのグローバル ping をイネーブルにします。
関連コマンド
|
|
|
|---|---|
server-group sip group
SIP サーバ グループを設定し、SIP サーバ グループ コンフィギュレーション モードを開始するには、Cisco Unified SIP Proxy コンフィギュレーション モードで server-group sip group コマンドを使用します。SIP サーバ グループを削除するには、このコマンドの no 形式を使用します。
server-group sip group server-group-name network
no server-group sip group server-group-name network
構文の説明
| （注） 使用されるサーバ グループ名は、発信要求の SIP URI に挿入されます。Cisco Unified CM などの一部のデバイスでは、処理前に要求の URI を検証するため、サーバ グループ名の設定は慎重に行う必要があります。この機能性を実現するために、完全修飾ドメイン名（FQDN）を使用してエンド デバイスを設定することが必要になる場合があります。 | |
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
このコマンドを使用する前に、 network 引数により指定されたネットワークを設定する必要があります。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。サーバ グループ要素が設定されたら、そのサーバ グループをアクティブにする前に、commit コマンドを使用する必要があります。
例
次の例では、「internal」というネットワークを使用する SIP サーバ グループ「sg1」を作成し、サーバ グループ SIP コンフィギュレーション モードを開始する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
element ip-address（SIP サーバ グループ）
SIP サーバ グループの IP 要素を作成し、その特性を決定するには、SIP サーバ グループ コンフィギュレーション モードで element ip-address コマンドを使用します。IP 要素を SIP サーバ グループから削除するには、このコマンドの no 形式を使用します。
element ip-address ipaddress port { udp | tcp | tls } [ q-value q-value ] [ weight weight ]
no element ip-address ipaddress port { udp | tcp | tls } [ q-value q-value ] [ weight weight ]
構文の説明
コマンド デフォルト
コマンド モード
SIP サーバ グループ コンフィギュレーション（cusp-config-sg）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、q-value が 1.0 で、重みが 0 （デフォルト値）のサーバ グループに対して要素を作成する方法を示します。
次の例では、q-value が 0.5 で、重みが 0 の TCP を使用するサーバ グループに対して要素を作成する方法を示します。
次の例では、サーバ グループから要素を削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
element reference
SIP サーバ グループの参照要素を作成し、その特性を決定するには、SIP サーバ グループ コンフィギュレーション モードで element reference コマンドを使用します。参照要素を SIP サーバ グループから削除するには、このコマンドの no 形式を使用します。
element reference reference [ q-value q-value ] [ weight weight ]
no element reference reference
構文の説明
（オプション）サーバ グループ内の他の要素に対する、サーバ グループ要素のプライオリティを指定する実数。有効な値は 0.0 ～ 1.0 です。デフォルトの q-value は 1.0 です。 |
|
（オプション）重み付けに基づくルーティングを実装する場合に参照要素に割り当てられる割合。有効な範囲は 0 ～ 100 です。デフォルトの重みは 0 です。 |
コマンド デフォルト
コマンド モード
SIP サーバ グループ コンフィギュレーション（cusp-config-sg）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、q-value が 1.0 で、重みが 0 （デフォルト）のグループに、サーバ グループ要素を追加する方法を示します。
次の例では、q-value が 0.5 で、重みが 0 のグループに、サーバ グループ要素を追加する方法を示します。
次の例では、サーバ グループから要素を削除する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
failover-resp-code
SIP サーバ グループのフェールオーバー応答コードを設定するには、SIP サーバ グループ コンフィギュレーション モードで failover-resp-code コマンドを使用します。フェールオーバー応答コードを削除するには、このコマンドの no 形式を使用します。
failover-resp-code response-codes [ - response-codes ] [ , response-codes ]
構文の説明
コマンド デフォルト
コマンド モード
SIP サーバ グループ コンフィギュレーション（cusp-config-sg）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
複数のフェールオーバー応答コードを設定するには、個々のコードをカンマで区切り、ダッシュ記号を使用して範囲を指定します。カンマとダッシュの後にスペースを入力する必要があります。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、応答コード 503、505、506、507、または 580 のいずれかが、次のサーバ グループ要素へのフェールオーバーをトリガーできるように、フェールオーバー応答コードを設定する方法を示します。
次の例では、応答コード 500 および 503 だけが次のサーバ グループ要素へのフェールオーバーをトリガーできるように、フェールオーバー応答コードを設定する方法を示します。
次の例では、応答コードにより次のサーバ グループ要素へのフェールオーバーがトリガーされないように、フェールオーバー応答コードを設定する方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
lb-type
SIP サーバ グループのロード バランシング アルゴリズムを設定するには、SIP サーバ グループ コンフィギュレーション モードで lb-type コマンドを使用します。ロード バランシング アルゴリズムを SIP サーバ グループから削除し、デフォルト値に戻すには、このコマンドの no 形式を使用します。
lb-type {global | highest-q | request-uri | call-id | to-uri | weight }
no lb-type {global | highest-q | request-uri | call-id | to-uri | weight }
構文の説明
コマンド デフォルト
コマンド モード
SIP サーバ グループ コンフィギュレーション（cusp-config-sg）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
複数の要素が同一の最も高い q-value に割り当てられている場合、リストの次の要素が使用される前に、最初の要素が最大負荷容量に達します。このカスケーディング ロード バランシング動作のために、すべてのサーバ グループ要素の q-value が異なる場合には、highest-q アルゴリズムだけを使用することを推奨します。
このコマンドでは、ロード バランス タイプが単一の SIP サーバ グループにだけ適用されます。ロード バランス タイプをすべての SIP サーバ グループに適用するには、 server-group sip global-load-balance コマンドを使用します。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、SIP サーバ グループのロード バランシング タイプをグローバルに設定する方法を示します。
次の例では、SIP サーバ グループのロード バランシング アルゴリズムを、要求 URI に設定する方法を示します。
次の例では、SIP サーバ グループのロード バランシング タイプを、重み付けに基づくルーティングに設定する方法を示します。
次の例では、ロード バランシング タイプをデフォルト値（global）に戻す方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
ping（SIP サーバ グループ）
サーバ グループの ping をイネーブルにするには、SIP サーバ グループ コンフィギュレーション モードで ping コマンドを使用します。サーバ グループの ping をディセーブルにするには、このコマンドの no 形式を使用します。
構文の説明
コマンド デフォルト
コマンド モード
SIP サーバ グループ コンフィギュレーション（cusp-config-sg）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
特定のサーバ グループの ping がイネーブルになっている場合でも、 server-group sip global-ping command がイネーブルになるまで、ping は開始しません。
（注） このコマンドでは、コンフィギュレーションの変更を反映するために commit コマンドを使用する必要があります。
例
次の例では、サーバ グループの ping をイネーブルにする方法を示します。
次の例では、サーバ グループの ping をディセーブルにする方法を示します。
関連コマンド
|
|
|
|---|---|
反映するように選択された Cisco Unified SIP Proxy コマンドのコンフィギュレーションの変更を有効にします。 |
|
server-group sip retry-after
すべての SIP サーバ グループのフェールオーバー応答タイムアウト値を設定するには、Cisco Unified SIP Proxy コンフィギュレーション モードで server-group sip retry-after コマンドを使用します。すべての SIP サーバ グループのフェールオーバー応答タイムアウト値をデフォルト値に戻すには、このコマンドの no 形式を使用します。
server-group sip retry-after retry-after-time
no server-group sip retry-after
構文の説明
応答に Retry-After ヘッダー フィールドが含まれていない場合に、フェールオーバー応答を受信してから、過負荷状態になったサーバ グループ要素が再び使用可能になるまでの時間（ミリ秒）を指定します。応答に Retry-After ヘッダー フィールドが含まれている場合、ヘッダー フィールドの値が使用されます。最小値は 0 です。デフォルトは 0 です。 |
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
例
次の例では、すべての SIP サーバ グループの再試行タイムアウト値を 6,000 ミリ秒に設定する方法を示します。
次の例では、再試行タイムアウト値を 0 （デフォルト）に戻す方法を示します。
関連コマンド
|
|
|
|---|---|
server-group sip ping-options
SIP サーバ グループの ping オプションを設定し、SIP サーバ グループ ping オプション コンフィギュレーション モードを開始するには、Cisco Unified SIP Proxy コンフィギュレーション モードで server-group sip ping-options コマンドを使用します。サブモードでコマンドの ping オプションをデフォルト値に戻すには、このコマンドの no 形式または default 形式を使用します。
server-group sip ping-options network ip-address port
no server-group sip ping-options network
default server-group sip ping-options network
構文の説明
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy コンフィギュレーション（cusp-config）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
このコマンドは、転送タイプが UDP のサーバ グループ要素にだけ関連するものです。 no コマンドを使用するには、ping オプションが存在している必要があります。
例
次の例では、IP アドレスが 10.2.3.4 で、「internal」という名前の SIP サーバ グループの ping オプションを設定する方法を示します。
次の例では、「internal」という名前の SIP サーバ グループのすべての ping オプションをデフォルト値に設定する方法を示します。
関連コマンド
|
|
|
|---|---|
method（SIP サーバ グループ ping オプション）
SIP サーバ グループ ping の要求方式を設定するには、SIP サーバ グループ ping オプション コンフィギュレーション モードで method コマンドを使用します。SIP サーバ グループ ping の要求方式を削除するには、このコマンドの no 形式または default 形式を使用します。
構文の説明
コマンド デフォルト
コマンド モード
SIP サーバ グループ ping オプション コンフィギュレーション（cusp-config-ping）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
このコマンドは、単一の SIP サーバ グループの ping オプション方式にだけ適用されます。すべての SIP サーバ グループに対してグローバル ping オプションを適用するには、 server-group sip global-ping-options コマンドを使用します。
例
次の例では、SIP サーバ グループ ping オプション方式を OPTIONS（デフォルト）に設定する方法を示します。
次の例では、SIP サーバ グループ ping オプション方式を PING に設定する方法を示します。
次の例では、SIP サーバ グループ ping オプション方式をデフォルト値に戻す方法を示します。
関連コマンド
|
|
|
|---|---|
ping-type
SIP サーバ グループの ping タイプおよび間隔を設定するには、SIP サーバ グループ ping オプション コンフィギュレーション モードで ping-type コマンドを使用します。デフォルト値に戻すには、このコマンドの no 形式または default 形式を使用します。
ping-type { proactive | reactive | adaptive } ping-interval [ adaptive-ping-interval-for-up-element ]
構文の説明
コマンド デフォルト
コマンド モード
SIP サーバ グループ ping オプション コンフィギュレーション（cusp-config-ping）
コマンド履歴
|
|
|
|---|---|
使用上のガイドライン
ping がバースト送信されないようにするために、要素は同時に ping されず、特定の間隔で ping されます。たとえば、ping 間隔が 50 ミリ秒に設定されており、サーバ グループに対して 3 つの要素が設定されているとします。ping は最初の要素に対して送信されます。50 ミリ秒後、2 つ目の要素に対して ping が送信されます。最後に、さらに 50 ミリ秒後、3 つ目の要素に対して ping が送信されます。
例
次の例では、ping 間隔を 1,000 ミリ秒にして、リアクティブな ping をサーバ グループに設定する方法を示します。
次の例では、ping 間隔を 2,000 ミリ秒にして、プロアクティブな ping をサーバ グループに設定する方法を示します。
次の例では、down 要素の ping 間隔を 1,000 ミリ秒、up 要素の ping 間隔を 2,000 ミリ秒にして、アダプティブな ping をサーバ グループに設定する方法を示します。
次の例では、サーバ グループの ping タイプのデフォルト値（ping 間隔が 1,000 ミリ秒のリアクティブな ping）に戻す方法を示します。
関連コマンド
|
|
|
|---|---|
timeout
SIP サーバ グループの ping タイムアウト間隔を設定するには、Cisco Unified SIP Proxy SIP サーバ グループ ping オプション コンフィギュレーション モードで timeout コマンドを使用します。SIP サーバ グループから ping タイムアウト間隔を削除し、デフォルト値に戻すには、このコマンドの no 形式または default 形式を使用します。
構文の説明
ping が失敗したと見なされるまでの、ping と応答の間隔の最大時間数（ミリ秒）を指定します。指定できる最小値は 0 です。デフォルト値は 500 です。 |
コマンド デフォルト
コマンド モード
Cisco Unified SIP Proxy SIP サーバ グループ ping オプション コンフィギュレーション（cusp-config-ping）
コマンド履歴
|
|
|
|---|---|
例
次の例では、SIP サーバ グループの ping タイムアウト間隔を 500 ミリ秒に設定する方法を示します。
次の例では、SIP サーバ グループの ping タイムアウト間隔を 1000 ミリ秒に設定する方法を示します。
次の例では、SIP サーバの ping タイムアウト間隔をデフォルト値に戻す方法を示します。
関連コマンド
|
|
|
|---|---|
show status server-group sip
すべての SIP サーバ グループまたは単一の SIP サーバ グループのステータスを表示するには、Cisco Unified SIP Proxy EXEC モードで show status server-group sip コマンドを使用します。
show status server-group sip [ server-group-name ]
構文の説明
コマンド モード
Cisco Unified SIP Proxy EXEC （cusp）
コマンド履歴
|
|
|
|---|---|
例
次の例は、 show status server-group sip コマンドの出力例です。
表 5 に、この出力で表示される重要なフィールドの説明を示します。
|
|
|
|---|---|
重み付けに基づくルーティングを実装する場合に、ルート グループの request-URI または route-URI 要素に割り当てられる割合を表示します。 |
|
関連コマンド
|
|
|
|---|---|
フィードバック