Dans cet article
dropdown icon
Types de paramètres d'approvisionnement
    Paramètres à usage général
    Activer les paramètres
    Déclencheurs
    Horaires configurables
    Règles du profil
    Règle de mise à niveau
dropdown icon
Paramètres d'approvisionnement
    Paramètres du profil de configuration
    Paramètres de mise à niveau du firmware
    Paramètres à usage général
    Variables d'expansion des macros
    Codes d'erreur internes

Paramètres d'approvisionnement pour les téléphones des séries 9800 et 8875 (BroadWorks)

list-menuDans cet article
list-menuUn commentaire ?

Cet article d'aide concerne les téléphones de bureau Cisco de la gamme 9800 et le visiophone Cisco 8875 enregistrés auprès de Cisco BroadWorks. Les informations de cette page incluent les paramètres d'approvisionnement et leur syntaxe.

Types de paramètres d'approvisionnement

Cette section décrit les paramètres d'approvisionnement, organisés de manière générale par fonction.

Paramètres à usage général

Les paramètres généraux GPP_* (Admin Login > Advanced > Voice > Provisioning) sont utilisés comme registres de chaînes gratuits lors de la configuration du téléphone pour qu'il interagisse avec une solution de serveur d'approvisionnement particulière. Les paramètres GPP_* sont vides par défaut. Ils peuvent être configurés pour contenir diverses valeurs, notamment les suivantes :

  • Clés de cryptage

  • URL

  • Informations sur l'état de l'approvisionnement en plusieurs étapes.

  • Modèles de demandes de publication

  • Nom des paramètres, alias, cartes

  • Des valeurs de chaîne partielles, finalement combinées en valeurs de paramètres complètes.

Les paramètres GPP_* sont disponibles pour l'extension des macros dans le cadre d'autres paramètres de provisionnement. À cette fin, les noms de macros à une seule lettre en majuscule (A à P) suffisent pour identifier le contenu de GPP_A à GPP_P. De plus, les noms de macros à deux lettres majuscules SA à SD identifient GPP_SA à GPP_SD comme des majuscules lorsqu'ils sont utilisés comme arguments pour les options d'URL suivantes :

key, uid et pwd

Ces paramètres peuvent être utilisés comme variables dans les règles d'approvisionnement et de mise à niveau. Ils sont référencés en préfixant le nom de la variable par un caractère « $ », par exemple $GPP_A.

Activer les paramètres

Les paramètres Provision_Enable et Upgrade_Enable contrôlent toutes les opérations de resynchronisation des profils et de mise à niveau du firmware. Ces paramètres contrôlent les resynchronisations et les mises à niveau indépendamment les uns des autres. Ces paramètres contrôlent également les commandes de resynchronisation et de mise à niveau des URL qui sont émises via le serveur Web d'administration. Ces deux paramètres sont réglés sur Oui par défaut.

Le paramètre Resync_From_SIP contrôle les demandes d'opérations de resynchronisation. Un événement SIP NOTIFY est envoyé par le serveur proxy du fournisseur de services vers le téléphone. S'il est activé, le proxy peut demander une resynchronisation. Pour ce faire, le proxy envoie un message SIP NOTIFY contenant l'en-tête Event : resync vers l'appareil.

L'appareil conteste la demande avec une réponse 401 (autorisation refusée pour les informations d'identification utilisées). L'appareil attend une demande ultérieure authentifiée avant d'honorer la demande de resynchronisation émanant du proxy. Les en-têtes Event : reboot_now et Event : restart_now redémarrent à froid et à chaud, respectivement, ce qui est également difficile.

Les deux activations restantes sont Resync_On_Reset et Resync_After_Upgrade_Attempt. Ces paramètres déterminent si l'appareil effectue une opération de resynchronisation après le redémarrage du logiciel de mise sous tension et après chaque tentative de mise à niveau.

Lorsque Resync_On_Reset est activé, l'appareil introduit un délai aléatoire qui suit la séquence de démarrage avant la réinitialisation. Le délai est aléatoire, jusqu'à la valeur spécifiée par Resync_Random_Delay (en secondes). Dans un pool de téléphones qui s'allument simultanément, ce délai étale les heures de début des demandes de resynchronisation provenant de chaque appareil. Cette fonctionnalité peut être utile dans le cadre d'un déploiement résidentiel de grande envergure, en cas de panne de courant régionale.

Déclencheurs

Le téléphone vous permet de vous resynchroniser à des intervalles ou à une heure précis.

Resynchroniser à des intervalles précis

Le téléphone est conçu pour se resynchroniser régulièrement avec le serveur d'approvisionnement. L'intervalle de resynchronisation est configuré en Resync_Periodic (secondes). Si cette valeur est laissée vide, l'appareil ne se resynchronise pas régulièrement.

La resynchronisation a généralement lieu lorsque les lignes vocales sont inactives. Si une ligne vocale est active alors qu'une resynchronisation est prévue, le téléphone retarde la procédure de resynchronisation jusqu'à ce que la ligne redevienne inactive. Une resynchronisation peut entraîner une modification des valeurs des paramètres de configuration.

Une opération de resynchronisation peut échouer parce que le téléphone ne parvient pas à récupérer un profil sur le serveur, parce que le fichier téléchargé est endommagé ou parce qu'une erreur interne s'est produite. L'appareil essaie de se resynchroniser après le délai spécifié dans Resync_Error_Retry_Delay (secondes). Si Resync_Error_Retry_Delay est réglé sur 0, l'appareil n'essaie pas de se resynchroniser après une tentative de resynchronisation infructueuse.

Si une mise à niveau échoue, une nouvelle tentative est effectuée après les secondes de Upgrade_Error_Retry_Delay.

Deux paramètres configurables sont disponibles pour déclencher une resynchronisation de manière conditionnelle : Resync_Trigger_1 et Resync_Trigger_2. Chaque paramètre peut être programmé à l'aide d'une expression conditionnelle qui fait l'objet d'un développement macro. À l'expiration de l'intervalle de resynchronisation (heure de la prochaine resynchronisation), les déclencheurs, s'ils sont définis, empêcheront la resynchronisation à moins qu'un ou plusieurs déclencheurs ne soient évalués à vrai.

L'exemple de condition suivant déclenche une resynchronisation. Dans l'exemple, la dernière tentative de mise à niveau du téléphone s'est écoulée depuis plus de 5 minutes (300 secondes), et au moins 10 minutes (600 secondes) se sont écoulées depuis la dernière tentative de resynchronisation.

$UPGTMR gt 300 and $PRVTMR ge 600

Resynchroniser à une heure précise

Le paramètre Resync_At permet de resynchroniser le téléphone à une heure précise. Ce paramètre utilise le format 24 heures (hhmm) pour spécifier l'heure.

Le paramètre Resync_At_Random_Delay permet de resynchroniser le téléphone dans un délai indéterminé. Ce paramètre utilise un format entier positif pour spécifier l'heure.

Il faut éviter d'inonder le serveur de demandes de resynchronisation provenant de plusieurs téléphones configurés pour être resynchronisés en même temps. Pour ce faire, le téléphone déclenche la resynchronisation jusqu'à 10 minutes après l'heure spécifiée.

Par exemple, si vous réglez l'heure de resynchronisation à 10 h (10 h), le téléphone déclenche la resynchronisation à tout moment entre 10 h et 10 h 10.

Par défaut, cette fonctionnalité est désactivée. Si le paramètre Resync_At est configuré, le paramètre Resync_Periodic est ignoré.

Horaires configurables

Vous pouvez configurer des calendriers pour les resynchronisations périodiques, et spécifier les intervalles entre les nouvelles tentatives en cas d'échec de resynchronisation et de mise à niveau en utilisant ces paramètres de provisionnement :

  • Resync_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

Chaque paramètre accepte une seule valeur de délai (secondes). La nouvelle syntaxe étendue permet d'établir une liste d'éléments de retard consécutifs séparés par des virgules. Le dernier élément de la séquence est implicitement répété pour toujours.

En option, vous pouvez utiliser un signe plus pour spécifier une autre valeur numérique qui ajoute un délai supplémentaire aléatoire.

Exemple 1

Dans cet exemple, le téléphone se resynchronise régulièrement toutes les deux heures. En cas d'échec de resynchronisation, l'appareil réessaie à intervalles réguliers : 30 minutes, 1 heure, 2 heures, 4 heures. L'appareil continue d'essayer toutes les 4 heures jusqu'à ce qu'il soit resynchronisé correctement.


Resync_Periodic=7200
Resync_Error_Retry_Delay=1800,3600,7200,14400

Exemple 2

Dans cet exemple, l'appareil se resynchronise régulièrement toutes les heures (plus un délai aléatoire supplémentaire de 10 minutes maximum). En cas d'échec de resynchronisation, l'appareil réessaie à intervalles réguliers : 30 minutes (plus 5 minutes au maximum). 1 heure (plus 10 minutes), 2 heures (plus 15 minutes). L'appareil continue d'essayer à intervalles de 2 heures (plus 15 minutes maximum) jusqu'à ce qu'il soit resynchronisé avec succès.


Resync_Periodic=3600+600
Resync_Error_Retry_Delay=1800+300,3600+600,7200+900

Exemple 3

Dans cet exemple, si une tentative de mise à niveau à distance échoue, l'appareil réessaie dans 30 minutes, puis de nouveau au bout d'une heure, puis dans deux heures. Si la mise à niveau échoue toujours, l'appareil réessaie toutes les quatre à cinq heures jusqu'à ce que la mise à niveau soit réussie.


Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Règles du profil

Le téléphone fournit plusieurs paramètres de profil de configuration à distance (Profile_Rule*). Ainsi, chaque opération de resynchronisation peut récupérer plusieurs fichiers gérés par différents serveurs.

Dans le scénario le plus simple, l'appareil se resynchronise régulièrement avec un profil unique sur un serveur central, qui met à jour tous les paramètres internes pertinents. Sinon, le profil peut être partagé entre différents fichiers. Un seul fichier est commun à tous les téléphones d'un déploiement. Un fichier distinct et unique est fourni pour chaque compte. Les clés de cryptage et les informations relatives aux certificats peuvent être fournies par un autre profil, stocké sur un serveur distinct.

Chaque fois qu'une opération de resynchronisation est prévue, le téléphone évalue les quatre paramètres Profile_Rule* dans l'ordre :

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

Chaque évaluation peut donner lieu à la récupération du profil depuis un serveur d'approvisionnement distant, avec une éventuelle mise à jour d'un certain nombre de paramètres internes. Si une évaluation échoue, la séquence de resynchronisation est interrompue et est réessayée depuis le début indiqué par le paramètre Resync_Error_Retry_Delay (secondes). Si toutes les évaluations aboutissent, l'appareil attend la seconde spécifiée par le paramètre Resync_Periodic, puis effectue une autre resynchronisation.

Le contenu de chaque paramètre Profile_Rule* se compose d'un ensemble d'alternatives. Les alternatives sont séparées par le caractère | (pipe). Chaque alternative consiste en une expression conditionnelle, une expression d'attribution, une URL de profil et toutes les options d'URL associées. Tous ces composants sont facultatifs pour chaque alternative. Voici les combinaisons valides et l'ordre dans lequel elles doivent apparaître, le cas échéant :


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

Dans chaque paramètre Profile_Rule*, toutes les alternatives, sauf la dernière, doivent fournir une expression conditionnelle. Cette expression est évaluée et traitée comme suit :

  1. Les conditions sont évaluées de gauche à droite, jusqu'à ce que l'on en trouve une qui soit vraie (ou jusqu'à ce qu'une alternative soit trouvée sans expression conditionnelle).

  2. Toute expression de devoir qui l'accompagne est évaluée, si elle est présente.

  3. Si une URL est spécifiée dans le cadre de cette alternative, on essaie de télécharger le profil qui se trouve à l'URL spécifiée. Le système essaie de mettre à jour les paramètres internes en conséquence.

Si toutes les alternatives comportent des expressions conditionnelles et qu'aucune n'est vraie (ou si l'intégralité de la règle de profil est vide), le paramètre ProfileRule* est ignoré dans son intégralité. Le paramètre de règle de profil suivant de la séquence est évalué.

Exemple 1

Cet exemple se resynchronise inconditionnellement avec le profil à l'URL spécifiée et envoie une requête HTTP GET au serveur d'approvisionnement distant :


http://remote.server.com/cisco/$MA.cfg

Exemple 2

Dans cet exemple, l'appareil est resynchronisé vers deux URL différentes, en fonction de l'état d'enregistrement de la ligne 1. En cas de perte d'inscription, l'appareil envoie un script HTTP POST vers un script CGI. L'appareil envoie le contenu de la macro GPP_A étendue, qui peut fournir des informations supplémentaires sur l'état de l'appareil :


($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg
| [--post a] http://p.tel.com/lost-reg?

Exemple 3

Dans cet exemple, l'appareil est resynchronisé sur le même serveur. L'appareil fournit des informations supplémentaires si aucun certificat n'est installé sur l'appareil (pour les anciennes versions antérieures à la version 2.0) :


(“$CCERT” eq “Installed”)? https://p.tel.com/config?
| https://p.tel.com/config?cisco$MAU

Exemple 4

Dans cet exemple, la ligne 1 est désactivée jusqu'à ce que GPP_A soit défini comme étant égal à Provisioned via la première URL. Ensuite, elle est resynchronisée avec la deuxième URL :


(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov
| https://p.tel.com/configs

Exemple 5

Dans cet exemple, le profil renvoyé par le serveur est censé contenir des balises d'éléments XML. Ces tags doivent être remappés avec des noms de paramètres appropriés à l'aide de la carte des alias stockée dans GPP_B :


[--alias b] https://p.tel.com/account/$PN$MA.xml

Une resynchronisation est généralement considérée comme un échec si le profil demandé n'est pas reçu du serveur. Le paramètre Resync_Fails_on_FNF peut modifier ce comportement par défaut. Si Resync_Fails_on_FNF est réglé sur Non, l'appareil accepte une réponse « fichier introuvable » de la part du serveur en tant que resynchronisation réussie. La valeur par défaut pour Resync_Fails_on_FNF est Oui.

Règle de mise à niveau

La règle de mise à niveau est de demander à l'appareil de passer à une nouvelle charge et d'indiquer d'où se procurer la charge, si nécessaire. Si le chargement se trouve déjà sur l'appareil, celui-ci n'essaiera pas de le récupérer. Ainsi, la validité de l'emplacement de chargement n'a pas d'importance lorsque la charge souhaitée se trouve sur la partition inactive.

La Upgrade_Rule spécifie une charge du microprogramme qui, si elle est différente de la charge actuelle, sera téléchargée et appliquée, sauf si elle est limitée par une expression conditionnelle ou si Upgrade_Enable est réglé sur Non.

Le téléphone propose un paramètre de mise à niveau à distance configurable, Upgrade_Rule. Ce paramètre accepte une syntaxe similaire à celle des paramètres des règles de profil. Les options d'URL ne sont pas prises en charge pour les mises à niveau, mais des expressions conditionnelles et des expressions d'affectation peuvent être utilisées. Si des expressions conditionnelles sont utilisées, le paramètre peut être renseigné avec plusieurs alternatives, séparées par le caractère |. La syntaxe de chaque alternative est la suivante :


[ conditional-expr ] [ assignment-expr ] URL

Comme pour les paramètres Profile_Rule*, le paramètre Upgrade_Rule évalue chaque alternative jusqu'à ce qu'une expression conditionnelle soit satisfaite ou qu'aucune alternative ne contienne d'expression conditionnelle. L'expression d'assignation qui l'accompagne est évaluée, si elle est spécifiée. Ensuite, une mise à niveau vers l'URL spécifiée est tentée.

Si le Upgrade_Rule contient une URL sans expression conditionnelle, l'appareil passe à l'image du firmware spécifiée dans l'URL. Après l'extension des macros et l'évaluation de la règle, l'appareil ne réessaie pas de mise à niveau tant que la règle n'est pas modifiée ou que la combinaison effective entre schéma, serveur, port et chemin de fichier n'est pas modifiée.

Pour tenter de mettre à niveau le firmware, l'appareil désactive le son au début de la procédure et redémarre à la fin de celle-ci. L'appareil lance automatiquement une mise à niveau basée sur le contenu de Upgrade_Rule uniquement si toutes les lignes vocales sont actuellement inactives.

Par exemple,


https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads

Dans cet exemple, la Upgrade_Rule met à niveau le firmware vers l'image qui est stockée à l'URL indiquée.

Voici un autre exemple :


(“$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

Cet exemple indique à l'unité de charger l'une des deux images, en fonction du contenu d'un paramètre général, GPP_F.

Paramètres d'approvisionnement

Vous pouvez trouver les paramètres d'approvisionnement dans l'onglet Approvisionnement de la page Web du téléphone.

Paramètres du profil de configuration

Le tableau suivant définit la fonction et l'utilisation de chaque paramètre dans la section Paramètres du profil de configuration, sous l'onglet Approvisionnement.

Tableau 1. Paramètres du profil de configuration

Nom du paramètre

Description et valeur par défaut

Activer la mise à disposition

Contrôle toutes les actions de resynchronisation indépendamment des actions de mise à niveau du firmware. Réglez sur Oui pour activer le provisionnement à distance.

La valeur par défaut est Oui.

Resynchronisation lors de la réinitialisation

Déclenche une resynchronisation après chaque redémarrage, sauf pour les redémarrages provoqués par des mises à jour des paramètres et du firmware.

La valeur par défaut est Oui.

Retard aléatoire de resynchronisation

Un délai aléatoire après la séquence de démarrage avant de procéder à la réinitialisation, spécifié en secondes. Dans un pool d'appareils de téléphonie IP dont la mise sous tension est programmée simultanément, cela permet d'étaler les heures auxquelles chaque unité envoie une demande de resynchronisation au serveur d'approvisionnement. Cette fonctionnalité peut être utile dans le cadre d'un déploiement résidentiel de grande envergure, en cas de panne de courant régionale.

La valeur de ce champ doit être un entier compris entre 0 et 65535.

La valeur par défaut est 2.

Date de resynchronisation (HHmm)

L'heure (HHmm) à laquelle l'appareil se resynchronise avec le serveur d'approvisionnement.

La valeur de ce champ doit être un nombre à quatre chiffres compris entre 0000 et 2400 pour indiquer l'heure au format HHmm. Par exemple, 0959 indique 09h59.

La valeur par défaut est vide. Si la valeur n'est pas valide, le paramètre est ignoré. Si ce paramètre est défini avec une valeur valide, le paramètre Resync Periodic est ignoré.

Resynchronisation aléatoire

Empêche la surcharge du serveur d'approvisionnement lorsqu'un grand nombre d'appareils s'allument simultanément.

Pour éviter d'inonder le serveur de demandes de resynchronisation provenant de plusieurs téléphones, le téléphone se resynchronise entre les heures et les minutes, plus le délai aléatoire (hhmm, hhmm+random_delay). Par exemple, si le délai aléatoire = (Resynchronisation aléatoire + 30) /60 minutes, la valeur saisie en secondes est convertie en minutes, arrondie à la minute suivante pour calculer l'intervalle final random_delay.

La valeur valide est comprise entre 600 et 65 535.

Si la valeur est inférieure à 600, le délai aléatoire interne est compris entre 0 et 600.

La valeur par défaut est de 600 secondes (10 minutes).

Resynchronisation périodique

L'intervalle de temps entre les resynchronisations périodiques avec le serveur d'approvisionnement. Le chronomètre de resynchronisation associé n'est actif qu'après la première synchronisation réussie avec le serveur.

Les formats valides sont les suivants :

  • Un entier

    Exemple : Une entrée de 3 000 indique que la prochaine resynchronisation aura lieu dans 3 000 secondes.

  • Nombres entiers

    Exemple : Une entrée de 600 200 300 indique que la première resynchronisation a lieu dans 600 secondes, la deuxième dans 1 200 secondes après la première et la troisième dans 300 secondes après la seconde.

  • Un intervalle de temps

    Par exemple, une entrée de 2400+30 indique que la prochaine resynchronisation aura lieu entre 2400 et 2430 secondes après une resynchronisation réussie.

Réglez ce paramètre sur zéro pour désactiver la resynchronisation périodique.

La valeur par défaut est de 3 600 secondes.

Erreur de resynchronisation : nouvelle tentative

Si une opération de resynchronisation échoue parce que l'appareil de téléphonie IP n'a pas pu récupérer de profil sur le serveur, que le fichier téléchargé est endommagé ou qu'une erreur interne se produit, l'appareil essaie de se resynchroniser à nouveau après un délai spécifié en secondes.

Les formats valides sont les suivants :

  • Un entier

    Exemple : Une entrée de 300 indique que la prochaine tentative de resynchronisation aura lieu dans 300 secondes.

  • Nombres entiers

    Exemple : Une entrée de 600 200 300 indique que la première tentative a lieu 600 secondes après l'échec, la deuxième tentative 1 200 secondes après l'échec de la première tentative et la troisième 300 secondes après l'échec de la deuxième tentative.

  • Un intervalle de temps

    Par exemple, une entrée de 2400+30 indique que la prochaine tentative aura lieu entre 2400 et 2430 secondes après un échec de resynchronisation.

Si le délai est réglé sur 0, l'appareil n'essaie pas de se resynchroniser à nouveau après une tentative de resynchronisation infructueuse.

Retard de resynchronisation forcé

Délai maximum (en secondes) pendant lequel le téléphone attend avant d'effectuer une resynchronisation.

L'appareil ne se resynchronise pas tant que l'une de ses lignes téléphoniques est active. Comme une resynchronisation peut prendre plusieurs secondes, il est préférable d'attendre que l'appareil soit inactif pendant une longue période avant de procéder à la resynchronisation. Cela permet à un utilisateur de passer des appels successifs sans interruption.

L'appareil dispose d'un compte à rebours qui lance le compte à rebours lorsque toutes ses lignes sont inactives. Ce paramètre est la valeur initiale du compteur. Les événements de resynchronisation sont retardés jusqu'à ce que ce compteur passe à zéro.

La valeur valide est comprise entre 0 et 65535.

La valeur par défaut est de 14 400 secondes.

Resynchronisation depuis SIP

Permet de déclencher une resynchronisation via un message SIP NOTIFY.

La valeur par défaut est Oui.

Resynchronisation après une tentative de mise à niveau

Active ou désactive l'opération de resynchronisation après toute mise à niveau. Si Oui est sélectionné, la synchronisation est déclenchée.

La valeur par défaut est Oui.

Resynchroniser Trigger 1, Resync Trigger 2

Conditions de déclenchement de la resynchronisation configurables. Une resynchronisation est déclenchée lorsque l'équation logique de ces paramètres prend la valeur VRAI.

La valeur par défaut est (vide).

La resynchronisation échoue sur FNF

Une resynchronisation est considérée comme un échec si le profil demandé n'est pas reçu du serveur. Ce paramètre peut être remplacé par ce paramètre. Lorsqu'il est réglé sur Non, l'appareil accepte une réponse « fichier introuvable » de la part du serveur en tant que resynchronisation réussie.

La valeur par défaut est Oui.

Règle de profil

Règle du profil B


Règle de profil C


Règle D du profil

Chaque règle de profil indique au téléphone la source auprès de laquelle il peut obtenir un profil (fichier de configuration). À chaque opération de resynchronisation, le téléphone applique tous les profils dans l'ordre.

Par défaut : /$PSN.xml

Si vous appliquez le cryptage AES-256-CBC aux fichiers de configuration, spécifiez la clé de cryptage avec le mot clé --key comme suit :

[--key] <encryption key>

Vous pouvez mettre la clé de cryptage entre guillemets doubles («) en option.

Option DHCP à utiliser

Les options DHCP, séparées par des virgules, utilisées pour récupérer le firmware et les profils.

La valeur par défaut est 66 160 159 150, 60, 43 125.

Message de demande de journal

Ce paramètre contient le message qui est envoyé au serveur Syslog au début d'une tentative de resynchronisation.

La valeur par défaut est $PN $MAC —Requering % $SCHEME : //$SERVIP : $PORT$PATH.

Message de réussite du journal

Le message Syslog qui est émis lors d'une tentative de resynchronisation réussie.

La valeur par défaut est $PN $MAC —Resync réussie % $SCHEME : //$SERVIP : $PORT$PATH -- $ERR.

Message d'échec du journal

Le message Syslog émis après l'échec d'une tentative de resynchronisation.

La valeur par défaut est $PN $MAC -- Echec de la resynchronisation : $ERR.

Resynchronisation configurable par l'utilisateur

Permet à un utilisateur de resynchroniser le téléphone depuis l'écran du téléphone IP.

La valeur par défaut est Oui.

Paramètres de mise à niveau du firmware

Le tableau suivant définit la fonction et l'utilisation de chaque paramètre dans la section Mise à niveau du firmware de l'onglet Provisioning.

Tableau 2. Paramètres de mise à niveau du firmware

Nom du paramètre

Description et valeur par défaut

Activer la mise à niveau

Permet les opérations de mise à niveau du firmware indépendamment des opérations de resynchronisation.

La valeur par défaut est Oui.

Configurez ce paramètre de l'une des manières suivantes :

  • Dans le fichier de configuration du téléphone au format XML (cfg.xml), entrez une chaîne au format suivant : <Upgrade_Enable ua="na">Oui</Upgrade_Enable>

  • Sur la page Web d'administration téléphonique, définissez ce champ sur Oui ou Non.

Erreur de mise à niveau, nouvelle tentative

L'intervalle entre les nouvelles tentatives de mise à niveau (en secondes) s'appliquait en cas d'échec de la mise à niveau. L'appareil possède un minuteur d'erreur de mise à niveau du firmware qui s'active en cas d'échec d'une tentative de mise à niveau. Le chronomètre est initialisé avec la valeur de ce paramètre. La prochaine tentative de mise à niveau du firmware aura lieu lorsque le compte à rebours sera terminé.

La valeur par défaut est de 3 600 secondes.

Configurez ce paramètre de l'une des manières suivantes :

  • Dans le fichier de configuration du téléphone au format XML (cfg.xml), entrez une chaîne au format <Upgrade_Error_Retry_Delay ua="na">3600</Upgrade_Error_Retry_Delay>

  • Sur la page Web d'administration du téléphone, définissez la valeur.

Règle de mise à niveau

Un script de mise à niveau du firmware qui définit les conditions de mise à niveau et les URL du firmware associées. Il utilise la même syntaxe que Profile Rule.

Utilisez le format suivant pour saisir la règle de mise à niveau :

<tftp|http|https>://<ip address><:port>/<path>/<load name>

Par exemple :

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

Si aucun protocole n'est spécifié, le TFTP est supposé. Si aucun nom de serveur n'est spécifié, l'hôte qui demande l'URL est utilisé comme nom de serveur. Si aucun port n'est spécifié, le port par défaut est utilisé (69 pour le TFTP, 80 pour le HTTP ou 443 pour le HTTPS).

La valeur par défaut est vide.

Configurez ce paramètre de l'une des manières suivantes :

  • Dans le fichier de configuration du téléphone au format XML (cfg.xml), entrez une chaîne au format <Upgrade_Rule ua="na">suivant : http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • Sur la page Web d'administration du téléphone, entrez le chemin où est stocké le fichier de chargement.

Message de demande de mise à niveau du journal

Message Syslog émis au début d'une tentative de mise à niveau du firmware.

Par défaut : $PN $MAC -- Demande de mise à niveau $SCHEME : //$SERVIP : $PORT$PATH

Configurez ce paramètre de l'une des manières suivantes :

  • Dans le fichier de configuration du téléphone au format XML (cfg.xml), entrez une chaîne au format suivant : <Log_Upgrade_Request_Msg ua="na">$PN $MAC -- Demande de mise à niveau $SCHEME : //$SERVIP : $PORT$PATH</Log_Upgrade_Request_Msg>

  • Sur la page Web d'administration du téléphone, personnalisez le paramètre selon vos besoins.

Message de réussite de la mise à niveau du journal

Message Syslog émis après une tentative de mise à niveau du firmware réussie.

La valeur par défaut est $PN $MAC -- Mise à niveau réussie $SCHEME : //$SERVIP : $PORT$PATH -- $ERR

Configurez ce paramètre de l'une des manières suivantes :

  • Dans le fichier de configuration du téléphone au format XML (cfg.xml), entrez une chaîne au format suivant : <Log_Upgrade_Success_Msg ua="na">$PN $MAC -- Mise à niveau réussie $SCHEME : //$SERVIP : $PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • Sur la page Web d'administration du téléphone, personnalisez le paramètre selon vos besoins.

Message d'échec de mise à niveau du journal

Message Syslog émis suite à l'échec d'une tentative de mise à niveau du firmware.

La valeur par défaut est $PN $MAC -- Echec de la mise à niveau : $ERR

Configurez ce paramètre de l'une des manières suivantes :

  • Dans le fichier de configuration du téléphone au format XML (cfg.xml), entrez une chaîne au format suivant : <Log_Upgrade_Failure_Msg ua="na">$PN $MAC -- Échec de la mise à niveau : $ERR</Log_Upgrade_Failure_Msg>

  • Sur la page Web d'administration du téléphone, personnalisez le paramètre selon vos besoins.

Partage du microprogramme entre pairs

Active ou désactive la fonction Peer Firmware Sharing (PFS). Sélectionnez Oui ou Non pour activer ou désactiver la fonctionnalité.

Par défaut : Oui

Configurez ce paramètre de l'une des manières suivantes :

  • Dans le fichier de configuration du téléphone au format XML (cfg.xml), entrez une chaîne au format suivant : <Peer_Firmware_Sharing ua="na">Oui</Peer_Firmware_Sharing>

  • Sur la page Web d'administration téléphonique, définissez ce champ sur Oui ou Non.

Serveur de log de partage du microprogramme Peer

Indique l'adresse IP et le port vers lesquels le message UDP est envoyé.

Par exemple : 10.98.76. 123:514 où 10.98.76.123 est l'adresse IP et 514 le numéro de port.

Configurez ce paramètre de l'une des manières suivantes :

  • Dans le fichier de configuration du téléphone au format XML (cfg.xml), entrez une chaîne au format <Peer_Firmware_Sharing_Log_Server ua="na">10.98.76</Peer_Firmware_Sharing_Log_Server>. 123:514

  • Sur la page Web d'administration du téléphone, saisissez l'adresse du serveur de journalisation.

Paramètres à usage général

Le tableau suivant définit la fonction et l'utilisation de chaque paramètre dans la section Paramètres à usage général de l'onglet Approvisionnement.

Tableau 3. Paramètres à usage général

Nom du paramètre

Description et valeur par défaut

GPP A - GPP P

Les paramètres généraux GPP_* sont utilisés comme registres de chaînes gratuits lors de la configuration des téléphones pour qu'ils interagissent avec un serveur d'approvisionnement en particulier. Ils peuvent être configurés pour contenir diverses valeurs, notamment les suivantes :

  • Clés de cryptage.

  • URL.

  • Informations sur l'état de l'approvisionnement en plusieurs étapes.

  • Modèles de demandes de publication.

  • Mappes d'alias de noms de paramètres.

  • Des valeurs de chaîne partielles, finalement combinées en valeurs de paramètres complètes.

La valeur par défaut est vide.

Variables d'expansion des macros

Certaines variables macro sont reconnues dans les paramètres de provisionnement suivants :

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Log_*

  • GPP_* (sous certaines conditions)

Dans ces paramètres, les types de syntaxe, tels que $NAME ou $ (NAME), sont reconnus et développés.

Les sous-chaînes de variables macro peuvent être spécifiées avec les notations $ (name:P) et $ (name:p:Q), où p et q sont des entiers non négatifs (disponibles dans la révision 2.0.11 et versions ultérieures). L'expansion des macros qui en résulte est la sous-chaîne commençant au décalage de caractères p, avec une longueur q (ou bien jusqu'à la fin de la chaîne si q n'est pas spécifié). Par exemple, si GPP_A contient ABCDEF, alors $ (A:2) devient CDEF et $ (A : 2:3) devient CDE.

Un nom inconnu n'est pas traduit et la forme $NAME ou $ (NAME) reste inchangée dans la valeur du paramètre après le développement.

Nom du paramètre

Description et valeur par défaut

$

La forme $$ s'étend à un seul caractère $.

De A à P

Remplacé par le contenu des paramètres généraux GPP_A à GPP_P.

SA à SD

Remplacé par les paramètres spéciaux GPP_SA à GPP_SD. Ces paramètres contiennent les clés ou les mots de passe utilisés pour l'approvisionnement.

$SA à $SD sont reconnus comme arguments pour le qualificatif d'URL de resynchronisation facultatif, --key.

MA

Adresse MAC en minuscules hexadécimales, par exemple 000e08aabbcc.

MAU

Adresse MAC en chiffres hexadécimaux majuscules, par exemple 000E08AABBCC.

MAC

Adresse MAC utilisant des chiffres hexadécimaux minuscules et des deux-points pour séparer les paires de chiffres hexadécimaux. Par exemple 00:0 e:08:aa:bb:cc.

PN

Nom du produit. Par exemple, CP-8875, DP-9851, DP-9871.

PSN

Numéro de série du produit. Par exemple, V03.

SN

Chaîne de numéro de série. Par exemple 88012BA01234.

CCERT

État du certificat client SSL : installé ou non installé.

IP

Adresse IP du téléphone sur son sous-réseau local. Par exemple 192.168.1.100.

EXTIP

Adresse IP externe du téléphone, telle qu'elle apparaît sur Internet. Par exemple 66.43.16.52.

SWVER

Chaîne de version du logiciel. Par exemple,

PHONEOS.3-1-1-0104-37

HWVER

Chaîne de version matérielle. Par exemple, 2.0.1

PRVST

État d'approvisionnement (chaîne numérique) :

-1 = demande de resynchronisation explicite

0 = resynchronisation à la mise sous tension

1 = resynchronisation périodique

2 = échec de la resynchronisation, nouvelle tentative

UPGST

État de mise à niveau (chaîne numérique) :

1 = première tentative de mise à niveau

2 = échec de la mise à niveau, nouvelle tentative

UPGERR

Message de résultat (ERR) de la précédente tentative de mise à niveau ; par exemple, http_get a échoué.

PRVTMR

Quelques secondes se sont écoulées depuis la dernière tentative de resynchronisation.

UPGTMR

Quelques secondes se sont écoulées depuis la dernière tentative de mise à niveau.

REGTMR1

Quelques secondes se sont écoulées depuis que Line 1 a perdu son enregistrement sur le serveur SIP.

REGTMR2

Quelques secondes se sont écoulées depuis que Line 2 a perdu son enregistrement sur le serveur SIP.

UPGCOND

Nom de la macro Legacy.

SCHEME

Schéma d'accès aux fichiers, TFTP, HTTP ou HTTPS, obtenu après avoir analysé l'URL de resynchronisation ou de mise à niveau.

SERV

Demandez le nom d'hôte du serveur cible, tel qu'il a été obtenu après avoir analysé l'URL de resynchronisation ou de mise à niveau.

SERVIP

Demandez l'adresse IP du serveur cible, telle qu'elle a été obtenue après avoir analysé l'URL de resynchronisation ou de mise à niveau, peut-être à la suite d'une recherche DNS.

PORT

Demandez le port UDP/TCP cible, tel qu'il a été obtenu après avoir analysé l'URL de resynchronisation ou de mise à niveau.

PATH

Demandez le chemin du fichier cible, tel qu'il a été obtenu après avoir analysé l'URL de resynchronisation ou de mise à niveau.

ERR

Message de résultat d'une tentative de resynchronisation ou de mise à niveau. Utile uniquement pour générer des messages Syslog contenant les résultats. La valeur est conservée dans la variable UPGERR en cas de tentative de mise à niveau.

UIDN

Le contenu du paramètre de configuration Line n UserID.

EMS

Extension MobilityStatut

MUID

Extension MobilityNom d'utilisateur

MPWD

Extension MobilityMot de passe

Codes d'erreur internes

Le téléphone définit un certain nombre de codes d'erreur internes (X00 à X99) pour faciliter la configuration et permettre un contrôle plus précis du comportement de l'appareil dans certaines conditions d'erreur.

Tableau 4. Codes d'erreur internes

Nom du paramètre

Description et valeur par défaut

X00

Erreur de couche de transport (ou ICMP) lors de l'envoi d'une requête SIP.

X20

Les requêtes SIP expirent en attendant une réponse.

X40

Erreur générale liée au protocole SIP (par exemple, un codec inacceptable dans le SDP dans les messages 200 et ACK, ou un délai d'attente pendant l'attente de l'ACK).

X60

Numéro composé non valide selon le plan de numérotation indiqué.

Cet article était-il utile ?
Cet article était-il utile ?