Referência de Comando para Dispatcher e CBR

Este capítulo descreve como usar comandos dscontrol do Dispatcher. Esta também é uma referência de comando para o CBR.

Para as versões anteriores, quando o produto era conhecido como Network Dispatcher, o nome do comando de controle do Dispatcher era ndcontrol. O nome do comando de controle do Dispatcher é agora dscontrol. Assegure-se de atualizar todos os arquivos de script anteriores para usar dscontrol (não ndcontrol) para a configuração do Dispatcher.

O CBR usa um subconjunto dos comandos do Dispatcher listados nesta referência de comando. Durante o uso desses diagramas de sintaxe para CBR, substitua cbrcontrol para dscontrol. Para obter informações, consulte Diferenças de Configuração entre CBR e Dispatcher.

A lista a seguir contém os comandos anotados neste capítulo:

É possível inserir uma versão minimizada dos parâmetros de comando dscontrol. Você precisa apenas inserir as letras exclusivas dos parâmetros. Por exemplo, para obter ajuda sobre o comando file save, você poderá digitar dscontrol he f em vez de dscontrol help file.

Para inicializar a interface da linha de comandos: emita dscontrol para receber um prompt de comandos dscontrol.

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

Os valores de parâmetro de comando devem ser inseridos em caracteres no idioma inglês. As únicas exceções são nomes de host (usados em comandos de cluster, servidor e alta disponibilidade) e nomes de arquivo (usados em comandos de arquivo).

Diferenças de Configuração entre CBR e Dispatcher

A interface de linha de comandos do CBR é um subconjunto da interface de linha de comandos do Dispatcher. Para CBR, substitua o comando cbrcontrol em vez de dscontrol para configurar o componente.

Nota:
O componente Content Based Routing (CBR) não está disponível em plataformas que executam um JVM de 64 bits, exceto para HP-UX ia64. No HP-UX ia64, o componente CBR executa como um aplicativo de 32 bits. É possível usar o método de encaminhamento CBR do componente Dispatcher do Balanceador de Carga para fornecer roteamento baseado em conteúdo sem o uso do Caching Proxy. Consulte roteamento baseado em conteúdo do Dispatcher (Método de Encaminhamento CBR) para obter informações adicionais.

Alguns dos comandos que estão omitidos no CBR estão listados abaixo.

  1. alta disponibilidade
  2. subagent
  3. executor
  4. cluster
  5. port
  6. rule add {c:p:r} type port
  7. server

dscontrol advisor — controle do orientador

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--orientador--+-connecttimeout--name--+-port---------+--timeoutseconds---+-><
                          |                       '-cluster:port-'                   |
                          +-interval--name--+-port---------+--Segundos---------------+
                          |                 '-cluster:port-'                         |
                          +-list-----------------------------------------------------+
                          +-loglevel--name--+-port---------+--nível------------------+
                          |                 '-cluster:port-'                         |
                          +-logsize--name--+-port---------+--+-unlimited-----------+-+
                          |                '-cluster:port-'  '-número de registros-' |
                          +-receivetimeout--name--+-port---------+--timeoutseconds---+
                          |                       '-cluster:port-'                   |
                          +-report--name--+-port---------+---------------------------+
                          |               '-cluster:port-'                           |
                          +-retries--name--+-port---------+--numretries--------------+
                          |                '-cluster:port-'                          |
                          +-start--name--+-port---------+--+----------------+--------+
                          |              '-cluster:port-'  '-arquivo de log-'        |
                          +-status--name--+-port---------+---------------------------+
                          |               '-cluster:port-'                           |
                          +-stop--name--+-port---------+-----------------------------+
                          |             '-cluster:port-'                             |
                          +-tempo limite--name--+-port---------+--+-unlimited-+------+
                          |                     '-cluster:port-'  '-Segundos--'      |
                          '-versão--name--+-port---------+---------------------------'
                                          '-cluster:port-'
 

connecttimeout
Configure quanto tempo um orientador aguarda antes de relatar que uma conexão com um servidor para uma porta específica em um servidor (um serviço) falhou. Para obter informações adicionais, consulte o Tempo Limite de Conexão do Orientador e Tempo Limite de Recebimento para Servidores.
name
O nome do orientador. Possíveis valores incluem connect, db2, dns, ftp, http, https, cachingproxy, imap, ldap, ldaps, nntp, ping, pop3, self, sip, smtp, ssl, ssl2http, telnet, e wlm.

Consulte Lista de Orientadores para obter informações adicionais sobre os orientadores que o Balanceador de Carga fornece.

Os nomes dos orientadores customizados são do formato xxxx, em que ADV_xxxx é o nome da classe que implementa o orientador customizado. Consulte Criando Orientadores Customizados (Customizável) para obter informações adicionais.

port
O número da porta que o orientador está monitorando.
cluster:port
O valor de cluster é opcional nos comandos do orientador, mas o valor de porta é necessário. Se o valor de cluster não estiver especificado, o orientador iniciará a execução na porta para todos os clusters. Se você especificar um cluster, o orientador iniciará a execução na porta, mas apenas para o cluster especificado. Consulte Iniciando e Parando um Orientador para obter informações adicionais.

O cluster é o endereço no formato de endereço IP ou do nome simbólico. A porta é o número da porta que o orientador está monitorando.

timeoutseconds
Um número inteiro positivo que representa o tempo limite em segundos, no qual o orientador aguarda antes de relatar que uma conexão com um servidor falhou. O padrão é 3 vezes o valor especificado para o tempo de intervalo do orientador.
interval
Configura com que frequência o orientador consultará os servidores para obter informações.
seconds
Um número inteiro positivo que representa o número de segundos entre os pedidos para os servidores sobre seus status atuais. O padrão é 7.
list
Mostra uma lista de orientadores que fornecem atualmente informações para o gerenciador.
loglevel
Configura o nível de criação de log para o log de um orientador.
level
O número do nível (0 a 5). O padrão é 1. Quanto mais alto for o número, haverá mais informações que estão gravadas no log do orientador. Os seguintes são os valores possíveis: 0 é Nenhum, 1 é Mínimo, 2 é Básico, 3 é Moderado, 4 é Avançado, 5 é Detalhado.
logsize
Configura o tamanho máximo do log de um orientador. Ao configurar o tamanho máximo para o arquivo de log, o arquivo será quebrado; quando o arquivo atingir o tamanho especificado, as entradas subsequentes serão gravadas na parte superior do arquivo, sobrescrevendo as entradas de log anteriores. O tamanho do log não pode ser configurado como menor do que o seu tamanho atual. As 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ê configurar o nível de log, mais cuidadosamente deverá escolher o tamanho do log, porque o espaço pode se esgotar rapidamente quando efetuar login nos níveis superiores.
number of records
O tamanho máximo em bytes para o arquivo de log do orientador. É 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, porque as próprias entradas de log variam em tamanho. O valor padrão é 1 MB.
receivetimeout
Configure quanto tempo um orientador aguarda antes de relatar que um recebimento de uma porta específica em um servidor (um serviço) falhou. Para obter informações adicionais, consulte o Tempo Limite de Conexão do Orientador e Tempo Limite de Recebimento para Servidores.
timeoutseconds
Um número inteiro positivo que representa o tempo limite em segundos, no qual o orientador aguarda antes de relatar que um recebimento de um servidor falhou. O padrão é 3 vezes o valor especificado para o tempo de intervalo do orientador.
report
Exibir um relatório no estado do orientador.
retry
A nova tentativa configura o número de novas tentativas que um orientador pode fazer antes de marcar um servidor 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.
start
Iniciar o orientador. Há orientadores para cada protocolo. As portas padrão são as seguintes:
Nome do Orientador Protocolo Porta
cachingproxy HTTP (via Caching Proxy) 80
conectar ICMP 12345
db2 privado 50000
dns DNS 53
ftp FTP 21
http HTTP 80
https SSL 443
imap IMAP 143
ldap LDAP 389
ldaps SSL 443
nntp NNTP 119
ping PING 0
pop3 POP3 110
self privado 12345
sip SIP 5060
smtp SMTP 25
ssl SSL 443
ssl2http SSL 443
telnet Telnet 23
WLM privado 10.007
Nota:
O orientador FTP deve avisar apenas na porta de controle FTP (21). Não inicie um orientador FTP na porta de dados FTP (20).
log file
O nome do arquivo no qual os dados de gerenciamento estão registrados. Cada registro no log tem o registro de data e hora.

O arquivo padrão é advisorname_port.log, por exemplo, http_80.log. Para alterar o diretório no qual os arquivos de log são mantidos, consulte Alterando os Caminhos do Arquivo de Log. Os arquivos de log padrão para orientadores específicos ao cluster (ou site) são criados com o endereço do cluster, por exemplo, http_127.40.50.1_80.log.

status
Exiba o status atual de todos os valores em um orientador que pode ser configurado globalmente e seus padrões.
stop
Para o orientador.
tempo limite
Configura o número de segundos para o qual o gerenciador considerará as informações a partir do orientador como válidas. Se o gerenciador achar que as informações do orientador são mais antigas que esse período de tempo limite, o gerenciador não usará essas informações em determinados pesos para os servidores na porta que o orientador está monitorando. Uma exceção para esse tempo limite é quando o orientador informou ao gerenciador que um servidor específico está inativo. O gerenciador usará essas informações sobre o servidor mesmo após as informações do orientador expirarem.
seconds
Um número positivo que representa o número de segundos ou a palavra unlimited. O valor padrão é ilimitado.
version
Exibe a versão atual do orientador.

Exemplos

dscontrol binlog — controle do arquivo de log binário

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--binlog--+-start-----------------------+----------><
                      +-stop------------------------+
                      +-set--+-retention--hours---+-+
                      |      '-interval--Segundos-' |
                      '-status----------------------'
 

start
Inicia o log binário.
stop
Para o log binário.
set
Configura campos de criação de log binário. Para obter informações adicionais sobre como configurar campos para criação de log binário, consulte Usando Criação de Log Binário para Analisar Estatísticas do Servidor.
retention
O número de horas que os arquivos de log binário são mantidos. O valor padrão da retention é 24.
hours
O número de horas.
interval
O número de segundos entre as entradas de log. O valor padrão do interval é 60.
seconds
O número de segundos.
status
Mostra a retenção e os intervalos do log binário.

cluster udscontrol — configurar clusters

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--cluster--+-add--cluster+c2+...;;--+--------------------------------------+-+-><
                       |                      +-address--address---------------------+ |
                       |                      +-proporções--ativo--new--port--system-+ |
                       |                      +-maxports--size-----------------------+ |
                       |                      +-maxservers--size---------------------+ |
                       |                      +-tempo de permanência--time-----------+ |
                       |                      +-weightbound--peso--------------------+ |
                       |                      +-porttype--da mensagem----------------+ |
                       |                      +-primaryhost--address-----------------+ |
                       |                      +-staletimeout--staletimeout-----------+ |
                       |                      '-sharedbandwidth--size----------------' |
                       +-set--cluster+c2+...;;--+-proporções--ativo--new--port--system-+-+
                       |                      +-maxports--size-----------------------+ |
                       |                      +-maxservers--size---------------------+ |
                       |                      +-tempo de permanência--time-----------+ |
                       |                      +-weightbound--peso--------------------+ |
                       |                      +-porttype--da mensagem----------------+ |
                       |                      +-primaryhost--address-----------------+ |
                       |                      +-staletimeout--staletimeout-----------+ |
                       |                      '-sharedbandwidth--size----------------' |
                       +-remove--cluster-----------------------------------------------+
                       +-report--cluster-----------------------------------------------+
                       '-status--cluster-----------------------------------------------'
 

add
Inclua este cluster. Você deve definir pelo menos um cluster.
cluster
O nome do cluster ou o endereço ao qual os clientes se conectam. O valor do cluster é um nome simbólico ou está no formato de endereço IP. Um valor do cluster de 0.0.0.0 pode ser usado para especificar um cluster curinga. Consulte Usar Cluster Curinga para Combinar Configurações do Servidor para obter informações adicionais.

Com a exceção do comando dscontrol cluster add, é possível usar dois pontos (:) para agir como um curinga. Por exemplo, o comando a seguir, dscontrol cluster set : weightbound 80, resultará na configuração de weightbound como 80 para todos os clusters.

Nota:
Os clusters adicionais são separados por um sinal de mais (+).
endereço
O endereço IP exclusivo da máquina TCP como um nome do host ou no formato de endereço IP. Se o valor do cluster não puder ser resolvido, você deverá fornecer esse endereço IP do máquina física.
Nota:
O endereço se aplica apenas ao componente Dispatcher.
endereço
Valor do endereço do cluster.
proportions
No nível do cluster, configure a proporção de importância de conexões ativas (ativas), novas conexões (novas), informações de orientadores (porta) e informações de um programa de monitoramento de sistema, como o Metric Server (sistema) que são usadas pelo gerenciador para configurar pesos do servidor. Cada um desses valores, descritos a seguir, é expresso como uma porcentagem do total e portanto, sempre com o total de 100. Para obter informações adicionais, consulte Proporção de Importância Fornecida às Informações de Status.
active
Um número de 0 a 100 que representa a proporção de peso a ser fornecida para as conexões ativas. O padrão é 50.
new
Um número de 0 a 100 que representa a proporção de peso a ser fornecida para as novas conexões. O padrão é 50.
port
Um número de 0 a 100 que representa a proporção de peso a ser fornecida para as informações de orientadores. O padrão é 0.
Nota:
Quando um orientador for iniciado e se a proporção da porta for 0, o Balanceador de Carga configurará automaticamente esse valor como 1, para que o gerenciador use as informações do orientador como entrada para calcular o peso do servidor.
system
Um número de 0 a 100 que representa a proporção de peso a ser fornecida para as informações das métricas do sistema, como do Metric Server. O padrão é 0.
maxports
O número máximo de portas. O valor padrão de maxports é 8.
size
O número de portas permitido.
maxservers
O número máximo padrão de servidores por porta. Ele pode ser substituído para portas individuais usando port maxservers. O valor padrão de maxservers é 32.
size
O número de servidores permitido em uma porta.
tempo de permanência
O tempo de permanência padrão para portas a serem criadas. Ele pode ser substituído para portas individuais usando tempo de permanência da porta. O valor padrão de stickytime é 0.
Nota:
Para o método de encaminhamento cbr do Dispatcher, se você configurar stickytime (para um valor diferente de zero), o tempo de permanência da porta será ativado se a porta for SSL (e não HTTP). Se o tempo de permanência para as portas a serem criadas for não zero e a nova porta incluída for SSL, a afinidade de ID de SSL será ativada para a porta. Para desativar a afinidade de ID de SSL na porta, você precisará configurar explicitamente o tempo de permanência da porta como 0.
time
O valor do tempo de permanência em segundos.
weightbound
O limite de peso da porta padrão. Ele pode ser substituído para portas individuais usando port weightbound. O valor padrão de weightbound é 20.
weight
O valor de weightbound.
porttype
O tipo de porta padrão. Ele pode ser substituído para portas individuais usando port porttype.
tipo
Os possíveis valores são tcp, udp e both.
primaryhost
O endereço NFA dessa máquina do Dispatcher ou o endereço NFA da máquina do Dispatcher de backup. Em uma alta disponibilidade mútua configuração, um cluster está associado com a máquina primária ou de backup.

Se alterar o primaryhost de um cluster após principal e backups já estarem iniciados e executando alta disponibilidade mútua, você também deverá forçar o novo host principal a assumir o controle. E será necessário atualizar os scripts e desconfigurar e configurar manualmente o cluster de forma correta. Consulte Alta disponibilidade mútua para obter informações adicionais.

address
O valor do endereço do primaryhost. O padrão é o endereço NFA dessa máquina.
staletimeout
O número de segundos durante os quais não poderá haver nenhuma atividade em uma conexão antes que a conexão seja removida. O padrão para FTP é 900; o padrão para Telnet é 259,200. O padrão para todos os outros protocolos é 300. Ele pode ser substituído para portas individuais usando port staletimeout. Consulte Usando o Valor de Tempo Limite Obsoleto para obter informações adicionais.
staletimout
O valor de staletimeout.
sharedbandwidth
A quantidade máxima de largura de banda (em kilobytes por segundo) que pode ser compartilhada no nível do cluster. Para obter mais informações sobre largura de banda compartilhada, consulte Usando Regras com Base na Largura da Banda Reservada e Largura da Banda Compartilhada e Regra de Largura da Banda Compartilhada.
Nota:
A largura de banda compartilhada aplica-se ao componente Dispatcher.
size
O tamanho de sharedbandwidth é um valor de número inteiro. O padrão é zero. Se o valor for zero, a largura da banda não poderá ser compartilhada no nível do cluster.
set
Configurar as propriedades do cluster.
remove
Remover esse cluster.
report
Mostre os campos internos do cluster.
Nota:
O relatório se aplica ao componente Dispatcher.
status
Mostre o status atual de um cluster específico.

Exemplos

executor dscontrol — controle do executor

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--executor--+-report--------------------------------------------------------------------+-><
                        +-set--+-nfa--Endereço IP-----------+---------------------------------------+
                        |      +-maxclusters--size----------+                                       |
                        |      +-maxports--size-------------+                                       |
                        |      +-fintimeout--fintimeout-----+                                       |
                        |      +-hatimeout--time------------+                                       |
                        |      +-hasynctimeout--time--------+                                       |
                        |      +-maxservers--size-----------+                                       |
                        |      +-mss--size------------------+                                       |
                        |      +-staletimeout--staletimeout-+                                       |
                        |      +-tempo de permanência--time-+                                       |
                        |      +-clientgateway--address-----+                                       |
                        |      +-weightbound--peso----------+                                       |
                        |      +-porttype--da mensagem------+                                       |
                        |      +-wideportnumber--port-------+                                       |
                        |      '-sharedbandwidth--size------'                                       |
                        +-configurar--interface_address+i2+...--+---------------------------------+-+
                        |                                       '-interface_name--máscara de rede-' |
                        +-desconfigurar--interface_address------------------------------------------+
                        +-start---------------------------------------------------------------------+
                        +-status--------------------------------------------------------------------+
                        '-stop----------------------------------------------------------------------'
 

report
Exiba um relatório de captura instantânea de estatísticas. Por exemplo: total de pacotes recebidos, pacotes descartados, pacotes encaminhados com erros, etc.
Nota:
O relatório se aplica ao componente Dispatcher.
set
Configurar os campos do executor.
nfa
Configure o nonforwarding address. Qualquer pacote enviado para esse endereço não será encaminhado pela máquina do Dispatcher.
Nota:
O NFA aplica-se ao componente Dispatcher.
IP address
O endereço de Protocolo da Internet como um nome simbólico ou no formato decimal pontuado.
maxclusters
O número máximo de clusters que pode ser configurado. O valor padrão de maxclusters é 100.
size
O número máximo de clusters que pode ser configurado.
maxports
O valor padrão de maxports para clusters a serem criados. Ele pode ser substituído pelo comando cluster set ou cluster add. O valor padrão de maxports é 8.
size
O número de portas.
fintimeout
O número de segundos para manter uma conexão na memória após ela ser colocada no estado FIN. O valor de fintimeout padrão é 30.
fintimeout
O valor de fintimeout.
Nota:
Fintimeout aplica-se ao componente Dispatcher.
hatimeout
O número de segundos que o executor usa para definir o tempo limite de pulsações de alta disponibilidade. O valor padrão é 2.
Nota:
O valor de hatimeout aplica-se ao componente Dispatcher.
time
O valor de hatimeout.
hasynctimeout
O número de segundos que o executor usa para definir o tempo limite da replicação de registros de conexão entre a máquina principal e a máquina de backup. O valor padrão é 50.

O cronômetro é usado para garantir que as máquinas principal e de backup tentem se sincronizar. No entanto, se houver muitas conexões existentes e a máquina ativa continuar a manipular um carregamento de tráfego recebido significativo, a sincronização poderá não ser concluída antes do cronômetro expirar. Como resultado, o Balanceador de Carga tentará se sincronizar novamente de modo incessante, e as duas máquinas nunca serão sincronizadas. Se esta situação ocorrer, configure o hasynctimeout como o valor maior do que o padrão para fornecer tempo suficiente às duas máquinas para a troca de informações sobre conexões existentes. Para configurar este cronômetro, o comando hasynctimeout deverá ser emitido depois do comando dscontrol executor start, mas antes de emitir os comandos de alta disponibilidade (dscontrol highavailability).

Nota:
O valor de hasynctimeout aplica-se ao componente Dispatcher.
time
O valor de hasynctimeout.
maxservers
O número máximo padrão de servidores por porta. Ele pode ser substituído pelo comando cluster ou port. O valor padrão de maxservers é 32.
mss
O número máximo de bytes no segmento de dados da conexão TCP/UDP. O número de bytes no segmento de dados e o cabeçalho devem incluir no máximo menos do que o número de bytes na unidade máxima de transmissão (MTU). O valor padrão de mss é 1460.
Nota:
O tamanho do segmento máximo se aplica apenas ao método de encaminhamento nat ou cbr do componente Dispatcher.
size
O número de servidores.
staletimeout
O número de segundos durante os quais não poderá haver nenhuma atividade em uma conexão antes que a conexão seja removida. O padrão para FTP é 900; o padrão para Telnet é 259,200. O padrão para todas as outras portas é 300. Ele pode ser substituído pelo comando cluster ou port. Consulte Usando o Valor de Tempo Limite Obsoleto para obter informações adicionais.
staletimeout
O valor de staletimeout.
tempo de permanência
O valor do tempo de permanência da porta padrão para todos os clusters futuros. Ele pode ser substituído pelo comando cluster ou port. O valor de tempo de permanência padrão é 0.
time
O valor do tempo de permanência em segundos.
clientgateway
Clientgateway é um endereço IP usado para NAT/NAPT ou Roteamento baseado em conteúdo do Dispatcher. Esse é o endereço do roteador pelo qual o tráfego na direção de retorno é encaminhado do Balanceador de Carga para os clientes. Clientgateway deve ser configurado para um valor de não zero antes da inclusão de uma porta com um método de encaminhamento de NAT/NAPT ou Roteamento baseado em conteúdo do Dispatcher. Consulte NAT/NAPT do Dispatcher (Método de Encaminhamento NAT) e roteamento baseado em conteúdo do Dispatcher (Método de Encaminhamento CBR) para obter informações adicionais.
Nota:
Clientgateway aplica-se apenas ao componente Dispatcher.
address
O endereço do clientgateway como um nome simbólico ou em formato de número com decimal. O padrão é 0.0.0.0.
weightbound
O valor de weightbound da porta padrão para todas as portas futuras. Ele pode ser substituído pelo comando cluster ou port. O valor de weightbound padrão é 20.
weight
O valor de weightbound.
porttype
O valor de porttype da porta padrão para todas as portas futuras. Ele pode ser substituído pelo comando cluster ou port.
Nota:
Porttype aplica-se ao componente Dispatcher.
tipo
Os possíveis valores são tcp, udp e both.
wideportnumber
Uma porta TCP não usada em cada máquina do Dispatcher. O wideportnumber deve ser o mesmo para todas as máquinas do Dispatcher. O valor padrão de wideportnumber é 0, indicando que o suporte à longa distância não está em uso.
Nota:
Wideportnumber aplica-se ao componente Dispatcher.
port
O valor de wideportnumber.
sharedbandwidth
A quantidade máxima de largura da banda (em kilobytes por segundo) que pode ser compartilhada no nível do executor. Para obter mais informações sobre largura de banda compartilhada, consulte Usando Regras com Base na Largura da Banda Reservada e Largura da Banda Compartilhada e Regra de Largura da Banda Compartilhada.
Nota:
A largura de banda compartilhada aplica-se ao componente Dispatcher.
size
O tamanho de sharedbandwidth é um valor de número inteiro. O padrão é zero. Se o valor for zero, a largura da banda não poderá ser compartilhada no nível do executor.
configurar
Configure um endereço (por exemplo, um endereço do cluster, endereço de retorno ou endereço de pulsação de alta disponibilidade) como a placa da interface de rede da máquina do Dispatcher. Ele é conhecido também como a configuração de um alias na máquina do Dispatcher.
Nota:
Configure aplica-se ao componente Dispatcher.
interface_address
O endereço como um nome simbólico ou no formato de endereço IP.
Nota:
Os endereços da interface adicionais são separados por um sinal de mais (+).
interface_name netmask
Ela apenas será necessária, se o endereço não corresponder a nenhuma sub-rede para endereços existentes. O interface_name pode ter um valor, como: en0, eth1, eri0. A netmask é a máscara de 32 bits usada para identificar os bits do endereço da sub-rede na parte do host de um endereço IP.
unconfigure
Exclui o endereço de alias da placa da interface de rede.
Nota:
Unconfigure aplica-se ao componente Dispatcher.
start
Iniciar o executor.
status
Exibe o status atual dos valores no executor que podem ser configurados e seus padrões.
stop
Para o executor.
Nota:
Stop aplica-se ao Dispatcher e ao CBR.

Exemplos

arquivo dscontrol — gerenciar arquivos de configuração

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--file--+-delete--arquivo[.ext]----------+---------><
                    +-appendload--arquivo[.ext]------+
                    +-report-------------------------+
                    +-save--arquivo[.ext]--+-------+-+
                    |                      '-force-' |
                    '-newload--arquivo[.ext]---------'
 

delete
Excluir o arquivo.
arquivo[.ext]
Um arquivo de configuração que consiste em comando dscontrol.

A extensão do arquivo (.ext) pode ser qualquer coisa que você deseje e pode ser omitido.

appendload
Para atualizar a configuração atual, o comando appendload executa comandos executáveis do arquivo de script.
report
Relate no arquivo ou arquivos disponíveis.
save
Salve a configuração atual do Balanceador de Carga no arquivo.
Nota:
Arquivos são salvos nos / carregados dos seguintes diretórios, em que component é dispatcher ou cbr:
  • Sistemas operacionais AIX, HP-UX, Linux e Solaris: /opt/ibm/edge/lb/servers/configurations/component
  • Sistemas operacionais Windows: <install_root>ibm\edge\lb\servers\configurations\component
force
Para salvar seu arquivo em um arquivo existente do mesmo nome, use Force para excluir o arquivo existente antes de salvar o novo arquivo. Se você não usar a opção Force, o arquivo existente não será sobrescrito.
newload
Carrega e executa um novo arquivo de configuração no Balanceador de Carga. O novo arquivo de configuração substitui a configuração atual.

Exemplos

Ajuda do dscontrol — exibir ou imprimir a ajuda para este comando

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--help--+-orientador-----------+-------------------><
                    +-binlog---------------+
                    +-cluster--------------+
                    +-executor-------------+
                    +-file-----------------+
                    +-help-----------------+
                    +-alta disponibilidade-+
                    +-Host-----------------+
                    +-logstatus------------+
                    +-manager--------------+
                    +-metric---------------+
                    +-port-----------------+
                    +-regra----------------+
                    +-server---------------+
                    +-set------------------+
                    +-status---------------+
                    '-subagent-------------'
 

Exemplos

alta disponibilidade de dscontrol — controle de alta disponibilidade

Nota:
O diagrama de sintaxe de alta disponibilidade dscontrol aplica-se apenas ao componente Dispatcher.
Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--highavailability--+-status--------------------------------------+-><
                                +-backup--+-add--+-primary-+--+-auto---+--p-+-+
                                |         |      +-backup--+  '-manual-'    | |
                                |         |      '-both----'                | |
                                |         '-delete--------------------------' |
                                +-reach--+-add----+--address--mask------------+
                                |        '-delete-'                           |
                                +-heartbeat--+-add--srcaddress--dstaddress-+--+
                                |            '-delete--address-------------'  |
                                '-takeover--+---------+-----------------------'
                                            '-address-'
 

status
Retornar um relatório sobre alta disponibilidade. As máquinas são identificadas como tendo uma das três condições de status ou estados:
Active
Uma determinada máquina (uma principal, de backup ou ambas) está roteando pacotes.
Standby
Uma determinada máquina (uma principal, de backup ou ambas) não está roteando pacotes; ela está monitorando o estado de um Dispatcher active.
Idle
Uma determinada máquina está roteando pacotes, e não está tentando estabelecer contato com seu Dispatcher parceiro.
Além disso, a palavra-chave status retorna informações sobre vários subestados:
Synchronized
Uma determinada máquina estabeleceu contato com outro Dispatcher.
Outros subestados
Esta máquina está tentando estabelecer contato com seu Dispatcher parceiro, mas ainda não obteve êxito.
backup
Especifique as informações para a máquina principal ou de backup.
add
Define e executa as funções de alta disponibilidade para esta máquina.
primary
Identifica a máquina Dispatcher que tem uma função primary.
backup
Identifica a máquina Dispatcher que tem uma função de backup.
ambos
Identifica a máquina do Dispatcher que tem ambas as funções principal e de backup. Esse é o recurso de alta disponibilidade mútua no qual as funções principal e de backup são associadas por conjunto de cluster. Consulte Alta disponibilidade mútua para obter informações adicionais.
auto
Especifica uma estratégia de recuperação automática, na qual a máquina principal continuará a rotear pacotes, assim que voltar ao serviço.
manual
Especifica uma estratégia de recuperação manual, na qual a máquina principal não continua a rotear pacotes até que o administrador emita um comando takeover.
p[orta]
Uma porta TCP não utilizada nas duas máquinas, a ser usada pelo Dispatcher para suas mensagens de pulsação. A port deve ser a mesma para ambas as máquinas, principal e de backup.
delete
Remove esta máquina da alta disponibilidade, para que ela não seja mais usada como uma máquina de backup ou principal.
alcance
Ao incluir ou excluir o endereço de destino para os Dispatchers principais e de backup, o orientador de alcance manda pings dos Dispatchers de backup e principal para determinar quão atingíveis são os seus destinos.
Nota:
Ao configurar o destino de alcance, será necessário iniciar também o orientador de alcance. O orientador de alcance é iniciado automaticamente pela função de gerenciador.
add
Inclui um endereço de destino para o orientador de alcance.
delete
Remove um endereço de destino do orientador de alcance.
address
Endereço IP (formato de endereço IP ou simbólico) no nó de destino.
mask
Uma máscara de sub-rede.
pulsação
Define uma sessão de comunicação entre as máquinas Dispatcher principal e de backup.
add
Informe o Dispatcher de origem, o endereço de seu parceiro (endereço de destino).
srcaddress
Endereço de origem. O endereço (IP ou simbólico) desta máquina Dispatcher.
dstaddress
Endereço de destino. O endereço (IP ou simbólico) da outra máquina Dispatcher.
Nota:
O srcaddress e o dstaddress devem ser os NFAs das máquinas para pelo menos um par de pulsações.
delete
Remove o par de endereços das informações de pulsação. É possível especificar o endereço de destino ou de origem do par de pulsações.
address
O endereço (IP ou simbólico) do destino ou da origem.
takeover
Configuração simples de alta disponibilidade (a função das máquinas do Dispatcher é principal ou de backup):
  • O controle instrui um Dispatcher de espera para se tornar ativo e começar a rotear pacotes. Isso força o Dispatcher ativo atualmente a ficar em espera. O comando takeover deve ser emitido na máquina em espera e funciona apenas quando a estratégia for manual. O subestado deve ser sincronizado.
A configuração de alta disponibilidade mútua (a função de cada máquina do Dispatcher é ambas):
  • A máquina do Dispatcher com o recurso de alta disponibilidade mútua contém dois clusters que correspondem aos do seu parceiro. Um dos clusters é considerado o cluster principal (o cluster de backup do parceiro) e o outro é o cluster de backup (o cluster principal do parceiro). O controle instrui a máquina do Dispatcher a iniciar o roteamento para o(s) cluster(s) da outra máquina. O comando takeover só pode ser emitido quando o(s) cluster(s) da máquina do Dispatcher está(ão) no estado de espera e no subestado sincronizado. Isso forçará o(s) cluster(s) atualmente ativo(s) do parceiro a mudar para o estado de espera. O comando takeover trabalha somente quando a estratégia é manual. Consulte Alta disponibilidade mútua para obter informações adicionais.
Notas:
  1. Observe que as funções das máquinas (principal, backup, ambas) não são alteradas. Apenas seu status relativo (ativo ou em espera) é alterado.
  2. Existem três scripts de controle: goActive, goStandby e goInOp. Consulte Utilizando Scripts.
address
O valor do endereço de controle é opcional. Ele deve ser usado apenas quando as funções da máquina forem ambas principal e de backup (configuração mútua de alta disponibilidade). O endereço especificado é o NFA da máquina do Dispatcher, que normalmente roteia o tráfego deste cluster. Quando houver um controle dos dois clusters, especifique o próprio endereço de NFA do Dispatcher.

Exemplos

dscontrol host — configure uma máquina remota

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--host:--remote_host-------------------------------><
 

remote_host
O nome da máquina remota do Balanceador de Carga sendo configurada. Ao digitar esse comando, certifique-se de que não haja espaço entre host: e remote_host, por exemplo:
dscontrol host:remote_host
Após esse comando ser emitido no prompt de comandos, insira qualquer comando dscontrol válido que deseja emitir para a máquina remota do Balanceador de Carga.

status do log dscontrol — exibir configurações de log do servidor

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--logstatus----------------------------------------><
 

logstatus
Exibe as configurações de log do servidor (nome do arquivo de log, nível de criação de log e tamanho do log).

Exemplos

Para exibir o status do log:

dscontrol logstatus

Este comando produz saída semelhante à:

Dispatcher Log Status:
------------------------------
Log filename ............... C:\PROGRA~1\IBM\edge\lb\servers\logs\dispatcher
\server.log
Log level .................. 1
Maximum log size (bytes) ... 1048576

dscontrol manager — controle do gerenciador

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--manager--+-interval--Segundos---------------------+-><
                       +-loglevel--nível------------------------+
                       +-logsize--+-unlimited-+-----------------+
                       |          '-bytes-----'                 |
                       +-metric set--+-loglevel--nível--------+-+
                       |             '-logsize--+-unlimited-+-' |
                       |                        '-bytes-----'   |
                       +-quiesce--server--+-----+---------------+
                       |                  '-now-'               |
                       +-reach set--+-interval--Segundos-----+--+
                       |            +-loglevel--nível--------+  |
                       |            '-logsize--+-unlimited-+-'  |
                       |                       '-bytes-----'    |
                       +-refresh--ciclo de atualização----------+
                       +-report--+----------------+-------------+
                       |         '-cluster+c2+...-'             |
                       +-restart--Mensagem----------------------+
                       +-sensitivity--peso----------------------+
                       +-smoothing--índice de suavização--------+
                       +-start--+-----------------------------+-+
                       |        '-arquivo de log--metric_port-' |
                       +-status---------------------------------+
                       +-stop-----------------------------------+
                       +-unquiesce--server----------------------+
                       '-versão---------------------------------'
 

interval
Configure a frequência com que o gerenciador atualizará os pesos dos servidores para o executor, atualizando os critérios que o executor usa para rotear pedido de clientes.
seconds
Um número positivo que representa em segundos, a frequência com que o gerenciador atualizará os pesos para o executor. O padrão é 2.
loglevel
Configura o nível de criação de log para o log do gerenciador.
level
O número do nível (0 a 5). Quanto maior o número, mais informações serão gravadas no log do gerenciador. O padrão é 1. A seguir há os valores possíveis: 0 é Nenhum, 1 é Mínimo, 2 é Básico, 3 é Moderado, 4 é Avançado e 5 é Detalhado.
logsize
Configura o tamanho máximo do log do gerenciador. Ao configurar o tamanho máximo para o arquivo de log, o arquivo será quebrado; quando o arquivo atingir o tamanho especificado, as entradas subsequentes serão gravadas na parte superior do arquivo, sobrescrevendo as entradas de log anteriores. O tamanho do log não pode ser configurado como menor do que o seu tamanho atual. As 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ê configurar o nível de log, mais cuidadosamente deverá escolher o tamanho do log, porque o espaço pode se esgotar rapidamente quando efetuar login nos níveis superiores.
bytes
O tamanho máximo em bytes para o arquivo de log do gerenciador. É 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, porque as próprias entradas de log variam em tamanho. O valor padrão é 1 MB.
metric set
Configura o loglevel e o logsize para o log do monitor de métrica. O nível de log é o nível de criação de log do monitor de métrica (0 - Nenhum, 1 - Mínimo, 2 - Básico, 3 - Moderado, 4 - Avançado ou 5 - Detalhado). O nível de log padrão é 1. O tamanho do log é o número máximo de bytes a serem registrados no arquivo de log do monitor de métrica. É possível especificar um número positivo maior que zero ou unlimited. O tamanho do log padrão é 1 MB.
quiesce
Não especifique mais conexões a serem enviadas a um servidor, exceto as novas conexões subsequentes do cliente para o servidor em quiesce, se a conexão for designada como permanente e o tempo de permanência não tiver sido expirado. O gerenciador configura o peso para esse servidor como 0 em cada porta para a qual ele está definido. Use esse comando, se desejar fazer alguma manutenção rápida em um servidor e, em seguida tirá-lo do modo de quiesce. Se você excluir um servidor em quiesce da configuração e, em seguida, incluí-lo novamente, ele não reterá seu status antes de estar em quiesce. Para obter informações adicionais, consulte o Manipulação da Conexão do Servidor em Quiesce.
server
O endereço IP do servidor como um nome simbólico ou em formato decimal pontuado.

Ou então, se você usou um particionamento de servidor, use o nome exclusivo do servidor lógico. Consulte Particionamento do Servidor: Servidores Lógicos Configurados como um Servidor Físico (endereço IP) para obter informações adicionais.

now
Use apenas suspender “agora”, se você tiver configurado o tempo de permanência e desejar que novas conexões sejam enviadas para outro servidor (diferente do servidor em quiesce) antes do tempo de permanência expirar. Para obter informações adicionais, consulte o Manipulação da Conexão do Servidor em Quiesce.
reach set
Configura o intervalo, o nível de log e o tamanho do log para o orientador de alcance.
refresh
Configure o número de intervalos antes de consultar o executor para uma atualização de informações sobre conexões novas e ativas.
refresh cycle
Um número positivo que representa o número de intervalos. O padrão é 2.
report
Exiba um relatório de captura instantânea de estatísticas.
cluster
O endereço do cluster que você deseja que seja exibido no relatório. O endereço pode ser um nome simbólico ou no formato de endereço IP. O padrão é uma exibição de relatório do gerenciador para todos os clusters.
Nota:
Os clusters adicionais são separados por um sinal de mais (+).
restart
Reinicie todos os servidores (que não estão inativos) para os pesos normalizados (metade do peso máximo).
message
Uma mensagem que você deseja que seja gravada no arquivo de log do gerenciador.
sensitivity
Configura a sensibilidade máxima para quais pesos serão atualizados. Essa configuração define quando o gerenciador deve alterar o peso para o servidor com base nas informações externas.
weight
Um número de 1 a 100 a ser usado como porcentagem de peso. O padrão 5 cria uma sensibilidade mínima de 5%.
smoothing
Configura o índice que suaviza a variação no peso quando efetuar o balanceamento de carga. Um índice de suavização superior fará com que os pesos do servidor sejam alterados menos drasticamente, conforme as condições da rede são alteradas. Um índice inferior fará com que os pesos do servidor seja alterado mais drasticamente.
index
Um número de vírgula flutuante. O padrão é 1.5.
start
Inicie o gerenciador.
log file
O nome do arquivo no qual os dados do gerenciador estão registrados. Cada registro no log tem o registro de data e hora.

O arquivo padrão é instalado no diretório logs. Consulte Apêndice C. Arquivos de Configuração de Amostra. Para alterar o diretório no qual os arquivos de log são mantidos, consulte Alterando os Caminhos do Arquivo de Log.

metric_port
A porta que o Metric Server usará para relatar os carregamentos do sistema. Se você especificar uma porta métrica, deverá especificar um nome do arquivo de log. A porta métrica padrão é 10004.
status
Exiba o status atual de todos os valores no gerenciador que pode ser configurado globalmente e seus padrões.
stop
Para o gerenciador.
unquiesce
Especifique se o gerenciador pode começar a fornecer um peso superior a 0 para um servidor que ficou no modo de quiesce anteriormente, em cada porta para a qual ele está definido.
server
O endereço IP do servidor como um nome simbólico ou em formato decimal pontuado.
version
Exibe a versão atual do gerenciador.

Exemplos

dscontrol metric — configurar métricas do sistema

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--metric--+-add--cluster+c2+...+cN:metric+metric1+...+metricN--------------+-><
                      +-remove--cluster+c2+...+cN:metric+metric1+...+metricN-----------+
                      +-proportions--cluster+c2+...+cN proportion1 prop2 prop3...propN-+
                      '-status--cluster+c2+...+cN:metric+metric1+...+metricN-----------'
 

add
Inclua a métrica especificada.
cluster
O endereço para o qual os clientes se conectam. O endereço pode ser o nome do host da máquina ou o formato de anotação do endereço IP. Os clusters adicionais são separados por um sinal de mais (+).
metric
O nome da métrica do sistema. Ele deve ser o nome de um executável ou arquivo de script no diretório de script do servidor de métrica.
remove
Remove a métrica especificada.
proportions
Configura as proporções para todas as métricas associadas a esse objeto.
status
Exibe os valores atuais dessa métrica.

Exemplos

dscontrol port — configurar portas

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--port--+-add--cluster:port--+----------------------------+-+-><
                    |                    +-crossport--otherport-------+ |
                    |                    +-maxservers--size-----------+ |
                    |                    +-stickymask--value----------+ |
                    |                    +-tempo de permanência--time-+ |
                    |                    +-method--da mensagem--------+ |
                    |                    +-staletimeout--value--------+ |
                    |                    +-weightbound--peso----------+ |
                    |                    +-porttype--da mensagem------+ |
                    |                    +-protocol--da mensagem------+ |
                    |                    '-reset--value---------------' |
                    +-set--cluster:port--+-crossport--otherport-------+-+
                    |                    +-maxservers--size-----------+ |
                    |                    +-stickymask--value----------+ |
                    |                    +-tempo de permanência--time-+ |
                    |                    +-staletimeout--value--------+ |
                    |                    +-weightbound--peso----------+ |
                    |                    +-porttype--da mensagem------+ |
                    |                    +-maxhalfopen--value---------+ |
                    |                    '-reset--value---------------' |
                    +-remove--cluster:port------------------------------+
                    +-report--cluster:port------------------------------+
                    +-status--cluster:port------------------------------+
                    '-halfopenaddressreport--cluster:port---------------'
 

add
Inclui uma porta em um cluster. Você deve incluir uma porta em um cluster antes de poder incluir qualquer servidor nessa porta. Se não houver nenhuma porta para um cluster, todos os pedidos do cliente serão processados localmente. Você pode incluir mais de uma porta de uma vez usando esse comando.
cluster
O endereço do cluster como um nome simbólico ou no formato de endereço IP. Você pode usar dois pontos (:) para atuar como um caractere curinga. Por exemplo, o comando a seguir, dscontrol port add :80, resultará na inclusão da porta 80 em todos os clusters.
Nota:
Os clusters adicionais são separados por um sinal de mais (+).
port
O número da porta. Um valor de número da porta igual a 0 (zero) pode ser usado para especificar uma porta curinga.
Nota:
Portas adicionais são separadas com um sinal de mais (+).
crossport
Crossport permite expandir o recurso de permanência/afinidade em diversas portas para que as solicitações de clientes recebidas em diferentes portas ainda possam ser enviadas para o mesmo servidor para solicitações subsequentes. Para o valor de crossport, especifique o número de otherport para o qual deseja compartilhar o recurso de afinidade de crossport. Para usar esse recurso, as portas deverão:
  • compartilhar o mesmo endereço de cluster
  • compartilhar os mesmos servidores
  • ter o mesmo valor de tempo de permanência (não zero)
  • ter o mesmo valor de tempo de permanência
Para remover o recurso de crossport, configure o valor de crossport novamente para seu próprio número de porta. Para obter mais informações sobre o recurso de afinidade de crossport, consulte Afinidade de Porta Cruzada.
Nota:
Crossport aplica-se apenas aos métodos de encaminhamento MAC e NAT/NATP do componente Dispatcher.
otherport
O valor de crossport. O valor padrão é o mesmo que o próprio número de port.
maxservers
O número máximo de servidores. O valor padrão de maxservers é 32.
size
O valor de maxservers.
stickymask
A máscara de endereço de afinidade pedidos do cliente recebidos dos grupos de recursos baseados nos endereços de sub-redes comuns. Quando um pedido do cliente faz primeiro uma conexão com a porta, todos os pedidos subsequentes de clientes com o mesmo endereço de sub-rede (designados por essa parte do endereço IP que está sendo mascarado) são direcionados para o mesmo servidor. Para ativar stickymask, o tempo de permanência da porta deverá ter um valor de não zero. Consulte Máscara de Endereço de Afinidade (stickymask) para obter informações adicionais.
Nota:
A palavra-chave stickymask aplica-se apenas ao componente Dispatcher.
value
O valor de stickymask é o número de bits de ordem superior do endereço IP de 32 bits que você deseja mascarar. Os valores possíveis são: 8, 16, 24 e 32. O valor padrão é 32, o que desativa o recurso de máscara de endereço de afinidade.
tempo de permanência
O intervalo entre o fechamento de uma conexão e a abertura de uma nova conexão, durante o qual um cliente será enviado de volta ao mesmo servidor usado durante a primeira conexão. Após o tempo de permanência, o cliente pode ser enviado a um servidor diferente do primeiro.

Para o componente Dispatcher:

  • Para o método de encaminhamento cbr do Dispatcher
    • Só é possível configurar o tempo de permanência (para um valor diferente de zero) em uma porta SSL (não HTTP) porque a configuração do tempo de permanência ativa a afinidade de ID de SSL.
    • Se você configurar o tempo de permanência da porta, o tipo de afinidade na regra deverá ser nenhum (padrão). A afinidade baseada em regra (cookie passivo, URI) não pode coexistir quando o tempo de permanência estiver configurado na porta.
  • Para os métodos de encaminhamento mac e nat do Dispatcher
    • Se você configurar o tempo de permanência da porta (para um valor de não zero), não será possível configurar um tipo de afinidade na regra. A afinidade baseada em regra não pode coexistir quando o tempo de permanência estiver configurado na porta.
    • A configuração do valor do tempo de permanência da porta ativa a afinidade de endereço IP.

Para o componente CBR: Se você configurar o tempo de permanência da porta para um valor de não zero, o tipo de afinidade na regra deverá ser nenhum (padrão). A afinidade baseada em regra (cookie passivo, URI, cookie ativo) não pode coexistir quando o tempo de permanência estiver configurado na porta.

time
O tempo de permanência da porta em número de segundos. Zero significa que a porta não é permanente.
method
O método de encaminhamento. Os possíveis métodos de encaminhamento são: encaminhamento mac, encaminhamento nat ou encaminhamento content-based routing (cbr). Você não pode incluir um método de encaminhamento nat ou cbr a menos que especifique primeiro um endereço IP diferente de zero no parâmetro clientgateway do comando dscontrol executor. Consulte NAT/NAPT do Dispatcher (Método de Encaminhamento NAT) e roteamento baseado em conteúdo do Dispatcher (Método de Encaminhamento CBR) para obter informações adicionais.
Notas:
  1. Method aplica-se apenas ao componente Dispatcher.
  2. Se o servidor backend estiver na mesma sub-rede que o endereço de retorno, e se você estiver usando o método de encaminhamento cbr ou nat, você deverá definir o endereço do roteador para ser o endereço do servidor backend.
  3. Se você incluir um método de encaminhamento mac, será necessário especificar o parâmetro "protocol" como HTTP ou SSL.
tipo
O tipo de método de encaminhamento. Os possíveis valores são: mac, nat ou cbr. O padrão é o encaminhamento mac.
staletimeout
O número de segundos durante os quais não poderá haver nenhuma atividade em uma conexão antes que a conexão seja removida. Para o componente Dispatcher, o valor padrão é 900 para porta 21 (FTP) e 259,200 para porta 23 (Telnet). Para todas as outras portas do Dispatcher e para todas as portas do CBR, o padrão é 300. Staletimeout também pode ser configurado no nível do executor ou do cluster. Consulte Usando o Valor de Tempo Limite Obsoleto para obter informações adicionais.
value
O valor de staletimeout em número de segundos.
weightbound
Configure o peso máximo para os servidores nessa porta. Isto afeta quanta diferença pode haver entre o número de pedidos o executor pode atribuir a cada servidor. O valor padrão é 20.
weight
Um número de 1 a 100 que representa o limite máximo de peso.
porttype
O tipo de porta.
Nota:
Porttype aplica-se apenas ao Dispatcher.
tipo
Os possíveis valores são tcp, udp e both. O valor padrão é both (tcp/udp).
protocolo
O tipo de protocolo. Para o componente Dispatcher, esse é um parâmetro obrigatório durante a especificação de um método "cbr" na porta. Se selecionar um tipo de protocolo de porta SSL, você também deverá especificar um tempo de permanência diferente de zero para ativar a afinidade de ID de SSL. Se você selecionar o protocolo HTTP, é possível estabelecer afinidade de servidor usando regras de "conteúdo". Consulte roteamento baseado em conteúdo do Dispatcher (Método de Encaminhamento CBR) para obter informações adicionais.
Nota:
Protocol aplica-se apenas ao método de encaminhamento cbr do Dispatcher.
tipo
Os possíveis valores são HTTP ou SSL.
maxhalfopen
O limite para o máximo de conexões abertas pela metade. Use esse parâmetro para detectar possíveis ataques de negação de serviço que resultam em um grande número de conexões TCP abertas pela metade em servidores.

Um valor positivo indica que foi feita uma verificação para determinar se as atuais conexões abertas pela metade excedem o limite. Se o valor atual estiver acima do limite, é feita uma chamada para um script de alerta. Consulte Negação de Detecção de Ataque de Serviço para obter informações adicionais.

Nota:
maxhalfopen aplica-se apenas ao Dispatcher.
value
O valor de maxhalfopen. O padrão é zero (nenhuma verificação será feita).
reset
A reconfiguração permite especificar se o Balanceador de Carga enviará reconfigurações TCP para servidores inativos na porta. Uma reconfiguração TCP faz com que a conexão seja fechada imediatamente. Consulte Enviando Reconfiguração de TCP para um Servidor Inativo (Apenas Componente Dispatcher) para obter informações adicionais.
Nota:
Reset aplica-se apenas ao componente Dispatcher. O clientgateway no comando dscontrol executor deve ser configurado como um endereço do roteador para usar a palavra-chave reset.
value
Os valores possíveis para a reconfiguração são yes e no. O padrão é no (nenhuma reconfiguração TCP é feita em servidores inativos). Quando reset for yes, as reconfigurações TCP serão enviadas para servidores inativos.
set
Configurar os campos de uma porta.
remove
Remove essa porta.
report
Relate nesta porta.
status
Configura o status dos servidores nessa porta. Se desejar ver o status em todas as portas, não especifique uma port com este comando. No entanto, não se esqueça dos dois pontos.
numSeconds
A quantidade de tempo, em segundos, antes de reconfigurar as conexões abertas pela metade.
halfopenaddressreport
Gera entradas no log (halfOpen.log) para todos os endereços de clientes (até aproximadamente 8000 pares de endereços) que acessaram servidores que têm quaisquer conexões abertas pela metade. Além disso, os dados estatísticos são relatados de volta para a linha de comandos, como: número total, maior e médio de conexões abertas pela metade e o tempo médio de conexões abertas pela metade (em segundos). Consulte Negação de Detecção de Ataque de Serviço para obter informações adicionais.

Exemplos

dscontrol rule — configure rules

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--rule--+-add--cluster:port:rule--tipo--da mensagem--| opts |-+-><
                    +-dropserver--cluster:port:rule--server---------------+
                    +-remove--cluster:port:rule---------------------------+
                    +-report--cluster:port:rule---------------------------+
                    +-set--cluster:port:rule--| opts |--------------------+
                    +-status--cluster:port:rule---------------------------+
                    '-useserver--cluster:port:rule--server+s2+...---------'
 
opts:
 
|--+---------------------------------+--------------------------|
   +-beginrange--low--endrange--high-+
   +-prioridade--nível---------------+
   +-pattern--pattern----------------+
   +-tos--value----------------------+
   +-tempo de permanência--time------+
   +-affinity--affinity_type---------+
   +-cookiename--value---------------+
   +-evaluate--nível-----------------+
   '-sharelevel--nível---------------'
 

add
Incluir essa regra a uma porta.
cluster
O endereço do cluster como um nome simbólico ou no formato de endereço IP. Você pode usar dois pontos (:) para atuar como um caractere curinga. Por exemplo, o comando a seguir, dscontrol rule add :80:RuleA type type, resultará na inclusão de RuleA na porta 80 para todos os clusters.
Nota:
Os clusters adicionais são separados por um sinal de mais (+).
port
O número da porta. Você pode usar dois pontos (:) para atuar como um caractere curinga. Por exemplo, o comando a seguir, dscontrol rule add clusterA::RuleA type type, resultará na inclusão de RuleA em todas as portas para ClusterA.
Nota:
Portas adicionais são separadas com um sinal de mais (+).
regra
O nome escolhido para a regra. Esse nome pode conter qualquer caractere alfanumérico, sublinhado, hífen ou ponto. O nome pode conter de 1 a 20 caracteres e não pode conter espaços em branco.
Nota:
Regras adicionais são separadas por um sinal de mais (+).
tipo
O tipo de regra.
tipo
Suas escolhas para type são:
ip
A regra é baseada no endereço IP do cliente.
time
A regra é baseada no horário do dia.
connection
A regra é baseada no número de conexões por segundo para a porta. Essa regra funcionará apenas se o gerenciador estiver em execução.
active
A regra é baseada no número do total de conexões ativas para a porta. Essa regra funcionará apenas se o gerenciador estiver em execução.
porta
A regra é baseada na porta do cliente.
Nota:
Port aplica-se ao componente Dispatcher.
service
Essa regra é baseada no campo de byte tipo de serviço (TOS) no cabeçalho IP.
Nota:
Service aplica-se apenas ao componente Dispatcher.
reservedbandwidth
Essa regra é baseada na largura da banda (kilobytes por segundo) sendo entregue por um conjunto de servidores. Para obter informações adicionais, consulte Usando Regras com Base na Largura da Banda Reservada e Largura da Banda Compartilhada e Regra de Largura da Banda Reservada.
Nota:
Reservedbandwidth aplica-se apenas ao componente Dispatcher.
sharedbandwidth
Essa regra é baseada na quantidade de largura da banda (kilobytes por segundo) que é compartilhada no nível do executor ou cluster. Para obter informações adicionais, consulte Usando Regras com Base na Largura da Banda Reservada e Largura da Banda Compartilhada e Regra de Largura da Banda Compartilhada.
Nota:
Sharedbandwidth aplica-se apenas ao componente Dispatcher.
true
Essa regra é sempre true. Pense nela como uma instrução else em lógica de programação.
content
Essa regra descreve uma expressão regular que será comparada com as URLs solicitadas pelo cliente. Isso é válido para Dispatcher e CBR.
beginrange
O menor valor no intervalo usado para determinar se a regra é ou não verdadeira.
low
Depende do tipo de regra. O tipo de valor e seu padrão são listados aqui pelo tipo de regra:
ip
O endereço do cliente como um nome simbólico ou no formato de endereço IP. O padrão é 0.0.0.0.
time
Um inteiro. O padrão é 0, representando meia noite.
connection
Um inteiro. O padrão é 0.
active
Um inteiro. O padrão é 0.
port
Um inteiro. O padrão é 0.
reservedbandwidth
Um número inteiro (kilobytes por segundo). O padrão é 0.
endrange
O maior valor no intervalo usado para determinar se a regra é ou não verdadeira.
high
Depende do tipo de regra. O tipo de valor e seu padrão são listados aqui pelo tipo de regra:
ip
O endereço do cliente como um nome simbólico ou no formato de endereço IP. O padrão é 255.255.255.254.
time
Um inteiro. O padrão é 24, representando meia noite.
Nota:
Ao definir beginrange e endrange dos intervalos de tempo, observe que cada valor deve ser um número inteiro representando apenas a parte de hora do tempo: as partes de uma hora não são especificadas. Por essa razão, para especificar uma única hora — quer dizer, a hora entre 3h e 4h— você especificaria um beginrange de 3 e um endrange também de 3. Isso significa todos os minutos começando às 3h e terminando às 3h59min. A especificação de um beginrange de 3 e um endrange de 4 cobriria o período de duas horas de 3h a 4h59min.
connections
Um inteiro. O padrão é 2 para a 32ª potência menos 1.
active
Um inteiro. O padrão é 2 para a 32ª potência menos 1.
port
Um inteiro. O padrão é 65535.
reservedbandwidth
Um número inteiro (kilobytes por segundo). O padrão é 2 para a 32ª potência menos 1.
prioridade
A ordem na qual as regras são recebidas.
level
Um inteiro. Se você não especificar a prioridade da primeira regra incluída, o Dispatcher irá configurá-la por padrão como 1. Quando uma regra subsequente é incluída, por padrão, sua prioridade é calculada para ser 10 + a atual prioridade mais baixa de qualquer regra existente. Por exemplo, suponha que você tem uma regra existente cuja prioridade é 30. Você inclui uma nova regra e configura sua prioridade como 25 (que, lembre-se, é uma prioridade mais alta que 30). Em seguida você inclui uma terceira regra sem configurar uma prioridade. A prioridade da terceira regra é calculada para ser 40 (30 + 10).
pattern
Especifica o padrão a ser usado para uma regra de tipo de conteúdo.
pattern
O padrão a ser usado. Para obter mais informações sobre valores válidos, consulte Apêndice B. Sintaxe de Regra de Conteúdo (Padrão).
tos
Especifica o valor de “tipo de serviço” (TOS) usado para a regra de tipo de serviço.
Nota:
TOS aplica-se apenas ao componente Dispatcher.
value
A sequência de 8 caracteres a ser usada para o valor de tos, em que os caracteres válidos são: 0 (zero binário), 1 (um binário) e x (não importa). Por exemplo: 0xx1010x. Para obter informações adicionais, consulte o Usando Regras com Base no Tipo de Serviço (TOS).
tempo de permanência
Especifica o tempo de permanência a ser usado para uma regra. Ao configurar o parâmetro affinity para "activecookie" no comando rule, o tempo de permanência deve ser configurado para um valor diferente de zero para ativar esse tipo de afinidade. O tempo de permanência na regra não se aplica aos tipos de regra de afinidade "passivecookie" ou "uri".

Consulte Afinidade do Cookie Ativo para obter informações adicionais.

Nota:
O tempo de permanência da regra aplica-se apenas ao componente CBR.
time
Tempo em segundos.
affinity
Especifica o tipo de afinidade a ser usado para uma regra: cookie ativo, cookie passivo, URI ou nenhum.

Um tipo de afinidade de "activecookie" ativa o balanceamento de carga do tráfego da Web com afinidade para o mesmo servidor com base nos cookies gerados pelo Balanceador de Carga.

Um tipo de afinidade de "passivecookie" ativa o balanceamento de carga do tráfego da Web com afinidade para o mesmo servidor com base nos cookies de autoidentificação gerados pelos servidores. Você deve usar o parâmetro cookiename junto com afinidade de cookie passivo.

Um tipo de afinidade de "URI" ativa o balanceamento de carga de tráfego da Web para servidores proxy de armazenamento em cache de uma maneira que aumenta efetivamente o tamanho do cache.

Consulte Afinidade do Cookie Ativo, Afinidade do Cookie Passivo e afinidade de URI para obter mais informações.

Nota:
A afinidade aplica-se às regras configuradas com o método de encaminhamento cbr do Dispatcher e ao componente CBR.
affinity_type
Os possíveis valores para o tipo de afinidade são: nenhum (padrão), activecookie, passivecookie ou uri.
cookiename
Um nome arbitrário configurado pelo administrador que age como um identificador para o Balanceador de Carga. É o nome que o Balanceador de Carga deve procurar na solicitação de cabeçalho HTTP do cliente. O nome do cookie, junto com seu valor, age como um identificador para o Balanceador de Carga, permitindo que o Balanceador de Carga envie solicitações subsequentes de um Web site para a mesma máquina servidor. O nome do cookie só é aplicável com afinidade de "cookie passivo".

Consulte Afinidade do Cookie Passivo para obter informações adicionais.

Nota:
O nome do cookie aplica-se às regras configuradas com o método de encaminhamento cbr do componente Dispatcher e ao componente CBR.
value
O valor do nome do cookie.
evaluate
Essa opção só está disponível no componente Dispatcher. Especifica se você deve avaliar a condição da regra em todos os servidores na porta ou nos servidores dentro da regra. Essa opção só é válida para regras que tomam suas decisões com base nas características dos servidores, como: regras de conexão, ativas e de largura de banda reservada. Para obter informações adicionais, consulte Opção de Avaliação de Servidor para Regras.

Para a regra de tipo de conexão, também é possível especificar uma opção de avaliação — upserversonrule. Com a especificação de upserversonrule, é possível garantir que os servidores restantes na regra não sejam sobrecarregados se algum dos servidores no conjunto de servidores estiver inativo.

level
Os possíveis valores são porta, regra ou upserversonrule. O padrão é porta. O valor upserversonrule só está disponível para o tipo de conexão regra.
sharelevel
Esse parâmetro destina-se apenas à regra de largura da banda compartilhada. Especifica se você deve compartilhar largura da banda no nível do cluster ou nível do executor. O compartilhamento de largura da banda no nível do cluster permite que uma porta (ou portas) compartilhe uma quantidade máxima de largura da banda em várias portas dentro do mesmo cluster. O compartilhamento de largura da banda no nível do executor permite que um cluster (ou clusters) dentro da configuração do Dispatcher inteira compartilhe uma quantidade máxima de largura da banda. Para obter informações adicionais, consulte Regra de Largura da Banda Compartilhada.
level
Os possíveis valores são executor ou cluster.
dropserver
Remover um servidor a partir de um conjunto de regras.
server
O endereço IP da máquina servidor TCP como um nome simbólico ou em formato de endereço IP.

Ou então, se você usou um particionamento de servidor, use o nome exclusivo do servidor lógico. Consulte Particionamento do Servidor: Servidores Lógicos Configurados como um Servidor Físico (endereço IP) para obter informações adicionais.

Nota:
Os servidores adicionais são separados por um sinal de mais (+).
remove
Remove uma ou mais regras, separadas umas das outras por outro sinal de mais.
report
Exibe os valores internos de uma ou mais regras.
set
Configura valores para essa regra.
status
Exibe os valores configuráveis de uma ou mais regras.
useserver
Insere servidores em um conjunto de regras.

Exemplos

dscontrol server — configurar servidores

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--server--+-add--cluster:port:server--+-------------------------+-+-><
                      |                           +-address--address--------+ |
                      |                           +-collocated--value-------+ |
                      |                           +-sticky--value-----------+ |
                      |                           +-weight--value-----------+ |
                      |                           +-fixedweight--value------+ |
                      |                           +-cookievalue--value------+ |
                      |                           +-mapport--portvalue------+ |
                      |                           +-protocolo--value--------+ |
                      |                           +-roteador--addr----------+ |
                      |                           +-returnaddress--addr-----+ |
                      |                           +-advisorrequest--cadeia--+ |
                      |                           '-advisorresponse--cadeia-' |
                      +-set--cluster:port:server--+-collocated--value-------+-+
                      |                           +-sticky--value-----------+ |
                      |                           +-weight--value-----------+ |
                      |                           +-fixedweight--value------+ |
                      |                           +-cookievalue--value------+ |
                      |                           +-protocolo--value--------+ |
                      |                           +-roteador--addr----------+ |
                      |                           +-advisorrequest--cadeia--+ |
                      |                           '-advisorresponse--cadeia-' |
                      +-down--cluster:port:server-----------------------------+
                      +-remove--cluster:port:server---------------------------+
                      +-report--cluster:port:server---------------------------+
                      +-up--cluster:port:server-------------------------------+
                      '-status--cluster:port:server---------------------------'
 

add
Inclui esse servidor.
cluster
O endereço do cluster como um nome simbólico ou no formato de endereço IP. Você pode usar dois pontos (:) para atuar como um caractere curinga. Por exemplo, o comando a seguir, dscontrol server add :80:ServerA, resultará na inclusão de ServerA na porta 80 em todos os clusters.
Nota:
Os clusters adicionais são separados por um sinal de mais (+).
port
O número da porta. Você pode usar dois pontos (:) para atuar como um caractere curinga. Por exemplo, o comando a seguir, dscontrol server add ::ServerA, resultará na inclusão de ServerA em todos os clusters em todas as portas.
Nota:
Portas adicionais são separadas com um sinal de mais (+).
server
O server é o endereço IP exclusivo da máquina servidor TCP como um nome simbólico ou no formato de endereço IP.

Ou, se você usar um nome exclusivo que não resolve para um endereço IP, deverá fornecer o parâmetro address do servidor no comando dscontrol server add. Consulte Particionamento do Servidor: Servidores Lógicos Configurados como um Servidor Físico (endereço IP) para obter informações adicionais.

Nota:
Os servidores adicionais são separados por um sinal de mais (+).
endereço
O endereço IP exclusivo da máquina servidor TCP como um nome do host ou no formato de endereço IP. Se o servidor não puder ser resolvido, você deverá fornecer o endereço da máquina servidor física. Consulte Particionamento do Servidor: Servidores Lógicos Configurados como um Servidor Físico (endereço IP) para obter informações adicionais.
address
Valor do endereço do servidor.
collocated
Instalado permite especificar se o Dispatcher está instalado em uma das máquinas servidor na qual ele está fazendo o balanceamento de carga.
Nota:
Lembre-se do seguinte:
  • O parâmetro instalado é válido durante o uso dos métodos de encaminhamento mac, nat ou cbr do Dispatcher. Site Selector e CBR podem ser instalados em todas as plataformas, mas não requerem essa palavra-chave. Para obter informações adicionais, consulte Usando Servidores Instalados.
  • Sistemas Windows: a disposição não está disponível.
value
Valor de collocated: yes ou no. O padrão é no.
sticky
Permite que um servidor substitua a configuração de tempo de permanência em sua porta. Com um valor padrão de “yes", o servidor retém a afinidade normal conforme definido na porta. Com um valor de “no", o cliente não retornará para esse servidor na próxima vez que emitir uma solicitação nessa porta, independentemente da configuração de tempo de permanência da porta. Isso é útil em certas situações nas quais você está usando regras. Para obter informações adicionais, consulte o substituição de afinidade de porta.
value
O valor de sticky: yes ou no. O padrão é yes.
weight
Um número de 0 a 100 (mas não exceder o valor de weightbound da porta especificada) que representa o peso para este servidor. Configurar o peso para zero evitará que quaisquer novos pedidos sejam enviados para o servidor, mas não terminará nenhuma conexão atualmente ativa com esse servidor. O padrão é um meio do valor máximo weightbound da porta especificada. Se o gerenciador estiver em execução, essa configuração será sobrescrita rapidamente.
value
O valor do peso do servidor.
fixedweight
A opção fixedweight permite especificar se você deseja que o gerenciador modifique o peso do servidor ou não. Se você configurar o valor de fixedweight como yes, quando o gerenciador for executado, não terá permissão para modificar o peso do servidor. Para obter informações adicionais, consulte o Pesos Fixados pelo Gerenciador.
value
Valor de fixedweight: yes ou no. O padrão é no.
cookievalue
Cookievalue é um valor arbitrário que representa o lado do servidor do par nome do cookie / valor do cookie. O valor do cookie, junto com o nome do cookie, age como um identificador que permite que o Balanceador de Carga envie solicitações de clientes subsequentes para o mesmo servidor. Consulte Afinidade do Cookie Passivo para obter informações adicionais.
Nota:
Cookievalue é válido para Dispatcher (usando método de encaminhamento cbr) e CBR.
value
O valor é qualquer valor arbitrário. O padrão é nenhum valor de cookie.
mapport
Mapeie o número da porta de destino da solicitação do cliente (que é para Dispatcher) para o número da porta do servidor que o Dispatcher usa para fazer o balanceamento de carga da solicitação do cliente. Permite que o Balanceador de Carga receba uma solicitação do cliente na porta e transmita-a para uma porta diferente na máquina servidor. Com mapport, é possível balancear a carga de solicitações do cliente para um servidor que pode ter diversos daemons de servidor em execução.
Nota:
protocolo
Os valores válidos para protocolo são HTTP e HTTPS. O padrão é HTTP.
Nota:
Protocol aplica-se apenas ao componente CBR.
portvalue
Valor do número da porta do mapa. O padrão é o número da porta de destino do pedido do cliente.
roteador
Se estiver configurando uma rede de longa distância, o endereço do roteador para o servidor remoto. O padrão é 0, indicando um servidor local. Observe que quando o endereço do roteador do servidor é configurado para algo diferente de zero (indicando um servidor remoto), ele não poderá ser reconfigurado para 0 para tornar o servidor local novamente. Em vez disso, o servidor deve ser removido e depois incluído novamente sem que um endereço de roteador seja especificado. Da mesma forma, um servidor definido como local (endereço do roteador = 0) não pode ser transformado em remoto alterando-se o endereço do roteador. O servidor deve ser removido e incluído novamente. Consulte Configurando Suporte ao Dispatcher de Longa Distância para obter informações adicionais.
Nota:
Router aplica-se apenas ao Dispatcher. Se estiver usando os métodos de encaminhamento nat ou cbr, com a inclusão de um servidor na configuração, você deverá especificar o endereço do roteador.
addr
O valor do endereço do roteador.
returnaddress
Um endereço IP exclusivo ou nome do host. É um endereço configurado na máquina do Dispatcher que o Dispatcher usa com seu endereço de origem ao fazer o balanceamento de carga da solicitação do cliente para o servidor. Isso garante que o servidor retornará o pacote para a máquina do Dispatcher para processar o conteúdo da solicitação, em vez de enviar o pacote diretamente para o cliente. (O Dispatcher encaminhará o pacote IP para o cliente.) Você deve especificar o valor do endereço de retorno quando o servidor for incluído. O endereço de retorno não pode ser alterado, a menos que você remova o servidor e o inclua novamente. O endereço de retorno não pode ser o mesmo que o endereço do cluster, servidor ou NFA.
Nota:
Returnaddress aplica-se apenas ao Dispatcher. Ao usar métodos de encaminhamento nat ou cbr, você deve definir um endereço e retorno para comunicação entre o Balanceador de Carga e os servidores de back-end. O número de conexões que o Balanceador de Carga pode manter ativas com o servidor de back-end é limitado pelo número de endereços de retorno que são definidos. O Load Balancer usa portas que são baseadas apenas no endereço de retorno, e não na combinação de endereço de retorno e do servidor. Quando todas as portas disponíveis estão em uso, conexões adicionais falham. Em um ambiente ocupado, use diversos endereços de retorno para evitar a falta de portas disponíveis.
addr
Valor do endereço de retorno.
advisorrequest
O orientador HTTP ou HTTPS usa a sequência de solicitações do orientador para consultar o funcionamento dos servidores. Isso só será válido para servidores avisados pelo orientador HTTP ou HTTPS. Você deve iniciar o orientador HTTP ou HTTPS para que esse valor seja ativado. Consulte Configurando o Orientador HTTP ou HTTPS Usando a Opção de Pedido e Resposta (URL) para obter informações adicionais.
Nota:
Advisorrequest aplica-se aos componentes Dispatcher e CBR.
string
Valor da sequência usado pelo orientador HTTP ou HTTPS. O padrão é HEAD / HTTP/1.0.
Nota:
Se houver um espaço em branco dentro da sequência --
  • Quando emitir o comando a partir do prompt shell dscontrol>>, você deverá colocar aspas ao redor da sequência. Por exemplo: server set cluster:port:server advisorrequest "head / http/1.0"
  • Ao emitir o comando dscontrol do prompt do sistema operacional, você deverá preceder o texto com "\" e seguir o texto com \"". Por exemplo: dscontrol server set cluster:port:server advisorrequest "\"head / http/1.0\""

advisorresponse
A sequência de respostas do orientador que o orientador HTTP ou HTTPS varre na resposta HTTP. Ela só será válida para servidores que são avisados pelo orientador HTTP ou HTTPS. Você deve iniciar o orientador HTTP ou HTTPS para que esse valor seja ativado. Consulte Configurando o Orientador HTTP ou HTTPS Usando a Opção de Pedido e Resposta (URL) para obter informações adicionais.
Nota:
Advisorresponse aplica-se aos componentes Dispatcher e CBR.
string
Valor da sequência usado pelo orientador HTTP ou HTTPS. O padrão é null.
Nota:
Se houver um espaço em branco dentro da sequência --
  • Quando emitir o comando a partir do prompt shell dscontrol>>, você deverá colocar aspas ao redor da sequência.
  • Ao emitir o comando dscontrol do prompt do sistema operacional, você deverá preceder o texto com "\" e seguir o texto com \"".
down
Marque este servidor como inativo. Este comando quebra todas as conexões ativas com esse servidor e impede que quaisquer outras conexões ou pacote sejam enviados a esse servidor.

Quando o comando server down for usado para colocar um servidor off-line, se o valor de tempo de permanência for diferente de zero para esse servidor, os clientes existentes continuarão a ser servidos por esse servidor até que o tempo de permanência expire. O servidor não será desativado até que o valor de tempo de permanência expire.

remove
Remove esse servidor.
report
Relata nesse servidor. O relatório contém as seguintes informações por servidor: o número atual de conexões por segundo (CPS), kilobytes transferidos por segundo (KBPS), número total de conexões (Total), número de conexões que estão no estado ativo (Active), número de conexões que estão no estado FIN (FINed) e o número de conexões concluídas (Comp).
set
Configura valores para esse servidor.
status
Mostra o status dos servidores.
up
Marque este servidor como ativo. O Dispatcher enviará agora novas conexões para esse servidor.

Exemplos

dscontrol set — configurar log do servidor

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

loglevel
O nível no qual o dsserver registra suas atividades.
level
O valor padrão do loglevel é 0. O intervalo é de 0 a 5. Os seguintes são os valores possíveis: 0 é Nenhum, 1 é Mínimo, 2 é Básico, 3 é Moderado, 4 é Avançado, 5 é Detalhado.
logsize
O número máximo de bytes a serem registrados no arquivo de log.
size
O valor padrão do logsize é 1 MB.

dscontrol status — exibir se o gerenciador e os orientadores estão em execução

Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--status-------------------------------------------><
 

Exemplos

dscontrol subagent — configurar subagente SNMP

Nota:
Os diagramas de sintaxe de comando dscontrol subagent aplicam-se ao componente Dispatcher.
Ler diagrama de sintaxeManter visual do diagrama de sintaxe>>-dscontrol--subagent--+-loglevel--nível--------------------+-><
                        +-logsize--+-bytes-----+-------------+
                        |          '-unlimited-'             |
                        +-report-----------------------------+
                        +-start--+-------------------------+-+
                        |        '-community_name--logfile-' |
                        +-status-----------------------------+
                        +-stop-------------------------------+
                        '-versão-----------------------------'
 

loglevel
O nível em que o subagente registra suas atividades em um arquivo.
level
O número do nível (0 a 5). Quanto maior o número, mais informações serão gravadas no log do gerenciador. O padrão é 1. A seguir há os valores possíveis: 0 é Nenhum, 1 é Mínimo, 2 é Básico, 3 é Moderado, 4 é Avançado e 5 é Detalhado.
logsize
Configure o tamanho máximo dos bytes a serem registrados no log do subagente. O padrão é MB. Ao configurar o tamanho máximo para o arquivo de log, o arquivo será quebrado; quando o arquivo atingir o tamanho especificado, as entradas subsequentes serão gravadas na parte superior do 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ê configurar o nível de log, mais cuidadosamente deverá escolher o tamanho do log, porque o espaço pode se esgotar rapidamente quando efetuar login nos níveis superiores.
bytes
O tamanho máximo em bytes para o arquivo de log do subagente. É possível especificar um número inteiro positivo maior que zero ou a palavra unlimited. O arquivo de log pode não atingir o tamanho máximo exato antes de sobrescrever porque as entradas de log em si variam de tamanho. O valor padrão é ilimitado.
report
Exiba um relatório de captura instantânea de estatísticas.
start
Inicie o subagente.
community_name
O nome do valor SNMP do nome da comunidade que pode ser usado como uma senha de segurança. O padrão é público.

Para a plataforma Windows: O nome da comunidade para o sistema operacional é usado.

log file
Nome do arquivo no qual os dados do subagente SNMP são registrados. Cada registro no log possui registro de data e hora. O padrão é subagent.log. O arquivo padrão é instalado no diretório logs. Consulte Apêndice C. Arquivos de Configuração de Amostra. Para alterar o diretório no qual os arquivos de log são mantidos, consulte Alterando os Caminhos do Arquivo de Log.
status
Exibe o status atual de todos os valores no subagente SNMP que podem ser configurados globalmente e seus padrões.
version
Exibe a versão atual do subagente.

Exemplos