- Accueil
- /
- Article
Paramètres de mise à disposition pour les téléphones 9800 et 8877 (BroadWorks)
Cet article d'aide concerne les téléphones de bureau Cisco 9800 Series et les téléphones vidéo Cisco 8875 enregistrés sur Cisco BroadWorks. Les informations de cette page incluent les paramètres de mise à disposition et leur syntaxe.
Types de paramètres de déploiement
Cette section décrit les paramètres de déploiement organisés dans une large mesure par rapport à une 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 certaine solution de serveur de déploiement. Les paramètres GPP _* sont vides par défaut. Ils peuvent être configurés pour obtenir diverses valeurs, notamment les suivantes :-
Clés de chiffrement.
-
URL
-
Des informations sur l'état d'une mise à disposition en plusieurs étapes.
-
Modèles de requête de publication
-
Mappages d’alias de noms de paramètres.
-
Des valeurs de chaîne partielles, pouvant être combinées en des valeurs de paramètre complètes.
Les paramètres GPP _* sont disponibles pour l'expansion de macro au sein d'autres paramètres de mise à disposition. À cette fin, les noms de macros en majuscules avec une seule lettre (A-P) suffisent pour identifier le contenu du GPP_A au GPP_P. En outre, les noms de macros en majuscules à deux lettres SA à SD identifient GPP_SA à GPP_SD comme un cas particulier lorsqu'ils sont utilisés comme arguments des options URL suivantes :
key, uid, et pwd
Ces paramètres peuvent être utilisés en tant que variables dans les règles de mise à disposition et mise à niveau. Ils sont référencés en préfixant le nom de la variable par un caractère ‘$’, comme $GPP_A.
Activer des paramètres
Les paramètres Provision_Enable et Upgrade_Enable contrôlent toutes les resynchronisations de profil et opérations de mise à niveau du micrologiciel. Ces paramètres contrôlent les resynchronisations et les mises à niveau indépendamment. Ces paramètres contrôlent également les commandes de resynchronisation et de mise à niveau qui sont émises par le serveur Web d'administration. Ces deux paramètres sont définis sur Oui par défaut.
Le paramètre Resync_From_SIP contrôle les requêtes de resynchronisation. Un événement SIP NOTIFY est envoyé à partir du serveur de proxy du fournisseur de services au téléphone. S'il est activé, le proxy peut demander une resynchronisation. Pour ce faire, le serveur proxy envoie un message SIP NOTIFY contenant l'événement : en-tête de resynchronisation, au périphérique.
Le périphérique répond à la requête avec une réponse 401 (autorisation refusée pour les informations d'identification utilisées). Le périphérique attend une requête ultérieure authentifiée avant d'exécuter la requête de resynchronisation du proxy. Les en-têtes d'événement : reboot_now et : restart_now effectuent des redémarrages à froid et à chaud, respectivement, qui sont également validés par le serveur.
Les deux derniers paramètres Enables 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 séquence d'amorçage 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 d'amorçage avant d'effectuer la réinitialisation. Le délai est une durée aléatoire jusqu'à la valeur indiquée par le paramètre Resync_Random_Delay (en secondes). Dans un pool de téléphones qui se mettent en marche simultanément, ce délai permet de répartir les heures de début des demandes de resynchronisation de chaque unité. Cette fonctionnalité peut être utile dans les déploiements résidentiels de grande envergure, en cas de panne d’électricité régionale.
Déclenchements
Le téléphone permet la resynchronisation à des intervalles spécifiques ou à une heure donnée.
Resynchroniser à des intervalles spécifiques
Le téléphone est conçu pour se resynchroniser régulièrement avec le serveur de mise à disposition. L'intervalle de resynchronisation est configuré dans Resync_Periodic (en secondes). Si cette valeur est laissée vide, ou si elle est égale à zéro, le périphérique n'est pas resynchronisé périodiquement.
La resynchronisation a généralement lieu lorsque les lignes téléphoniques sont inactives. Lorsqu'une ligne vocale est active et qu'une resynchronisation doit avoir lieu, 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 parce que le téléphone ne parvient pas à récupérer un profil à partir du serveur, parce que le fichier téléchargé est endommagé, ou parce qu'une erreur interne s'est produite. Le périphérique tente d'effectuer une resynchronisation à nouveau après une durée spécifiée dans Resync_Error_Retry_Delay (en secondes). Si Resync_Error_Retry_Delay est défini sur 0, le périphérique ne tente pas d’effectuer à nouveau une resynchronisation 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 sous condition une resynchronisation : Resync_Trigger_1 et Resync_Trigger_2. Chaque paramètre peut être programmé avec une expression conditionnelle qui subit une expansion de macro. À l'expiration de l'intervalle de resynchronisation (heure de la prochaine resynchronisation) les déclencheurs, s'ils ont été définis, empêchent la resynchronisation, sauf si un au moins des déclencheurs est égal à Vrai.
L'exemple de condition suivant déclenche une resynchronisation. Dans cet exemple, la dernière tentative de mise à niveau de téléphone s'est écoulée il y a plus de 5 minutes (300 secondes), et moins de 10 minutes (600 secondes) se sont écoulées depuis la dernière tentative de resynchronisation.
$UPGTMR gt 300 and $PRVTMR ge 600
Resynchronisation à une heure donnée
Le paramètre Resync_At permet au téléphone de se resynchroniser à une heure donnée. 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 d'effectuer une resynchronisation après un délai non spécifié dans le temps. Ce paramètre utilise un format entier positif pour indiquer l'heure.
Saturer le serveur avec des requêtes de resynchronisation de plusieurs téléphones qui sont configurés pour effectuer une resynchronisation en même temps doit être évité. Pour ce faire, le téléphone déclenche la resynchronisation au maximum 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éclenchera la resynchronisation à tout instant entre 10 h 00 et 10 h 10
Cette fonctionnalité est désactivée par défaut. Lorsque le paramètre Resync_At est mis à disposition, le paramètre Resync_At est ignoré.
Horaires configurables
Vous pouvez configurer des horaires de resynchronisations périodiques, et vous pouvez spécifier des intervalles de nouvelle tentative en cas d’échec de resynchronisation et de mise à niveau à l’aide de ces paramètres de mise à disposition :
-
Resync_Periodic
-
Resync_Error_Retry_Delay
-
Upgrade_Error_Retry_Delay
Chaque paramètre accepte un seul délai (en secondes). La nouvelle syntaxe étendue permet une liste séparée par des virgules des délais consécutifs. Le dernier élément de la séquence est répété implicitement de manière continue.
Éventuellement, vous pouvez utiliser un signe plus pour indiquer une valeur numérique qui ajoute un délai aléatoire supplémentaire, comme illustré dans cet exemple.
Exemple 1
Dans cet exemple, le téléphone effectue périodiquement une resynchronisation 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_Periodic=7200 Resync_Error_Retry_Delay=1800,3600,7200,14400
Exemple 2
Dans cet exemple, le périphérique se resynchronise périodiquement toutes les heures (plus un délai supplémentaire aléatoire de 10 minutes). Dans le cas d'une panne de 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 jusqu'à 15 minutes). 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_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, le périphérique retente la mise à niveau au bout de 30 minutes, puis à nouveau après une heure, 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.
Upgrade_Error_Retry_Delay = 1800,3600,7200,14400+3600
Règles de profil
Le téléphone fournit plusieurs paramètres de profil de configuration à distance (Profile_Rule*). C'est pourquoi chaque opération de resynchronisation peut récupérer plusieurs fichiers, gérés par des serveurs distincts.
Dans le scénario le plus simple, le périphérique se resynchronise périodiquement à un seul profil sur un serveur principal, qui met à jour tous les paramètres internes qui s'appliquent. Le profil peut aussi être partagé entre différents fichiers. Un seul fichier est commun à tous les téléphones d'un déploiement. Un fichier distinct, 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 distinct.
Chaque fois qu'une resynchronisation doit être effectuée, le téléphone évalue les quatre paramètres Profile_Rule* dans l'ordre :
-
Profile_Rule
-
Profile_Rule_B
-
Profile_Rule_C
-
Profile_Rule_D
Chaque évaluation peut entraîner une récupération du profil à partir d'un serveur de mise à disposition à distance, 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 à nouveau au moment 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 et exécute ensuite un autre resynchronisation.
Le contenu de chaque paramètre Profile_Rule* se compose d'un ensemble de solutions alternatives. Les solutions alternatives sont séparées par le caractère | (barre verticale). Chaque solution 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 au sein de chaque alternative. Voici les combinaisons valides et l'ordre dans lequel elles doivent s'affichent, le cas échéant :
[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]
Au sein de chaque paramètre Profile_Rule*, toutes les solutions alternatives sauf 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 existe une qui donne la valeur Vrai (ou jusqu'à ce qu'une alternative soit trouvée sans expression conditionnelle).
-
Toutes les expressions d'affectation d'accompagnement sont évaluées, le cas échéant.
-
Si une URL est spécifiée dans le cadre de cette solution 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 comportent des expressions conditionnelles et qu'aucune ne prend la valeur Vrai (ou si l'ensemble de la règle du profil est vide), le paramètre Profile_Rule* tout entier est ignoré. Le paramètre de règle de profil suivant de la séquence est évalué.
Exemple 1
Cet exemple effectue une resynchronisations inconditionnelle au profil de l'URL spécifiée et 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 sur deux URL différentes, en fonctionnalité de l'état d'enregistrement de la ligne 1. En cas de perte d'enregistrement, le périphérique exécute 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 | [--post a] http://p.tel.com/lost-reg ?
Exemple 3
Dans cet exemple, le périphérique réalise une resynchronisation sur le même serveur. Le périphérique fournit des informations supplémentaires, si un certificat n'est pas installé sur l'unité (pour les unités antérieures à la 2.0 existantes) :
(« $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 à Mis à disposition par la première URL. Ensuite, il effectue une resynchronisation à 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, on suppose que le profil que le serveur renvoie contient des balises d'éléments XML. Ces balises doivent être mappées de nouveau aux noms de paramètres appropriés par la correspondance 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. Lorsque Resync_Fails_On_FNF est défini sur Non, le périphérique considère la 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 informe le périphérique qu’il doit s’activer pour recevoir une nouvelle charge et d’où obtenir la charge, le cas échéant. Si la charge est déjà sur le périphérique, il ne tente pas d'obtenir la charge. Ainsi, la validité de l'emplacement de charge importe peu lorsque la charge souhaitée se trouve dans la partition inactive.
L'Upgrade_Rule indique une version de micrologiciel qui, si elle est différente de la charge actuelle, est téléchargée et appliquée à moins qu'elle ne soit limitée par une expression conditionnelle ou que Upgrade_Enable soit défini 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'attribution 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 de Profile_Rule*, le paramètre Upgrade_Rule évalue chaque alternative jusqu'à ce qu'une expression conditionnelle soit satisfaite ou qu'une alternative ne comporte aucune expression conditionnelle. L' expression d'affectation d'accompagnement est évaluée, le cas échéant. Puis, une tentative de mise à niveau vers l'URL spécifiée est effectuée.
Si Upgrade_Rule contient une URL sans expression conditionnelle, le périphérique est mis à niveau vers 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 n'effectue pas une nouvelle tentative de mise à niveau jusqu'à ce que la règle soit modifiée ou que la combinaison schéma + serveur + port + 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 le redémarre à la fin de la procédure. Le périphérique ne démarre automatiquement une mise à niveau qui est définie par le contenu de Upgrade_Rule que si toutes les lignes téléphoniques sont actuellement inactives.
Par exemple,
https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads
Dans cet exemple, Upgrade_Rule met à niveau le micrologiciel vers l'image qui est stockée à l'adresse 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 du paramètre général, GPP_F.
Paramètres de déploiement
Les paramètres de configuration sont disponibles sous l'onglet Déploiement de la page web du téléphone.
Paramètres de profil de configuration
Le tableau ci-dessous indique la fonction et l'utilisation de chaque paramètre dans la section Paramètres de 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. Définir la valeur à Oui pour activer la mise à disposition à distance. La valeur par défaut est Oui. |
Resync lors de la réinitialisation |
Déclenche une resynchronisation après que chaque redémarrage à l'exception des redémarrages dus à des mises à niveau du micrologiciel et les mises à jour du paramètre. La valeur par défaut est Oui. |
Resync Random Delay |
Délai aléatoire après la séquence de démarrage précédant la réinitialisation, indiqué en secondes. Dans un pool de périphériques de téléphonie IP planifiés pour un démarrage simultané, cette option permet d’espacer les heures auxquelles chaque unité envoie une requête de resynchronisation au serveur de mise à disposition. Cette fonctionnalité peut être utile dans les déploiements résidentiels 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 65 535. La valeur par défaut est de 2. |
Resync At (HHmm) |
L'heure (HHmn) à laquelle le périphérique se resynchronise avec le serveur de configuration. La valeur de ce champ doit être un nombre à quatre chiffres allant de 0000 à 2400 pour indiquer l'heure au format HHmn. Par exemple, 0959 indique 09:59. Aucune valeur par défaut n'est définie. Si la valeur n'est pas valide, le paramètre est ignoré. Si ce paramètre est défini à une valeur valide, le paramètre Resync Periodic est ignoré. |
Resync At Random Delay |
Empêche une surcharge du serveur de mise à disposition lorsqu'un grand nombre de périphériques sont mis en marche simultanément. Pour éviter de submerger le serveur de requêtes de resynchronisation à partir de plusieurs téléphones, le téléphone se resynchronise dans la plage comprise entre l'heure et les minutes et l'heure 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)/60minutes, la valeur d'entrée en secondes est convertie en minutes, arrondie à la minute supérieure pour calculer l'intervalle final random_delay. La valeur valide est comprise entre 0 et 65 535. Si la valeur est inférieure à 600, le délai aléatoire interne se situe entre 0 et 600. La valeur par défaut est 600 secondes (10 minutes). |
Resync Periodic |
L'intervalle de temps entre des resynchronisations périodiques avec le serveur de configuration. Le minuteur de resynchronisation associé est actif uniquement 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 3600 secondes. |
Resync Error Retry Delay |
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 d’effectuer à nouveau une resynchronisation après une tentative de resynchronisation infructueuse. |
Forced Resync Delay |
Délai maximum (en secondes) pendant lequel le téléphone attend avant d'effectuer une resynchronisation. Le périphérique n'effectue pas de resynchronisation lorsqu'une de ses lignes téléphoniques est active. Une resynchronisation pouvant prendre quelques secondes, il convient d'attendre que le périphérique soit resté inactif pendant une longue période avant de le resynchroniser. Cela permet de passer une succession d'appels sans interruption. L'appareil dispose d'un minuteur qui démarre le compte à rebours lorsque toutes les lignes sont inactives. Ce paramètre est la valeur initiale du compteur. Les événements de resynchronisation sont retardés jusqu'à ce que le compteur soit décrémenté jusqu'à zéro. La valeur valide est comprise entre 0 et 65 535. La valeur par défaut est de 14 400 secondes. |
Resync From SIP |
Permet à une resynchronisation d'être déclenchée via un message SIP NOTIFY. La valeur par défaut est Oui. |
Resync After Upgrade Attempt |
Active ou désactive l'opération de resynchronisation après qu'une mise à niveau se produit. Si Oui est sélectionné, la synchronisation est déclenchée. La valeur par défaut est Oui. |
Resync Trigger 1, Resync Trigger 2 |
Conditions de déclenchement de resynchronisation pouvant être configurées. Une resynchronisation est déclenchée lorsque l’équation logique de ces paramètres est égale à TRUE. La valeur par défaut est (vide). |
Resync Fails On FNF |
Une resynchronisation est considérée comme ayant échoué si un profil requis n’est pas reçu du serveur. Ceci peut être annulé par ce paramètre. Lorsque cette option est définie sur non, le périphérique considère la réponse La valeur par défaut est Oui. |
Profile Rule Profile Rule B Profile Rule C Profile Rule D |
Chaque règle de profil informe le téléphone de l'existence d'une source à partir de laquelle obtenir un profil (fichier de configuration). Au cours de chaque opération de resynchronisation, le téléphone applique tous les profils de séquence. Par défaut : Si vous appliquez le chiffrement AES-256-cipher pour les fichiers de configuration, spécifiez la clé de chiffrement avec le mot-clé
Vous pouvez placer la clé de chiffrement entre guillemets doubles (") de manière optionnelle. |
DHCP Option To Use |
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 de 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 |
Log Success Msg |
Message syslog qui est émis à la fin d'une tentative réussie de resynchronisation. 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 |
User Configurable Resync |
Permet à l’utilisateur 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 ci-dessous indique 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 |
---|---|
Upgrade Enable |
Permet 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 à l'aide d'une des méthodes suivantes :
|
Upgrade Error Retry Delay |
L'intervalle pour réessayer la mise à niveau (en secondes) s'applique lorsque la mise à niveau échoue. 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 cette mise à niveau. Le temporisateur est initialisé avec la valeur configurée dans ce paramètre. La prochaine tentative de mise à niveau du micrologiciel sera effectuée lorsque le décompte de ce temporisateur arrivera à zéro. La valeur par défaut est de 3600 secondes. Configurez ce paramètre à l'aide d'une des méthodes suivantes :
|
Upgrade Rule |
Un script de mise à niveau du micrologiciel définit les conditions de la mise à niveau et les adresses URL associées du micrologiciel. Il utilise la même syntaxe que le paramètre Profile Rule. Utilisez le format qui suit pour saisir la règle de mise à niveau :
Par exemple :
Lorsqu'aucun protocole n'est spécifié, le protocole par défaut est TFTP. 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 à l'aide d'une des méthodes suivantes :
|
Log Upgrade Request Msg |
Le message syslog émis au début d'une tentative de mise à niveau du micrologiciel. Valeur par défaut : Configurez ce paramètre à l'aide d'une des méthodes suivantes :
|
Log Upgrade Success Msg |
Le message syslog émis après une tentative réussie de mise à niveau du micrologiciel. La valeur par défaut est Configurez ce paramètre à l'aide d'une des méthodes suivantes :
|
Log Upgrade Failure Msg |
Le message syslog émis après l'échec d'une tentative de mise à niveau du micrologiciel. La valeur par défaut est Configurez ce paramètre à l'aide d'une des méthodes suivantes :
|
Partage de micrologiciel par les homologues |
Active ou désactive la fonctionnalité Partage d'image. Sélectionnez Oui ou Non pour activer ou désactiver la fonction. Par défaut : Oui Configurez ce paramètre à l'aide d'une des méthodes suivantes :
|
Serveur de journaux de partage de micrologiciel entre homologues |
Indique l'adresse IP et le port auxquels 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 à l'aide d'une des méthodes suivantes :
|
Paramètres généraux
Le tableau ci-dessous indique 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 à usage global GPP _* sont utilisés dans une chaîne libre enregistrée lors de la configuration des téléphones pour interagir avec un serveur de mise à disposition donné. Ils peuvent être configurés pour obtenir 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 :
-
Profile_Rule
-
Profile_Rule_*
-
Resync_Trigger_*
-
Upgrade_Rule
-
Log_*
-
GPP_* (dans des conditions spécifiques)
Au sein de ces paramètres, les types de syntaxe, par exemple $NAME ou $(NAME), sont reconnus et font l'objet d'expansion.
Des 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 supérieure). Le développement de macro qui en résulte est la sous-chaîne commençant au décalage de caractère p, de 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) prend la valeur étendue CDEF, et $(A:2:3) prend la valeur étendue CDE.
Un nom non reconnu n'est pas traduit, et la forme $NAME ou $(NAME) demeure inchangée dans la valeur du paramètre après expansion.
Nom paramètre |
Description et valeur par défaut |
---|---|
$ |
La forme $$ se modifie pour devenir un seul caractère $. |
A à P |
Remplacé par le contenu des paramètres généraux GPP_A jusqu'à 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 lors de la mise à disposition. Les paramètres $SA à $SD sont reconnus comme des arguments pour l'identificateur d'URL de resynchronisation facultatif --key. |
MA |
L'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 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, DP-9851, DP-9871. |
PSN | Numéro de série du produit. Par exemple, V03. |
NS |
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 au sein de son sous-réseau local. Par exemple 192.168.1.100. |
EXTIP |
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.3-1-1-0104-37 |
HWVER |
Chaîne de version du matériel. Par exemple, 2.0.1 |
PRVST |
État de mise à disposition (une chaîne numérique) : -1 = requête de resynchronisation explicite 0 = resynchronisation de démarrage 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 ligne 1 a perdu l'enregistrement sur le serveur SIP. |
REGTMR2 |
Secondes depuis que ligne 2 a perdu l'enregistrement sur le serveur SIP. |
UPGCOND |
Nom de la macro existante. |
SCHEME |
Schéma d'accès au fichier, un parmi TFTP, HTTP ou HTTPS, comme obtenu après l'analyse de l'URL de mise à niveau ou de resynchronisation. |
SERV |
Demander le nom d'hôte du serveur cible, extrait après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
SERVIP |
Demander l'adresse IP du serveur cible, extrait après l'analyse de l'URL de resynchronisation ou de mise à niveau, éventuellement suite à la recherche DNS. |
PORT |
Demander le port UDP/TCP cible, extrait après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
PATH |
Demander le chemin du fichier cible, extrait après l'analyse de l'URL de resynchronisation ou de mise à niveau. |
ERR |
Message de résultats de la tentative de resynchronisation ou de mise à niveau. Utile uniquement pour générer les messages syslog de résultat. La valeur est conservée dans la variable UPGERR dans le cas des tentatives de mise à niveau. |
UIDn |
Le contenu du paramètre de configuration de l'ID utilisateur de la ligne n. |
EMS |
État Extension Mobility |
MUID |
ID utilisateur Extension Mobility |
MPWD |
Mot de passe Extension Mobility |
Codes d'erreur interne
Le téléphone définit un certain nombre de codes d’erreur interne (X00 - X99) pour faciliter la configuration en fournissant un meilleur contrôle du comportement de l’unité sous 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 lors de l'attente d'une réponse. |
X40 |
Erreur générale du protocole SIP (par exemple, codec inacceptable dans SDP en 200 et messages ACK ou expiration en attendant ACK). |
X60 |
Numéro composé non valide conformément aux instructions du plan de numérotation fourni. |