Referência de Comando para Controlador Nortel Alteon

Este capítulo descreve como usar os seguintes comandos nalcontrol para Controlador Nortel Alteon:

É possível usar uma versão abreviado dos parâmetros de comando nalcontrol digitando as letras exclusivas dos parâmetros. Por exemplo, para obter ajuda sobre o comando file save, é possível digitar nalcontrol he f em vez de nalcontrol help file.

Para obter o prompt de comandos nalcontrol: digite nalcontrol.

Para terminar a interface de linha de comandos: digite exit ou quit.

Nota:
Você deve usar caracteres em inglês para todos os valores de parâmetro de comando. As únicas exceções são nomes de host (usados em comandos do servidor) e nomes de arquivo (usados em comandos de arquivo).

nalcontrol consultant — configurar e controlar um consultor

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-nalcontrol--consultor--+-add--scID--address--swIPAddr--+---------------------------+-+-><
                          |                               +-rcommunity--readCommName--+ |
                          |                               '-wcommunity--writeCommName-' |
                          +-binarylog--scID+scID2...;;--+-report------------------------+-+
                          |                           +-set--+-interval--interval---+-+ |
                          |                           |      '-retention--retention-' | |
                          |                           +-start-------------------------+ |
                          |                           '-stop--------------------------' |
                          +-remove--scID+scID2...;;---------------------------------------+
                          +-report--scID+scID2...;;---------------------------------------+
                          +-set--+--------------------------------+---------------------+
                          |      +-loglevel--nível----------------+                     |
                          |      +-logsize--+-size------+---------+                     |
                          |      |          '-unlimited-'         |                     |
                          |      +-sensitivity--weight percentage-+                     |
                          |      '-tempo de hibernação--sec-------'                     |
                          +-start--scID+scID2...;;----------------------------------------+
                          '-stop--scID+scID2...;;-----------------------------------------'
 

add
Inclui um consultor de comutador.
scID
Uma sequência definida pelo usuário que se refere ao consultor.
endereço
O endereço IP do Nortel Alteon Web Switch para o qual o consultor fornece pesos.
swIPAddr
O endereço IP do comutador.
rcommunity
O nome da comunidade de leitura usado nas comunicações get do SNMP com Nortel Alteon Web Switch. O padrão é público.
readCommName
A sequência que representa o nome da comunidade de leitura, conforme configurado no Nortel Alteon Web Switch. O padrão é público.
wcommunity
O nome da comunidade da gravação usado nas comunicações get do SNMP.
writeCommName
A sequência que representa o nome da comunidade de gravação, conforme configurado no Nortel Alteon Web Switch. O padrão é particular.
binarylog
Controla a criação de log binário para um consultor.
report
Relata as características da criação de log binário.
set
Configura com que frequência, em segundos, informações são gravadas nos logs binários. O recurso de criação de log binário permite que informações de serviço sejam armazenadas em arquivos de log binário para cada um dos serviços definidos na configuração. As informações são gravadas nos logs apenas quando os segundos do intervalo de log especificado tiverem decorrido após o último registro ser gravado no log. O intervalo de criação de log binário padrão é 60.
interval
Configura o número de segundos entre entradas no log binário.
retention
Configura o número de horas pelas quais os arquivos de log binário são mantidos.
start
Inicia a criação de log binário.
stop
Para a criação de log binário.
remove
Remove um consultor de comutador.
report
Relata as características dos consultores do comutador.
set
Configura as características dos consultores do comutador.
loglevel
Configura o nível em que o consultor do comutador registra atividades. O valor padrão é 1.
level
O número do nível de 0 a 5. O padrão é 1. Os possíveis valores são:
  • 0 = Nenhum
  • 1 = Mínimo
  • 2 = Básico
  • 3 = Moderado
  • 4 = Avançado
  • 5 = Detalhado
logsize
Configura o número máximo de bytes registrado no arquivo de log. O valor padrão é 1048576. Quando você configura um tamanho máximo para o arquivo de log, o arquivo é quebrado; quando o arquivo atinge o tamanho especificado, as entradas subsequentes são gravadas sobre o arquivo, sobrescrevendo as entradas de log anteriores. O tamanho do log não pode ser configurado como menor do que o seu tamanho atual. Entradas de log são registradas pela data e hora, portanto, é possível informar a ordem na qual elas foram gravadas. Quanto mais alto você configura o nível de log, mais cuidadosamente você deverá escolher o tamanho do log, pois é possível esgotar o espaço rapidamente durante um login em níveis superiores.
size
O número máximo de bytes registrado no log do consultor. É possível especificar um número inteiro positivo maior que zero ou a palavra unlimited. O arquivo de log poderá não atingir o tamanho máximo exato antes da sobrescrição, pois as entradas de log variam de tamanho.
sensitivity
Indica a quantidade de mudanças que devem acontecer entre os pesos novo e antigo para que o peso seja alterado. A diferença entre os pesos novo e antigo deve ser maior que a porcentagem de sensibilidade para que o peso seja alterado. O intervalo válido é 0 a 100; o padrão é 5.
weight percentage
Um número inteiro de 0 a 100 representando o valor da sensibilidade.
sleeptime
Configura o número de segundos para suspensão entre ciclos de peso-configuração. O padrão é 7.
seconds
Um número inteiro representando o tempo de hibernação em segundos. O intervalo válido é de 0 a 2,147,460.
start
Inicia a coleta de métricas e a configuração de pesos.
stop
Para a coleta de métricas e a configuração de pesos.

Exemplos

nalcontrol controller — gerenciar o controlador

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-nalcontrol--controlador--+-report--------------------------+-><
                            '-set--+------------------------+-'
                                   +-loglevel--nível--------+
                                   '-logsize--+-size------+-'
                                              '-unlimited-'
 

report
Exibe as características do controlador. Informações da versão são exibidas como parte desse relatório.
set
Configura as características do controlador.
loglevel
Configura o nível em que o controlador registra atividades. O valor padrão é 1.
level
O número do nível de 0 a 5. O padrão é 1. Os valores possíveis são:
  • 0 = Nenhum
  • 1 = Mínimo
  • 2 = Básico
  • 3 = Moderado
  • 4 = Avançado
  • 5 = Detalhado
logsize
Configura o número máximo de bytes registrado no arquivo de log. O valor padrão é 1048576. Quando você configura um tamanho máximo para o arquivo de log, o arquivo é quebrado; quando o arquivo atinge o tamanho especificado, as entradas subsequentes são gravadas sobre o arquivo, sobrescrevendo as entradas de log anteriores. O tamanho do log não pode ser configurado como menor do que o seu tamanho atual. Entradas de log são registradas pela data e hora, portanto, é possível informar a ordem na qual elas foram gravadas. Quanto mais alto você configura o nível de log, mais cuidadosamente você deverá escolher o tamanho do log, pois é possível esgotar o espaço rapidamente durante um login em níveis superiores.
size | unlimited
O número máximo de bytes registrado no log do consultor. É possível especificar um número inteiro positivo maior que zero ou a palavra unlimited. O arquivo de log poderá não atingir o tamanho máximo exato antes da sobrescrição, pois as entradas de log variam de tamanho.

Exemplos

nalcontrol file — gerenciar arquivos de configuração

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-nalcontrol--file--+-delete--filename-+----------------------><
                     +-load--filename---+
                     +-report-----------+
                     '-save--filename---'
 

delete
Exclui o arquivo de configuração especificado.
nome do arquivo
Um arquivo de configuração. A extensão do arquivo deve ser .xml. Se essa extensão não for especificada, ela será assumida.
load
Carrega a configuração armazenada no arquivo especificado.
Nota:
O carregamento de um arquivo anexa a configuração armazenada nesse arquivo à configuração em execução. Se quiser carregar uma nova configuração, você deverá parar e reiniciar o servidor antes de carregar o arquivo.
report
Lista os arquivos de configuração.
save
Salva a atual configuração para o arquivo especificado.
Nota:
Os arquivos são salvos e carregados a partir dos seguintes diretórios:
  • Sistemas AIX, HP-UX, Linux e Solaris: /opt/ibm/edge/lb/servers/configurations/nal
  • Sistemas Windows: <install_root>ibm\edge\lb\servers\configurations\nal

Exemplos

nalcontrol help — exibir ou imprimir ajuda para este comando

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-nalcontrol--help--+-controlador----------+------------------><
                     +-consultor------------+
                     +-file-----------------+
                     +-help-----------------+
                     +-alta disponibilidade-+
                     +-metrinalllector------+
                     +-ownercontent---------+
                     '-serviço--------------'
 

Exemplos

nalcontrol highavailability — controlar alta disponibilidade

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-nalcontrol--highavailability--+-add--+-address--address---------------+-+-><
                                 |      +-partneraddress--partneraddress-+ |
                                 |      +-port--port---------------------+ |
                                 |      '-role--+-principal-+------------' |
                                 |              '-secondary-'              |
                                 +-dropreach--address----------------------+
                                 +-remove----------------------------------+
                                 +-report----------------------------------+
                                 +-set--+-beatinterval--time-----+---------+
                                 |      +-takeoverinterval--time-+         |
                                 |      +-loglevel--nível--------+         |
                                 |      '-logsize--+-size------+-'         |
                                 |                 '-unlimited-'           |
                                 +-start--+-auto---+-----------------------+
                                 |        '-manual-'                       |
                                 +-stop------------------------------------+
                                 +-takeover--------------------------------+
                                 '-usereach--address-----------------------'
 

add
Configura um nó, um parceiro e destinos de alcance de alta disponibilidade.
endereço
O endereço do qual receber pulsações.
address
O endereço IP do nó de alta disponibilidade.
partneraddress
O endereço para o qual enviar pulsações. Esse é o endereço IP ou o nome do host configurados no nó do parceiro. Esse endereço é usado para a comunicação com uma máquina de parceiro de alta disponibilidade.
address
O endereço IP do parceiro.
porta
A porta usada para a comunicação com o parceiro. O padrão é 12345.
port
O número da porta.
role
A função de alta disponibilidade.
primary | secondary
A função principal ou secundária.
dropreach
Remova esse destino de alcance dos critérios de alta disponibilidade.
address
O endereço IP do destino de alcance.
remove
Remova o nó, o parceiro e o destino de alcance da configuração de alta disponibilidade. A alta disponibilidade deve ser interrompida antes do uso do comando.
report
Exibe informações de alta disponibilidade.
set
Configura as características de alta disponibilidade.
beatinterval
Configura com que frequência, em milissegundos, pulsações são enviadas para o parceiro. O padrão é 500.
time
Um número inteiro positivo representando o tempo do intervalo de superação em milissegundos.
takeoverinterval
Configura a quantidade de tempo, em milissegundos, que deve prescrever (durante o qual nenhuma pulsação é recebida) antes de se assumir o controle. O padrão é 2000.
time
Um número inteiro positivo representando o tempo do intervalo de controle em milissegundos.
loglevel
Configura o nível em que atividades são registradas. O valor padrão é 1.
level
O número do nível de 0 a 5. O padrão é 1. Os possíveis valores são:
  • 0 = Nenhum
  • 1 = Mínimo
  • 2 = Básico
  • 3 = Moderado
  • 4 = Avançado
  • 5 = Detalhado
logsize
Configura o número máximo de bytes registrado no arquivo de log de alta disponibilidade. O valor padrão é 1048576. Quando você configura um tamanho máximo para o arquivo de log, o arquivo é quebrado; quando o arquivo atinge o tamanho especificado, as entradas subsequentes são gravadas sobre o arquivo, sobrescrevendo as entradas de log anteriores. O tamanho do log não pode ser configurado como menor do que o seu tamanho atual. Entradas de log são registradas pela data e hora, portanto, é possível informar a ordem na qual elas foram gravadas. Quanto mais alto você configura o nível de log, mais cuidadosamente você deverá escolher o tamanho do log, pois é possível esgotar o espaço rapidamente durante um login em níveis superiores.
size | unlimited
O número máximo de bytes registrados no log de alta disponibilidade. É possível especificar um número inteiro positivo maior que zero ou a palavra unlimited. O arquivo de log poderá não atingir o tamanho máximo exato antes da sobrescrição, pois as entradas de log variam de tamanho.
start
Começa a usar a alta disponibilidade. Um nó, um parceiro e um destino de alcance de alta disponibilidade devem ser configurados antes do uso desse comando.
auto | manual
Determina se você deve iniciar a alta disponibilidade com uma estratégia de recuperação automática ou manual.
stop
Para de usar alta disponibilidade.
takeover
Assume o controle a partir do nó de alta disponibilidade ativo.
usereach
O endereço do destino de alcance que começará a usar alta disponibilidade. Inclua um destino de alcance que possa sofrer um ping para que parceiros de alta disponibilidade determinem até que ponto seus destinos são alcançáveis.
address
O endereço IP do destino de alcance.

Exemplos

nalcontrol metriccollector — configurar coletor de métrica

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-nalcontrol--metricollector--+-report--scID+scID2+...;;:mN+mN2...;;----------------------------+-><
                               '-set--scID+scID2+...;;:mN+mN2...;;--+-connecttimeout--sec------+-'
                                                                +-loglevel--nível----------+
                                                                +-logsize--+-size------+---+
                                                                |          '-unlimited-'   |
                                                                +-receivetimeout--sec------+
                                                                '-tempo de hibernação--sec-'
 

report
Exibe as características de um coletor de métrica.
scID (switch consultant ID)
Uma sequência definida pelo usuário que se refere ao consultor.
mN (metric name)
Nome que identifica a métrica fornecida ou customizada.
set
Configura as características de um coletor de métrica.
connecttimeout
Configure quanto tempo um coletor de métrica aguarda antes de relatar que uma conexão falhou.
sec
Um número inteiro positivo representando a quantidade de tempo em segundos que o coletor de métrica aguarda antes de relatar que uma conexão com um serviço falhou.
loglevel
Configura o nível em que o consultor especificado registra atividades. O padrão é 1.
level
O número do nível. O padrão é 1. Quanto mais alto o número, mais informações serão gravadas no log do consultor. Os valores possíveis são:
  • 0 = Nenhum
  • 1 = Mínimo
  • 2 = Básico
  • 3 = Moderado
  • 4 = Avançado
  • 5 = Detalhado
logsize
Configura o número máximo de bytes registrado no arquivo de log. O valor padrão é 1048576. Quando você configura um tamanho máximo para o arquivo de log, o arquivo é quebrado; quando o arquivo atinge o tamanho especificado, as entradas subsequentes são gravadas sobre o arquivo, sobrescrevendo as entradas de log anteriores. O tamanho do log não pode ser configurado como menor do que o seu tamanho atual. Entradas de log são registradas pela data e hora, portanto, é possível informar a ordem na qual elas foram gravadas. Quanto mais alto você configura o nível de log, mais cuidadosamente você deverá escolher o tamanho do log, pois é possível esgotar o espaço rapidamente durante um login em níveis superiores.
size | unlimited
O número máximo de bytes registrado no log do consultor. É possível especificar um número inteiro positivo maior que zero ou a palavra unlimited. O arquivo de log poderá não atingir o tamanho máximo exato antes da sobrescrição, pois as entradas de log variam de tamanho.
receivetimeout
Configura quanto tempo o consultor espera antes de relatar que um recebimento de serviço falhou.
sec
Um número inteiro positivo representando a quantidade de tempo em segundos que o consultor aguarda antes de relatar que um recebimento de serviço falhou.
sleeptime
Configura a quantidade de tempo em segundos que o coletor de métrica fica suspenso entre ciclos de métrica-coleção.
sec
Um número inteiro positivo representando o número de segundos do tempo de hibernação.

Exemplos

nalcontrol server — configurar um servidor

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-nalcontrol--serer--+-report--scID+scID2...;;:svcID+svcID2...;;:serverID+svrID2...;;------------------------------------+-><
                      '---set--scID+scID2...;;:svcID+svcID2...;;:serverID+svrID2--+---------------------------------+---'
                                                                              +-fixedweight--+-Número inteiro-+-+
                                                                              |              '-desativado-----' |
                                                                              +-requestsourceip--IPAddress------+
                                                                              +-metricserveraddress--IPAddress--+
                                                                              '-metricserverport--portNumber----'
 

report
Exibe características dos servidores.
scID
Uma sequência definida pelo usuário que representa o consultor.
svcID
Uma sequência definida pelo usuário que representa o identificador de serviço virtual e o número da porta virtual no comutador.
serverID
Um número inteiro que representa o servidor no comutador.
set
Configura características de servidores.
fixedweight
Configura um peso fixo para este servidor. O padrão é off. O fixedweight máximo é 48.
integer | off
Um número inteiro positivo representando o peso fixo para este servidor ou a palavra off para especificar nenhum peso fixo.
requestsourceip
Configura o endereço a partir do qual contatar o servidor para solicitações de aplicativos.
IPAddress
O endereço IP a partir do qual contatar o servidor como um nome simbólico ou em formato de endereço IP.
metricserveraddress
Configura o endereço a partir do qual contatar o servidor para solicitações do servidor de métrica.
IPAddress
O endereço IP do servidor de métrica como um nome simbólico ou em formato de endereço IP.
metricserverport
Configura a porta a ser usada para contatar o servidor de métrica.
portNumber
O número da porta usado para contatar o servidor de métrica.

Exemplos

nalcontrol service — configurar um serviço

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-nalcontrol--serviço--+-add--scID+scID2...;;:serviceID+svcID2...;;--vsid--virSvrID--vport--virPortNum------+-><
                        +-métricas--scID+scID2...;;:svcID+svcID2...;;--mN--importance--mCN2--i2--------------+
                        +-refresh--scID+scID2...;;:svcID+svcID2...;;-----------------------------------------+
                        +-remove--scID+scID2...;;:svcID+svcID2...;;------------------------------------------+
                        +-report--scID+scID2...;;:svcID+svcID2...;;------------------------------------------+
                        '-set--scID+scID2...;;:svcID+svcID2...;;----metric--mN----+-requeststring--cadeia--+-'
                                                                              +-responsestring--cadeia-+
                                                                              '-retry--numretries------'
 

add
Inclui um serviço no consultor especificado.
scID (switchConsultantID)
Uma sequência definida pelo usuário que se refere ao consultor.
svcID (serviceID)
Uma sequência definida pelo usuário que identifica o serviço.
vsid
A palavra-chave de identificador de serviço virtual.
virSvrID (virtualServerID)
O número no comutador que representa o servidor virtual.
vport
A palavra-chave de porta virtual.
virPortNum (virtualPortNumber)
O número da porta para o serviço atualmente configurado no comutador.
métricas
Especifica o conjunto de métricas usadas para calcular pesos e a importância de cada métrica. A importância é expressa como uma porcentagem do total. A soma dos valores da importância deverá totalizar 100. As métricas podem ser qualquer combinação da métrica de dados de conexão, métricas do orientador de aplicativo e métricas do servidor de métrica. Os padrões são as métricas de conexão ativa (activeconn) e de taxa de conexão (connrate) com importância de 50/50.
mN (metric name)
Nome que identifica o coletor de métrica que coletará medidas para determinar o peso do servidor.

A seguir está uma lista de nomes de métricas válidos e suas portas associadas.

Nome do Orientador Protocolo Porta
conectar ICMP 12345
db2 privado 50000
dns DNS 53
ftp FTP 21
http HTTP 80
https SSL 443
proxy de armazenamento HTTP (via Caching Proxy) 80
imap IMAP 143
ldap LDAP 389
nntp NNTP 119
ping PING 0
pop3 POP3 110
sip SIP 5060
smtp SMTP 25
ssl SSL 443
telnet Telnet 23
WLM privado 10.007
activeconn n/d n/d
connrate n/d n/d
cpuload n/d n/d
memload n/d n/d
importance
Um número de 0 a 100 que representa a importância dessa métrica ao calcular pesos do servidor.
refresh
Atualiza um serviço com informações de Nortel Alteon Web Switch.
remove
Remove um serviço.
report
Relata características de um serviço.
set
Configura características de um serviço.
metric
Configura as características de uma métrica configurada.
mN (metric name)
O nome da métrica desejada.
requeststring
Configura uma sequência de solicitações para a métrica especificada. Representa a solicitação enviada por um coletor de métrica para reunir informações de métrica.
string
A sequência de solicitações enviadas pelo coletor de métrica para o servidor.
responsestring
Configura uma sequência de respostas para a métrica especificada. A sequência de respostas especificada é usada pelo coletor de métrica para comparar as respostas recebidas dos servidores e determinar subsequentemente a disponibilidade do servidor.
string
A sequência de respostas à qual o coletor de métrica compara as respostas do servidor recebidas.
retry
Retry configura o número de novas tentativas que podem ser feitas antes de marcar um servidor como inativo.
numretries
Um número inteiro maior ou igual a zero. Esse valor não deve ser maior do que 3. Se a palavra-chave novas tentativas não estiver configurada, o número de novas tentativas será padronizado como zero.

Exemplos