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 de propósito geral GPP _* ( Login de administrador > advanced > Voice > Provisioning ) são usados como registros de cadeia de caracteres gratuitos 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. Eles 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 pós-atendimento

  • Mapas de alias do nome do parâmetro

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

Os parâmetros de 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, os nomes de macro de letras maiúsculas de duas letras SA a SD identificam GPP _ SA a GPP _ SD como um caso especial quando usado como argumentos 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 P rovision_ Enable e U pgrade_ Enable controlam todas as operações de ressincronização de perfil e atualização de firmware. Esses parâmetros controlam as ressincronizações e atualizações independentemente um do outro. Esses parâmetros também controlam a ressincronização e atualizam os comandos de URL emitidos pelo servidor Web de administração. Ambos os parâmetros são definidos como Yes por padrão.

O parâmetro R esync_ F rom_ SIP controla as solicitações de operações de ressincronização. Um evento de notificação SIP é enviado do servidor proxy do provedor de serviços para o telefone. Se ativado, o proxy poderá solicitar uma ressincronização. Para fazer 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 subsequente autenticada antes de honrar a solicitação de ressincronização do proxy. O evento: reboot_now e Evento: restart_now cabeçalhos executam reinicializações frias e quentes, respectivamente, que também são desafiados.

As duas ativações restantes são R esync_ O n_ Reset e R esync_ A fter_ U pgrade_ Tentativa. Esses parâmetros determinam se o dispositivo executa uma operação de ressincronização após a reinicialização do software de inicialização e após cada tentativa de atualização.

Quando R esync_ O n_ Reset está ativado, o dispositivo introduz um atraso aleatório que segue a sequência de inicialização antes que a redefinição seja executada. O atraso é um tempo aleatório até o valor que o atraso R esync_ R andom_ (em segundos) especifica. Em um pool de telefones que liga simultaneamente, esse atraso espalha os horários de início das solicitações de ressincronização de cada unidade. Esse recurso pode ser útil em uma grande implantação residencial, no caso de uma falha de energia regional.

Disparadores

O telefone permite que você sincronize novamente em intervalos específicos ou em um horário específico.

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 R esync_ Periódico (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 R esync_ E rror_ R etry_ Atraso (segundos). Se o atraso R esync_ E rror_ R etry_ 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 U pgrade_ E rror_ R etry_ Atraso segundos.

Dois parâmetros configuráveis estão disponíveis para acionar condicionalmente uma ressincronização: R esync_ T rigger_ 1 e R esync_ T rigger_ 2. Cada parâmetro pode ser programado com uma expressão condicional que passa pela expansão da macro. Quando o intervalo de ressincronização expirar (tempo para a próxima ressincronização), os gatilhos, se definidos, evitarão 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 e $PRVTMR ge 600

Ressincronizar em um horário específico

O parâmetro R esync_ 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 R esync_ A t_ R andom_ Atraso permite que o telefone seja sincronizado novamente em um atraso não especificado no tempo. Esse parâmetro usa um formato inteiro positivo para especificar a hora.

Inundar o servidor com solicitações de ressincronização de vários telefones que são 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 R esync_ At for provisionado, o parâmetro R esync_ Periodic será ignorado.

Agendas configuráveis

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

  • R esync_ Periódico

  • Atraso esync_ de rror_ Retry_ Atraso de etry_ R

  • Atraso pgrade_ de rror_ U-E-R-etry_-R-U

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 nestes intervalos: 30 minutos, 1 hora, 2 horas, 4 horas. O dispositivo continua tentando em intervalos de 4 horas até que seja ressincronizado com êxito.

 R esync_ Periódico=7200 R esync_ E rror_ R etry_ Atraso=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 tenta novamente nestes 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.

 R esync_ Periódico=3600+600 R esync_ E rror_ R etry_ Atraso=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 repetirá a cada quatro a cinco horas até que a atualização seja bem-sucedida.

 U pgrade_ E rror_ R etry_ Atraso   =   1800,3600,7200,14400+3600 

Regras do perfil

O telefone fornece vários parâmetros de perfil de configuração remota (P rofile_ Rule*). Assim, cada operação de ressincronização pode recuperar vários arquivos que diferentes servidores 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 e exclusivo é fornecido para cada conta. As chaves de criptografia e as informações do certificado podem ser fornecidas ainda por 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 P rofile_ Rule* na sequência:

  1. Regra rofile_ P

  2. P rofile_ R ule_ B

  3. P rofile_ R ule_ C

  4. P rofile_ R ule_ 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á repetida novamente do início especificado pelo parâmetro de atraso R esync_ E rror_ R etry_ (segundos). Se todas as avaliações forem bem-sucedidas, o dispositivo aguardará pelo segundo especificado pelo parâmetro R esync_ Periódico e, em seguida, executará outra ressincronização.

O conteúdo de cada parâmetro P rofile_ 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, uma URL de perfil e quaisquer opções de URL associadas. Todos esses componentes são opcionais em cada alternativa. A seguir estão 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 P rofile_ 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 que acompanha é avaliada, se presente.

  3. Se uma URL for especificada como parte dessa alternativa, será feita uma tentativa de baixar o perfil localizado na URL especificada. O sistema tenta atualizar os parâmetros internos de acordo.

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 P rofile_ Rule* será ignorado. O próximo parâmetro de regra de perfil na sequência é avaliado.

Exemplo 1

Este exemplo é ressincronizado 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 é ressincronizado com duas URLs diferentes, dependendo do estado do registro da Linha 1. Em caso de registro perdido, o dispositivo executa um HTTP POST para um script 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 | [--post a] http://p.tel.com/lost-reg? 

Exemplo 3

Neste exemplo, o dispositivo é ressincronizado com o mesmo servidor. O dispositivo fornece 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 o GPP _ A seja definido como igual ao provisionado por meio da primeira URL. Posteriormente, ele é ressincronizado com o segundo URL:

 (“$A” ne “Provisionado”)? (L ine_ E nable_ 1 _ = "Não";)! 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 é considerada malsucedida se um perfil solicitado não for recebido do servidor. O parâmetro R esync_ F ails_ O n_ FNF pode substituir esse comportamento padrão. Se R esync_ F ails_ O n_ 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 R esync_ F ails_ O n_ 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, não tentará obter a carga. Portanto, a validade do local de carga não importa quando a carga desejada está na partição inativa.

A regra U pgrade_ 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 a opção U pgrade_ Enable esteja definida como No .

O telefone fornece um parâmetro de atualização remota configurável, U pgrade_ Rule. Esse parâmetro aceita uma sintaxe semelhante à dos parâmetros de regra de perfil. As opções de URL não são suportadas para atualizações, mas as expressões condicionais e as 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:

 URL [  conditional-expr  ] [  assignment-expr  ] 

Como no caso dos parâmetros P rofile_ Rule*, o parâmetro U pgrade_ 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 a regra U pgrade_ contiver uma URL sem uma expressão condicional, o dispositivo será atualizado para a imagem de firmware especificada pela URL. 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 + filepath será alterada.

Para tentar uma atualização de firmware, o dispositivo desativa o áudio no início do procedimento e reinicializa no final do procedimento. O dispositivo inicia automaticamente uma atualização que é conduzida pelo conteúdo da regra U pgrade_ 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 U pgrade_ Rule atualiza o firmware para a imagem armazenada na URL indicada.

Aqui está 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

Você pode encontrar os parâmetros de provisionamento na guia Provisioning na página da Web do 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 sob a guia Provisioning .

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 de ressincronização

Um 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 agendados 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 grande implantação residencial, no caso de uma falha de energia regional.

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

O valor padrão é 2.

Ressincronização às (HHmm)

A 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 varia de 0000 a 2400 para indicar a hora no formato HHmm. Por exemplo, 0959 indica 09:59.

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 um grande número de dispositivos é ligado 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 final random_delay .

O valor válido varia entre 600 e 65535.

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 ficará ativo somente após a primeira sincronização bem-sucedida com o servidor.

Os formatos válidos são os seguintes:

  • Um número inteiro

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

  • Vários números inteiros

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

  • Um intervalo de tempo

    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 de erro de ressincronização

Se uma operação de ressincronização falhar porque o dispositivo de telefonia IP não pôde recuperar um perfil do servidor ou o arquivo baixado estiver corrompido ou ocorrer um erro interno, o dispositivo tentará sincronizar novamente após um tempo especificado em segundos.

Os formatos válidos são os seguintes:

  • Um número inteiro

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

  • Vários números inteiros

    Exemplo: Uma entrada de 600.1200.300 indica que a primeira tentativa ocorre em 600 segundos após a falha, a segunda tentativa ocorre em 1200 segundos após a falha da primeira tentativa e a terceira tentativa ocorre em 300 segundos após a falha da segunda tentativa.

  • Um intervalo de tempo

    Por exemplo, a entrada 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á sincronizar novamente após uma tentativa de ressincronização com falha.

Atraso de ressincronização forçada

Atraso máximo (em segundos) que o telefone aguarda antes de executar 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 um 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 este contador diminua para zero.

O valor válido varia entre 0 e 65535.

O valor padrão é 14.400   segundos.

Ressincronização De SIP

Permite que uma ressincronização seja acionada por uma mensagem de notificação 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 disparador de ressincronização configurável. Uma ressincronização é acionada quando a equação lógica nesses parâmetros é avaliada como VERDADEIRO.

O valor padrão é (vazio).

Falha na 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 no , o dispositivo aceita uma resposta file-not-found 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 da qual 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 você estiver aplicando a criptografia AES-256-CBC aos arquivos de configuração, especifique a chave de criptografia com a --key palavra-chave da seguinte forma:

[--chave ]

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

Opção de DHCP a ser usada

Opções de DHCP, delimitadas por vírgulas, 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 sucesso

A mensagem syslog que é emitida após a conclusão bem-sucedida 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 da atualização

Ativa as 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), insira uma string neste formato: <U pgrade_ Enable ua="na">Yes Enable>pgrade_

  • 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 de firmware que é ativado após uma tentativa de atualização de firmware com falha. O timer é inicializado com o valor neste parâmetro. A próxima tentativa de atualização de firmware ocorre quando este timer conta para 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), insira uma string neste formato: <U pgrade_ E rror_ R etry_ Delay ua="na">3600 E rror_ R etry_ Delay>pgrade_

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

Regra de atualização

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

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), insira uma string neste formato: <U pgrade_ Rule ua="na">http://10.74.16.242/PHONEOS.3-0-1-0001-213.loads</Upgrade_Rule>

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

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

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

Padrão: $PN $MAC -- Solicitando atualização $SCHEME://$SERVIP:$PORT$PATH

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

  • No arquivo de configuração do telefone com XML (cfg.xml), insira uma string neste formato: <L og_ U pgrade_ R Msg equest_ ua="na">$PN $MAC -- Requesting upgrade $SCHEME://$SERVIP:$PORT$PATH U pgrade_ R equest_ Msg>og_

  • 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 syslog emitida depois que uma tentativa de atualização do firmware é 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), insira uma string neste formato: <L og_ U pgrade_ S uccess_ Msg ua="na">$PN $MAC -- Successful upgrade $SCHEME://$SERVIP:$PORT$PATH -- $ERR U pgrade_ S uccess_ Msg>og_

  • 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 syslog emitida após uma tentativa de atualização de 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), insira uma string neste formato: <L og_ U pgrade_ F ailure_ Msg ua="na">$PN $MAC -- Upgrade failed: $ERR U pgrade_ F ailure_ Msg>og_

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

Compartilhamento De Firmware Pares

Ativa ou desativa o recurso PFS (Compartilhamento de firmware 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), insira uma string neste formato: <P eer_ F irmware_ Sharing ua="na">Yes F irmware_ Sharing>eer_

  • 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 correspondente

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), insira uma string neste formato: <Peer_Firmware_Sharing_Log_ua do servidor="na">10.98.76.123:514Firmware_Sharing_Log_Servidor>eer_

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

Tabela 3. Parâmetros gerais

nome do Parâmetro

Descrição e valor padrão

GPP A - GPP P

Os parâmetros de finalidade geral 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. Eles 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 postal.

  • O alias do nome do parâmetro mapeia.

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

O valor padrão é em branco.

Variáveis de expansão de macro

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

  • Regra rofile_ P

  • P rofile_ R ule_*

  • R esync_ T rigger_*

  • Regra pgrade_ U

  • Log_*

  • 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 variáveis de macro podem ser especificadas com a notação $(NAME:p) e $(NAME:p:q), onde 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 fim da string se q não for especificado). Por exemplo, se GPP _ A contiver ABCDEF, $(A:2) se expande para CDEF e $(A:2:3) se expande para CDE.

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

Nome de 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 por meio de GPP _ P.

SA através de SD

Substituído por parâmetros de finalidade especial GPP _ SA por GPP _ SD. Esses parâmetros contêm chaves ou senhas usadas no 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 letras minúsculas, por exemplo, 000e08aabbcc.

MAU

Endereço MAC usando 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-CC-C-9K.

PSN

Número da 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-8875.1-0-1-0001-1

COLHEITA

String da 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. Repita a tentativa

PRÓXIMO

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.

CARREGAMENTO

Nome da macro herdada.

ESQUEMA

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 da 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 da 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 vários 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 em mensagens 200 e ACK ou expira ao aguardar ACK).

X60

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