Vue d'ensemble des paramètres de mise à disposition
Ce chapitre décrit les paramètres de mise à disposition qui peuvent être utilisés dans les scripts de profil de configuration.
Dans le cadre de la documentation associée à ce produit, nous nous efforçons d’utiliser un langage exempt de préjugés. Dans cet ensemble de documents, le langage exempt de discrimination renvoie à une langue qui exclut la discrimination en fonction de l’âge, des handicaps, du genre, de l’appartenance raciale de l’identité ethnique, de l’orientation sexuelle, de la situation socio-économique et de l’intersectionnalité. Des exceptions peuvent s’appliquer dans les documents si le langage est codé en dur dans les interfaces utilisateurs du produit logiciel, si le langage utilisé est basé sur la documentation RFP ou si le langage utilisé provient d’un produit tiers référencé. Découvrez comment Cisco utilise le langage inclusif.
Cisco peut fournir des traductions du présent contenu dans la langue locale pour certains endroits. Veuillez noter que des traductions sont fournies à titre informatif seulement et, en cas d’incohérence, la version anglaise du présent contenu prévaudra.
Ce chapitre décrit les paramètres de mise à disposition qui peuvent être utilisés dans les scripts 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 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 : /$PSN.xml Si vous appliquez le chiffrement AES-256-cipher pour les fichiers de configuration, spécifiez la clé de chiffrement avec le mot-clé -clé en procédant comme suit : [--key <encryption key>] 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 $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH. |
Log Success Msg |
Message syslog qui est émis à la fin d'une tentative réussie de resynchronisation. La valeur par défaut est $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR. |
Log Failure Msg |
Message syslog émis après une tentative de resynchronisation infructueuse. La valeur par défaut est $PN $MAC -- Resync failed: $ERR. |
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. |
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 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. |
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. |
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 sollicitant l'URL est utilisé en tant que nom de serveur. Lorsqu'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. |
Log Upgrade Request Msg |
Le message syslog émis au début d'une tentative de mise à niveau du micrologiciel. Valeur par défaut : $PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATH |
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 $PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR |
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 $PN $MAC -- Upgrade failed: $ERR |
Partage de micrologiciel par les homologues |
Active ou désactive la fonction Partage du micrologiciel avec les homologues. Sélectionnez Oui ou Non pour activer ou désactiver la fonction. Par défaut : Oui |
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. |
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 paramètre |
Description et valeur par défaut |
---|---|
GPP A - GPP P |
La valeur par défaut est vide. |
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.
|
||
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 |
|||
PSN |
|||
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,
|
||
HWVER |
|||
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. |
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 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. |