Tipos de parâmetros de provisionamento

Esta seção descreve os parâmetros de provisionamento amplamente organizados de acordo com a função.

Parâmetros gerais

Os parâmetros gerais GPP_* (Login do administrador > avançado > Voz > Provisionamento) são usados como registros de strings livres ao configurar o telefone para interagir com uma solução de servidor de provisionamento específica. Os parâmetros GPP_* estão vazios por padrão. Podem ser configurados para conter diversos valores, incluindo o seguinte:

  • Chaves de criptografia

  • URLs

  • Informações de status de provisionamento multiestágio.

  • Modelos de solicitação post

  • Mapas de alias do nome do parâmetro

  • Valores de string parciais, eventualmente combinados em valores de parâmetros completos.

Os parâmetros GPP_* estão disponíveis para expansão de macro dentro de outros parâmetros de provisionamento. Para esse fim, os nomes de macro de letras maiúsculas simples (A a P) são suficientes para identificar o conteúdo de GPP_A a GPP_P. Além disso, a macro de letras maiúsculas com duas letras do SA a SD identifica GPP_SA a GPP_SD como um caso especial quando usada como argumento das seguintes opções de URL:

key, uid e pwd

Esses parâmetros podem ser usados como variáveis nas regras de provisionamento e atualização. Eles são referenciados prefixando o nome da variável com um caractere "$", como $GPP_A.

Ativar parâmetros

Os parâmetros Provision_Enable e Upgrade_Enable controlam todas as operações de ressincronização de perfil e atualização de firmware. Esses parâmetros controlam as ressincronizaçãos e atualizações independentemente um do outro. Eles também controlam a ressincronização e atualizam comandos de URL emitidos pelo servidor Web de administração. Esses dois parâmetros são definidos como Sim por padrão.

O parâmetro Resync_From_SIP controla solicitações de operações de ressincronização. Um evento de notificação SIP é enviado do servidor proxy do fornecedor de serviços para o telefone. Se estiver ativado, o proxy poderá solicitar uma ressincronização. Para isso, o proxy envia uma mensagem de notificação SIP que contém o evento: cabeçalho de ressincronização do dispositivo.

O dispositivo desafia a solicitação com uma resposta 401 (autorização recusada para credenciais de uso). O dispositivo espera uma solicitação posterior autenticada antes de honrar a solicitação de ressincronização do proxy. Os cabeçalhos Event: reboot_now e Event: restart_now executam reinicializações frias e quentes, respectivamente, que também são desafiados.

As duas ativações restantes são Resync_On_Reset e Resync_After_Upgrade_Attempt. Esses parâmetros determinam se o dispositivo executa uma operação de ressincronização depois que o software de inicialização é reinicializado e depois de cada tentativa de atualização.

Quando Resync_On_Reset está ativado, o dispositivo introduz um atraso aleatório que segue a sequência de inicialização antes que a redefinição seja efetuada. O atraso é uma hora aleatória até o valor que Resync_Random_Delay (em segundos) especifica. Em um pool de telefones que liga simultaneamente, esse atraso espalha as horas de início das solicitações de ressincronização de cada unidade. Esse recurso pode ser útil em uma implementação residencial grande, no caso de uma falha de energia regional.

Disparadores

O telefone permite que você faça a ressincronização em intervalos específicos ou em uma hora específica.

Ressincronização em intervalos específicos

O telefone é projetado para sincronizar novamente com o servidor de provisionamento periodicamente. O intervalo de ressincronização é configurado em Resync_Periodic (segundos). Se esse valor for deixado em branco, o dispositivo não será ressincronizado periodicamente.

A ressincronização normalmente ocorre quando as linhas de voz estão ociosas. Se uma linha de voz estiver ativa quando uma ressincronização for concluída, o telefone atrasará o procedimento de ressincronização até que a linha fique ociosa novamente. Uma ressincronização pode fazer com que os valores do parâmetro de configuração sejam alterados.

Uma operação de ressincronização pode falhar porque o telefone não consegue recuperar um perfil do servidor, o arquivo baixado está corrompido ou ocorreu um erro interno. O dispositivo tenta sincronizar novamente após um tempo especificado em Resync_Error_Retry_Delay (segundos). Se Resync_Error_Retry_Delay for definido como 0, o dispositivo não tentará sincronizar novamente após uma tentativa de ressincronização com falha.

Se uma atualização falhar, uma nova tentativa será executada depois de Upgrade_Error_Retry_Delay segundos.

Dois parâmetros configuráveis estão disponíveis para acionar condicionalmente uma ressincronização: Resync_Trigger_1 e Resync_Trigger_2. Cada parâmetro pode ser programado com uma expressão condicional que sai da expansão da macro. Quando o intervalo de ressincronização expirar (tempo para a próxima ressincronização), os gatilhos, se definidos, irão impedir a ressincronização, a menos que um ou mais gatilhos sejam avaliados como verdadeiro.

A seguinte condição de exemplo aciona uma ressincronização. No exemplo, a última tentativa de atualização do telefone levou mais de 5 minutos (300 segundos) e pelo menos 10 minutos (600 segundos) se passaram desde a última tentativa de ressincronização.

$UPGTMR gt 300 and $PRVTMR ge 600

Ressincronizar em um horário específico

O parâmetro Resync_At permite que o telefone seja sincronizado novamente em um horário específico. Esse parâmetro usa o formato de 24 horas (hhmm) para especificar a hora.

O parâmetro Resync_At_Random_Delay permite que o telefone seja sincronizado novamente em um atraso não especificado no tempo. Esse parâmetro usa um formato de inteiro positivo para especificar o tempo.

Inundar o servidor com solicitações de ressincronização de vários telefones definidos para ressincronização ao mesmo tempo deve ser evitado. Para isso, o telefone aciona a ressincronização de até 10 minutos após o tempo especificado.

Por exemplo, se você definir o tempo de ressincronização para 1000 (10 a.m.), o telefone acionará a ressincronização a qualquer momento entre 10:00 a.m. e 10:10 a.m.

Por padrão, este recurso está desativado. Se o parâmetro Resync_At for provisionado, o parâmetro Resync_Periodic será ignorado.

Agendas configuráveis

Você pode configurar agendas para ressincronizações periódicas e pode especificar intervalos de repetição para ressincronização e falhas de atualização usando esses parâmetros de provisionamento:

  • Resync_Periodic

  • Resync_Error_Retry_Delay

  • Upgrade_Error_Retry_Delay

Cada parâmetro aceita um único valor de atraso (segundos). A nova sintaxe estendida permite uma lista separada por vírgulas de elementos de atraso consecutivos. O último elemento na sequência é implicitamente repetido para sempre.

Opcionalmente, você pode usar um sinal de adição para especificar outro valor numérico que acrescenta um atraso extra aleatório.

Exemplo 1

Neste exemplo, o telefone é periodicamente ressincronizado a cada 2 horas. Se ocorrer uma falha de ressincronização, o dispositivo tentará novamente nos seguintes intervalos: 30 minutos, 1 hora, 2 horas, 4 horas. O dispositivo continua tentando executar intervalos de 4 horas até que ele seja ressincronizado com êxito.

 Resync_Periodic=7200 Resync_Error_Retry_Delay=1800,3600,7200,14400

Exemplo 2

Neste exemplo, o dispositivo é periodicamente ressincronizado a cada hora (mais um atraso aleatório extra de até 10 minutos). No caso de uma falha de ressincronização, o dispositivo se repete nos seguintes intervalos: 30 minutos (mais de 5 minutos). 1 hora (mais de 10 minutos), 2 horas (mais de 15 minutos). O dispositivo continua tentando em intervalos de 2 horas (mais de 15 minutos) até que ele seja ressincronizado com êxito.

 Resync_Periodic=3600+600 Resync_Error_Retry_Delay=1800+300,3600+600,7200+900

Exemplo 3

Neste exemplo, se uma tentativa de atualização remota falhar, o dispositivo tentará novamente a atualização em 30 minutos, depois novamente depois de mais uma hora, em duas horas. Se a atualização ainda falhar, o dispositivo se repete a cada quatro a cinco horas até que a atualização tenha sido bem-sucedida.

Upgrade_Error_Retry_Delay  =  1800,3600,7200,14400+3600

Regras de perfil

O telefone fornece vários parâmetros de perfil de configuração remota (Profile_Rule*). Dessa forma, cada operação de ressincronização pode recuperar vários arquivos que os servidores diferentes gerenciam.

No cenário mais simples, o dispositivo é ressincronizado periodicamente para um único perfil em um servidor central, que atualiza todos os parâmetros internos pertinentes. Como alternativa, o perfil pode ser dividido entre arquivos diferentes. Um arquivo é comum para todos os telefones em uma implantação. Um arquivo separado exclusivo é fornecido para cada conta. As chaves de criptografia e as informações do certificado podem ser fornecidas ainda em outro perfil, armazenado em um servidor separado.

Sempre que uma operação de ressincronização for concluída, o telefone avaliará os quatro parâmetros Profile_Rule* na sequência:

  1. Profile_Rule

  2. Profile_Rule_B

  3. Profile_Rule_C

  4. Profile_Rule_D

Cada avaliação pode resultar em uma recuperação de perfil de um servidor de provisionamento remoto, com uma possível atualização de alguns parâmetros internos. Se uma avaliação falhar, a sequência de ressincronização será interrompida e será tentada novamente do início especificado pelo parâmetro Resync_Error_Retry_Delay (segundos). Se todas as avaliações forem bem-sucedidas, o dispositivo aguardará pelo segundo especificado pelo parâmetro Resync_Periodic e, em seguida, executará outra ressincronização.

O conteúdo de cada parâmetro Profile_Rule* consiste em um conjunto de alternativas. As alternativas são separadas pelo caractere | (pipe). Cada alternativa consiste em uma expressão condicional, uma expressão de atribuição, um URL de perfil e qualquer opção de URL associada. Todos esses componentes são opcionais em cada alternativa. Veja a seguir as combinações válidas e a ordem em que elas devem aparecer, se houver:

[ conditional-expr ] [ assignment-expr ] [[ options ] URL ]

Dentro de cada parâmetro de Profile_Rule*, todas as alternativas, exceto a última, devem fornecer uma expressão condicional. Essa expressão é avaliada e processada da seguinte forma:

  1. As condições são avaliadas da esquerda para a direita, até que seja encontrada uma avaliação verdadeira (ou até que seja encontrada uma alternativa sem nenhuma expressão condicional).

  2. Qualquer expressão de atribuição incluída será avaliada, se houver.

  3. Se um URL for especificado como parte dessa alternativa, será feita uma tentativa de download do perfil localizado no URL especificado. O sistema tenta atualizar os parâmetros internos conforme necessário.

Se todas as alternativas tiverem expressões condicionais e nenhuma for avaliada como verdadeira (ou se a regra de perfil inteira estiver vazia), todo o parâmetro Profile_Rule* será ignorado. O próximo parâmetro de regra de perfil na sequência é avaliado.

Exemplo 1

Este exemplo ressincroniza incondicionalmente para o perfil no URL especificado e executa uma solicitação HTTP GET para o servidor de provisionamento remoto:

http://remote.server.com/cisco/$MA.cfg

Exemplo 2

Neste exemplo, o dispositivo é sincronizado com duas URLs diferentes, dependendo do estado do registro da Linha 1. No caso de registro perdido, o dispositivo executa um HTTP POST para um script de CGI. O dispositivo envia o conteúdo da macro expandida GPP_A, que pode fornecer informações adicionais sobre o estado do dispositivo:

 ($PRVTMR ge 600)? http://p.tel.com/has-reg.cfg | [--postar a] http://p.tel.com/lost-reg?

Exemplo 3

Neste exemplo, o dispositivo é ressincronizado com o mesmo servidor. O dispositivo fornecerá informações adicionais se um certificado não estiver instalado na unidade (para unidades anteriores às 2.0 herdadas):

 ("$CCERT" eq "Instalado")? https://p.tel.com/config? | https://p.tel.com/config?cisco$MAU

Exemplo 4

Neste exemplo, a Linha 1 é desativada até que GPP_A seja definido como sendo provisionado por meio do primeiro URL. Posteriormente, ele será ressincronizado com o segundo URL:

(“$A” ne “Provisioned”)? (Line_Enable_1_ = “No”;)! https://p.tel.com/init-prov| https://p.tel.com/configs

Exemplo 5

Neste exemplo, presume-se que o perfil que o servidor retorna contém tags de elemento XML. Essas tags devem ser remapeadas para nomes de parâmetros adequados pelo mapa de aliases armazenados no GPP_B:

[--alias b] https://p.tel.com/account/$PN$MA.xml

Uma ressincronização normalmente será considerada malsucedida se um perfil solicitado não for recebido do servidor. O parâmetro Resync_Fails_On_FNF pode substituir esse comportamento padrão. Se Resync_Fails_On_FNF estiver definido como Não, o dispositivo aceitará uma resposta de arquivo não encontrado do servidor como uma ressincronização bem-sucedida. O valor padrão para Resync_Fails_On_FNF é Sim.

Regra de atualização

A regra de atualização é dizer ao dispositivo para ativar para uma nova carga e de onde obter a carga, se necessário. Se a carga já estiver no dispositivo, ele não tentará obter a carga. Portanto, a validade do local de carga não importará quando a carga desejada estiver na partição inativa.

O Upgrade_Rule especifica uma carga de firmware que, se for diferente da carga atual, será baixada e aplicada, a menos que seja limitada por uma expressão condicional ou Upgrade_Enable esteja definida como Não.

O telefone fornece um parâmetro de atualização remota configurável, Upgrade_Rule. Esse parâmetro aceita uma sintaxe semelhante à dos parâmetros de regras de perfil. Não há suporte para opções de URL em atualizações, mas expressões condicionais e expressões de atribuição podem ser usadas. Se as expressões condicionais forem usadas, o parâmetro poderá ser preenchido com várias alternativas, separadas pelo caractere |. A sintaxe de cada alternativa é a seguinte:

[ conditional-expr ] [ assignment-expr ] URL

Como no caso dos parâmetros Profile_Rule*, o parâmetro Upgrade_Rule avalia cada alternativa até que uma expressão condicional seja atendida ou uma alternativa não tenha nenhuma expressão condicional. A expressão de atribuição que acompanha é avaliada, se especificada. Em seguida, uma atualização para a URL especificada é tentada.

Se o Upgrade_Rule contiver uma URL sem uma expressão condicional, o dispositivo será atualizado para a imagem de firmware que a URL especifica. Após a expansão de macro e a avaliação da regra, o dispositivo não tentará atualizar até que a regra seja modificada, ou a combinação efetiva de esquema + servidor + porta + caminho de arquivo será alterada.

Para tentar uma atualização de firmware, o dispositivo desabilita o áudio no início do procedimento e reinicia no fim do procedimento. O dispositivo inicia automaticamente uma atualização que é controlada pelo conteúdo de Upgrade_Rule somente se todas as linhas de voz estiverem inativas no momento.

Por exemplo:

https://10.73.10.223/firmware/PHONEOS-8875.1-0-1-0001-1.loads

Neste exemplo, o Upgrade_Rule atualiza o firmware para a imagem armazenada no URL indicado.

Aqui está um outro exemplo:

(“$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 exemplo direciona a unidade para carregar uma das duas imagens, com base no conteúdo de um parâmetro de propósito geral, GPP_F.

Parâmetros de provisionamento

É possível encontrar os parâmetros de provisionamento na guia Provisionamento, na página da Web telefone.

Parâmetros do perfil de configuração

A tabela a seguir define a função e o uso de cada parâmetro na seção Parâmetros do perfil de configuração na guia Provisionamento.

Tabela 1. Parâmetros do perfil de configuração

Nome do parâmetro

Descrição e valor padrão

Ativação de provisionamento

Controla todas as ações de ressincronização independentemente das ações de atualização do firmware. Defina como Sim para ativar o provisionamento remoto.

O valor padrão é Sim.

Ressincronização ao redefinir

Aciona uma ressincronização após cada reinicialização, exceto para reinicializações causadas por atualizações de parâmetros e atualizações de firmware.

O valor padrão é Sim.

Atraso aleatório da ressincronização

Atraso aleatório após a sequência de inicialização antes de executar a redefinição, especificada em segundos. Em um pool de dispositivos de telefonia IP programados para ligar simultaneamente, isso introduz uma propagação nos horários em que cada unidade envia uma solicitação de ressincronização para o servidor de provisionamento. Esse recurso pode ser útil em uma implementação residencial grande, no caso de uma falha de energia regional.

O valor desse campo deve ser um número inteiro que varia entre 0 e 65.535.

O valor padrão é 2.

Ressincronização às (HHmm)

Hora (HHmm) que o dispositivo sincroniza novamente com o servidor de provisionamento.

O valor desse campo deve ser um número de quatro dígitos que vai de 0000 a 2400 para indicar a hora no formato HHmm. Por exemplo, 0959 indica 09h59.

O valor padrão é vazio. Se o valor for inválido, o parâmetro será ignorado. Se esse parâmetro for definido com um valor válido, o parâmetro Ressincronização periódica será ignorado.

Ressincronização com atraso aleatório

Impede uma sobrecarga do servidor de provisionamento quando muitos dispositivos são ligados simultaneamente.

Para evitar a inundação de solicitações de ressincronização no servidor de vários telefones, o telefone é ressincronizado no intervalo entre as horas e os minutos e as horas e os minutos mais o atraso aleatório (hhmm, hhmm+random_delay). Por exemplo, se o atraso aleatório = (Ressincronização com atraso aleatório + 30)/60 minutos, o valor de entrada em segundos será convertido em minutos, arredondando para o próximo minuto para calcular o intervalo de random_delay final.

O valor válido é varia entre 600 e 65.535.

Se o valor for menor que 600, o atraso aleatório interno estará entre 0 e 600.

O valor padrão é 600 segundos (10 minutos).

Ressincronização periódica

O intervalo de tempo entre as sincronizações periódicas com o servidor de provisionamento. O temporizador de ressincronização associado só estará ativo depois da primeira sincronização bem-sucedida com o servidor.

Os formatos válidos são estes:

  • Um número inteiro

    Exemplo: a inserção de 3000 indica que a próxima ressincronização ocorrerá em 3000 segundos.

  • Vários números inteiros

    Exemplo: a inserção de 600,1200,300 indica que a primeira ressincronização ocorre em 600 segundos, a segunda ressincronização ocorre 1200 segundos depois da primeira e a terceira ressincronização ocorre 300 segundos após a segunda.

  • Um período

    Por exemplo, a inserção de 2400+30 indica que a próxima ressincronização ocorrerá entre 2400 e 2430 segundos após uma ressincronização bem-sucedida.

Defina esse parâmetro como zero para desativar a ressincronização periódica.

O valor padrão é 3600 segundos.

Atraso de repetição após erro de ressincronização

Se uma operação de ressincronização falhar porque o dispositivo de telefonia IP não conseguiu recuperar um perfil do servidor, o arquivo baixado está corrompido ou ocorreu um erro interno, o dispositivo tentará se ressincronizar depois de um tempo especificado em segundos.

Os formatos válidos são estes:

  • Um número inteiro

    Exemplo: a inserção de 300 indica que a próxima ressincronização ocorrerá em 300 segundos.

  • Vários números inteiros

    Exemplo: a inserção de 600,1200,300 indica que a primeira tentativa ocorrerá 600 segundos após a falha, a segunda tentativa ocorrerá 1200 segundos após a falha da primeira tentativa e a terceira tentativa ocorrerá 300 segundos após a falha da segunda tentativa.

  • Um período

    Por exemplo, a inserção de 2400+30 indica que a próxima tentativa ocorrerá entre 2400 e 2430 segundos após uma falha de ressincronização.

Se o atraso for definido como 0, o dispositivo não tentará se ressincronizar depois de uma tentativa de ressincronização com falha.

Atraso de ressincronização forçada

Atraso máximo (em segundos) que o telefone espera antes de realizar uma ressincronização.

O dispositivo não é ressincronizado enquanto uma de suas linhas telefônicas está ativa. Como uma ressincronização pode levar vários segundos, é desejável aguardar até que o dispositivo fique ocioso por um período longo antes da ressincronização. Isso permite que o usuário faça chamadas sucessivas sem interrupção.

O dispositivo tem um temporizador que começa a contagem regressiva quando todas as linhas ficam ociosas. Esse parâmetro é o valor inicial do contador. Os eventos de ressincronização são atrasados até que o contador chegue a zero.

O valor válido varia entre 0 e 65.535.

O valor padrão é 14.400 segundos.

Ressincronização de SIP

Permite que uma ressincronização seja acionada por uma mensagem NOTIFY SIP.

O valor padrão é Sim.

Ressincronização após tentativa de atualização

Ativa ou desativa a operação de ressincronização após ocorrer qualquer atualização. Se a opção Sim for selecionada, a sincronização será acionada.

O valor padrão é Sim.

Gatilho de ressincronização 1, Gatilho de ressincronização 2

Condições de gatilho de ressincronização configurável. Uma ressincronização é acionada quando a equação lógica nesses parâmetros é avaliada como TRUE.

O valor padrão é (vazio).

Falha de ressincronização em FNF

Uma ressincronização será considerada malsucedida se um perfil solicitado não for recebido do servidor. Isso pode ser substituído por esse parâmetro. Quando está definido como Não, o dispositivo aceita uma resposta de arquivo não encontrado do servidor como uma ressincronização bem-sucedida.

O valor padrão é Sim.

Regra de perfil

Regra de perfil B

Regra de perfil C

Regra de perfil D

Cada regra de perfil informa o telefone sobre uma fonte de onde se obtém um perfil (arquivo de configuração). Durante cada operação de ressincronização, o telefone aplica todos os perfis em sequência.

Padrão: /$PSN.xml

Se estiver aplicando a criptografia AES-256-CBC aos arquivos de configuração, especifique a chave de criptografia com a palavra-chave --key da seguinte forma:

[--key <chave de criptografia>]

Você pode colocar a chave de criptografia entre aspas duplas ("), se desejar.

Opção de DHCP a ser usada

Opções de DHCP, delimitadas por vírgula, usadas para recuperar firmware e perfis.

O valor padrão é 66,160,159,150,60,43,125.

Registrar mensagem de solicitação

Esse parâmetro contém a mensagem que é enviada ao servidor syslog no início de uma tentativa de ressincronização.

O valor padrão é $PN $MAC –Requesting % $SCHEME://$SERVIP:$PORT$PATH.

Registrar mensagem de êxito

A mensagem syslog que é emitida após a conclusão com êxito de uma tentativa de ressincronização.

O valor padrão é $PN $MAC –Successful Resync % $SCHEME://$SERVIP:$PORT$PATH -- $ERR.

Registrar mensagem de falha

A mensagem syslog que é emitida após uma tentativa de ressincronização com falha.

O valor padrão é $PN $MAC -- Resync failed: $ERR.

Ressincronização configurável pelo usuário

Permite que um usuário ressincronize o telefone na tela do telefone IP.

O valor padrão é Sim.

Parâmetros de atualização de firmware

A tabela a seguir define a função e o uso de cada parâmetro na seção Atualização de firmware da guia Provisionamento.

Tabela 2. Parâmetros de atualização de firmware

Nome do parâmetro

Descrição e valor padrão

Ativação de atualização

Ativa operações de atualização de firmware independentemente de ações de ressincronização.

O valor padrão é Sim.

Configure esse parâmetro com um dos métodos:

  • No arquivo de configuração do telefone com XML(cfg.xml), digite uma cadeia de caracteres neste formato: <Upgrade_Enable ua=">Yes</Upgrade_Enable>

  • Na página da Web de administração do telefone, defina esse campo como Sim ou Não.

Atraso de repetição de erro de atualização

O intervalo de repetição de atualização (em segundos) aplicado em caso de falha na atualização. O dispositivo tem um temporizador de erro de atualização do firmware que é ativado após uma tentativa de atualização do firmware com falha. O temporizador é inicializado com o valor desse parâmetro. A próxima tentativa de atualização de firmware ocorre quando esse contador chega a zero.

O valor padrão é 3600 segundos.

Configure esse parâmetro com um dos métodos:

  • No arquivo de configuração do telefone com XML(cfg.xml), digite uma cadeia de caracteres neste formato: <Upgrade_Error_Retry_Delay ua=">3600</Upgrade_Error_Retry_Delay>

  • Na página da Web de administração do telefone, defina o valor.

Regra de atualização

Script de atualização de firmware que define condições de atualização e URLs de firmware associados. Ele usa a mesma sintaxe da regra de perfil.

Use o seguinte formato para inserir a regra de atualização:

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

Por exemplo: 

tftp://192.168.1.5/firmware/PHONEOS-8875.1-0-1-0001-1.loads
http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads

Se nenhum protocolo for especificado, TFTP será presumido. Se nenhum nome de servidor for especificado, o host que solicita a URL será usado como o nome do servidor. Se nenhuma porta for especificada, a porta padrão será usada (69 para TFTP, 80 para HTTP ou 443 para HTTPS).

O valor padrão é em branco.

Configure esse parâmetro com um dos métodos:

  • No arquivo de configuração do telefone com XML(cfg.xml), digite uma string neste formato: <Upgrade_Rule ua=">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

  • Na página da Web de administração do telefone, digite o caminho onde o arquivo de carga está armazenado.

Registrar mensagem de solicitação de atualização

Mensagem do syslog emitida no início de uma tentativa de atualização do firmware.

Padrão: $PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATH

Configure esse parâmetro com um dos métodos:

  • No arquivo de configuração do telefone com XML(cfg.xml), digite uma cadeia de caracteres neste formato: <Log_Upgrade_Request_Msg ua=">$PN $MAC -- Solicitando atualização $SCHEME://$SERVIP:$PORT$PATH</Log_Upgrade_Request_Msg>

  • Na página da Web de administração do telefone, personalize o parâmetro conforme necessário.

Registrar mensagem de êxito de atualização

Mensagem do syslog emitida após uma tentativa de atualização do firmware ter sido concluída com êxito.

O valor padrão é $PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR

Configure esse parâmetro com um dos métodos:

  • No arquivo de configuração do telefone com XML(cfg.xml), digite uma cadeia de caracteres neste formato: <Log_Upgrade_Success_Msg ua=">$PN $MAC -- Atualização bem-sucedida $SCHEME://$SERVIP:$PORT$PATH -- $ERR</Log_Upgrade_Success_Msg>

  • Na página da Web de administração do telefone, personalize o parâmetro conforme necessário.

Registrar mensagem de falha de atualização

Mensagem do syslog emitida após uma tentativa de atualização do firmware com falha.

O valor padrão é $PN $MAC -- Upgrade failed: $ERR

Configure esse parâmetro com um dos métodos:

  • No arquivo de configuração do telefone com XML(cfg.xml), digite uma string neste formato: <Log_Upgrade_Failure_Msg ua=">$PN $MAC -- Falha na atualização: $ERR</Log_Upgrade_Failure_Msg>

  • Na página da Web de administração do telefone, personalize o parâmetro conforme necessário.

Compart. firmware corresp.

Habilita ou desativa o recurso Compartilhamento de firmware (PFS) correspondente. Selecione Sim ou Não para ativar ou desativar o recurso.

Padrão: Sim

Configure esse parâmetro com um dos métodos:

  • No arquivo de configuração do telefone com XML(cfg.xml), digite uma string neste formato: <Peer_Firmware_Sharing ua=">Yes</Peer_Firmware_Sharing>

  • Na página da Web de administração do telefone, defina esse campo como Sim ou Não.

Servidor de registro de compartilhamento de firmware de mesmo nível

Indica o endereço IP e a porta para a qual a mensagem UDP é enviada.

Por exemplo: 10.98.76.123:514, onde 10.98.76.123 é o endereço IP e 514 é o número da porta.

Configure esse parâmetro com um dos métodos:

  • No arquivo de configuração do telefone com XML(cfg.xml), digite uma string neste formato: <Peer_Firmware_Sharing_Log_Server ua=">10.98.76.123:514</Peer_Firmware_Sharing_Log_Server>

  • Na página da Web de administração do telefone, digite o endereço do servidor de log.

Parâmetros gerais

A tabela a seguir define a função e o uso de cada parâmetro na seção Parâmetros gerais da guia Provisionamento.

Tabela 3. Parâmetros gerais

Nome do parâmetro

Descrição e valor padrão

GPP A - GPP P

Os parâmetros gerais GPP_* são usados como registros de cadeia de caracteres livres ao configurar os telefones para interagir com uma solução de servidor de provisionamento específica. Podem ser configurados para conter diversos valores, incluindo o seguinte:

  • Chaves de criptografia.

  • URLs.

  • Informações de status de provisionamento multiestágio.

  • Modelos de solicitação post.

  • O alias do nome do parâmetro mapeia.

  • Valores de string parciais, eventualmente combinados em valores de parâmetros completos.

O valor padrão é em branco.

Variáveis de expansão de macros

Determinadas variáveis de macro são reconhecidas nos seguintes parâmetros de provisionamento:

  • Profile_Rule

  • Profile_Rule_*

  • Resync_Trigger_*

  • Upgrade_Rule

  • Registro

  • GPP_* (sob condições específicas)

Dentro desses parâmetros, os tipos de sintaxe, como $NAME ou $(NAME), são reconhecidos e expandidos.

As subcadeias de caracteres da variável de macro podem ser especificadas com a notação $(NAME:p) e $(NAME:p:q), em que p e q são inteiros não negativos (disponíveis na revisão 2.0.11 e acima). A expansão de macro resultante é a substring que começa no deslocamento de caractere p, com comprimento q (ou outro até o final da string se q não for especificado). Por exemplo, se GPP_A contiver ABCDEF, $(A:2) expande para CDEF e $(A:2:3) expande para CDE.

Um nome não reconhecido não é convertido e a forma $NAME ou $(NAME) permanece inalterado no valor do parâmetro após a expansão.

Nome do parâmetro

Descrição e valor padrão

$

A forma $$ se expande para um único caractere $.

A a P

Substituído pelo conteúdo dos parâmetros de finalidade geral GPP_A a GPP_P.

SA a SD

Substituído por parâmetros de finalidade especial GPP_SA a GPP_SD. Esses parâmetros contêm chaves ou senhas usadas em provisionamento.

$SA a $SD são reconhecidos como argumentos para o qualificador de URL de ressincronização opcional, --key.

MA

Endereço MAC usando dígitos hexadecimais de maiúsculas e minúsculas, por exemplo, 000e08aabbcc.

MAU

Endereço MAC usando os dígitos hexadecimais de maiúsculas e minúsculas, por exemplo 000E08AABBCC.

MAC

Endereço MAC usando dígitos hexadecimais minúsculos e dois-pontos para separar pares de dígitos hexadecimais. Por exemplo, 00:0e:08:aa:bb:cc.

PN

Nome do produto. Por exemplo, CP-8875, DP-9851, DP-9871.

PSN

Número de série do produto. Por exemplo, V03.

SN

String do número de série, por exemplo, 88012BA01234.

CCERT

Status do certificado do cliente SSL: instalado ou não instalado.

IP

O endereço IP do telefone dentro da sub-rede local. Por exemplo 192.168.1.100.

EXTIP

IP externo do telefone, como visto na Internet. Por exemplo 66.43.16.52.

SWVER

String de versão do software. Por exemplo:

PHONEOS.3-1-1-0104-37

HWVER

String de versão do hardware. Por exemplo, 2.0.1

PRVST

Estado de provisionamento (uma string numérica):

-1 = Solicitação de ressincronização explícita

0 = Ressincronização de inicialização

1 = Ressincronização periódica

2 = falha na ressincronização. tente novamente

UPGST

Estado da atualização (uma string numérica):

1 = Primeira tentativa de atualização

2 = Falha na atualização, tente novamente

UPGERR

Mensagem de resultado (ERR) da tentativa de atualização anterior; por exemplo http_get falhou.

PRVTMR

Segundos desde a última tentativa de ressincronização.

UPGTMR

Segundos desde a última tentativa de atualização.

REGTMR1

Segundos desde que a Linha 1 perdeu o registro com o servidor SIP.

REGTMR2

Segundos desde que a Linha 2 perdeu o registro com o servidor SIP.

UPGCOND

Nome da macro herdada.

SCHEME

Esquema de acesso a arquivo, um de TFTP, HTTP ou HTTPS, conforme obtido após a análise da nova sincronização ou da atualização da URL.

SERV

Nome do host do servidor de destino da solicitação, conforme obtido após a análise da URL de ressincronização ou atualização.

SERVIP

Endereço IP do servidor de destino da solicitação, conforme obtido após a análise da nova sincronização ou atualização da URL, possivelmente seguindo a pesquisa DNS.

PORTA

Porta UDP/TCP de destino da solicitação, conforme obtido após a análise da nova sincronização ou da atualização da URL.

CAMINHO

Caminho do arquivo de destino da solicitação, conforme obtido após a análise da nova sincronização ou da atualização do URL.

ERR

Mensagem de resultado da tentativa de ressincronização ou atualização. Útil apenas para gerar mensagens syslog de resultado. O valor é preservado na variável UPGERR no caso de tentativas de atualização.

UIDn

O conteúdo do parâmetro de configuração UserID da Linha n.

EMS

Status do Extension Mobility

MUID

ID do usuário do Extension Mobility

MPWD

Senha do Extension Mobility

Códigos de erro interno

O telefone define um número de códigos de erro interno (X00 – X99) para facilitar a configuração no fornecimento de um melhor controle sobre o comportamento da unidade sob determinadas condições de erro.

Tabela 4. Códigos de erro interno

Nome do parâmetro

Descrição e valor padrão

X00

Erro de camada de transporte (ou ICMP) ao enviar uma solicitação SIP.

X20

A solicitação SIP expira enquanto aguarda uma resposta.

X40

Erro de protocolo SIP geral (por exemplo, codec inaceitável em SDP nas mensagens 200 e ACK, ou expira ao aguardar ACK).

X60

Número discado inválido de acordo com o plano de discagem fornecido.