- Inicio
- /
- Artículo
Gracias por sus comentarios.
Aprovisionar parámetros para teléfonos en Cisco BroadWorks
En este artículo
¿Comentarios?Este artículo de ayuda es para teléfonos Cisco 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
En esta sección se describen los parámetros de aprovisionamiento ampliamente organizados según la función.
Parámetros de uso general
Los parámetros de uso general GPP_* () se utilizan como registros de cadenas libres cuando se configura el teléfono para que interactúe con una solución de servidor de aprovisionamiento particular. Los parámetros GPP_* están vacíos de manera predeterminada. Se pueden configurar para que contengan diversos valores, incluidos los siguientes:
-
Claves de cifrado
-
Direcciones URL
-
Información de estado de aprovisionamiento de varias etapas.
-
Plantillas posteriores a la solicitud
-
Mapas de alias de nombre de parámetros
-
Valores de cadenas parciales, finalmente 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 macros mayúsculas de una sola letra (de la A a la P) son suficientes para identificar el contenido de GPP_A a la GPP_P. Además, los nombres de macros mayúsculas de dos letras de SA a SD identifican GPP_SA a GPP_SD como un caso especial cuando se utilizan como argumentos de las siguientes opciones de URL:
clave, uid y pwd
Estos parámetros se pueden utilizar como variables en las reglas de aprovisionamiento y actualización. Se hace referencia a ellos prefiriendo el nombre de la variable con un carácter “$”, como $GPP_A.
Habilitar parámetros
Los parámetros Provision_Habilitar y Upgrade_Habilitar controlan todas las operaciones de resincronización de perfiles y actualización de firmware. Estos parámetros controlan las resincronizaciones y las mejoras de forma independiente entre sí. Estos parámetros también controlan los comandos de URL de resincronización y actualización que se emiten a través del servidor web de administración. Estos dos parámetros están definidos en Sí de manera 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 evento: el encabezado de resincronización con el dispositivo.
El dispositivo rechaza la solicitud con una respuesta 401 (autorización rechazada para las credenciales utilizadas). El dispositivo espera una solicitud autenticada posterior antes de aceptar la solicitud de resincronización del proxy. El Evento: reboot_now y Evento: restart_now los encabezados realizan reinicios fríos y cálidos, respectivamente, que también son desafiados.
Las dos habilitaciones restantes son Resync_On_Reset y Resync_After_Upgrade_Attempt. Estos parámetros determinan si el dispositivo realiza una operación de resincronización después de que se reinicie el software de encendido y después de cada intento de actualización.
Cuando Resync_On_Reset está habilitado, el dispositivo introduce una demora aleatoria 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 característica puede ser útil en una implementación residencial grande, en el caso de una falla de energía regional.
Disparadores
El teléfono le permite resincronizar a intervalos específicos o a una hora específica.
Resincronización a intervalos específicos
El teléfono está diseñado para resincronizarse 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 suele tener lugar cuando las líneas de voz están inactivas. Si una línea de voz está activa cuando vence 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 cambien los valores de los parámetros de configuración.
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 produjo un error interno. El dispositivo intenta resincronizarse nuevamente después de una hora especificada en Resync_Error_Retry_Delay (segundos). Si Resync_Error_Retry_Delay se establece en 0, el dispositivo no intenta resincronizarse después de un intento fallido de resincronización.
Si falla una actualización, se realiza un reintento después de Upgrade_Error_Retry_Delay segundos.
Hay dos parámetros configurables disponibles para activar de forma condicional 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 expansión de macros. Cuando caduca el intervalo de resincronización (tiempo para la próxima resincronización), si se establece, los activadores evitarán la resincronización, a menos que uno o más activadores se evalúen como verdadero.
La siguiente condición de ejemplo activa 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 y $PRVTMR ge 600Resincronización a una hora específica
El parámetro Resync_At permite que el teléfono se resincronice a una hora específica. 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 resincronice en un intervalo de tiempo no especificado. Este parámetro utiliza un formato entero positivo para especificar la hora.
Se debe evitar la inundación del servidor con solicitudes de resincronización de varios teléfonos que están configurados para resincronizarse al mismo tiempo. Para hacerlo, el teléfono activa la resincronización hasta 10 minutos después de la hora especificada.
Por ejemplo, si configura el tiempo 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 manera predeterminada, esta opción esta deshabilitada. Si se proporciona el parámetro Resync_At, se ignora el parámetro Resync_Periodic.
Planificaciones configurables
Puede configurar planificaciones para las resincronizaciones periódicas y especificar los intervalos de reintento para los errores de resincronización y actualización mediante el uso de estos parámetros de aprovisionamiento:
-
Resync_Periódico
-
Demora de Resync_Error_Retry_
-
Demora de Upgrade_Error_Retry_
Cada parámetro acepta un único valor de retraso (segundos). La nueva sintaxis extendida permite una lista separada por comas de elementos de demora 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 anexe un intervalo adicional aleatorio.
Ejemplo 1
En este ejemplo, el teléfono se resincroniza periódicamente cada 2 horas. Si se produce una falla en la resincronización, el dispositivo vuelve a intentarlo en estos intervalos: 30 minutos, 1 hora, 2 horas, 4 horas. El dispositivo continúa intentando intervalos de 4 horas hasta que se resincroniza 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 (más un intervalo aleatorio adicional de hasta 10 minutos). En el caso de un error de resincronización, el dispositivo vuelve a intentar en estos intervalos: 30 minutos (más un máximo de 5 minutos). 1 hora (más un máximo de 10 minutos), 2 horas (más un máximo de 15 minutos). El dispositivo continúa intentando intervalos de 2 horas (más hasta 15 minutos) hasta que se resincroniza con éxito.
Resync_Periódico=3600+600 Resync_Error_Retry_Retraso=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 vuelve a intentarlo cada cuatro a cinco horas hasta que la actualización se realice correctamente.
Upgrade_Error_Retry_Delay = 1800,3600,7200,14400+3600 Reglas del perfil
El teléfono proporciona varios parámetros de perfil de configuración remota (Profile_Regla*). Por lo tanto, cada operación de resincronización puede recuperar varios archivos administrados por diferentes servidores.
En la situación más simple, el dispositivo se resincroniza periódicamente con un único perfil en un servidor central, que actualiza todos los parámetros internos pertinentes. Como alternativa, 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 independiente y único para cada cuenta. Las claves de cifrado y la información de certificados pueden ser suministradas por otro perfil, almacenado en un servidor independiente.
Cada vez que vence una operación de resincronización, el teléfono evalúa los cuatro parámetros de Profile_Regla* en secuencia:
-
Profile_Regla
-
Profile_Rule_B
-
Profile_Rule_C
-
Profile_Rule_O
Cada evaluación puede resultar en una recuperación de perfil desde un servidor de aprovisionamiento remoto, con una posible actualización de algunos parámetros internos. Si una evaluación falla, 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 son correctas, el dispositivo espera el segundo especificado por el parámetro Resync_Periodic y luego realiza otra resincronización.
El contenido de cada parámetro Profile_Rule* consta de 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 ] [[ opciones ] URL ] Dentro de cada parámetro Profile_Regla*, 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 encuentre una que se evalúe como verdadera (o hasta que se encuentre una alternativa sin expresión condicional).
-
Se evalúa cualquier expresión de asignación que la acompañe, si está presente.
-
Si se especifica una URL como parte de esa alternativa, se intenta descargar el perfil que se encuentra en la 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 perfil está vacía), se omite el parámetro Profile_Regla* completo. Se evalúa el siguiente parámetro de regla perfil en la secuencia.
Ejemplo 1
Este ejemplo se resincroniza incondicionalmente con el perfil en la 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 URL diferentes, según el estado de registro de la línea 1. En caso de pérdida de registro, el dispositivo realiza un HTTP POST a una secuencia de comandos CGI. El dispositivo envía el contenido del GPP_A expandido de macros, que puede proporcionar información adicional sobre el estado del dispositivo:
($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg | [--publicar a] http://p.tel.com/lost-reg? Ejemplo 3
En este ejemplo, el dispositivo se resincroniza con el mismo servidor. El dispositivo proporciona información adicional si no se instala un certificado en la unidad (para unidades heredadas anteriores a la versión 2.0):
(“$CCERT” eq “Instalado”)? 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 como Aprovisionado a través de la primera URL. Luego, se resincroniza con la segunda URL:
(“$A” ne “Aprovisionado”)? (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 reasignarse 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 Por lo general, una resincronización se considera incorrecta 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 una resincronización exitosa. El valor predeterminado de Resync_Fails_On_FNF es Sí.
Regla de mejora
La regla de actualización es para indicar al dispositivo que se active para una carga nueva y desde dónde obtener la carga, si es necesario. Si la carga ya está en el dispositivo, no se intentará obtener la carga. Por lo tanto, 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 que Upgrade_Enable se establezca en No.
El teléfono proporciona un parámetro de actualización remota configurable, Upgrade_Rule. Este parámetro acepta una sintaxis similar a los parámetros de regla perfil. Las opciones de URL no son compatibles con las mejoras, pero se pueden utilizar expresiones condicionales y expresiones de asignación. Si se usan expresiones condicionales, el parámetro se puede llenar con varias alternativas, separadas por el | carácter. La sintaxis para cada alternativa es la siguiente:
URL de [ conditional-expr ] [ assignment-expr ] 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. Si se especifica, se evalúa la expresión de asignación que acompaña. A continuación, se intenta actualizar a la URL especificada.
Si la Upgrade_Rule contiene una URL sin una expresión condicional, el dispositivo se actualiza a la imagen de firmware que especifica la URL. Después de la expansión de macros y la evaluación de la regla, el dispositivo no vuelve a intentar actualizar hasta que se modifique la regla o se cambie la combinación efectiva de esquema + servidor + puerto + ruta de archivo.
Para intentar actualizar el firmware, el dispositivo desactiva el audio al inicio del procedimiento y se reinicia al final del procedimiento. El dispositivo comienza automáticamente una mejora 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, la Upgrade_Rule actualiza el firmware a la imagen almacenada en la URL indicada.
Este es 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 a la unidad que cargue una de dos imágenes, en función del contenido de un parámetro de uso 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
En la siguiente tabla, se definen la función y el uso de cada parámetro en la sección Parámetros de perfil de configuración en la ficha Aprovisionamiento .
|
Nombre del parámetro |
Descripción y valor predeterminado |
|---|---|
|
Habilitación de aprovisionamiento |
Controla todas las acciones de resincronización independientemente de las acciones de actualización de firmware. Establézcalo en Sí para habilitar el aprovisionamiento remoto. El valor predeterminado es Yes. |
|
Resincronización al restablecer |
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 Yes. |
|
Intervalo aleatorio de resincronización |
Un intervalo aleatorio que sigue a la secuencia de arranque antes de realizar el restablecimiento, especificado en segundos. En un grupo de dispositivos de telefonía IP que están programados para encenderse simultáneamente, esto introduce una propagación en los tiempos en los que cada unidad envía una solicitud de resincronización al servidor de aprovisionamiento. Esta característica puede ser útil en una implementación residencial grande, en el caso de una falla de energía regional. El valor de este campo debe ser un número entero entre 0 y 65535. El valor predeterminado es 2. |
|
Resincronización En (HHmm) |
La hora (HHmm) en la que el dispositivo vuelve a sincronizarse con el servidor de aprovisionamiento. El valor de este campo debe ser un número de cuatro dígitos entre 0000 y 2400 para indicar la hora en formato HHmm. Por ejemplo, 0959 indica 09:59. El valor predeterminado es vacío. Si el valor no es válido, el parámetro será ignorado. Si este parámetro se establece con un valor válido, el parámetro Resync Periodic (Resincronización periódica) será ignorado. |
|
Resincronización A Demora Aleatoria |
Evita una sobrecarga del servidor de aprovisionamiento cuando se enciende una gran cantidad de dispositivos simultáneamente. Para evitar la acumulación de solicitudes de resincronización al servidor de varios teléfonos, el teléfono se resincroniza en el intervalo entre las horas y los minutos, y las horas y los minutos más el intervalo aleatorio (hhmm, hhmm+random_delay). Por ejemplo, si el intervalo aleatorio es igual a (Resync At Random Delay + 30)/60 minutos, el valor de entrada en segundos se convierte en minutos y se redondea hasta el minuto siguiente para calcular el intervalo random_delay final. El valor válido oscila entre 600 y 65535. Si el valor es menor que 600, el intervalo interno aleatorio está entre 0 y 600. El valor predeterminado es 600 segundos (10 minutos). |
|
Resincronización periódica |
El intervalo de tiempo entre las resincronizaciones periódicas 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 de 3600 segundos. |
|
Demora de reintento por error de resincronización |
Si una operación de resincronización falla porque el dispositivo de telefonía IP no pudo recuperar un perfil del servidor, porque el archivo descargado está dañado o porque se produce un error interno, el dispositivo intentará resincronizarse 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 resincronizarse después de un intento fallido de resincronización. |
|
Demora de resincronización forzada |
Demora máxima (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. Dado que una resincronización puede demorar varios segundos, es deseable esperar hasta que el dispositivo haya estado inactivo durante un período prolongado antes de la resincronización. Esto permite que el usuario realice llamadas sucesivas sin interrupciones. El dispositivo tiene un temporizador que comienza a contar hacia abajo cuando todas sus líneas están inactivas. Este parámetro es el valor inicial del contador. Los eventos de resincronización se retrasan hasta que este contador disminuya a cero. El valor válido oscila entre 0 y 65535. El valor predeterminado es de 14 400 segundos. |
|
Resincronización desde SIP |
Permite que se active una resincronización a través de un mensaje SIP NOTIFY. El valor predeterminado es Yes. |
|
Resincronización después del intento de mejora |
Habilita o deshabilita la operación de resincronización después de que se produce una mejora. Si se selecciona Yes (Sí), se activa la sincronización. El valor predeterminado es Yes. |
|
Activador de resincronización 1, Activador de resincronización 2 |
Condiciones de activación de resincronización configurables. Se activa una resincronización cuando la ecuación lógica en estos parámetros se evalúa como TRUE. El valor predeterminado es (vacío). |
|
Falla la resincronización en FNF |
Una resincronización se considera incorrecta si no se recibe un perfil solicitado del servidor. Esto se puede sobrescribir con el parámetro. Cuando se establece en no, el dispositivo acepta una respuesta de El valor predeterminado es Yes. |
|
Regla del perfil Regla del perfil B Regla del perfil C Regla del perfil D |
Cada regla de perfil informa al teléfono de una fuente desde 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. Valor predeterminado: Si está aplicando el cifrado AES-256-CBC a los archivos de configuración, especifique la clave de cifrado con la palabra clave Opcionalmente, puede incluir la clave de cifrado entre comillas dobles ("). |
|
Opción DHCP para utilizar |
Las opciones de DHCP, delimitadas por comas, se utilizan para recuperar firmware y perfiles. El valor predeterminado es 66,160,159,150,60,43,125. |
|
Mensaje 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 |
|
Mensaje de éxito del registro |
El mensaje de registro del sistema que se emite al finalizar con éxito un intento de resincronización. El valor predeterminado es |
|
Msg. de error de registro |
El mensaje de registro del sistema que se envía 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 Yes. |
Parámetros de actualización de firmware
En la siguiente tabla, se definen 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 |
|---|---|
|
Habilitación de la mejora |
Habilita las operaciones de actualización de firmware independientemente de las acciones de resincronización. El valor predeterminado es Yes. Configure este parámetro con uno de los métodos:
|
|
Demora de reintento de error de mejora |
Se aplica el intervalo de reintento de actualización (en segundos) en caso de que falle la actualización. El dispositivo tiene un temporizador de errores de actualización de firmware que se activa después de un intento fallido de actualización de 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 a cero. El valor predeterminado es de 3600 segundos. Configure este parámetro con uno de los métodos:
|
|
Regla de mejora |
Una secuencia de comandos de actualización de firmware que define las condiciones de actualización y las URL de firmware asociadas. Utiliza la misma sintaxis que la regla de perfil. 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, se utiliza el host que solicita la URL como nombre de 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 es en blanco. Configure este parámetro con uno de los métodos:
|
|
Mensaje de solicitud de mejora de registro |
Se emitió un mensaje de syslog al inicio de un intento de actualización de firmware. Valor predeterminado: Configure este parámetro con uno de los métodos:
|
|
Mensaje de éxito de la mejora del registro |
El mensaje de syslog emitido después de un intento de actualización del firmware finaliza correctamente. El valor predeterminado es Configure este parámetro con uno de los métodos:
|
|
Mensaje de error de mejora del registro |
Se emitió un mensaje de syslog después de un intento fallido de actualización de firmware. El valor predeterminado es Configure este parámetro con uno de los métodos:
|
|
Uso compartido de firmware entre extremos |
Habilita o deshabilita la función de uso compartido de firmware entre extremos (PFS). Seleccione Sí o No para habilitar o deshabilitar la característica. Predeterminado: Sí Configure este parámetro con uno de los métodos:
|
|
Servidor de registro de uso compartido de firmware entre extremos |
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:
|
Parámetros de uso general
En la siguiente tabla, se definen la función y el uso de cada parámetro en la sección Parámetros de uso general de la ficha Aprovisionamiento .
|
Nombre del parámetro |
Descripción y valor predeterminado |
|---|---|
|
gpp a - gpp p |
Los parámetros de uso general GPP_* se utilizan como registros de cadenas libres cuando se configuran los teléfonos para que interactúen con una solución de servidor de aprovisionamiento particular. Se pueden configurar para que contengan diversos valores, incluidos los siguientes:
El valor predeterminado es en blanco. |
Variables de expansión de macros
Algunas variables de macros se reconocen en los siguientes parámetros de aprovisionamiento:
-
Profile_Regla
-
Profile_Rule_*
-
Resync_Trigger_*
-
Upgrade_regla
-
Log_*
-
GPP_* (en condiciones específicas)
Dentro de estos parámetros, los tipos de sintaxis, como $NAME o $(NAME), se reconocen y expanden.
Las subcadenas de variables de macros se pueden especificar con las notaciones $(NAME:p) y $(NAME:p:q), donde p y q son números enteros no negativos (disponibles en la versión 2.0.11 y superiores). La expansión de macro resultante es la subcadena que comienza en el desplazamiento de caracteres p, con una longitud de q (o hasta el final de cadena si no se especifica q). Por ejemplo, si GPP_A contiene ABCDEF, $(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. |
|
De A a P |
Se ha sustituido por el contenido de los parámetros de uso general GPP_A a GPP_P. |
|
SA a SD |
Se ha sustituido por parámetros de propósito especial GPP_SA hasta 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 que utiliza dígitos hexadecimales en minúsculas, por ejemplo, 000e08aabbcc. |
|
MAU |
Dirección MAC que utiliza dígitos hexadecimales en mayúsculas, por ejemplo 000E08AABBCC. |
|
MAC |
Dirección MAC que utiliza dígitos hexadecimales en minúsculas y dos puntos para separar pares de dígitos hexadecimales. Por ejemplo 00:0e:08:aa:bb:cc. |
|
PN |
Nombre del producto. Por ejemplo, CP-8875-CC-C-9K. |
|
psn | Número de serie de producto. Por ejemplo, V03. |
|
SN |
Cadena de número de serie. Por ejemplo 88012BA01234. |
|
ccert |
Estado del certificado del cliente SSL: Instalado o no instalado. |
|
IP |
Dirección IP del teléfono dentro de su subred local. Por ejemplo 192.168.1.100. |
|
exconsejo |
IP externa del teléfono, tal como se ve en Internet. Por ejemplo 66.43.16.52. |
|
oscilación |
Cadena de versión de software. Por ejemplo, phoneos-8875.1-0-1-0001-1 |
|
hwver |
Cadena de versión de hardware. Por ejemplo, 2.0.1 |
|
prvst |
Estado de aprovisionamiento (una cadena numérica): -1 = solicitud de resincronización explícita 0 = resincronización de encendido 1 = resincronización periódica 2 = falló la resincronización, reintentar |
|
Categoría: Upgst |
Estado de actualización (una cadena numérica): 1 = primer intento de mejora 2 = error de mejora, reintentar |
|
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. |
|
cond. upgcond |
Nombre de macro heredado. |
|
esquema |
Esquema de acceso a archivos, uno de TFTP, HTTP o HTTPS, como se obtuvo después de analizar la URL de resincronización o actualización. |
|
serv |
Solicite el nombre de host del servidor de destino, como se obtuvo después de analizar la URL de resincronización o actualización. |
|
servicio |
Solicite la dirección IP del servidor de destino, como se obtuvo después de analizar la URL de resincronización o actualización, posiblemente después de la búsqueda de DNS. |
|
puerto |
Solicite el puerto UDP/TCP de destino, como se obtuvo después de analizar la URL de actualización o resincronización. |
|
ruta |
Solicite la ruta de archivo de destino, como se obtuvo después de analizar la URL de resincronización o actualización. |
|
err |
Mensaje de resultado de intento de resincronización o actualización. Solo es útil para generar mensajes syslog de resultados. El valor se conserva en la variable UPGERR en caso de intentos de actualización. |
|
UIDn |
El contenido del parámetro de configuración UserID de línea n. |
|
EE.UU. |
Estado de Extension Mobility |
|
Categoría: Muid |
ID de usuario de Extension Mobility |
|
mpwd |
Contraseña de Extension Mobility |
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 preciso sobre el comportamiento de la unidad en 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 solicitudes SIP mientras se espera una respuesta. |
|
X40 |
Error general del protocolo SIP (por ejemplo, códec inaceptable en SDP en 200 y mensajes ACK, o se agota el tiempo de espera de ACK). |
|
X60 |
Número marcado no válido de acuerdo con el plan de marcado especificado. |
