- ホーム
- /
- 投稿記事
コメントありがとうございます。
9800シリーズと8875電話のプロビジョニングパラメータ（ブロードワークス）
この記事の内容
フィードバックがある場合このヘルプ記事は、シスコブロードワークスに登録されているシスコデスクフォン9800シリーズとシスコビデオフォン8875を対象としています。このページの情報には、プロビジョニングパラメータとその構文が含まれます。
プロビジョニングパラメータタイプ
このセクションでは、機能別に大まかに分類されたプロビジョニングパラメータについて説明します。
汎用パラメーター
汎用パラメータGPP_*（）は、特定のプロビジョニングサーバーソリューションと通信するように電話を設定する際のフリーストリングレジスタとして使用されます。 GPP_*パラメータはデフォルトでは空です。 これらは、次のようなさまざまな値を含むように構成できます。
-
暗号化キー
-
URL
-
多段階プロビジョニングのステータス情報。
-
投稿依頼テンプレート
-
パラメータ名のエイリアスマップ
-
部分的な文字列値、最終的には完全なパラメータ値に結合されます。
GPP_*パラメータは、他のプロビジョニングパラメータ内でのマクロ展開に使用できます。 このためには、GPP_AからGPP_Pの内容を識別するには、1文字の大文字のマクロ名（AからP）で十分です。 また、SAからSDまでの2文字の大文字マクロ名は、次のURLオプションの引数として使用すると、GPP_SAからGPP_SDまでが特殊ケースであることがわかります。
キー、UID、およびパスワード
これらのパラメータは、プロビジョニングとアップグレードのルールで変数として使用できます。 変数名の前に「$」文字を付けることで参照されます（$GPP_A など）。
パラメータを有効にする
Provision_EnableとUpgrade_Enableのパラメータは、すべてのプロファイルの再同期とファームウェアのアップグレード操作を制御します。 これらのパラメータは、再同期とアップグレードを互いに独立して制御します。 これらのパラメータは、管理Webサーバーを介して発行されるURLの再同期およびアップグレードコマンドも制御します。 これらのパラメータは両方とも、デフォルトで 「はい」 に設定されています。
Resync_from_SIPパラメータは、再同期操作のリクエストを制御します。 SIP NOTIFYイベントは、サービスプロバイダーのプロキシサーバーから電話に送信されます。 有効にすると、プロキシは再同期を要求できます。 そのために、プロキシはEvent: resyncヘッダーを含むSIP NOTIFYメッセージをデバイスに送信します。
デバイスは401応答でリクエストに挑戦します（使用された資格情報の認証が拒否されました）。 デバイスは、プロキシからの再同期要求を受け入れる前に、認証された後続のリクエストを待っています。 イベント:reboot_now ヘッダーと Event: restart_now ヘッダーは、それぞれコールドリスタートとウォームリスタートを実行しますが、これらもチャレンジされます。
残りの2つの有効化は、再同期時リセットと再同期後_アップグレード_試行です。 これらのパラメータは、電源投入後のソフトウェアの再起動後やアップグレードを試みた後にデバイスが再同期操作を実行するかどうかを決定します。
Resync_On_Resetが有効になっていると、デバイスはリセットが実行される前の起動シーケンスに従ってランダムな遅延を発生させます。 遅延は、Resync_Random_Delay（秒単位）で指定された値までのランダム時間です。 同時に電源が入る電話プールでは、この遅延により各ユニットからの再同期要求の開始時間が分散されます。 この機能は、大規模な住宅施設で、地域の停電が発生した場合に役立ちます。
トリガー
電話では、特定の間隔または特定の時間に再同期できます。
特定の間隔で再同期します
電話は定期的にプロビジョニングサーバーと再同期するように設計されています。 再同期間隔は、Resync_Periodic（秒）で設定されています。 この値を空のままにすると、デバイスは定期的に再同期されません。
再同期は通常、音声回線がアイドル状態のときに行われます。 再同期の期日に音声回線がアクティブな場合、電話は回線が再びアイドル状態になるまで再同期処理を遅らせます。 再同期により、構成パラメータの値が変更される可能性があります。
電話がサーバーからプロファイルを取得できない、ダウンロードしたファイルが破損している、または内部エラーが発生したために、再同期操作が失敗することがあります。 デバイスは、Resync_Error_Retry_Delay（秒）で指定された時間が経過すると、再同期を試みます。 Resync_Error_Retry_Delayが0に設定されている場合、デバイスは再同期に失敗した後も再同期を試みません。
アップグレードが失敗した場合、Upgrade_Error_Retry_Delay秒後に再試行が実行されます。
条件付きで再同期をトリガーするために、Resync_Trigger_1とResync_Trigger_2の2つの設定可能なパラメーターがあります。 各パラメータは、マクロ展開を行う条件式でプログラムできます。 再同期間隔（次の再同期の時間）が切れると、トリガーが設定されている場合、1つ以上のトリガーがtrueと評価されない限り再同期は行われません。
次の条件例では、再同期がトリガーされます。 この例では、前回の電話アップグレードの試行が5分（300秒）以上経過し、最後の再同期試行から少なくとも10分（600秒）が経過しています。
$UPGTMR gt 300 and $PRVTMR ge 600特定の時間に再同期する
Resync_Atパラメータを使用すると、特定の時間に電話を再同期できます。 このパラメータは24時間形式（hhmm）を使用して時間を指定します。
Resync_At_Random_Delayパラメータを使用すると、不特定の遅延で電話を再同期できます。 このパラメータは正の整数形式で時間を指定します。
同時に再同期するように設定された複数の電話からの再同期要求でサーバーが殺到することは避けてください。 そのために、電話は指定された時間の最大10分後に再同期をトリガーします。
たとえば、再同期時間を 10:00（午前10時）に設定すると、電話は午前10時から午前10時10分までの間にいつでも再同期を開始します。
デフォルトでは、この機能は無効になっています。 Resync_Atパラメーターがプロビジョニングされている場合、Resync_Periodicパラメーターは無視されます。
設定可能なスケジュール
次のプロビジョニングパラメータを使用して、定期的な再同期のスケジュールを設定したり、再同期やアップグレードが失敗した場合の再試行間隔を指定したりできます。
-
再同期_定期的
-
再同期_エラー_リトライ_ディレイ
-
アップグレード_エラー_リトライ_ディレイ
各パラメータには、1つの遅延値（秒）を指定できます。 新しい拡張構文では、連続する遅延要素をコンマで区切ってリストできます。 シーケンスの最後の要素は暗黙的に永遠に繰り返されます。
オプションで、プラス記号を使用して、ランダムに余分な遅延を追加する別の数値を指定できます。
例1
この例では、電話は2時間ごとに定期的に再同期します。 再同期に失敗した場合、デバイスは30分、1時間、2時間、4時間の間隔で再試行します。 デバイスは正常に再同期されるまで、4時間間隔で試行を続けます。
Resync_Periodic=7200
Resync_Error_Retry_Delay=1800,3600,7200,14400
例2
この例では、デバイスは1時間ごとに定期的に再同期します（さらに最大10分の余分な遅延があります）。 再同期に失敗した場合、デバイスは次の間隔で再試行します：30分（プラス最大5分）。 1時間（プラス最大10分）、2時間（プラス最大15分）。 デバイスは正常に再同期されるまで、2時間（プラス最大15分）の間隔で試行を続けます。
Resync_Periodic=3600+600
Resync_Error_Retry_Delay=1800+300,3600+600,7200+900
例3
この例では、リモートアップグレードが失敗すると、デバイスは30分後にアップグレードを再試行し、さらに1時間後、2時間後に再試行します。 それでもアップグレードが失敗した場合、デバイスはアップグレードが成功するまで4〜5時間ごとに再試行します。
Upgrade_Error_Retry_Delay = 1800,3600,7200,14400+3600
プロフィールルール
電話機は複数のリモート設定プロファイルパラメータ（Profile_Rule*）を提供します。 したがって、各再同期操作では、異なるサーバーが管理する複数のファイルを取得できます。
最も単純なシナリオでは、デバイスは中央サーバー上の1つのプロファイルに定期的に再同期され、関連するすべての内部パラメーターが更新されます。 または、プロファイルを異なるファイルに分割することもできます。 1つのファイルは、導入環境内のすべての電話で共通です。 アカウントごとに個別の固有のファイルが提供されます。 暗号化キーと証明書情報は、別のサーバーに保存されている別のプロファイルで提供できます。
再同期操作の期限が来ると、電話は4つのProfile_Rule*パラメータを順番に評価します。
-
プロフィール_ルール
-
プロフィール_ルール_B
-
プロフィール_ルール_C
-
プロフィール_ルール_D
評価するたびに、リモートプロビジョニングサーバーからプロファイルが取得され、いくつかの内部パラメーターが更新される可能性があります。 評価が失敗した場合、再同期シーケンスは中断され、Resync_Error_Retry_Delayパラメーターで指定された最初から再試行されます（秒）。 すべての評価が成功すると、デバイスはResync_Periodicパラメーターで指定された秒数を待ってから、もう一度再同期を実行します。
Profile_Rule*の各パラメーターの内容は、いくつかの選択肢で構成されています。 選択肢は | (パイプ) 文字で区切られています。 それぞれの選択肢は、条件式、代入式、プロファイルURL、および関連するURLオプションで構成されています。 これらのコンポーネントはすべて、それぞれの選択肢の中でオプションです。 以下は有効な組み合わせと、存在する場合はその順序です。
[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]
Profile_Rule*の各パラメーター内で、最後の選択肢を除くすべての選択肢に条件式を指定する必要があります。 この表現は次のように評価され、処理されます。
-
条件は、真と評価される条件が見つかるまで（または条件式なしで1つの選択肢が見つかるまで）、左から右に評価されます。
-
付随する代入式があれば評価されます。
-
その代替手段の一部としてURLが指定されている場合、指定されたURLにあるプロファイルのダウンロードが試みられます。 システムは、それに応じて内部パラメータを更新しようとします。
すべての選択肢に条件式があり、どれも真と評価されない場合（またはプロファイルルール全体が空の場合）、Profile_Rule*パラメーター全体がスキップされます。 シーケンスの次のプロファイルルールパラメータが評価されます。
例1
この例では、指定されたURLのプロファイルに無条件に再同期し、リモートプロビジョニングサーバーへのHTTP GETリクエストを実行します。
http://remote.server.com/cisco/$MA.cfg
例2
この例では、デバイスは回線1の登録状態に応じて、2つの異なるURLに再同期します。 登録を紛失した場合、デバイスはCGIスクリプトにHTTP POSTを実行します。 デバイスはマクロ展開されたGPP_Aの内容を送信します。これにより、デバイスの状態に関する追加情報が得られる場合があります。
($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg
| [--post a] http://p.tel.com/lost-reg?
例3
この例では、デバイスは同じサーバーに再同期します。 証明書がユニットにインストールされていない場合（2.0より前のレガシーユニットの場合）、デバイスは追加情報を提供します：
(“$CCERT” eq “Installed”)? https://p.tel.com/config?
| https://p.tel.com/config?cisco$MAU
例 4
この例では、GPP_Aが最初のURLでプロビジョニング済みと等しく設定されるまで、1行目は無効です。 その後、2番目のURLに再同期します。
(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov
| https://p.tel.com/configs
例5
この例では、サーバーが返すプロファイルにはXML要素タグが含まれていると想定されています。 これらのタグは、GPP_Bに保存されているエイリアスマップによって適切なパラメータ名に再マップする必要があります。
[--alias b] https://p.tel.com/account/$PN$MA.xml
要求されたプロファイルがサーバーから受信されない場合、再同期は通常、失敗したと見なされます。 Resync_fails_on_FNFパラメータは、このデフォルトの動作をオーバーライドできます。 resync_fails_on_FNFが「いいえ」に設定されている場合、デバイスはサーバーからのファイルが見つからないという応答を正常に再同期として受け入れます。 Resync_fails_on_FNFのデフォルト値は「はい」です。
アップグレードルール
アップグレードルールは、デバイスを新しいロードでアクティブにし、必要に応じてロードをどこから取得するかを指示することです。 デバイスにすでに負荷がかかっている場合は、負荷を取得しようとはしません。 つまり、目的のロードが非アクティブなパーティションにある場合は、ロード場所の有効性は関係ありません。
Upgrade_Ruleは、条件式で制限されているか、Upgrade_Enableが「いいえ」に設定されていない限り、現在の負荷と異なる場合にダウンロードして適用されるファームウェアの負荷を指定します。
電話には、設定可能なリモートアップグレードパラメータ、Upgrade_Ruleが1つあります。 このパラメータは、プロファイルルールパラメータと同様の構文を受け入れます。 アップグレードではURLオプションはサポートされていませんが、条件式と代入式は使用できます。 条件式を使用する場合、パラメーターには複数の選択肢を | 文字で区切って入力できます。 それぞれの選択肢の構文は次のとおりです。
[ conditional-expr ] [ assignment-expr ] URL
Profile_Rule*パラメーターの場合と同様に、Upgrade_Ruleパラメーターは、条件式が満たされるか、代替に条件式がなくなるまで、各選択肢を評価します。 付随する代入式が指定されていれば評価されます。 次に、指定されたURLへのアップグレードが試みられます。
Upgrade_Ruleに条件式のないURLが含まれている場合、デバイスはURLで指定されたファームウェアイメージにアップグレードされます。 マクロ展開とルールの評価の後、ルールが変更されるか、スキーム+サーバー+ポート+ファイルパスの有効な組み合わせが変更されるまで、デバイスはアップグレードを再試行しません。
ファームウェアのアップグレードを試みる場合、デバイスは手順の開始時にオーディオを無効にし、手順の最後に再起動します。 デバイスは、すべての音声回線が現在非アクティブな場合にのみ、Upgrade_Ruleの内容に基づいてアップグレードを自動的に開始します。
例えば、
https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loadsこの例では、Upgrade_Ruleは指定されたURLに保存されているイメージにファームウェアをアップグレードします。
これは別の例です：
(“$F” ne “beta-customer”)? http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads
| http://p.tel.com/firmware/PHONEOS-8875.1-0-1-0001-1.loads
この例では、汎用パラメーターGPP_Fの内容に基づいて、2つの画像のうちの1つをロードするようにユニットに指示します。
プロビジョニングパラメーター
プロビジョニングパラメータは、電話のウェブページの「プロビジョニング」タブにあります。
設定プロファイルのパラメーター
次の表は、「プロビジョニング」タブの「構成プロファイルパラメーター」セクションの各パラメーターの機能と使用方法を定義しています。
|
パラメータ名 |
説明とデフォルト値 |
|---|---|
|
プロビジョニングを有効にする |
ファームウェアのアップグレードアクションとは無関係に、すべての再同期アクションを制御します。 リモートプロビジョニングを有効にするには 「はい」 に設定してください。 デフォルト値は「はい」です。 |
|
リセット時に再同期 |
パラメータの更新とファームウェアのアップグレードによる再起動を除いて、再起動するたびに再同期を開始します。 デフォルト値は「はい」です。 |
|
再同期のランダム遅延 |
起動シーケンスに続いてリセットを実行するまでのランダムな遅延。秒単位で指定します。 同時に電源投入が予定されているIPテレフォニーデバイスのプールでは、各ユニットがプロビジョニングサーバーに再同期要求を送信する時間が異なります。 この機能は、大規模な住宅施設で、地域の停電が発生した場合に役立ちます。 このフィールドの値は、0から65535までの整数でなければなりません。 デフォルト値は2です。 |
|
で再同期（うーん） |
デバイスがプロビジョニングサーバーと再同期する時間（うーん）。 このフィールドの値は、HHmm形式の時間を示すために0000から2400までの4桁の数字でなければなりません。 たとえば、0959は 09:59 を示します。 デフォルト値は空です。 値が無効な場合、パラメータは無視されます。 このパラメータに有効な値を設定すると、Resync Periodic パラメータは無視されます。 |
|
ランダムな遅延で再同期します |
多数のデバイスの電源が同時にオンになったときの、プロビジョニングサーバーの過負荷を防ぎます。 複数の電話からサーバーへの再同期要求が殺到しないように、電話は時間と分、時間と分にランダムな遅延（hhmm、hhmm+random_delay）を加えた範囲で再同期します。 たとえば、ランダム遅延 = (ランダム遅延での再同期 + 30) /60分の場合、秒単位の入力値が分単位に変換され、次の分まで切り上げられて最終的なrandom_delay間隔が計算されます。 有効な値の範囲は600から65535です。 値が600未満の場合、内部のランダム遅延は0から600の間です。 デフォルト値は600秒（10分）です。 |
|
定期再同期 |
プロビジョニングサーバーと定期的に再同期する間の時間間隔。 関連する再同期タイマーは、サーバーとの最初の同期が成功した後にのみアクティブになります。 有効な形式は次のとおりです。
定期的な再同期を無効にするには、このパラメータをゼロに設定してください。 デフォルト値は3600秒です。 |
|
再同期エラー再試行遅延 |
IPテレフォニーデバイスがサーバーからプロファイルを取得できなかったか、ダウンロードしたファイルが破損しているか、内部エラーが発生したために再同期操作が失敗した場合、デバイスは秒単位で指定された時間が経過した後に再同期を試みます。 有効な形式は次のとおりです。
遅延が0に設定されている場合、デバイスは再同期に失敗した後も再同期を試みません。 |
|
強制再同期遅延 |
再同期を実行する前に電話が待機する最大遅延（秒単位）。 電話回線の1つがアクティブな間は、デバイスは再同期しません。 再同期には数秒かかることがあるので、再同期する前にデバイスが長時間アイドル状態になるまで待つことをお勧めします。 これにより、ユーザーは中断することなく連続して電話をかけることができます。 このデバイスには、すべての回線がアイドル状態になるとカウントダウンを開始するタイマーがあります。 このパラメータはカウンターの初期値です。 再同期イベントは、このカウンタがゼロになるまで遅延されます。 有効な値の範囲は0から65535です。 デフォルト値は14,400秒です。 |
|
SIPから再同期 |
SIP NOTIFYメッセージを介して再同期をトリガーできるようにします。 デフォルト値は「はい」です。 |
|
アップグレードを試みた後に再同期します |
アップグレードが行われた後の再同期操作を有効または無効にします。 「はい」を選択すると、同期がトリガーされます。 デフォルト値は「はい」です。 |
|
再同期トリガー1、再同期トリガー2 |
設定可能な再同期トリガー条件。 これらのパラメーターの論理式がTRUEと評価されると、再同期がトリガーされます。 デフォルト値は (空) です。 |
|
FNFで再同期が失敗する |
要求されたプロファイルがサーバーから受信されない場合、再同期は失敗したと見なされます。 これはこのパラメータで上書きできます。 いいえに設定すると、デバイスはサーバーからの デフォルト値は「はい」です。 |
|
プロフィールルール プロファイルルールB プロファイルルールC プロファイルルールD |
各プロファイルルールは、プロファイル（設定ファイル）を取得するソースを電話に通知します。 再同期操作のたびに、電話はすべてのプロファイルを順番に適用します。 デフォルト:
オプションで、暗号化キーを二重引用符（「）で囲むことができます。 |
|
使用するDHCPオプション |
ファームウェアとプロファイルを取得するために使用される、カンマで区切られたDHCPオプション。 デフォルト値は66,160,159,150,60,43,125です。 |
|
ログリクエストメッセージ |
このパラメータには、再同期の開始時にSyslogサーバーに送信されるメッセージが含まれています。
|
|
成功メッセージをログに記録します |
再同期が正常に完了したときに発行されるsyslogメッセージ。 デフォルト値は |
|
障害メッセージをログに記録します |
再同期が失敗した後に発行されるsyslogメッセージ。
|
|
ユーザー設定可能な再同期 |
ユーザーがIP電話画面から電話を再同期できるようにします。 デフォルト値は「はい」です。 |
ファームウェアのアップグレードパラメーター
次の表は、「プロビジョニング」タブの「ファームウェアアップグレード」セクションの各パラメーターの機能と使用方法を定義しています。
|
パラメータ名 |
説明とデフォルト値 |
|---|---|
|
アップグレードを有効にする |
再同期アクションとは無関係にファームウェアのアップグレード操作を可能にします。 デフォルト値は「はい」です。 このパラメータは次のいずれかの方法で設定します。
|
|
アップグレードエラー、再試行遅延 |
アップグレードが失敗した場合に適用されるアップグレード再試行間隔（秒単位）。 デバイスには、ファームウェアのアップグレードに失敗するとアクティブになるファームウェアアップグレードエラータイマーがあります。 タイマーはこのパラメーターの値で初期化されます。 次のファームウェアのアップグレードは、このタイマーのカウントダウンがゼロになったときに行われます。 デフォルト値は3600秒です。 このパラメータは次のいずれかの方法で設定します。
|
|
アップグレードルール |
アップグレード条件と関連するファームウェアのURLを定義するファームウェアアップグレードスクリプト。 プロファイルルールと同じ構文を使用します。 アップグレードルールを入力するには、次の形式を使用してください。
例えば: プロトコルが指定されていない場合は、TFTPが想定されます。 サーバー名が指定されていない場合は、URLをリクエストしたホストがサーバー名として使用されます。 ポートが指定されていない場合は、デフォルトのポートが使用されます（TFTPの場合は69、HTTPの場合は80、HTTPSの場合は443）。 デフォルト値は空白です。 このパラメータは次のいずれかの方法で設定します。
|
|
アップグレードリクエストメッセージをログに記録してください |
ファームウェアのアップグレードの開始時に発行されるSyslogメッセージ。 デフォルト: このパラメータは次のいずれかの方法で設定します。
|
|
アップグレード成功メッセージをログに記録します |
ファームウェアのアップグレードが正常に完了した後に発行されるSyslogメッセージ。
このパラメータは次のいずれかの方法で設定します。
|
|
アップグレード失敗メッセージをログに記録します |
ファームウェアのアップグレードに失敗した後に発行されるSyslogメッセージ。
このパラメータは次のいずれかの方法で設定します。
|
|
ピアファームウェア共有 |
ピアファームウェア共有（PFS）機能を有効または無効にします。 この機能を有効または無効にするには、「はい」または「いいえ」を選択してください。 デフォルト:はい このパラメータは次のいずれかの方法で設定します。
|
|
ピアファームウェア共有ログサーバー |
UDPメッセージの送信先のIPアドレスとポートを示します。 例:10.98.76. 123:514 ここで、10.98.76.123はIPアドレス、514はポート番号です。 このパラメータは次のいずれかの方法で設定します。
|
汎用パラメーター
次の表は、「プロビジョニング」タブの「汎用パラメーター」セクションの各パラメーターの機能と使用方法を定義しています。
|
パラメータ名 |
説明とデフォルト値 |
|---|---|
|
GPP A - GPP P |
汎用パラメータGPP_*は、特定のプロビジョニングサーバーソリューションと通信するように電話を設定するときにフリーストリングレジスタとして使用されます。 これらは、次のようなさまざまな値を含むように構成できます。
デフォルト値は空白です。 |
マクロ展開変数
特定のマクロ変数は、次のプロビジョニングパラメータ内で認識されます。
-
プロフィール_ルール
-
プロフィール_ルール_*
-
再同期_トリガー_*
-
アップグレード_ルール
-
log_*
-
GPP_*（特定の条件下で）
これらのパラメータ内では、$NAMEや$ (NAME) などの構文タイプが認識され、展開されます。
マクロ変数の部分文字列は、$ (名前:P) と $ (名前:P: Q) という表記で指定できます。ここで、p と q は非負の整数です (リビジョン 2.0.11 以降で使用可能)。 結果として得られるマクロ展開は、文字オフセット p から始まり、長さ q (q が指定されていない場合は文字列の終わりまで) の部分文字列です。 たとえば、GPP_AにABCDEFが含まれている場合、$ (A: 2) はCDEFに展開され、$ (A: 2:3) はCDEに展開されます。
認識できない名前は翻訳されず、展開後もパラメーター値の$NAMEまたは$ (NAME) 形式は変更されません。
|
パラメータ名 |
説明とデフォルト値 |
|---|---|
|
$ |
$$という形式は、単一の $ 文字に展開されます。 |
|
AからPまで |
GPP_AからGPP_Pまでの汎用パラメーターの内容に置き換えられます。 |
|
SA から SD まで |
GPP_SAからGPP_SDまでの特殊用途パラメータに置き換えられました。 これらのパラメータには、 プロビジョニングに使用されるキーまたはパスワードが格納されます。 $SAから$SDは、 オプションの再同期URL修飾子--keyの引数として認識されます。 |
|
MA |
小文字の16進数を使用したMACアドレス、たとえば、000e08aabbcc。 |
|
MAU |
000E08AABBCCなど、大文字の16進数を使用したMACアドレス。 |
|
MAC |
小文字の16進数でMACアドレスを使用し、16進数のペアを区切るにはコロンを使用します。 たとえば、00:0 e: 08: aa: bb: cc。 |
|
PN |
製品名。 たとえば、CP-8875、DP-9851、DP-9871などです。 |
|
PSN | 製品シリーズ番号。 たとえば、V03です。 |
|
SN |
シリアル番号の文字列。たとえば、88012BA01234です。 |
|
CCERT |
SSLクライアント証明書のステータス：インストール済みまたは未インストール。 |
|
IP |
ローカルサブネット内の電話のIPアドレス。 たとえば、192.168.1.100。 |
|
EXTIP |
インターネットで見られる電話の外部 IP。 たとえば、66.43.16.52です。 |
|
SWVER |
ソフトウェアバージョン文字列。 例えば、 PHONEOS.3-1-1-0104-37 |
|
HWVER |
ハードウェアバージョンの文字列。 たとえば、2.0.1 |
|
PRVST |
プロビジョニング状態（数字の文字列）： -1 = 明示的な再同期リクエスト 0 = 電源投入時の再同期 1 = 定期的な再同期 2 = 再同期に失敗しました、再試行してください |
|
UPGST |
アップグレード状態（数字の文字列）： 1 = 最初のアップグレードの試み 2 = アップグレードが失敗しました。再試行してください |
|
UPGERR |
前回のアップグレード試行の結果メッセージ（ERR）。たとえば、http_getが失敗しました。 |
|
PRVTMR |
最後に再同期を試みてからの秒数。 |
|
UPGTMR |
前回アップグレードを試みてからの秒数。 |
|
REGTMR1 |
ライン1がSIPサーバーへの登録を失ってからの秒数。 |
|
REGTMR2 |
2行目がSIPサーバーへの登録を失ってからの秒数。 |
|
UPGCOND |
レガシーマクロ名。 |
|
SCHEME |
再同期またはアップグレードURLを解析した後に取得された、TFTP、HTTP、またはHTTPSのいずれかのファイルアクセススキーム。 |
|
SERV |
再同期またはアップグレードURLを解析した後に取得された、ターゲットサーバーのホスト名をリクエストしてください。 |
|
SERVIP |
再同期またはアップグレードURLを解析した後、場合によってはDNSルックアップ後に取得された、ターゲットサーバーのIPアドレスをリクエストしてください。 |
|
PORT |
再同期またはアップグレードURLを解析した後に取得した、ターゲットのUDP/TCPポートをリクエストしてください。 |
|
PATH |
再同期またはアップグレードURLを解析した後に取得された、ターゲットファイルのパスをリクエストしてください。 |
|
ERR |
再同期またはアップグレードの試行の結果メッセージ。 結果のsyslogメッセージを生成する場合にのみ役に立ちます。 アップグレードを試みた場合、値はUPGERR変数に保存されます。 |
|
UIDN |
Line n userId設定パラメータの内容。 |
|
EMS |
Extension Mobilityステータス |
|
MUID |
Extension MobilityユーザーID |
|
MPWD |
Extension Mobilityパスワード |
内部エラーコード
電話機には複数の内部エラーコード（X00—X99）が定義されています。これにより、特定のエラー状態におけるユニットの動作をより細かく制御するための設定が容易になります。
|
パラメータ名 |
説明とデフォルト値 |
|---|---|
|
X00 |
SIPリクエストを送信する際のトランスポート層（またはICMP）エラー。 |
|
X20 |
SIPリクエストは、応答を待っている間にタイムアウトします。 |
|
X40 |
一般的なSIPプロトコルエラー（たとえば、200のSDPで受け入れられないコーデックとACKメッセージ、またはACKを待っている間にタイムアウトになったなど）。 |
|
X60 |
指定されたダイヤルプランによると、ダイヤルされた番号は無効です。 |
