- Página inicial
- /
- Artigo
Parâmetros de provisionamento de telefones no Cisco BroadWorks
Este artigo de Ajuda é para telefones Cisco registrados no Cisco BroadWorks. As informações nesta página incluem os parâmetros de provisionamento e a sintaxe.
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 _* (
) 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:
-
Regra rofile_ P
-
P rofile_ R ule_ B
-
P rofile_ R ule_ C
-
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:
-
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).
-
Qualquer expressão de atribuição que acompanha é avaliada, se presente.
-
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 .
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:
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:
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 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: Se você estiver aplicando a criptografia AES-256-CBC aos arquivos de configuração, especifique a chave de criptografia com a 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 é |
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 é |
Registrar mensagem de falha |
A mensagem syslog que é emitida após uma tentativa de ressincronização com falha. O valor padrão é |
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 .
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:
|
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:
|
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:
Por exemplo:
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:
|
Registrar mensagem de solicitação de atualização |
Mensagem syslog emitida no início de uma tentativa de atualização de firmware. Padrão: Configure esse parâmetro com um dos métodos:
|
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 é Configure esse parâmetro com um dos métodos:
|
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 é Configure esse parâmetro com um dos métodos:
|
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:
|
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:
|
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 .
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:
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.
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. |