Referência de Comando para Controlador Cisco CSS

Este capítulo descreve como usar os seguintes comandos ccocontrol para Controlador Cisco CSS:

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

Para obter o prompt de comandos ccocontrol, digite: ccocontrol.

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).

ccocontrol consultant — configurar e controlar um consultor

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-ccocontrol--consultor--+-add--scID--address--swIPAddr--community--commName-+-><
                          +-binarylog--scID+scID2...;;--+-report-------------+--+
                          |                           +-set--+-interval--+-+  |
                          |                           |      '-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 (switchConsultantID)
Uma sequência definida pelo usuário que se refere ao consultor.
endereço
O endereço IP do Comutador Cisco CSS para o qual o consultor fornece pesos.
swIPAddr (switchIPAddress)
O endereço IP do comutador.
community
O nome usado no SNMP para obter e configurar comunicações com o Comutador Cisco CSS.
commName
O nome da comunidade de leitura/gravação do Comutador Cisco CSS.
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.
sec
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

ccocontrol controller — gerenciar o controlador

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-ccocontrol--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

ccocontrol file — gerenciar os arquivos de configuração

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

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/cco
  • Sistemas Windows: <install_root>ibm\edge\lb\servers\configurations\cco
force
Salva em um arquivo existente.

Exemplos

ccocontrol help — exibir ou imprimir ajuda para este comando

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

Exemplos

ccocontrol highavailability — controlar alta disponibilidade

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-ccocontrol--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

ccocontrol metriccollector — configurar coletor de métrica

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-ccocontrol--metriccollector--+-report--scID+scID2+...;;:mN+mN2...;;----------------------------+-><
                                '-set--scID+scID2+...;;:mN+mN2...;;--+-timeoutconnect--sec------+-'
                                                                 +-loglevel--nível----------+
                                                                 +-logsize--+-size------+---+
                                                                 |          '-unlimited-'   |
                                                                 +-timeoutreceive--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.
timeoutconnect
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.
timeoutreceive
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.
Um número inteiro positivo representando o número de segundos do tempo de hibernação.

Exemplos

ccocontrol ownercontent — controlar o nome do proprietário e a regra de conteúdo

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-ccocontrol--ownerContent--+-add--scID:ocN--ownername--oN--contentrule--cN------------------------------+-><
                             +-métricas--scID+scID2...;;:ocN+ocN2...;;--mN--importance--mN2--i2---------------+
                             +-refresh--scID+scID2...;;:ocN+ocN2...;;-----------------------------------------+
                             +-remove--scID+scID2...;;:ocN+ocN2...;;------------------------------------------+
                             +-report--scID+scID2...;;:ocN+ocN2...;;------------------------------------------+
                             '-set--scID+scID2...;;:ocN+ocN2...;;----metric--mN--+------------------------+---'
                                                                             +-requeststring--cadeia--+
                                                                             +-responsestring--cadeia-+
                                                                             '-retry--numretries------'
 

add
Inclui um ownercontent no consultor especificado.
scID (switch consultant ID)
Uma sequência definida pelo usuário que representa o consultor.
OCName (ownercontent name)
Uma sequência definida pelo usuário que representa o nome do proprietário e a regra de conteúdo no comutador.
ownername
O nome configurado no comutador que identifica a configuração do proprietário.
oN (ownername)
Uma sequência de texto exclusiva sem espaços. O ownername deve ser o mesmo que o especificado no comutador Cisco.
contentrule
O nome configurado no comutador que identifica a configuração de regra de conteúdo do proprietário.
cN (contentname)
Uma sequência de texto exclusiva sem espaços. O contentname deve ser o mesmo que o especificado no comutador Cisco.
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 (metricname)
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
ldaps SSL 443
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
Atualize os serviços configurados com a configuração do Comutador Cisco CSS.
remove
Remove ownercontent
report
Relata características de ownercontents.
set
Configura características de ownercontents.
metric
Configura as características de uma métrica.
mN
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 que 3. Se a palavra-chave retry não estiver configurada, o número de novas tentativas será padronizado como zero.

Exemplos

ccocontrol service — configurar um serviço

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-ccocontrol--service--+-report--scID+scID2...;;:ocN+ocN2...;;:svc+svc2...;;---------------------------------------+-><
                        '---set--scID+scID2...;;:ocN+ocN2...;;:svc+svc2...;;--+---------------------------------+---'
                                                                        +-fixedweight--+-Número inteiro-+-+
                                                                        |              '-desativado-----' |
                                                                        +-requestsourceip--IPAd-----------+
                                                                        +-metricserveraddress--IPAd-------+
                                                                        '-metricserverport--portN---------'
 

report
Exibe características de serviços.
scID (switch consultant ID)
Uma sequência definida pelo usuário que representa o consultor.
OCName (ownercontent name)
Uma sequência definida pelo usuário que representa o nome do proprietário e a regra de conteúdo no comutador.
svc (service)
Uma sequência definida pelo usuário no comutador que representa o serviço.
set
Configura características de serviços.
fixedweight
Configura um peso fixo para este serviço. O padrão é off.
integer | off
Um número inteiro positivo no intervalo de 0 a 10 representando o peso fixo para este serviço ou a palavra off para especificar nenhum peso fixo.
requestsourceip
Configura o endereço a partir do qual contatar o serviço para solicitações de aplicativo.
IPAd (IP address)
O endereço IP a partir do qual contatar o serviço, como um nome simbólico ou um formato de endereço IP.
metricserveraddress
Configura o endereço no qual contatar o serviço para solicitações do servidor de métrica.
IPAd (IP address)
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.
portN (port number)
O número da porta usado para contatar o servidor de métrica.

Exemplos