- Inicio
- /
- Artículo
Gracias por sus comentarios.
Parámetros de aprovisionamiento para teléfonos de la serie 9800 y 8875 (BroadWorks)
En este artículo
¿Comentarios?Este artículo de ayuda es para Cisco Desk Phone serie 9800 y Cisco Video Phone 8875 registrados en Cisco BroadWorks. La información de esta página incluye los parámetros de aprovisionamiento y su sintaxis.
Tipos de parámetros de aprovisionamiento
Esta sección describe los parámetros de aprovisionamiento organizados de manera amplia según la función.
Parámetros de propósito general
Los parámetros de uso general GPP_* (Inicio de ) se utilizan como registros de cadenas libres al configurar el teléfono para que interactúe con una solución de servidor de aprovisionamiento en particular. Los parámetros GPP_* están vacíos de forma predeterminada. Se pueden configurar para que contengan diversos valores, incluidos los siguientes:
-
Claves de cifrado
-
URLs
-
Información sobre el estado del aprovisionamiento multietapa.
-
Plantillas de postsolicitud
-
Nombre del parámetro alias maps
-
Valores de cadena parciales, eventualmente combinados en valores de parámetros completos.
Los parámetros GPP_* están disponibles para la expansión de macros dentro de otros parámetros de aprovisionamiento. Para este propósito, los nombres de macro mayúsculas de una sola letra (A a P) son suficientes para identificar el contenido de GPP_A a GPP_P. Además, los nombres de macro mayúsculas de dos letras SA a SD identifican GPP_SA a GPP_SD como un caso especial cuando se utilizan como argumentos de las siguientes opciones de URL:
llave, uid y pwd
Estos parámetros se pueden utilizar como variables en las reglas de aprovisionamiento y actualización. Se hace referencia a ellos prefijando el nombre de la variable con un carácter '$', como $GPP_A.
Habilitar parámetros
Los parámetros Provision_Enable y Upgrade_Enable controlan todas las operaciones de resincronización de perfiles y actualización de firmware. Estos parámetros controlan las resincronización y las actualizaciones independientemente entre sí. Estos parámetros también controlan los comandos de resincronización y actualización de URL que se emiten a través del servidor web de administración. Ambos parámetros están configurados en Sí de forma predeterminada.
El parámetro Resync_from_SIP controla las solicitudes de operaciones de resincronización. Se envía un evento SIP NOTIFY desde el servidor proxy del proveedor de servicios al teléfono. Si está habilitado, el proxy puede solicitar una resincronización. Para ello, el proxy envía un mensaje SIP NOTIFY que contiene el encabezado Event: resync al dispositivo.
El dispositivo desafía la solicitud con una respuesta 401 (autorización rechazada para credenciales usadas). El dispositivo espera una solicitud posterior autenticada antes de cumplir con la solicitud de resincronización del proxy. Los encabezados Evento: reboot_now y Evento: restart_now realizan reinicios fríos y calientes, respectivamente, que también son desafiados.
Las dos habilitantes restantes son Resync_On_Reset y Resync_After_Upgrade_Intent. Estos parámetros determinan si el dispositivo realiza una operación de resincronización después de reiniciar el software de encendido y después de cada intento de actualización.
Cuando Resync_On_Reset está habilitado, el dispositivo introduce un retardo aleatorio que sigue a la secuencia de arranque antes de que se realice el restablecimiento. El retraso es un tiempo aleatorio hasta el valor que especifica Resync_Random_Delay (en segundos). En un grupo de teléfonos que se encienden simultáneamente, este retraso extiende los tiempos de inicio de las solicitudes de resincronización de cada unidad. Esta función puede ser útil en una gran implementación residencial, en el caso de una falla de energía regional.
Desencadenadores
El teléfono le permite resincronizar a intervalos específicos o en un momento específico.
Resincronizar a intervalos específicos
El teléfono está diseñado para resincronizar con el servidor de aprovisionamiento periódicamente. El intervalo de resincronización se configura en Resync_Periodic (segundos). Si este valor se deja vacío, el dispositivo no se resincroniza periódicamente.
La resincronización generalmente se realiza cuando las líneas de voz están inactivas. Si una línea de voz está activa cuando debe realizarse una resincronización, el teléfono retrasa el procedimiento de resincronización hasta que la línea vuelva a estar inactiva. Una resincronización puede hacer que los valores de los parámetros de configuración cambien.
Una operación de resincronización puede fallar porque el teléfono no puede recuperar un perfil del servidor, el archivo descargado está dañado o se ha producido un error interno. El dispositivo intenta volver a sincronizar después de un tiempo especificado en Resync_Error_Retry_Delay (segundos). Si Resync_Error_Retry_Delay se establece en 0, el dispositivo no intenta volver a sincronizar después de un intento fallido de resincronización.
Si falla una actualización, se realiza un reintento después de los segundos Upgrade_Error_Retry_Delay.
Hay dos parámetros configurables disponibles para activar condicionalmente una resincronización: Resync_Trigger_1 y Resync_Trigger_2. Cada parámetro se puede programar con una expresión condicional que se somete a una macro expansión. Cuando expira el intervalo de resincronización (tiempo para la siguiente resincronización), los activadores, si se configuran, evitarán la resincronización a menos que uno o más activadores se evalúen como verdaderos.
La siguiente condición de ejemplo desencadena una resincronización. En el ejemplo, el último intento de actualización del teléfono ha transcurrido más de 5 minutos (300 segundos) y han transcurrido al menos 10 minutos (600 segundos) desde el último intento de resincronización.
$UPGTMR gt 300 and $PRVTMR ge 600Resincronizar en un momento específico
El parámetro Resync_At permite que el teléfono se resincronce en un momento específico. Este parámetro utiliza el formato de 24 horas (hhmm) para especificar la hora.
El parámetro Resync_At_Random_Delay permite que el teléfono se resincronce con un retraso no especificado en el tiempo. Este parámetro utiliza un formato entero positivo para especificar la hora.
Debe evitarse inundar el servidor con solicitudes de resincronización de varios teléfonos configurados para resincronizar al mismo tiempo. Para hacerlo, el teléfono activa la resincronización hasta 10 minutos después de la hora especificada.
Por ejemplo, si establece la hora de resincronización en 1000 (10 a.m.), el teléfono activa la resincronización en cualquier momento entre las 10:00 a.m. y las 10:10 a.m.
De forma predeterminada, esta función está deshabilitada. Si se aprovisiona el parámetro Resync_At, se ignora el parámetro Resync_Periodic.
Horarios configurables
Puede configurar programaciones para resincronización periódica y especificar los intervalos de reintento para los errores de resincronización y actualización mediante estos parámetros de aprovisionamiento:
-
Resincronización periódica
-
Retraso de reincronización de error_retratación_retraso
-
Retraso de error de retracción_de actualización
Cada parámetro acepta un único valor de retardo (segundos). La nueva sintaxis extendida permite una lista separada por comas de elementos de retardo consecutivos. El último elemento de la secuencia se repite implícitamente para siempre.
Opcionalmente, puede usar un signo más para especificar otro valor numérico que agregue un retraso adicional aleatorio.
Ejemplo 1
En este ejemplo, el teléfono se resincroniza periódicamente cada 2 horas. Si se produce un fallo de resincronización, el dispositivo se vuelve a intentar en los siguientes intervalos: 30 minutos, 1 hora, 2 horas, 4 horas. El dispositivo continúa probándose a intervalos de 4 horas hasta que se resincronice correctamente.
Resync_Periodic=7200
Resync_Error_Retry_Delay=1800,3600,7200,14400
Ejemplo 2
En este ejemplo, el dispositivo se resincroniza periódicamente cada hora (además de un retraso aleatorio adicional de hasta 10 minutos). En el caso de un fallo de resincronización, el dispositivo se reintenta a estos intervalos: 30 minutos (más hasta 5 minutos). 1 hora (más hasta 10 minutos), 2 horas (más hasta 15 minutos). El dispositivo continúa probándose a intervalos de 2 horas (más hasta 15 minutos) hasta que se resincroniza correctamente.
Resync_Periodic=3600+600
Resync_Error_Retry_Delay=1800+300,3600+600,7200+900
Ejemplo 3
En este ejemplo, si falla un intento de actualización remota, el dispositivo vuelve a intentar la actualización en 30 minutos, luego nuevamente después de una hora más y luego en dos horas. Si la actualización sigue fallando, el dispositivo se vuelve a intentar cada cuatro a cinco horas hasta que la actualización se realice correctamente.
Upgrade_Error_Retry_Delay = 1800,3600,7200,14400+3600
Reglas de perfil
El teléfono proporciona varios parámetros de perfil de configuración remota (Profile_Rule*). Por lo tanto, cada operación de resincronización puede recuperar varios archivos que administran diferentes servidores.
En el escenario más simple, el dispositivo se resincroniza periódicamente con un solo perfil en un servidor central, lo que actualiza todos los parámetros internos pertinentes. Alternativamente, el perfil se puede dividir entre diferentes archivos. Un archivo es común para todos los teléfonos en una implementación. Se proporciona un archivo separado y único para cada cuenta. Las claves de cifrado y la información del certificado pueden ser suministradas por otro perfil, almacenado en un servidor separado.
Siempre que se deba realizar una operación de resincronización, el teléfono evalúa los cuatro parámetros Profile_Rule* en secuencia:
-
Regla de perfil
-
Perfil_Rule_B
-
Profil_Rule_C
-
Perfil_Rule_D
Cada evaluación puede resultar en una recuperación de perfil de un servidor de aprovisionamiento remoto, con una posible actualización de algunos parámetros internos. Si falla una evaluación, la secuencia de resincronización se interrumpe y se vuelve a intentar desde el principio especificado por el parámetro Resync_Error_Retry_Delay (segundos). Si todas las evaluaciones tienen éxito, el dispositivo espera la segunda especificada por el parámetro Resync_Periodic y luego realiza otra resincronización.
El contenido de cada parámetro Profile_Rule* consiste en un conjunto de alternativas. Las alternativas están separadas por el carácter | (pipe). Cada alternativa consiste en una expresión condicional, una expresión de asignación, una URL de perfil y cualquier opción de URL asociada. Todos estos componentes son opcionales dentro de cada alternativa. Las siguientes son las combinaciones válidas y el orden en que deben aparecer, si están presentes:
[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]
Dentro de cada parámetro Profile_Rule*, todas las alternativas excepto la última deben proporcionar una expresión condicional. Esta expresión se evalúa y se procesa de la siguiente manera:
-
Las condiciones se evalúan de izquierda a derecha, hasta que se encuentra una que se evalúa como verdadera (o hasta que se encuentre una alternativa sin expresión condicional).
-
Cualquier expresión de asignación adjunta se evalúa, si está presente.
-
Si se especifica una URL como parte de esa alternativa, se intenta descargar el perfil que se encuentra en la dirección URL especificada. El sistema intenta actualizar los parámetros internos en consecuencia.
Si todas las alternativas tienen expresiones condicionales y ninguna se evalúa como verdadera (o si toda la regla del perfil está vacía), se omite todo el parámetro Profile_Rule*. Se evalúa el siguiente parámetro de regla de perfil en la secuencia.
Ejemplo 1
Este ejemplo se resincroniza incondicionalmente con el perfil en la dirección URL especificada y realiza una solicitud HTTP GET al servidor de aprovisionamiento remoto:
http://remote.server.com/cisco/$MA.cfg
Ejemplo 2
En este ejemplo, el dispositivo se resincroniza con dos direcciones URL diferentes, dependiendo del estado de registro de la línea 1. En caso de pérdida de registro, el dispositivo realiza un HTTP POST a un script CGI. El dispositivo envía el contenido de la macro GPP_A expandida, que puede proporcionar información adicional sobre el estado del dispositivo:
($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg
| [--post a] http://p.tel.com/lost-reg?
Ejemplo 3
En este ejemplo, el dispositivo se resincronización con el mismo servidor. El dispositivo proporciona información adicional si no hay un certificado instalado en la unidad (para las unidades anteriores a 2.0 anteriores a 2.0):
(“$CCERT” eq “Installed”)? https://p.tel.com/config?
| https://p.tel.com/config?cisco$MAU
Ejemplo 4
En este ejemplo, la línea 1 se deshabilita hasta que GPP_A se establezca igual a Aprovisionado a través de la primera dirección URL. Después, se resincronizó con la segunda URL:
(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov
| https://p.tel.com/configs
Ejemplo 5
En este ejemplo, se supone que el perfil que devuelve el servidor contiene etiquetas de elementos XML. Estas etiquetas deben ser reasignadas a los nombres de parámetros adecuados mediante el mapa de alias almacenado en GPP_B:
[--alias b] https://p.tel.com/account/$PN$MA.xml
Una resincronización generalmente se considera infructuosa si no se recibe un perfil solicitado del servidor. El parámetro Resync_Fails_on_FNF puede anular este comportamiento predeterminado. Si Resync_Fails_on_FNF se establece en No, el dispositivo acepta una respuesta de archivo no encontrado del servidor como resincronización correcta. El valor predeterminado para Resync_Fails_on_FNF es Sí.
Regla de actualización
La regla de actualización es indicar al dispositivo que se active a una nueva carga y de dónde obtener la carga, si es necesario. Si la carga ya está en el dispositivo, no intentará obtener la carga. Entonces, la validez de la ubicación de carga no importa cuando la carga deseada está en la partición inactiva.
La Upgrade_Rule especifica una carga de firmware que, si es diferente de la carga actual, se descargará y aplicará a menos que esté limitada por una expresión condicional o Upgrade_Enable se establezca en No.
El teléfono proporciona un parámetro configurable de actualización remota, Upgrade_Rule. Este parámetro acepta una sintaxis similar a los parámetros de la regla de perfil. Las opciones de URL no son compatibles con las actualizaciones, pero se pueden usar expresiones condicionales y expresiones de asignación. Si se utilizan expresiones condicionales, el parámetro se puede poblar con varias alternativas, separadas por el carácter |. La sintaxis para cada alternativa es la siguiente:
[ conditional-expr ] [ assignment-expr ] URL
Como en el caso de los parámetros Profile_Rule*, el parámetro Upgrade_Rule evalúa cada alternativa hasta que se satisface una expresión condicional o una alternativa no tiene expresión condicional. La expresión de asignación adjunta se evalúa, si se especifica. Luego, se intenta actualizar a la URL especificada.
Si la Regla de actualización contiene una dirección URL sin una expresión condicional, el dispositivo se actualiza a la imagen de firmware que especifica la dirección URL. Después de la expansión de la macro y la evaluación de la regla, el dispositivo no vuelve a intentar actualizar hasta que se modifica la regla o se cambia la combinación efectiva de esquema + servidor+puerto+ filepath.
Para intentar una actualización de firmware, el dispositivo deshabilita el audio al comienzo del procedimiento y se reinicia al final del procedimiento. El dispositivo inicia automáticamente una actualización impulsada por el contenido de Upgrade_Rule solo si todas las líneas de voz están actualmente inactivas.
Por ejemplo,
https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loadsEn este ejemplo, Upgrade_Rule actualiza el firmware a la imagen que se almacena en la dirección URL indicada.
Aquí hay otro ejemplo:
(“$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
Este ejemplo indica que la unidad cargue una de dos imágenes, según el contenido de un parámetro de propósito general, GPP_F.
Parámetros de aprovisionamiento
Puede encontrar los parámetros de aprovisionamiento en la ficha Aprovisionamiento en la página web del teléfono.
Parámetros del perfil de configuración
La siguiente tabla define la función y el uso de cada parámetro en la sección Parámetros del perfil de configuración en la ficha Aprovisionamiento.
|
Nombre del parámetro |
Descripción y valor predeterminado |
|---|---|
|
Activación de provisiones |
Controla todas las acciones de resincronización independientemente de las acciones de actualización del firmware. Establezca en Sí para habilitar el aprovisionamiento remoto. El valor predeterminado es Sí. |
|
Resincronización al reiniciar |
Activa una resincronización después de cada reinicio, excepto los reinicios causados por actualizaciones de parámetros y actualizaciones de firmware. El valor predeterminado es Sí. |
|
Retraso aleatorio de resincronización |
Un retraso aleatorio después de la secuencia de arranque antes de realizar el reinicio, especificado en segundos. En un grupo de dispositivos de telefonía IP que están programados para encenderse simultáneamente, esto introduce un diferencial en los tiempos en los que cada unidad envía una solicitud de resincronización al servidor de aprovisionamiento. Esta función puede ser útil en una gran implementación residencial, en el caso de una falla de energía regional. El valor de este campo debe ser un número entero que oscile entre 0 y 65535. El valor predeterminado es 2. |
|
Resincronización en (HHmm) |
La hora (HHmm) en que el dispositivo se resincroniza con el servidor de aprovisionamiento. El valor de este campo debe ser un número de cuatro dígitos que va de 0000 a 2400 para indicar la hora en formato HHmm. Por ejemplo, 0959 indica 09:59. El valor predeterminado está vacío. Si el valor no es válido, se ignora el parámetro. Si este parámetro se establece con un valor válido, se ignora el parámetro Resync Periodic. |
|
Resincronización con retraso aleatorio |
Evita una sobrecarga del servidor de aprovisionamiento cuando una gran cantidad de dispositivos se enciende simultáneamente. Para evitar que se inunden las solicitudes de resincronización al servidor desde varios teléfonos, el teléfono se resincroniza en el rango entre horas y minutos, y las horas y minutos más el retraso aleatorio (hhmm, hhmm+random_delay). Por ejemplo, si el retardo aleatorio = (Resincronización en retardo aleatorio + 30) /60 minutos, el valor de entrada en segundos se convierte en minutos, redondeando al siguiente minuto para calcular el intervalo final de retardo aleatorio. El valor válido oscila entre 600 y 65535. Si el valor es menor que 600, el retardo aleatorio interno está entre 0 y 600. El valor predeterminado es 600 segundos (10 minutos). |
|
Resincronización periódica |
El intervalo de tiempo entre la resincronización periódica con el servidor de aprovisionamiento. El temporizador de resincronización asociado solo está activo después de la primera sincronización exitosa con el servidor. Los formatos válidos son los siguientes:
Establezca este parámetro en cero para deshabilitar la resincronización periódica. El valor predeterminado es 3600 segundos. |
|
Error de resincronización Retraso de reintento |
Si una operación de resincronización falla porque el dispositivo de telefonía IP no pudo recuperar un perfil del servidor, o el archivo descargado está dañado o se produce un error interno, el dispositivo intenta volver a sincronizar después de un tiempo especificado en segundos. Los formatos válidos son los siguientes:
Si el retraso se establece en 0, el dispositivo no intenta volver a sincronizar después de un intento fallido de resincronización. |
|
Retraso de resincronización forzada |
Retraso máximo (en segundos) que el teléfono espera antes de realizar una resincronización. El dispositivo no se resincroniza mientras una de sus líneas telefónicas está activa. Debido a que una resincronización puede tardar varios segundos, es conveniente esperar hasta que el dispositivo haya estado inactivo durante un período prolongado antes de resincronizar. Esto permite que un usuario realice llamadas en sucesión sin interrupción. El dispositivo tiene un temporizador que comienza la cuenta regresiva cuando todas sus líneas se vuelven inactivas. Este parámetro es el valor inicial del contador. Los eventos de resincronización se retrasan hasta que este contador decrece a cero. El valor válido oscila entre 0 y 65535. El valor predeterminado es 14.400 segundos. |
|
Resincronización desde SIP |
Permite que se active una resincronización mediante un mensaje de notificación SIP. El valor predeterminado es Sí. |
|
Resincronizar después del intento de actualización |
Habilita o deshabilita la operación de resincronización después de que se produzca cualquier actualización. Si se selecciona Sí, se activa la sincronización. El valor predeterminado es Sí. |
|
Desencadenador de resincronización 1, Activador de resincronización 2 |
Condiciones de activación de resincronización configurables. Una resincronización se activa cuando la ecuación lógica en estos parámetros se evalúa como VERDADERA. El valor predeterminado es (vacío). |
|
La resincronización falla en FNF |
Una resincronización se considera infructuosa si no se recibe un perfil solicitado del servidor. Esto puede ser anulado por este parámetro. Cuando se establece en no, el dispositivo acepta una respuesta de El valor predeterminado es Sí. |
|
Regla de perfil Perfil Regla B Perfil Regla C Perfil Regla D |
Cada regla de perfil informa al teléfono de una fuente de la que obtener un perfil (archivo de configuración). Durante cada operación de resincronización, el teléfono aplica todos los perfiles en secuencia. Predeterminado:
Puede incluir la clave de cifrado entre comillas dobles (“) opcionalmente. |
|
Opción DHCP a usar |
Opciones DHCP, delimitadas por comas, utilizadas para recuperar firmware y perfiles. El valor predeterminado es 66,160,159,150,60,43,125. |
|
Msg de solicitud de registro |
Este parámetro contiene el mensaje que se envía al servidor syslog al inicio de un intento de resincronización. El valor predeterminado es |
|
Registro de Mensajes de Éxito |
El mensaje de syslog que se emite al completar con éxito un intento de resincronización. El valor predeterminado es |
|
Error de registro de error |
El mensaje de syslog que se emite después de un intento fallido de resincronización. El valor predeterminado es |
|
Resincronización configurable por el usuario |
Permite que un usuario resincronice el teléfono desde la pantalla del teléfono IP. El valor predeterminado es Sí. |
Parámetros de actualización de firmware
La siguiente tabla define la función y el uso de cada parámetro en la sección Actualización de firmware de la ficha Aprovisionamiento.
|
Nombre del parámetro |
Descripción y valor predeterminado |
|---|---|
|
Activar actualización |
Habilita las operaciones de actualización del firmware independientemente de las acciones de resincronización. El valor predeterminado es Sí. Configure este parámetro con uno de los métodos siguientes:
|
|
Error de actualización Retardo de reintento |
El intervalo de reintento de actualización (en segundos) aplicado en caso de fallo de actualización. El dispositivo tiene un temporizador de error de actualización de firmware que se activa después de un intento fallido de actualización del firmware. El temporizador se inicializa con el valor de este parámetro. El siguiente intento de actualización del firmware se produce cuando este temporizador cuenta regresiva hasta cero. El valor predeterminado es 3600 segundos. Configure este parámetro con uno de los métodos siguientes:
|
|
Regla de actualización |
Un script de actualización de firmware que define las condiciones de actualización y las URL de firmware asociadas. Utiliza la misma sintaxis que Profile Rule. Utilice el siguiente formato para introducir la regla de actualización:
Por ejemplo: Si no se especifica ningún protocolo, se asume TFTP. Si no se especifica ningún nombre de servidor, el host que solicita la dirección URL se utiliza como nombre del servidor. Si no se especifica ningún puerto, se utiliza el puerto predeterminado (69 para TFTP, 80 para HTTP o 443 para HTTPS). El valor predeterminado está en blanco. Configure este parámetro con uno de los métodos siguientes:
|
|
Cargo de solicitud de actualización de registro |
Mensaje de Syslog emitido al comienzo de un intento de actualización de firmware. Predeterminado: Configure este parámetro con uno de los métodos siguientes:
|
|
Cargo de éxito de actualización de registro |
Mensaje de Syslog emitido después de que un intento de actualización de firmware se complete correctamente. El valor predeterminado es Configure este parámetro con uno de los métodos siguientes:
|
|
Error de actualización del registro |
Mensaje de Syslog emitido después de un intento fallido de actualización del firmware. El valor predeterminado es Configure este parámetro con uno de los métodos siguientes:
|
|
Uso compartido de firmware entre pares |
Habilita o deshabilita la función de uso compartido de firmware entre pares (PFS). Seleccione Sí o No para habilitar o deshabilitar la función. Predeterminado: Sí Configure este parámetro con uno de los métodos siguientes:
|
|
Servidor de registro de intercambio de firmware entre pares |
Indica la dirección IP y el puerto al que se envía el mensaje UDP. Por ejemplo: 10.98.76. 123:514 donde, 10.98.76.123 es la dirección IP y 514 es el número de puerto. Configure este parámetro con uno de los métodos siguientes:
|
Parámetros de propósito general
La siguiente tabla define la función y el uso de cada parámetro en la sección Parámetros de propósito general de la ficha Aprovisionamiento.
|
Nombre del parámetro |
Descripción y valor predeterminado |
|---|---|
|
GPP A - GPP P |
Los parámetros de propósito general GPP_* se utilizan como registros de cadenas libres al configurar los teléfonos para que interactúen con una solución de servidor de aprovisionamiento en particular. Se pueden configurar para que contengan diversos valores, incluidos los siguientes:
El valor predeterminado está en blanco. |
Variables de expansión macro
Ciertas variables macro se reconocen dentro de los siguientes parámetros de aprovisionamiento:
-
Regla de perfil
-
Profil_Regla_*
-
Desincronización_disparador_*
-
Regla de actualización
-
Registro_*
-
GPP_* (bajo condiciones específicas)
Dentro de estos parámetros, los tipos de sintaxis, como $NAME o $ (NAME), son reconocidos y expandidos.
Las subcadenas de variables macro se pueden especificar con la notación $ (Nombre:P) y $ (Nombre:P: Q), donde p y q son enteros no negativos (disponibles en la revisión 2.0.11 y superior). La expansión de macro resultante es la subcadena que comienza en el desplazamiento de caracteres p, con longitud q (o bien hasta el final de la cadena si no se especifica q). Por ejemplo, si GPP_A contiene ABCDEF, entonces $ (A:2) se expande a CDEF y $ (A: 2:3) se expande a CDE.
Un nombre no reconocido no se traduce y el formulario $NAME o $ (NAME) permanece sin cambios en el valor del parámetro después de la expansión.
|
Nombre del parámetro |
Descripción y valor predeterminado |
|---|---|
|
$ |
El formulario $$ se expande a un solo carácter $. |
|
A a P |
Reemplazado por el contenido de los parámetros de propósito general GPP_A a GPP_P. |
|
SA a SD |
Reemplazado por parámetros de propósito especial GPP_SA a GPP_SD. Estos parámetros contienen claves o contraseñas utilizadas en el aprovisionamiento. $SA a $SD se reconocen como argumentos para el calificador de URL de resincronización opcional, --key. |
|
MA |
Dirección MAC usando dígitos hexademinúsculas, por ejemplo, 000e08aabbcc. |
|
MAU |
Dirección MAC con dígitos hexadecimales mayúsculas, por ejemplo 000E08AABBCC. |
|
MAC |
Dirección MAC usando dígitos hexadecimales minúsculas y puntos para separar pares de dígitos hexadecimales. Por ejemplo 00:0 e:08:aa:bb:cc. |
|
PN |
Nombre del producto. Por ejemplo, CP-8875, DP-9851, DP-9871. |
|
PSN | Número de serie del producto. Por ejemplo, V03. |
|
SN |
Serie de números de serie. por ejemplo 88012BA01234. |
|
CCERT |
Estado del certificado de cliente SSL: Instalado o no instalado. |
|
IP |
Dirección IP del teléfono dentro de su subred local. Por ejemplo 192.168.1.100. |
|
EXTIP |
IP externa del teléfono, como se ve en Internet. Por ejemplo 66.43.16.52. |
|
SWVER |
Cadena de versión de software. Por ejemplo, PHONEOS.3-1-1-0104-37 |
|
HWVER |
Cadena de versión de hardware. Por ejemplo, 2.0.1 |
|
PRVST |
Estado de aprovisionamiento (una cadena numérica): -1 = solicitud explícita de resincronización 0 = resincronización de encendido 1 = resincronización periódica 2 = error de resincronización, intento de reintento |
|
UPGST |
Estado de actualización (una cadena numérica): 1 = primer intento de actualización 2 = error de actualización, intento de reintento |
|
UPGERR |
Mensaje de resultado (ERR) del intento de actualización anterior; por ejemplo, http_get falló. |
|
PRVTMR |
Segundos desde el último intento de resincronización. |
|
UPGTMR |
Segundos desde el último intento de actualización. |
|
REGTMR1 |
Segundos desde que la Línea 1 perdió el registro con el servidor SIP. |
|
REGTMR2 |
Segundos desde que la Línea 2 perdió el registro con el servidor SIP. |
|
UPGCOND |
Nombre de macro heredado. |
|
SCHEME |
Esquema de acceso a archivos, uno de TFTP, HTTP o HTTPS, según se obtiene después de analizar la URL de resincronización o actualización. |
|
SERV |
Solicite el nombre de host del servidor de destino, tal como se obtiene después de analizar la URL de resincronización o actualización. |
|
SERVIP |
Solicite la dirección IP del servidor de destino, tal como se obtiene después de analizar la URL de resincronización o actualización, posiblemente después de la búsqueda de DNS. |
|
PORT |
Solicite el puerto UDP/TCP de destino, tal como se obtiene después de analizar la URL de resincronización o actualización. |
|
PATH |
Solicite la ruta del archivo de destino, tal como se obtiene después de analizar la URL de resincronización o actualización. |
|
ERR |
Mensaje de resultado de intento de resincronización o actualización. Únicamente útil para generar mensajes de syslog de resultados. El valor se conserva en la variable UPGERR en el caso de intentos de actualización. |
|
IdN |
El contenido del parámetro de configuración Line n UserID. |
|
EMS |
Extension MobilityEstado |
|
MUID |
Extension MobilityID de usuario |
|
MPWD |
Extension MobilityContraseña |
Códigos de error internos
El teléfono define una serie de códigos de error internos (X00-X99) para facilitar la configuración y proporcionar un control más fino sobre el comportamiento de la unidad bajo ciertas condiciones de error.
|
Nombre del parámetro |
Descripción y valor predeterminado |
|---|---|
|
X00 |
Error de capa de transporte (o ICMP) al enviar una solicitud SIP. |
|
X20 |
Se agota el tiempo de espera de la solicitud SIP mientras espera una respuesta. |
|
X40 |
Error general del protocolo SIP (por ejemplo, códec inaceptable en SDP en mensajes 200 y ACK, o tiempos de espera mientras espera ACK). |
|
X60 |
Número marcado no válido según el plan de marcado dado. |
