プロビジョニング パラメータ タイプ

ここでは、機能に従って広く整理されたプロビジョニング パラメータについて説明します。

汎用パラメータ

汎用パラメータ GPP_*(管理者ログイン > アドバンスト > 音声 > プロビジョニング)は、電話機を特定のプロビジョニング サーバ ソリューションと対話するように設定する際に、無料の文字列登録として使用されます。GPP_* パラメータはデフォルトでは空です。これらは、以下を含むさまざまな値を含むように設定できます。

  • 暗号化キー

  • URL

  • マルチステージ プロビジョニング ステータス情報。

  • Post リクエスト テンプレート

  • パラメータ名エイリアスマップ

  • 部分文字列の値は、最終的に完全なパラメータ値に組み合わされます。

GPP_* パラメータは、他のプロビジョニング パラメータ内のマクロ展開に使用できます。この目的のために、GPP_A ~ GPP_P の内容を識別するのに十分です。また、2 文字の大文字のマクロ名 SA ~ SD は、次の URL オプションの引数として使用する場合、GPP_SA ~ GPP_SD を特殊なケースとして識別します。

keyuidpwd

これらのパラメータは、プロビジョニングおよびアップグレード ルールの変数として使用できます。これらは、$GPP_A など、'$' 文字で変数名を接頭辞することで参照されます。

パラメータを有効にする

Provision_Enable および Upgrade_Enable パラメータは、すべてのプロファイルの再同期とファームウェア アップグレード操作を制御します。これらのパラメータは、再同期とアップグレードを独立して制御します。これらのパラメータは、管理 Web サーバから発行される再同期およびアップグレード URL コマンドも制御します。これらのパラメータは両方ともデフォルトで [はい] に設定されています。

Resync_From_SIP パラメータは、再同期操作の要求を制御します。SIP NOTIFY イベントは、サービス プロバイダー プロキシ サーバから電話機に送信されます。有効にすると、プロキシは再同期を要求できます。これを行うには、プロキシはイベントを含む SIP NOTIFY メッセージを送信します。デバイスに再同期ヘッダー。

デバイスは、401 応答(使用されたクレデンシャルに対して拒否された認証)でリクエストをチャレンジします。デバイスは、プロキシからの再同期要求に応える前に、認証された後続要求を期待します。イベント:reboot_now およびイベント:restart_now headers は、それぞれ寒さと暖かい再起動を実行し、これは課題です。

残りの 2 つの有効化は、Resync_On_Reset と Resync_After_Upgrade_ 試行です。これらのパラメータは、電源投入ソフトウェアの再起動後、および各アップグレード試行後にデバイスが再同期操作を実行するかどうかを決定します。

Resync_On_Reset が有効になっている場合、デバイスはリセットが実行される前にブートアップ シーケンスに続くランダムな遅延を導入します。遅延は、Resync_Random_Delay (秒単位) で指定される値までのランダムな時間です。同時に電源を投入する電話機のプールでは、この遅延により、各ユニットからの再同期要求の開始時間が広がります。この機能は、地域の停電が発生した場合に、大規模な住宅展開で役立ちます。

トリガー

電話機は、特定の間隔または特定の時間に再同期できます。

特定の間隔での再同期

電話機は、プロビジョニング サーバと定期的に再同期するように設計されています。再同期間隔は Resync_定期的 (秒) で構成されます。この値が空の場合、デバイスは定期的に再同期されません。

通常、再同期は、音声回線がアイドル状態のときに実行されます。再同期が予定されると音声回線がアクティブになっている場合、電話機は回線がアイドル状態になるまで再同期手順を遅らせます。再同期によって、設定パラメータの値が変更される場合があります。

電話機がサーバからプロファイルを取得できない、ダウンロードしたファイルが破損している、または内部エラーが発生したため、再同期操作が失敗する可能性があります。デバイスは、Resync_Error_Retry_Delay (秒) で指定された時間後に再同期を再試行します。Resync_Error_Retry_Delay が 0 に設定されている場合、デバイスは再同期試行に失敗した後に再同期を再試行しません。

アップグレードに失敗した場合、再試行は Upgrade_Error_Retry_遅延秒後に実行されます。

条件付きで再同期をトリガーするには、2 つの設定可能なパラメータを使用できます。Resync_Trigger_1 および Resync_Trigger_2。各パラメータは、マクロ展開を実行する条件式を使用してプログラムできます。再同期間隔が切れると(次の再同期の時間)、トリガーが設定されている場合、1 つ以上のトリガーが true と評価されない限り、再同期を防止します。

次の例は、再同期をトリガーします。この例では、最後の電話機のアップグレード試行が 5 分(300 秒)以上経過し、最後の再同期試行から少なくとも 10 分(600 秒)経過しています。

$UPGTMR gt 300 および $PRVTMR ge 600

特定の時刻に再同期

Resync_At パラメータを使用すると、電話機を特定の時間に再同期できます。このパラメータは、24 時間形式(hhmm)を使用して時刻を指定します。

Resync_At_Random_Delay パラメータを使用すると、電話機は、指定した時間内に再同期できます。このパラメータは、正の整数形式を使用して時刻を指定します。

同時に再同期するように設定されている複数の電話機からの再同期要求がサーバにフラッディングしないようにしてください。これを行うには、電話機は指定された時間から最大 10 分後に再同期をトリガーします。

たとえば、再同期時間を 1000(午前 10 時)に設定すると、電話機は午前 10:00 ~ 午前 10:10 時の間でいつでも再同期をトリガーします。

デフォルトでは、この機能は無効ですResync_At パラメータがプロビジョニングされている場合、Resync_Periodic パラメータは無視されます。

設定可能なスケジュール

定期的な再同期のためのスケジュールを設定できます。また、次のプロビジョニング パラメータを使用して、再同期とアップグレードの失敗に対する再試行間隔を指定できます。

  • Resync_定期的

  • Resync_rror_Retry_遅延

  • pgrade_Error_Retry_遅延

各パラメータは、単一の遅延値(秒)を受け入れます。新しい拡張構文では、連続した遅延要素のカンマ区切りリストを使用できます。シーケンスの最後の要素は、暗黙的に永遠に繰り返されます。

オプションで、プラス記号を使用して、ランダムな追加遅延を追加する別の数値を指定できます。

例 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 時間ごとに再試行します。

pgrade_Error_Retry_遅延  =  1800,3600,7200,14400+3600 

プロファイル ルール

電話機は、複数のリモート設定プロファイル パラメータ(Profile_Rule*)を提供します。したがって、各再同期操作は、異なるサーバが管理する複数のファイルを取得できます。

最もシンプルなシナリオでは、デバイスは中央サーバ上の単一のプロファイルと定期的に再同期し、関連するすべての内部パラメータを更新します。また、プロファイルを別のファイルに分割することもできます。1 つのファイルは、展開内のすべての電話機で共通です。アカウントごとに個別の固有のファイルが提供されます。暗号化キーと証明書情報は、別のサーバに保存されている別のプロファイルによって提供できます。

再同期操作が予定されているたびに、電話機は 4 つの Profile_Rule* パラメータを順番に評価します。

  1. Profile_ルール

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

各評価では、リモート プロビジョニング サーバからプロファイルを取得でき、一部の内部パラメータが更新される可能性があります。評価に失敗した場合、再同期シーケンスは中断され、Resync_Error_Retry_Delay パラメータ (秒) で指定された先頭から再度再試行されます。すべての評価が成功した場合、デバイスは Resync_Periodic パラメータで指定された秒間待機し、別の再同期を実行します。

各 Profile_Rule* パラメータの内容は、一連の代替案で構成されます。選択肢は | (パイプ) 文字で区切られます。各選択肢は、条件式、割り当て式、プロファイル URL、および関連する URL オプションから構成されます。これらのコンポーネントはすべて、各選択肢内でオプションです。以下は、有効な組み合わせと、存在する場合に表示する必要がある順序です。

 [ conditional-expr ] [ assignment-expr ] [[ options ] URL ] 

各 Profile_Rule* パラメータ内で、最後の選択肢を除くすべての選択肢は条件式を指定する必要があります。この式は次のように評価され、処理されます。

  1. 条件は左から右に評価され、その条件が true として評価されるまで評価されます(または条件式がない代替案が 1 つ見つかるまで)。

  2. 付随する代入式が存在する場合、評価されます。

  3. URL が代替の一部として指定されている場合、指定された URL にあるプロファイルをダウンロードしようとします。システムは、それに応じて内部パラメータを更新しようとします。

すべての選択肢に条件式があり、どれも true に評価されない場合 (またはプロファイルルール全体が空の場合)、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 | [--投稿 a] http://p.tel.com/lost-reg? 

例 3

この例では、デバイスが同じサーバに再同期します。デバイスは、証明書がユニットにインストールされていない場合(2.0 より前のレガシー ユニットの場合)、追加情報を提供します。

 (“$CCERT” eq “インストール済み”)? https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU 

例 4

この例では、回線 1 は GPP_A が最初の URL を通じて Provisioned に等しく設定されるまで無効になります。その後、2 番目の URL に再同期します。

 ("$A" は "プロビジョニング済み")? (Line_Enable_1_ =「いいえ」;)! https://p.tel.com/init-prov | https://p.tel.com/configs 

例 5

この例では、サーバが返すプロファイルに XML 要素タグが含まれていると想定されています。これらのタグは、GPP_B に保存されているエイリアス マップによって適切なパラメータ名に再マッピングする必要があります。

 [--エイリアス b] https://p.tel.com/account/$PN$MA.xml 

通常、再同期は、要求されたプロファイルがサーバから受信されない場合、失敗と見なされます。Resync_Fails_On_FNF パラメータは、このデフォルトの動作をオーバーライドできます。Resync_Fails_On_FNF が [いいえ] に設定されている場合、デバイスはサーバーからのファイルが見つからない応答を正常に再同期として受け入れます。Resync_Fails_On_FNF のデフォルト値は [はい] です。

アップグレード ルール

アップグレード ルールは、必要に応じて新しいロードにアクティベートし、ロードを取得する場所からデバイスに通知することです。ロードがすでにデバイスに存在する場合、ロードを取得しようとしません。そのため、負荷の場所の妥当性は、目的の負荷が非アクティブ パーティションにある場合には問題になりません。

Upgrade_ルールは、現在のロードと異なる場合、条件式によって制限されるか、[Upgrade_有効化] が [いいえ] に設定されていない限り、ダウンロードおよび適用されるファームウェア ロードを指定します。

電話機は、設定可能なリモート アップグレード パラメータ Upgrade_Rule を 1 つ提供します。このパラメータは、プロファイル ルール パラメータと同様のシンタックスを受け入れます。URL オプションはアップグレードに対応していませんが、条件式と割り当て式を使用できます。条件式を使用する場合、パラメータには複数の選択肢を| 文字で区切って入力できます。各選択肢のシンタックスは次のとおりです。

 [ conditional-expr ] [ assignment-expr ] URL 

Profile_Rule* パラメータの場合と同様に、Upgrade_Rule パラメータは、条件式が満たされるか、選択肢に条件式がない限り、各選択肢を評価します。指定した場合は、付随する割り当て式が評価されます。その後、指定された URL へのアップグレードが試行されます。

Upgrade_ルールに条件式なしの 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。 設定プロファイル パラメータ

パラメータ名

説明とデフォルト値

プロビジョニングの有効化

ファームウェア アップグレード アクションとは関係なく、すべての再同期アクションを制御します。[はい] に設定して、リモート プロビジョニングを有効にします。

デフォルト値は [はい(Yes)] です。

リセット時に再同期

パラメータの更新とファームウェア アップグレードによって引き起こされるリブートを除き、リブートごとに再同期がトリガーされます。

デフォルト値は [はい(Yes)] です。

再同期ランダム遅延

リセットを実行する前のブートアップ シーケンス後のランダム遅延(秒単位)。同時に電源を投入するようスケジュールされている IP テレフォニー デバイスのプールでは、各ユニットがプロビジョニング サーバに再同期要求を送信する時間が広がります。この機能は、地域の停電が発生した場合に、大規模な住宅展開で役立ちます。

このフィールドの値は、0 ~ 65535 の整数である必要があります。

デフォルト値は 2 です。

再同期 (HHmm)

デバイスがプロビジョニング サーバと再同期する時間(HHmm)。

HHmm 形式で時刻を示すには、このフィールドの値は 0000 ~ 2400 の 4 桁の数字である必要があります。たとえば、0959 は 09:59 を示します。

デフォルト値は空です。値が無効な場合、パラメータは無視されます。このパラメータに有効な値が設定されている場合、[定期再同期(Resync Periodic)] パラメータは無視されます。

ランダム遅延時の再同期

多数のデバイスの電源が同時にオンになっている場合、プロビジョニング サーバの過負荷を防止します。

複数の電話機からのサーバへの再同期要求のフラッディングを回避するために、電話機は時間と分、時間と分とランダム遅延 (hhmm、hhmm+random_delay) の範囲で再同期します。たとえば、ランダム遅延 = (ランダム遅延で再同期 + 30)/60 分の場合、秒単位の入力値は分に変換され、次の分に切り上げて最終的なrandom_delay 間隔を計算します。

有効な値は 600 ~ 65535 です。

値が 600 未満の場合、ランダム遅延内部は 0 ~ 600 です。

デフォルト値は 600 秒(10  分)です。

定期的な再同期

プロビジョニング サーバとの定期的な再同期間の時間間隔。関連する再同期タイマーは、サーバとの最初の同期が成功した後にのみアクティブになります。

有効な形式は次のとおりです。

  • 整数

    例:入力値は 3000 で、次の再同期が 3000 秒後に発生することを示します。

  • 複数の整数

    例:入力値 600,1200,300 は、最初の再同期が 600 秒で発生し、2 番目の再同期が最初の再同期から 1200 秒後に発生し、3 番目の再同期は 2 番目の再同期から 300 秒後に発生することを示します。

  • 時間範囲

    たとえば、2400+30 の入力は、再同期が成功してから 2400 ~ 2430 秒後に次の再同期が行われることを示します。

定期的な再同期を無効にするには、このパラメータを 0 に設定します。

デフォルト値は 3600 秒です。

再同期エラーの再試行遅延

IP テレフォニー デバイスがサーバからプロファイルを取得できなかったために再同期操作が失敗した場合、ダウンロードしたファイルが破損した場合、または内部エラーが発生した場合、デバイスは秒単位で指定された時間後に再同期を再試行します。

有効な形式は次のとおりです。

  • 整数

    例:入力値は 300 で、次の再同期再試行が 300 秒後に実行されることを示します。

  • 複数の整数

    例:入力値 600,1200,300 は、最初の再試行が失敗から 600 秒後に発生し、2 番目の再試行が最初の再試行失敗から 1200 秒後に、3 番目の再試行が 2 番目の再試行失敗から 300 秒後に発生することを示します。

  • 時間範囲

    たとえば、入力が 2400+30 の場合、再同期に失敗してから 2400 ~ 2430 秒以内に次の再試行が行われることを示します。

遅延が 0 に設定されている場合、デバイスは再同期試行に失敗した後に再同期を再試行しません。

強制再同期遅延

電話機が再同期を実行するまで待機する最大遅延(秒単位)。

電話回線の 1 つがアクティブになっている間は、デバイスは再同期されません。再同期には数秒かかる場合があるため、再同期する前にデバイスがアイドル状態になるまで長期間待つことが望ましいです。これにより、ユーザは中断することなく連続してコールを発信できます。

デバイスには、すべての回線がアイドル状態になると、カウントダウンを開始するタイマーがあります。このパラメータは、カウンタの初期値です。再同期イベントは、このカウンタが 0 になるまで遅延します。

有効な値は 0 ~ 65535 です。

デフォルト値は 14,400  秒です。

SIP から再同期

SIP NOTIFY メッセージを使用して再同期をトリガーできます。

デフォルト値は [はい(Yes)] です。

アップグレード試行後の再同期

アップグレードが行われた後の再同期操作を有効または無効にします。[はい(Yes)] を選択した場合、同期がトリガーされます。

デフォルト値は [はい(Yes)] です。

再同期トリガー 1、再同期トリガー 2

設定可能な再同期トリガー条件。これらのパラメータの論理式が TRUE に評価されると、再同期がトリガーされます。

デフォルト値は (空) です。

FNF で再同期が失敗する

要求されたプロファイルがサーバから受信されなかった場合、再同期は失敗と見なされます。これは、このパラメータで上書きできます。no に設定されている場合、デバイスはサーバーからのファイルが見つかりません 応答を正常な再同期として受け入れます。

デフォルト値は [はい(Yes)] です。

プロファイル ルール

プロファイル ルール B


プロファイル ルール C


プロファイル ルール D

各プロファイル ルールは、プロファイル(設定ファイル)を取得するソースを電話機に通知します。再同期操作のたびに、電話機はすべてのプロファイルを順番に適用します。

デフォルト: /$PSN.xml

設定ファイルに AES-256-CBC 暗号化を適用する場合は、次のように暗号キーを --key キーワードで指定します。

[--key ]

必要に応じて、暗号キーを二重引用符(")で囲むことができます。

使用する DHCP オプション

ファームウェアとプロファイルを取得するために使用される、コンマで区切られた DHCP オプション。

デフォルト値は 66,160,159,150,60,43,125 です。

ログ要求メッセージ

このパラメータには、再同期試行の開始時に syslog サーバに送信されるメッセージが含まれます。

デフォルト値は $PN $MAC – リクエスト % $SCHEME://$SERVIP:$PORT$PATH です。

ログの成功時のメッセージ

再同期試行が正常に完了したときに発行される syslog メッセージ。

デフォルト値は $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR です。

ログ障害メッセージ

再同期が失敗した後に発行される syslog メッセージ。

デフォルト値は $PN $MAC -- Resync failed: $ERR です。

ユーザー設定可能な再同期

ユーザが IP 電話画面から電話機を再同期できるようにします。

デフォルト値は [はい(Yes)] です。

ファームウェア アップグレード パラメータ

次の表は、[プロビジョニング] タブの [ファームウェア アップグレード] セクションにおける、各パラメータの機能と使用方法を定義しています。

表 2. ファームウェア アップグレード パラメータ

パラメータ名

説明とデフォルト値

アップグレードの有効化

再同期アクションに関係なく、ファームウェア アップグレード操作を有効にします。

デフォルト値は [はい(Yes)] です。

次のいずれかの方法でこのパラメータを設定します。

  • XML(cfg.xml) を含む電話設定ファイルで、次の形式で文字列を入力します。<Upgrade_Enable ua="na">YesEnable>pgrade_

  • 電話管理の Web ページで、このフィールドを [はい] または [いいえ] に設定します。

アップグレード エラーの再試行遅延

アップグレードに失敗した場合に適用されるアップグレード再試行間隔(秒単位)。デバイスには、ファームウェア アップグレードの試行が失敗した後にアクティブになるファームウェア アップグレード エラー タイマーがあります。タイマーはこのパラメータの値で初期化されます。このタイマーが0にカウントダウンすると、次のファームウェアアップグレードが試行されます。

デフォルト値は 3600 秒です。

次のいずれかの方法でこのパラメータを設定します。

  • XML(cfg.xml) のある電話設定ファイルで、次の形式で文字列を入力します。<Upgrade_Error_Retry_Delay ua="na">3600Error_Retry_Delay>pgrade_

  • 電話管理の Web ページで、値を設定します。

アップグレード ルール

アップグレード条件と関連するファームウェア URL を定義するファームウェア アップグレード スクリプト。プロファイル ルールと同じ構文を使用します。

次の形式を使用して、アップグレード ルールを入力します。

<tftp|http|https>:////

たとえば、次のようなものです。

tftp://192.168.1.5/firmware/PHONEOS-8875.1-0-1-0001-1.loads
http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads

プロトコルが指定されていない場合、TFTP が想定されます。サーバ名が指定されていない場合、URL を要求するホストがサーバ名として使用されます。ポートが指定されない場合、デフォルトのポートが使用されます(TFTP の場合は 69、HTTP の場合は 80、HTTPS の場合は 443)。

デフォルト値は空白です。

次のいずれかの方法でこのパラメータを設定します。

  • XML(cfg.xml) を含む電話設定ファイルで、次の形式で文字列を入力します。<Upgrade_Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • 電話管理の Web ページで、ロード ファイルが保存されているパスを入力します。

ログのアップグレード リクエストのメッセージ

ファームウェアアップグレードの開始時に Syslog メッセージが発行されました。

デフォルト: $PN $MAC -- 要求アップグレード $SCHEME://$SERVIP:$PORT$PATH

次のいずれかの方法でこのパラメータを設定します。

  • XML(cfg.xml) を含む電話設定ファイルで、次の形式で文字列を入力します。<Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATHUpgrade_Request_Msg>og_

  • 電話管理ウェブページで、必要に応じてパラメータをカスタマイズします。

ログのアップグレードの成功メッセージ

ファームウェアのアップグレードが完了した後に、Syslog メッセージが発行されました。

デフォルト値は $PN $MAC -- 成功したアップグレード $SCHEME://$SERVIP:$PORT$PATH -- $ERR です。

次のいずれかの方法でこのパラメータを設定します。

  • XML(cfg.xml) のある電話設定ファイルで、次の形式で文字列を入力します。<Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERRUpgrade_Success_Msg>og_

  • 電話管理ウェブページで、必要に応じてパラメータをカスタマイズします。

ログのアップグレード失敗のメッセージ

ファームウェアのアップグレードが失敗した後に、Syslog メッセージが発行されました。

デフォルト値は $PN $MAC -- アップグレードに失敗しました:$ERR です。

次のいずれかの方法でこのパラメータを設定します。

  • XML(cfg.xml) のある電話設定ファイルで、次の形式で文字列を入力します。<Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Upgrade failed: $ERRUpgrade_Failure_Msg>og_

  • 電話管理ウェブページで、必要に応じてパラメータをカスタマイズします。

ピア ファームウェア共有

ピア ファームウェア共有(PFS)機能を有効または無効にします。機能を有効または無効にするには、[はい ] または [いいえ ] を選択します。

デフォルト:はい

次のいずれかの方法でこのパラメータを設定します。

  • XML(cfg.xml) を含む電話設定ファイルで、次の形式で文字列を入力します。<Peer_Firmware_Sharing ua="na">YesFirmware_Sharing>eer_

  • 電話管理の Web ページで、このフィールドを [はい] または [いいえ] に設定します。

ピア ファームウェア共有ログ サーバ

UDP メッセージの送信先となる IP アドレスとポートを示します。

たとえば、次のようなものです。10.98.76.123:514 の場合、10.98.76.123 は IP アドレス、514 はポート番号です。

次のいずれかの方法でこのパラメータを設定します。

  • XML(cfg.xml) を含む電話設定ファイルで、次の形式で文字列を入力します。<Peer_Firmware_Sharing_Log_Server ua="na">10.98.76.123:514Firmware_Sharing_Log_Server>eer_

  • 電話管理の Web ページで、ログサーバーアドレスを入力します。

汎用パラメータ

次の表では、[プロビジョニング] タブの [汎用パラメータ] セクションにおける、各パラメータの機能と使用方法を定義しています。

表3。 汎用パラメータ

パラメータ名

説明とデフォルト値

gpp a - gpp p

汎用パラメータ GPP_* は、電話機を特定のプロビジョニング サーバ ソリューションと通信するように設定する際に、自由文字列レジスタとして使用されます。これらは、以下を含むさまざまな値を含むように設定できます。

  • 暗号化キー。

  • URL。

  • マルチステージ プロビジョニング ステータス情報。

  • ポストリクエスト テンプレート。

  • パラメータ名のエイリアス マップ。

  • 部分文字列の値は、最終的に完全なパラメータ値に組み合わされます。

デフォルト値は空白です。

マクロ展開変数

特定のマクロ変数は、次のプロビジョニング パラメータ内で認識されます。

  • Profile_ルール

  • rofile_Pule_*

  • esync_rigger_*

  • Upgrade_ ルール

  • Log_*

  • GPP_*(特定の条件下で)

これらのパラメータ内で、$NAME や $(NAME) などのシンタックスタイプが認識され、展開されます。

マクロ変数のサブ文字列は、$(NAME:p) および $(NAME: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

000e08aabbcc など、小文字の 16 進数を使用する MAC アドレス。

MAU

大文字の 16 進数を使用する MAC アドレス(例:000E08AABBCC)。

MAC

小文字の 16 進数およびコロンを使用して 16 進数のペアを区切る MAC アドレス。たとえば、00:0e:08:aa:bb:cc。

PN

製品名。たとえば、CP-8875-CC-C-9K などです。

PSN (航空機)

製品シリーズ番号。たとえば、V03 です。

SN

シリアル番号文字列。たとえば、88012BA01234。

CCERTコード

SSL クライアント証明書のステータス: インストール済みまたは未インストール。

IP

ローカル サブネット内の電話機の IP アドレス。例: 192.168.1.100

先端

インターネットで見られるように、電話機の外部 IP。たとえば、66.43.16.52 です。

swverバー

ソフトウェア バージョンの文字列。例えば

電話-8875.1-0-1-0001-1

うーん

ハードウェア バージョンの文字列。例: 2.0.1

プロイセン

プロビジョニングの状態(数値文字列):

-1 = 明示的な再同期要求

0 = 電源再同期

1 = 定期的な再同期

2 = 再同期に失敗しました。再試行してください

アップgst

アップグレード状態(数字文字列):

1 = 最初のアップグレード試行

2 = アップグレードに失敗しました。再試行してください

アップガー

以前のアップグレード試行の結果メッセージ (ERR)。たとえば、http_get 失敗しました。

prvtmrさん

最後の再同期試行からの秒数。

upgtmr さん

最後のアップグレード試行からの秒数。

REGTMR1

回線 1 が SIP サーバーへの登録を失ってからの秒数。

REGTMR2

回線 2 が SIP サーバーへの登録を失ってからの秒数。

アップコンド

従来のマクロ名。

スキーム

再同期またはアップグレード URL の解析後に取得される TFTP、HTTP、または HTTPS のいずれかのファイル アクセス スキーム。

サービス

再同期またはアップグレード URL の解析後に取得される、要求ターゲット サーバ ホスト名。

サーブ

再同期またはアップグレード URL の解析後に取得され、場合によっては DNS ルックアップに従うことで、要求ターゲット サーバの IP アドレス。

ポート

再同期またはアップグレード URL の解析後に取得された要求ターゲット UDP/TCP ポート。

パス

再同期またはアップグレード URL の解析後に取得される、要求ターゲット ファイル パス。

エラー

再同期またはアップグレード試行の結果メッセージ。結果の syslog メッセージを生成するときにのみ有用です。この値は、アップグレード試行時に UPGERR 変数に保存されます。

UID

回線 n ユーザ ID 設定パラメータの内容。

エムス

エクステンション モビリティ ステータス

ミュード

エクステンション モビリティ ユーザー ID

mpwd

エクステンション モビリティ パスワード

内部エラー コード

電話機は、特定のエラー条件下でユニットの動作をより細かく制御する設定を容易にするために、内部エラー コード(X00 ~ X99)の数を定義します。

表 4YAZ設定オプション 内部エラー コード

パラメータ名

説明とデフォルト値

X00

SIP 要求を送信する際のトランスポートレイヤー(または ICMP)エラーです。

X20

応答を待機している間、SIP 要求がタイムアウトします。

X40

一般的な SIP プロトコルエラー(たとえば、200 および ACK メッセージの SDP では許容できないコーデック、ACK の待機中にタイムアウトなど)。

X60

指定されたダイヤル プランに従ってダイヤル番号が無効です。