- Accueil
- /
- Article
Paramètres pour la mise à disposition de téléphones sur Cisco BroadWorks
Cet article d’aide concerne les téléphones Cisco enregistrés auprès de Cisco BroadWorks. Les informations sur cette page comprennent les paramètres de mise à disposition et leur syntaxe.
Types de paramètres de mise à disposition
Cette section décrit les paramètres de mise à disposition largement organisés en fonction.
Paramètres généraux
Les paramètres généraux GPP_* (
) sont utilisés comme registres de chaîne libre lors de la configuration du téléphone pour interagir avec une solution de serveur de mise à disposition 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 chiffrement
-
URL
-
Informations sur l'état de la mise à disposition en plusieurs étapes.
-
Modèles de demande de publication
-
Mappages d’alias de nom de paramètre
-
Valeurs de chaîne partielles, éventuellement combinées en valeurs de paramètre complètes.
Les paramètres GPP_* sont disponibles pour l'expansion de macro dans d'autres paramètres de mise à disposition. À cette fin, les noms de macros en majuscules d'une seule lettre (A à P) suffisent à identifier le contenu de GPP_A à GPP_P. De plus, les noms de macros en majuscules à deux lettres SA à SD identifient GPP_SA à GPP_SD comme un cas spécial lorsqu'ils sont utilisés comme arguments des options d'URL suivantes :
key, uid et pwd
Ces paramètres peuvent être utilisés comme variables dans les règles de mise à disposition et de mise à niveau. Ils sont référencés en préfixant le nom de la variable avec un caractère ‘$’, tel que $GPP_A.
Activer les paramètres
Les paramètres Provision_Activer et Upgrade_Activer contrôlent toutes les opérations de resynchronisation de profil et de mise à niveau du micrologiciel. 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 URL de resynchronisation et de mise à niveau qui sont émises via le serveur web d'administration. Ces deux paramètres sont configuré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 au 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'événement : resynchroniser l'en-tête au périphérique.
Le périphérique conteste la demande avec une réponse 401 (autorisation refusée pour les informations d'identification utilisées). Le périphérique attend une demande ultérieure authentifiée avant d'honorer la demande de resynchronisation du proxy. L’événement : reboot_now et Event : restart_now les en-têtes effectuent des redémarrages à froid et à chaud, respectivement, qui sont également validés.
Les deux autres activations sont Resync_On_Reset et Resync_After_Upgrade_Attempt. Ces paramètres déterminent si le périphérique effectue une opération de resynchronisation après la mise sous tension du logiciel et après chaque tentative de mise à niveau.
Lorsque Resync_On_Reset est activé, le périphérique introduit un délai aléatoire qui suit la séquence de démarrage avant que la réinitialisation ne soit effectuée. Le délai est un temps aléatoire jusqu'à la valeur spécifiée par Resync_Random_Delay (en secondes). Dans un pool de téléphones qui se mettent en marche simultanément, ce délai répartit les heures de début des demandes de resynchronisation de chaque unité. Cette fonctionnalité peut être utile dans un déploiement résidentiel de grande envergure, en cas de panne d'électricité régionale.
Déclencheurs
Le téléphone vous permet d'effectuer une resynchronisation à des intervalles ou à un moment précis.
Resynchroniser à des intervalles spécifiques
Le téléphone est conçu pour se resynchroniser périodiquement avec le serveur de mise à disposition. L'intervalle de resynchronisation est configuré en Resync_Périodique (secondes). Si cette valeur est laissée vide, le périphérique ne se resynchronise pas périodiquement.
La resynchronisation a généralement lieu lorsque les lignes vocales sont inactives. Si une ligne vocale est active lorsqu'une resynchronisation doit être effectuée, le téléphone retarde la resynchronisation jusqu'à ce que la ligne redevienne inactive. Une resynchronisation peut entraîner la modification des valeurs des paramètres de configuration.
Une resynchronisation peut échouer car le téléphone ne parvient pas à récupérer un profil à partir du serveur, le fichier téléchargé est endommagé ou une erreur interne s'est produite. Le périphérique tente de se resynchroniser à nouveau après une heure spécifiée dans Resync_Error_Retry_Delay (secondes). Si Resync_Error_Retry_Delay est configuré sur 0, le périphérique ne tente pas de resynchroniser à nouveau après une tentative de resynchronisation infructueuse.
Si une mise à niveau échoue, une nouvelle tentative est effectuée après Upgrade_Error_Retry_Delay secondes.
Deux paramètres configurables sont disponibles pour déclencher une resynchronisation sous condition : Resync_Trigger_1 et Resync_Trigger_2. Chaque paramètre peut être programmé avec une expression conditionnelle qui subit une expansion de macro. Lorsque l'intervalle de resynchronisation expire (heure de la prochaine resynchronisation), les déclencheurs, s'ils sont définis, empêchent la resynchronisation, à moins qu'un ou plusieurs déclencheurs ne prennent la valeur Vrai.
L'exemple de condition suivant déclenche une resynchronisation. Dans cet exemple, la dernière tentative de mise à niveau du téléphone s'est écoulée 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 et $PRVTMR ge 600
Resynchronisation à une heure précise
Le paramètre Resync_At permet au téléphone de se resynchroniser à 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 au téléphone de se resynchroniser à un délai non spécifié dans le temps. Ce paramètre utilise un format entier positif pour spécifier l'heure.
Inonder le serveur avec des demandes de resynchronisation provenant de plusieurs téléphones qui sont configurés pour se resynchroniser en même temps doit être évité. 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 définissez l'heure de resynchronisation à 1000 (10 h 00), le téléphone déclenche la resynchronisation à tout moment entre 10 h 00 et 10 h 10.
Par défaut, cette fonction est désactivée. Si le paramètre Resync_At est mis à disposition, le paramètre Resync_Periodic est ignoré.
Programmations configurables
Vous pouvez configurer des calendriers pour des resynchronisations périodiques et vous pouvez spécifier les intervalles de nouvelle tentative en cas d'échec de resynchronisation et de mise à niveau à l'aide de ces paramètres de mise à disposition :
-
Resync_Périodique
-
Délai Resync_Error_Retry_
-
Délai Upgrade_Error_Retry_
Chaque paramètre accepte une seule valeur de délai (en secondes). La nouvelle syntaxe étendue permet une liste séparée par des virgules d'éléments de retard consécutifs. Le dernier élément de la séquence est implicitement répété à jamais.
Facultativement, vous pouvez utiliser un signe plus pour spécifier une autre valeur numérique qui ajoute un délai aléatoire supplémentaire.
Exemple 1
Dans cet exemple, le téléphone se resynchronise périodiquement toutes les 2 heures. En cas de panne de resynchronisation, le périphérique effectue une nouvelle tentative à ces intervalles : 30 minutes, 1 heure, 2 heures, 4 heures. Le périphérique continue d'essayer à des intervalles de 4 heures jusqu'à ce qu'il se resynchronise avec succès.
Resync_Périodique=7200 Resync_Error_Retry_Délai=1800,3600,7200,14400
Exemple 2
Dans cet exemple, le périphérique se resynchronise périodiquement toutes les heures (plus un délai aléatoire supplémentaire allant jusqu'à 10 minutes). En cas d'échec de la resynchronisation, le périphérique effectue une nouvelle tentative à ces intervalles : 30 minutes (plus 5 minutes au maximum). 1 heure (plus 10 minutes au maximum), 2 heures (plus 15 minutes au maximum). Le périphérique continue d'essayer à des intervalles de 2 heures (plus 15 minutes au maximum) jusqu'à ce qu'il se resynchronise avec succès.
Resync_Périodique=3600+600 Resync_Error_Retry_Délai=1800+300,3600+600,7200+900
Exemple 3
Dans cet exemple, si une tentative de mise à niveau à distance échoue, le périphérique retente la mise à niveau dans 30 minutes, puis à nouveau après une heure de plus, puis dans deux heures. Si la mise à niveau échoue, le périphérique effectue une nouvelle tentative toutes les quatre à cinq heures jusqu'à ce que la mise à niveau réussisse.
Délai Upgrade_Error_Retry_ = 1800,3600,7200,14400+3600
Règles de 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 que différents serveurs gèrent.
Dans le scénario le plus simple, le périphérique se resynchronise périodiquement à un seul profil sur un serveur central, qui met à jour tous les paramètres internes pertinents. Sinon, le profil peut être divisé 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 chiffrement et les informations de certificat peuvent être fournies par encore un autre profil, stocké sur un serveur séparé.
Chaque fois qu'une resynchronisation doit être effectuée, le téléphone évalue les quatre paramètres Profile_Rule* dans l'ordre :
-
Règlerofile_p
-
Profile_Rule_B
-
Profile_Rule_C
-
Profile_Rule_N
Chaque évaluation peut entraîner une récupération de profil à partir d'un serveur de mise à disposition distant, avec une mise à jour possible d'un certain nombre de paramètres internes. Si une évaluation échoue, la séquence de resynchronisation est interrompue et est retentée depuis le début spécifié par le paramètre Resync_Error_Retry_Delay (en secondes). Si toutes les évaluations réussissent, le périphérique 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 | (tube). Chaque alternative se compose d'une expression conditionnelle, d'une expression d'affectation, d'une URL de profil et de toutes les options d'URL associées. Tous ces composants sont facultatifs dans 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, à l'exception de la dernière, doivent fournir une expression conditionnelle. Cette expression est évaluée et est traitée comme suit :
-
Les conditions sont évaluées de gauche à droite, jusqu'à ce qu'il en soit trouvé une qui donne la valeur Vrai (ou jusqu'à ce qu'une alternative soit trouvée sans expression conditionnelle).
-
Toute expression d'affectation d'accompagnement est évaluée, le cas échéant.
-
Si une URL est spécifiée dans le cadre de cette alternative, une tentative est effectuée pour télécharger le profil qui se trouve à l'URL spécifiée. Le système tente de mettre à jour les paramètres internes en conséquence.
Si toutes les alternatives ont des expressions conditionnelles et qu'aucune n'évalue la valeur Vrai (ou si toute la règle de profil est vide), tout le paramètre Profile_Rule* est ignoré. Le paramètre de règle de profil suivant de la séquence est évalué.
Exemple 1
Cet exemple se resynchronise inconditionnellement au profil à l'URL spécifiée et effectue une requête HTTP GET au serveur de mise à disposition à distance :
http://remote.server.com/cisco/$MA.cfg
Exemple 2
Dans cet exemple, le périphérique se resynchronise à deux URL différentes, en fonction de l'état d'enregistrement de la ligne 1. En cas de perte d'enregistrement, le périphérique effectue un HTTP POST vers un script CGI. Le périphérique envoie le contenu de la macro étendue GPP_A, qui peut fournir des informations supplémentaires sur l’état du périphérique :
($PRVTMR ge 600) ? http://p.tel.com/has-reg.cfg | [--poster un] http://p.tel.com/lost-reg?
Exemple 3
Dans cet exemple, le périphérique se resynchronise au même serveur. Le périphérique fournit des informations supplémentaires si un certificat n'est pas installé dans l'unité (pour les unités antérieures à la version 2.0) :
(«$CCERT » eq « Installé ») ? 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 égal à Provisionné via la première URL. Ensuite, il se resynchronise à la seconde URL :
(«$A » ne « Provisionné ») ? (Line_Enable_1_ = « Non » ;) ! https://p.tel.com/init-prov | https://p.tel.com/configs
Exemple 5
Dans cet exemple, le profil que le serveur renvoie est supposé contenir des balises d'éléments XML. Ces balises doivent être remappées aux noms de paramètres appropriés par 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 ayant échoué si un profil demandé n'est pas reçu du serveur. Le paramètre Resync_Fails_On_FNF peut remplacer ce comportement par défaut. Si Resync_Fails_On_FNF est configuré sur Non, le périphérique accepte une réponse file-not-found du serveur comme une 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 consiste à indiquer au périphérique qu'il doit activer pour une nouvelle charge et d'où obtenir la charge, si nécessaire. Si la charge est déjà sur le périphérique, il n'essaiera pas d'obtenir la charge. Ainsi, la validité de l'emplacement de charge n'a pas d'importance lorsque la charge souhaitée est dans la partition inactive.
La règle Upgrade_ spécifie une charge de micrologiciel qui, si elle est différente de la charge actuelle, sera téléchargée et appliquée à moins qu'elle ne soit limitée par une expression conditionnelle ou que Upgrade_Enable soit configuré sur Non.
Le téléphone fournit un paramètre de mise à niveau configurable à distance, Upgrade_Rule. Ce paramètre accepte une syntaxe similaire aux paramètres de règle de profil. Les options d'URL ne sont pas prises en charge pour les mises à niveau, mais les expressions conditionnelles et les expressions d'affectation peuvent être utilisées. Si des expressions conditionnelles sont utilisées, le paramètre peut être rempli avec plusieurs alternatives, séparées par le | caractère. La syntaxe de chaque alternative est la suivante :
[ conditional-expr ] [ assignment-expr ] URL
Comme dans le cas des paramètres Profile_Rule*, le paramètre Upgrade_Rule évalue chaque alternative jusqu'à ce qu'une expression conditionnelle soit satisfaite ou qu'une alternative n'ait pas d'expression conditionnelle. L'expression d'affectation d'accompagnement est évaluée, le cas échéant. Ensuite, une tentative de mise à niveau vers l'URL spécifiée est effectuée.
Si le paramètre Upgrade_Rule contient une URL sans expression conditionnelle, le périphérique est mis à niveau à l'image du micrologiciel que spécifie l'URL. Après l'expansion de macro et l'évaluation de la règle, le périphérique ne tente pas de mettre à niveau à nouveau jusqu'à ce que la règle soit modifiée, ou que la combinaison efficace de schéma + serveur + port + chemin d'accès + chemin d'accès soit modifiée.
Pour tenter une mise à niveau du micrologiciel, le périphérique désactive l'audio au début de la procédure et redémarre à la fin de la procédure. Le périphérique démarre automatiquement une mise à niveau qui est déterminée par 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 règle Upgrade_Rule met à niveau le micrologiciel à l'image qui est stockée à l'URL indiquée.
En voici un autre exemple :
(« $F » ne « bêta-client ») ? 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 de mise à disposition
Vous trouverez les paramètres de mise à disposition sur l'onglet Mise à disposition 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 Mise à disposition .
Nom du paramètre |
Description et valeur par défaut |
---|---|
Activation de la mise à disposition |
Contrôle toutes les actions de resynchronisation indépendamment des actions de mise à niveau du micrologiciel. Configurer sur Oui pour activer la mise à disposition à distance. La valeur par défaut est Oui. |
Resynchronisation lors de la réinitialisation |
Déclenche une resynchronisation après chaque redémarrage, à l'exception des redémarrages causés par des mises à jour de paramètres et des mises à niveau du micrologiciel. La valeur par défaut est Oui. |
Délai aléatoire de resynchronisation |
Délai aléatoire suivant la séquence de démarrage avant d'effectuer la réinitialisation, spécifié en secondes. Dans un pool de périphériques de téléphonie IP planifiés pour se mettre en marche simultanément, cela introduit un étalement des heures auxquelles chaque unité envoie une demande de resynchronisation au serveur de mise à disposition. Cette fonctionnalité peut être utile dans un déploiement résidentiel de grande envergure, en cas de panne d'électricité régionale. La valeur de ce champ doit être un nombre entier compris entre 0 et 65535. La valeur par défaut est 2. |
Resynchronisation à (HHmm) |
L'heure (HHmn) à laquelle le périphérique se resynchronise avec le serveur de mise à disposition. La valeur de ce champ doit être un nombre à quatre chiffres allant de 0000 à 2400 pour indiquer l'heure au format HHmm. Par exemple, 0959 indique 09:59. 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é. |
Délai de resynchronisation aléatoire |
Empêche une surcharge du serveur de mise à disposition lorsqu'un grand nombre de périphériques sont mis sous tension simultanément. Pour éviter d'inonder le serveur des demandes de resynchronisation à partir de plusieurs téléphones, le téléphone se resynchronise dans la plage comprise entre les heures et les minutes, et les heures et les minutes plus le délai aléatoire (hhmm, hhmm+random_delay). Par exemple, si le délai aléatoire = (Resync At Random Delay + 30)/60 minutes, la valeur d'entrée en secondes est convertie en minutes, arrondie à la minute suivante pour calculer l'random_delay intervalle final. La valeur valide est comprise entre 600 et 65535. 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 600 secondes (10 minutes). |
Resynchronisation périodique |
L'intervalle de temps entre des resynchronisations périodiques avec le serveur de mise à disposition. Le minuteur de resynchronisation associé n'est actif qu'après la première synchronisation réussie avec le serveur. Les formats valides sont les suivants :
Définissez ce paramètre à zéro pour désactiver la resynchronisation périodique. La valeur par défaut est de 3 600 secondes. |
Délai de nouvelle tentative d'erreur de resynchronisation |
Si une resynchronisation échoue parce que le périphérique de téléphonie IP n’a pas pu récupérer un profil à partir du serveur, ou si le fichier téléchargé est endommagé ou si une erreur interne se produit, le périphérique tente à nouveau d’effectuer une resynchronisation après une heure spécifiée en secondes. Les formats valides sont les suivants :
Si le délai est défini sur 0, le périphérique ne tente pas de resynchroniser à nouveau après une tentative de resynchronisation infructueuse. |
Délai de resynchronisation forcé |
Délai maximum (en secondes) pendant lequel le téléphone attend avant d'effectuer une resynchronisation. Le périphérique ne se resynchronise pas lorsqu'une de ses lignes téléphoniques est active. Une resynchronisation pouvant prendre plusieurs secondes, il est souhaitable d'attendre que le périphérique soit resté inactif pendant une longue période avant de se resynchroniser. Cela permet à un utilisateur de passer des appels successivement sans interruption. Le périphérique dispose d'un temporisateur qui commence à compter à rebours lorsque toutes ses lignes deviennent inactives. Ce paramètre est la valeur initiale du compteur. Les événements de resynchronisation sont retardés jusqu'à ce que ce compteur soit décrémenté à zéro. La valeur valide est comprise entre 0 et 65535. La valeur par défaut est de 14 400 secondes. |
Resynchronisation à partir du protocole SIP |
Permet de déclencher une resynchronisation via un message SIP NOTIFY. La valeur par défaut est Oui. |
Resynchronisation après la tentative de mise à niveau |
Active ou désactive l'opération de resynchronisation après qu'une mise à niveau ait eu lieu. Si Oui est sélectionné, la synchronisation est déclenchée. La valeur par défaut est Oui. |
Déclencheur de resynchronisation 1, déclencheur de resynchronisation 2 |
Conditions de déclenchement de 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). |
Échec de la resynchronisation sur FNF |
Une resynchronisation est considérée comme ayant échoué si un profil demandé n'est pas reçu du serveur. Ce paramètre peut remplacer ce paramètre. Lorsqu'elle est définie sur non, le périphérique accepte une réponse La valeur par défaut est Oui. |
Règle de profil Règle de profil B Règle de profil C Règle de profil D |
Chaque règle de profil informe le téléphone d'une source à partir de laquelle obtenir un profil (fichier de configuration). Lors de chaque opération de resynchronisation, le téléphone applique tous les profils dans l'ordre. Par défaut : Si vous appliquez le chiffrement AES-256-CBC aux fichiers de configuration, spécifiez la clé de chiffrement avec le mot-clé Vous pouvez placer la clé de chiffrement entre guillemets doubles («») facultativement. |
Option DHCP À utiliser |
Options DHCP, délimitées par des virgules, utilisées pour récupérer le micrologiciel et les profils. La valeur par défaut est 66,160,159,150,60,43,125. |
Log Request Msg |
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 |
Journaliser les paramètres de réussite |
Message syslog qui est émis à la fin d'une tentative de resynchronisation réussie. La valeur par défaut est |
Log Failure Msg |
Message syslog émis après une tentative de resynchronisation infructueuse. La valeur par défaut est |
Resynchronisation configurable par l’utilisateur |
Permet aux utilisateurs de resynchroniser le téléphone à partir de l'écran du téléphone IP. La valeur par défaut est Oui. |
Paramètres de mise à niveau du micrologiciel
Le tableau suivant définit la fonction et l'utilisation de chaque paramètre dans la section Mise à niveau du micrologiciel de l'onglet Mise à disposition .
Nom du paramètre |
Description et valeur par défaut |
---|---|
Activer la mise à niveau |
Active les opérations de mise à niveau du micrologiciel indépendamment des actions de resynchronisation. La valeur par défaut est Oui. Configurez ce paramètre avec l'une des méthodes suivantes :
|
Délai de nouvelle tentative d'erreur de mise à niveau |
L'intervalle de nouvelle tentative de mise à niveau (en secondes) s'applique en cas d'échec de la mise à niveau. Le périphérique dispose d'un temporisateur d'erreur de mise à niveau du micrologiciel qui s'active après l'échec d'une tentative de mise à niveau du micrologiciel. Le minuteur est initialisé avec la valeur dans ce paramètre. La prochaine tentative de mise à jour du microprogramme se produit lorsque ce minuteur compte sur zéro. La valeur par défaut est de 3 600 secondes. Configurez ce paramètre avec l'une des méthodes suivantes :
|
Règle de mise à niveau |
Un script de mise à niveau du micrologiciel qui définit les conditions de mise à niveau et les URL associées du micrologiciel. Il utilise la même syntaxe que Profile Rule. Utilisez le format suivant pour saisir la règle de mise à niveau :
par exemple
Si aucun protocole n'est spécifié, 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 TFTP, 80 pour HTTP ou 443 pour HTTPS). La valeur par défaut est vide. Configurez ce paramètre avec l'une des méthodes suivantes :
|
Journaliser la demande de mise à niveau Msg |
Message syslog émis au démarrage d’une tentative de mise à jour du microprogramme. Valeur par défaut : Configurez ce paramètre avec l'une des méthodes suivantes :
|
Log Mise à niveau réussie Msg |
Message syslog émis après la tentative de mise à jour du micrologiciel réussie. La valeur par défaut est Configurez ce paramètre avec l'une des méthodes suivantes :
|
Journaliser les échecs de mise à niveau Msg |
Message syslog émis après une tentative de mise à jour du micrologiciel qui a échoué. La valeur par défaut est Configurez ce paramètre avec l'une des méthodes suivantes :
|
Partage de micrologiciel entre homologues |
Active ou désactive la fonctionnalité de partage de micrologiciel entre homologues (PFS). Sélectionnez Oui ou Non pour activer ou désactiver la fonctionnalité. Par défaut : Oui Configurez ce paramètre avec l'une des méthodes suivantes :
|
Serveur de journaux de partage de micrologiciel entre homologues |
Indique l'adresse IP et le port vers lequel le message UDP est envoyé. par exemple 10.98.76.123:514 où, 10.98.76.123 est l'adresse IP et 514 est le numéro de port. Configurez ce paramètre avec l'une des méthodes suivantes :
|
Paramètres généraux
Le tableau suivant définit la fonction et l'utilisation de chaque paramètre dans la section Paramètres généraux de l'onglet Mise à disposition .
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îne libre lors de la configuration des téléphones pour interagir avec une solution de serveur de mise à disposition particulière. Ils peuvent être configurés pour contenir diverses valeurs, notamment les suivantes :
La valeur par défaut est vide. |
Variables d'expansion de macro
Certaines variables de macro sont reconnues dans les paramètres de mise à disposition suivants :
-
Règlerofile_p
-
Rrofile_ule_*
-
Resync_Trigger_*
-
Upgrade_règle
-
Log_*
-
GPP_* (dans des conditions spécifiques)
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 la notation $(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 plus récente). L'expansion de macro qui en résulte est la sous-chaîne commençant au décalage de caractères p, avec la longueur q (ou sinon jusqu'à la fin de la chaîne si q n'est pas spécifié). Par exemple, si GPP_A contient ABCDEF, alors $(A:2) est développé en CDEF et $(A:2:3) est développé en CDE.
Un nom non reconnu n'est pas traduit, et la forme $NAME ou $(NAME) reste inchangée dans la valeur du paramètre après expansion.
Nom du paramètre |
Description et valeur par défaut |
---|---|
$ |
Le formulaire $$ s'agrandit en un seul $ caractère. |
A à P |
Remplacé par le contenu des paramètres généraux GPP_A à GPP_P. |
SA à SD |
Remplacés par les paramètres spéciaux GPP_SA à GPP_SD. Ces paramètres contiennent des clés ou des mots de passe utilisés dans la mise à disposition. $SA à $SD sont reconnus comme des arguments pour le qualificateur d'URL de resynchronisation facultatif, --key. |
MA |
Adresse MAC utilisant des chiffres hexadécimaux en minuscules, par exemple 000e08aabbcc. |
MAU |
Adresse MAC utilisant des chiffres hexadécimaux en majuscules, par exemple 000E08AABBCC. |
Mac |
Adresse MAC utilisant des chiffres hexadécimaux en minuscules et des deux-points pour séparer les paires de chiffres hexadécimaux. Par exemple 00:0e:08:aa:bb:cc. |
PN |
Nom du produit. Par exemple, CP-8875-CC-C-9K. |
nsp | Numéro de série du produit. Par exemple, V03. |
SN |
Chaîne de numéro de série. par exemple 88012BA01234. |
cert |
Statut du certificat client SSL : Installé ou non installé. |
IP |
Adresse IP du téléphone au sein de son sous-réseau local. Par exemple 192.168.1.100. |
exastuce |
Adresse IP externe du téléphone, comme illustré sur Internet. Par exemple 66.43.16.52. |
swver |
Chaîne de version du logiciel. Par exemple, phoneos-8875.1-0-1-0001-1 |
ver hwver |
Chaîne de version du matériel. Par exemple, 2.0.1 |
prvst |
État de mise à disposition (une chaîne numérique) : -1 = demande de resynchronisation explicite 0 = resynchronisation de mise sous tension 1 = resynchronisation périodique 2 = la resynchronisation a échoué, nouvelle tentative |
upgst |
État de mise à niveau (une chaîne numérique) : 1 = première tentative de mise à niveau 2 = la mise à niveau a échoué, nouvelle tentative |
upgerr |
Message de résultat (ERR) de la tentative précédente de mise à niveau ; par exemple http_get a échoué. |
prvtmr |
Secondes depuis la dernière tentative de resynchronisation. |
upgtmr |
Secondes depuis la dernière tentative de mise à niveau. |
REGTMR1 |
Secondes depuis que la ligne 1 a perdu l'enregistrement avec le serveur SIP. |
REGTMR2 |
Secondes depuis que ligne 2 a perdu l'enregistrement avec le serveur SIP. |
upgcond |
Nom de la macro existante. |
schéma |
Schéma d'accès au fichier, un parmi TFTP, HTTP ou HTTPS, tel qu'obtenu après l'analyse de l'URL de mise à niveau ou de resynchronisation. |
serv |
Demander le nom d'hôte du serveur cible, obtenu après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
servip |
Demander l'adresse IP du serveur cible, obtenue après l'analyse de l'URL de resynchronisation ou de mise à niveau, éventuellement après la recherche DNS. |
port |
Demander le port UDP/TCP cible, tel qu'obtenu après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
chemin |
Demander le chemin du fichier cible, tel qu'obtenu après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
erreur |
Message de résultat de la tentative de resynchronisation ou de mise à niveau. Utile uniquement pour générer des messages syslog de résultats. La valeur est conservée dans la variable UPGERR dans le cas des tentatives de mise à niveau. |
Identifiant universel (UID) |
Le contenu du paramètre de configuration de l'ID utilisateur de la ligne n. |
ems |
Statut Extension Mobility |
muid |
ID utilisateur Extension Mobility |
mpwd |
Mot de passe Extension Mobility |
Codes d’erreur internes
Le téléphone définit un certain nombre de codes d'erreur internes (X00-X99) pour faciliter la configuration en fournissant un contrôle plus précis sur le comportement de l'unité dans certaines conditions d'erreur.
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 |
La requête SIP expire en attendant une réponse. |
X40 |
Erreur générale du protocole SIP (par exemple, codec inacceptable dans SDP en 200 et messages ACK, ou expiration pendant l'attente d'ACK). |
X60 |
Numéro composé non valide selon le plan de numérotation donné. |