Paramètres de mise à disposition

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.

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 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 :

  • Un nombre entier

    Exemple : une entrée de 3000 indique que la resynchronisation suivante se produit dans 3000 secondes.

  • Plusieurs entiers

    Exemple : une entrée de 600,1200,300 indique que la première resynchronisation survient dans 600 secondes, la deuxième resynchronisation se produit dans 1200 secondes après la première, et la troisième resynchronisation dans 300 secondes après la deuxième.

  • Un intervalle de temps

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

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 :

  • Un nombre entier

    Exemple : une entrée de 300 indique que la prochaine tentative de resynchronisation se produit dans 300 secondes.

  • Plusieurs entiers

    Exemple : une entrée de 600,1200,300 indique que la première tentative survient de 600 secondes après l’échec, la deuxième tentative se produit 1200 secondes après l’échec de la première tentative, et la troisième tentative 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 nouvelle tentative suivante se produit entre 2400 et 2430 secondes après un échec de resynchronisation.

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 file-not-found du serveur comme une resynchronisation réussie.

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.

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 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 :

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

Par exemple :

tftp://192.168.1.5/firmware/sip88xx.11-0-0MPP-321.loads
tftp://192.168.1.5/firmware/sip78xx.11-0-1MPP-321.loads
tftp://192.168.1.5/firmware/sip68xx.11-0-1MPP-321.loads

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.

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.

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 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 :
  • Des clés de chiffrement.

  • Des URL.

  • Des informations sur l’état d’une mise à disposition en plusieurs étapes.

  • Des modèles d’envoi de requête.

  • Des mappages d’alias de nom de paramètre.

  • Des valeurs de chaîne partielles, pouvant être combinées en des valeurs de paramètre complètes.

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.

Remarque

 

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-8841-3PCC.

Nom du produit. Par exemple, CP-7832-3PCC.

Nom du produit. Par exemple, CP-6841-3PCC.

PSN

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

Numéro de série du produit. Par exemple, 6841-3PCC.

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,

  • Pour le micrologiciel version 11.3 (1) SR1 et antérieures: :sip68xx.11-0-1MPP-312

  • Pour la version 11.3 (2) et ultérieures du micrologiciel : sip68xx.11-3-2MPP 0001-609

  • Pour le micrologiciel version 11.3 (1) SR1 et antérieures : sip78xx.11-0-1MPP-312

  • Pour la version 11.3 (2) et ultérieures du micrologiciel : sip78xx.11-3-2MPP 0001-609

  • Pour le micrologiciel version 11.3 (1) SR1 et antérieures : sip88xx.11-0-1MPP-312

  • Pour la version 11.3 (2) et ultérieures du micrologiciel : sip88xx.11-3-2MPP 0001-609

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

ORIGTYPE

AUTHSTATUS

Contrôle si le téléphone doit demander une licence.

Les valeurs pour
ORIGTYPE
sont : orig_ent, orig_mpp, aucun
Les valeurs pour
AUTHSTATUS
sont : classic, wxc, aucun
Ajoutez les variables dans :
  • règle de profil ou règle de mise à niveau – expansion des macros et expression conditionnelle

  • règle d’autorisation transitoire – expansion de macro

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 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.