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.
- alta disponibilidade
- subagent
- executor
- report
- set nfa <value>
- set fintimeout <value>
- set hatimeout <value>
- set hasynctimeout <value>
- set porttype <value>
- cluster
- report {c}
- set {c} porttype
- port
- add {c:p} porttype
- add {c:p} protocol
- set {c:p} porttype
- rule add {c:p:r} type port
- server
- add {c:p:s} router
- set {c:p:s} router
dscontrol advisor — controle do orientador

>>-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
- Para iniciar o orientador http na porta 80 para o cluster 127.40.50.1:
dscontrol advisor start http 127.40.50.1:80
- Para iniciar o orientador http na porta 88 para todos os clusters:
dscontrol advisor start http 88
- Para parar o orientador http na porta 80 para o cluster 127.40.50.1:
dscontrol advisor stop http 127.40.50.1:80
- Para configurar o tempo (30 segundos) que um orientador HTTP para a porta 80 aguarda antes de relatar que uma conexão com um servidor falhou:
dscontrol advisor connecttimeout http 80 30
- Para configurar o tempo (20 segundos) que um orientador HTTP para a porta 80 no cluster 127.40.50.1 aguarda antes de relatar que uma conexão com um servidor falhou:
dscontrol advisor connecttimeout http 127.40.50.1:80 20
- Para configurar o intervalo para o orientador FTP (para a porta 21) como 6 segundos:
dscontrol advisor interval ftp 21 6
- Para exibir a lista de orientadores que fornecem informações atualmente ao gerenciador:
dscontrol advisor list
Este comando produz saída semelhante à:
---------------------------------------
| ADVISOR | CLUSTER:PORT | TIMEOUT |
---------------------------------------
| http |127.40.50.1:80 | unlimited |
| ftp | 21 | unlimited |
---------------------------------------
- Para alterar o nível de log do orientador para 0 para melhor desempenho:
dscontrol advisor loglevel http 80 0
- Para alterar o tamanho do log do orientador ftp para a porta 21 para 5000 bytes:
dscontrol advisor logsize ftp 21 5000
- Para configurar o tempo (60 segundos) que um orientador HTTP (para a porta 80) aguarda antes de relatar que um recebimento de um servidor falhou:
dscontrol advisor receivetimeout http 80 60
- Para exibir um relatório no estado do orientador ftp (para a porta 21):
dscontrol advisor report ftp 21
Este comando produz saída semelhante à:
Advisor Report:
---------------
Advisor name ............. Ftp
Port number .............. 21
Cluster address .......... 9.67.131.18
Server address ........... 9.67.129.230
Load ..................... 8
Cluster address .......... 9.67.131.18
Server address ........... 9.67.131.215
Load ..................... -1
- Para exibir o status atual de valores associados ao orientador http para a porta 80:
dscontrol advisor status http 80
Este comando produz saída semelhante à seguinte:
Advisor Status:
---------------
Interval (seconds) ............ 7
Timeout (seconds) ............. Unlimited
Connect timeout (seconds).......21
Receive timeout (seconds).......21
Advisor log filename .......... Http_80.log
Log level ..................... 1
Maximum log size (bytes) ...... Unlimited
Number of retries ............. 0
- Para configurar o valor de tempo limite para as informações do orientador ftp na porta 21 como 5 segundos:
dscontrol advisor timeout ftp 21 5
- Para exibir o número da versão atual do orientador ssl para a porta 443:
dscontrol advisor version ssl 443
Este comando produz saída semelhante à seguinte:
Version: 04.00.00.00 - 07/12/2001-10:09:56-EDT
dscontrol binlog — controle do arquivo de log binário

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

>>-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
- Para incluir o endereço do cluster 130.40.52.153:
dscontrol cluster add 130.40.52.153
- Para remover o endereço do cluster 130.40.52.153:
dscontrol cluster remove 130.40.52.153
- Para configurar a importância relativa colocada na entrada (active, new, port, system) recebida pelo gerenciador para servidores que residem no cluster 9.6.54.12:
dscontrol cluster set 9.6.54.12 proportions 60 35 5 0
- Para incluir um cluster curinga:
dscontrol cluster add 0.0.0.0
- Para uma configuração de alta disponibilidade mútua, configure o
endereço do cluster 9.6.54.12 com o NFA da máquina de backup (9.65.70.19) como
host principal:
dscontrol cluster set 9.6.54.12 primaryhost 9.65.70.19
- Para mostrar o status do endereço do cluster 9.67.131.167:
dscontrol cluster status 9.67.131.167
Este comando produz saída semelhante à:
Cluster Status:
----------------
Cluster ................................. 9.67.131.167
Address ................................. 9.67.131.167
Number of target ports .................. 3
Default sticky time ..................... 0
Default stale timeout ................... 30
Default port weight bound ............... 20
Maximum number of ports ................. 8
Default port protocol ................... tcp/udp
Default maximum number of servers ....... 32
Proportion given to active connections... 0.5
Proportion given to new connections...... 0.5
Proportion given specific to the port.... 0
Proportion given to system metrics....... 0
Shared bandwidth (KBytes) ............... 0
Primary Host Address .................... 9.67.131.167
executor dscontrol — controle do executor

>>-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
- Para exibir os contadores internos para Dispatcher:
dscontrol executor status
Status do Executor:
----------------
Nonforwarding address ............... 9.67.131.151
Client gateway address .............. 0.0.0.0
Fin timeout ......................... 60
Wide area network port number ....... 0
Shared bandwidth (Kbytes) ........... 0
Default maximum ports per cluster ... 8
Maximum number of clusters .......... 100
Default maximum servers per port .... 32
Default stale timeout ............... 300
Default sticky time ................. 0
Default weight bound ................ 20
Default port type ................... tcp/udp
- Para configurar o nonforwarding address como 130.40.52.167:
dscontrol executor set nfa 130.40.52.167
- Para configurar o número máximo de clusters:
dscontrol executor set maxclusters 4096
- Para iniciar o executor:
dscontrol executor start
- Para parar o executor:
dscontrol executor stop
arquivo dscontrol — gerenciar arquivos de configuração

>>-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
- Para excluir um arquivo:
dscontrol file delete file3
File (file3) was deleted.
- Para carregar um novo arquivo de configuração para substituir a configuração atual:
dscontrol file newload file1.sv
File (file1.sv) was loaded into the Dispatcher.
- Para anexar um arquivo de configuração na configuração atual e carregar:
dscontrol file appendload file2.sv
File (file2.sv) was appended to the current configuration and loaded.
- Para visualizar um relatório de seus arquivos (isto é, aqueles arquivos que você salvou anteriormente):
dscontrol file report
FILE REPORT:
file1.save
file2.sv
file3
- Para salvar sua configuração em um arquivo nomeado file3:
dscontrol file save file3
The configuration was saved into file (file3).
Ajuda do dscontrol — exibir ou imprimir a ajuda para este comando

>>-dscontrol--help--+-orientador-----------+-------------------><
+-binlog---------------+
+-cluster--------------+
+-executor-------------+
+-file-----------------+
+-help-----------------+
+-alta disponibilidade-+
+-Host-----------------+
+-logstatus------------+
+-manager--------------+
+-metric---------------+
+-port-----------------+
+-regra----------------+
+-server---------------+
+-set------------------+
+-status---------------+
'-subagent-------------'
Exemplos
- Para obter ajuda sobre o comando dscontrol:
dscontrol help
Este comando produz saída semelhante à:
HELP COMMAND ARGUMENTS:
---------------------------------
Usage: help <help option>
Example: help cluster
help - print complete help text
advisor - help on advisor command
cluster - help on cluster command
executor - help on executor command
file - help on file command
host - help on host command
binlog - help on binary log command
manager - help on manager command
metric - help on metric command
port - help on port command
rule - help on rule command
server - help on server command
set - help on set command
status - help on status command
logstatus - help on server log status
subagent - help on subagent command
highavailability - help on high availability command
Observe que esses parâmetros dentro de <> são variáveis.
- Às vezes a ajuda mostrará as opções para as variáveis usando | para separar as opções:
fintimeout <cluster address>|all <time>
-Change FIN timeout
(Use 'all' para alterar todos os clusters)
alta disponibilidade de dscontrol — controle de alta disponibilidade
Nota:
O diagrama de sintaxe de alta disponibilidade dscontrol
aplica-se apenas ao componente Dispatcher.

>>-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:
- 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.
- 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
- Para verificar o status de alta disponibilidade de uma máquina:
dscontrol highavailability status
Output:
High Availability Status:
-------------------------
Role ........................primary
Recovery Strategy ........... manual
State ....................... Active
Sub-state.............. Synchronized
Primary host........... 9.67.131.151
Port .........................12345
Preferred Target....... 9.67.134.223
Heartbeat Status:
-----------------
Count ......................... 1
Source/destination ............ 9.67.131.151/9.67.134.223
Reachability Status:
--------------------
Count ................ 1
Address .............. 9.67.131.1 reachable
- Para incluir as informações de backup na máquina principal usando a estratégia
de recuperação automática e a porta 80:
dscontrol highavailability backup add primary auto 80
- Para incluir um endereço que o Dispatcher deve poder atingir:
dscontrol highavailability reach add 9.67.125.18
- Para incluir informações de pulsação para as máquinas principal e de backup.
Primary - highavailability heartbeat add 9.67.111.3 9.67.186.8
Backup - highavailability heartbeat add 9.67.186.8 9.67.111.3
- Para informar ao Dispatcher em espera para se tornar ativo, forçando a máquina ativa a ficar em espera:
dscontrol highavailability takeover
dscontrol host — configure uma máquina remota

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

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

>>-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
- Para configurar o intervalo de atualização para o gerenciador a cada 5 segundos:
dscontrol manager interval 5
- Para configurar o nível de criação de log como 0 para melhor desempenho:
dscontrol manager loglevel 0
- Para configurar o tamanho do log do gerenciador como 1.000.000 bytes:
dscontrol manager logsize 1000000
- Para especificar que mais nenhuma conexão será enviada ao servidor em 130.40.52.153:
dscontrol manager quiesce 130.40.52.153
- Para configurar o número de intervalos de atualização antes dos pesos serem atualizados para 3:
dscontrol manager refresh 3
- Para obter uma captura instantânea de estatísticas do gerenciador:
dscontrol manager report
Este comando produz saída semelhante à:
--------------------------------------------------------------------
| SERVER | IP ADDRESS | STATUS |
--------------------------------------------------------------------
| mach14.dmz.com | 10.6.21.14 | ACTIVE |
| mach15.dmz.com | 10.6.21.15 | ACTIVE |
--------------------------------------------------------------------
-----------------------------
| MANAGER REPORT LEGEND |
-----------------------------
| ACTV | Active Connections |
| NEWC | New Connections |
| SYS | System Metric |
| NOW | Current Weight |
| NEW | New Weight |
| WT | Weight |
| CONN | Connections |
-----------------------------
-------------------------------------------------------------------
| www.dmz.com | | | | | |
| 10.6.21.100 | WEIGHT | ACTV | NEWC | PORT | SYS |
| PORT: 21 |NOW NEW| 49% | 50% | 1% | 0% |
-------------------------------------------------------------------
| mach14.dmz.com | 10 10 | 0 | 0 | -1 | 0 |
| mach15.dmz.com | 10 10 | 0 | 0 | -1 | 0 |
-------------------------------------------------------------------
-------------------------------------------------------------------
| www.dmz.com | | | | | |
| 10.6.21.100 | WEIGHT | ACTV | NEWC | PORT | SYS |
| PORT: 80 |NOW NEW| 49% | 50% | 1% | 0% |
-------------------------------------------------------------------
| mach14.dmz.com | 10 10 | 0 | 0 | 23 | 0 |
| mach15.dmz.com | 9 9 | 0 | 0 | 30 | 0 |
-------------------------------------------------------------------
---------------------------------------------------
| ADVISOR | CLUSTER:PORT | TIMEOUT |
---------------------------------------------------
| http | 80 | unlimited |
| ftp | 21 | unlimited |
---------------------------------------------------
- Para reiniciar todos os servidores para pesos normalizados e gravar uma mensagem no arquivo de log do gerenciador:
dscontrol manager restart Restarting the manager to update code
Este comando produz saída semelhante à:
320-14:04:54 Restarting the manager to update code
- Para configurar a sensibilidade como mudanças de peso para 10:
dscontrol manager sensitivity 10
- Para configurar o índice de suavização como 2.0:
dscontrol manager smoothing 2.0
- Para iniciar o gerenciador e especificar o arquivo de log nomeado ndmgr.log (os caminhos não podem ser configurados)
dscontrol manager start ndmgr.log
- Para exibir o status atual dos valores associados ao gerenciador:
dscontrol manager status
Esse
comando produz saída semelhante ao seguinte exemplo.
Manager status:
===============
Metric port................................... 10004
Manager log filename.......................... manager.log
Manager log level............................. 1
Maximum manager log size (bytes).............. unlimited
Sensitivity level............................. 0.05
Smoothing index............................... 1.5
Update interval (seconds)..................... 2
Weights refresh cycle......................... 2
Reach log level............................... 1
Maximum reach log size (bytes)................ unlimited
Reach update interval (seconds)............... 7
Metric monitor log file name.................. MetricMonitor.log
Metric monitor log level...................... 1
Maximum metric monitor log size............... 1048576
- Para parar o gerenciador:
dscontrol manager stop
- Para especificar que mais nenhuma conexão nova será enviada a um servidor em 130.40.52.153. (Nota: Apenas suspenda o servidor “agora", se tiver configurado o tempo de permanência e desejar que novas conexões sejam enviadas para outro servidor antes do tempo de permanência expirar):
dscontrol manager quiesce 130.40.52.153 now
- Para especificar que mais nenhuma conexão nova será enviada a um servidor em 130.40.52.153. (Nota: Se você tiver configurado o tempo de permanência, novas conexões subsequentes do cliente serão enviadas para esse servidor até que o tempo de permanência expire):
dscontrol manager quiesce 130.40.52.153
- Para especificar que o gerenciador pode começar a fornecer um peso superior a 0 para um servidor em 130.40.52.153 que ficou no modo de quiesce anteriormente:
dscontrol manager unquiesce 130.40.52.153
- Para exibir o número da versão atual do gerenciador:
dscontrol manager version
dscontrol metric — configurar métricas do sistema

>>-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
- Para incluir uma métrica do sistema:
dscontrol metric add site1:metric1
- Para configurar as proporções para um nome de site com duas métricas do sistema:
dscontrol metric proportions site1 0 100
- Para exibir o status atual dos valores associados à métrica especificada:
dscontrol metric status site1:metric1
Este comando produz saída semelhante à seguinte:
Metric Status:
------------
Cluster ....................... 10.10.10.20
Metric name ................... metric1
Metric proportion ............. 50
Server .................... plm3
Metric data ............... -1
dscontrol port — configurar portas

>>-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:
- Method aplica-se apenas ao componente Dispatcher.
- 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.
- 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
- Para incluir as portas 80 e 23 em um endereço do cluster 130.40.52.153:
dscontrol port add 130.40.52.153:80+23
- Para incluir uma porta curinga em um endereço do cluster de 130.40.52.153:
dscontrol port set 130.40.52.153:0
- Para configurar o peso máximo de 10 para a porta 80 em um endereço do cluster de 130.40.52.153:
dscontrol port set 130.40.52.153:80 weightbound 10
- Para configurar o valor de stickytime como 60 segundos para as portas 80 e 23 em um endereço do cluster de 130.40.52.153:
dscontrol port set 130.40.52.153:80+23 stickytime 60
- Para configurar a afinidade de porta cruzada das portas 80 e 23 em um endereço do cluster de 130.40.52.153:
dscontrol port set 130.40.52.153:80 crossport 23
- Para remover a porta 23 de um endereço do cluster de 130.40.52.153:
dscontrol port remove 130.40.52.153:23
- Para obter o status da porta 80 em um endereço do cluster de 9.67.131.153:
dscontrol port status 9.67.131.153:80
Este comando produz saída semelhante à:
Port Status:
------------
Port number .................... 80
Cluster ........................ 9.67.131.153
Stale timeout .................. 300
Weight bound ................... 20
Maximum number of servers ...... 32
Sticky time .................... 0
Port type ...................... tcp/udp
Cross Port Affinity ............ 80
Sticky mask bits ............... 32
Max Half Open Connections ...... 0
Send TCP Resets ................ no
- Para obter o relatório da porta 80 em um endereço do cluster de 9.62.130.157:
dscontrol port report 9.62.130.157:80
Este comando produz saída semelhante à:
Port Report:
------------
Cluster address ................ 9.62.130.157
Port number .................... 80
Number of servers .............. 5
Maximum server weight .......... 10
Total active connections ....... 55
Connections per second ......... 12
KBytes per second .............. 298
Number half open ............... 0
TCP Resets sent ................ 0
Forwarding method .............. MAC Based Forwarding
- Para obter o relatório do endereço aberto pela metade da porta 80 em um endereço do cluster de 9.67.127.121:
dscontrol port halfopenaddressreport 9.67.127.121:80
Este comando produz saída semelhante à:
Half open connection report successfully created:
------------
Half Open Address Report for cluster:port = 9.67.127.121:80
Total addresses with half open connections reported ... 0
Total number of half open connections reported ........ 0
Largest number of half open connections reported ...... 0
Average number of half open connections reported ...... 0
Average half open connection time (seconds) reported .. 0
Total half open connections received .................. 0
dscontrol rule — configure rules

>>-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
- Para incluir uma regra que será sempre true, não especifique o intervalo inicial ou
intervalo final:
dscontrol rule add 9.37.67.100:80:trule type true priority 100
- Para criar uma regra que proíba o acesso a uma variedade de endereços IP, nesse
caso, aqueles que começam com “9:”
dscontrol rule add 9.37.131.153:80:ni type ip b 9.0.0.0 e 9.255.255.255
- Para criar uma regra que especificará o uso de um determinado
servidor das 11h às 15h:
dscontrol rule add cluster1:80:timerule type time beginrange 11 endrange 14
dscontrol rule useserver cluster1:80:timerule server05
- Para criar uma regra baseada no conteúdo do campo de byte TOS no
cabeçalho IP:
dscontrol rule add 9.67.131.153:80:tosrule type service tos 0xx1001x
- Para criar uma regra baseada na largura da banda reservada que
alocará um conjunto de servidores (avaliado dentro da regra) para entregar
dados a uma taxa máxima de 100 kilobytes por segundo:
dscontrol rule add 9.67.131.153:80:rbwrule type reservedbandwidth
beginrange 0 endrange 100 evaluate rule
- Para criar uma regra baseada na largura da banda compartilhada que
recrutará a largura da banda não usada no nível do cluster. (Nota: Primeiro você
deve especificar a quantidade máxima de largura da banda (kilobytes por segundo)
que pode ser compartilhada no nível do cluster usando o comando dscontrol cluster):
dscontrol cluster set 9.67.131.153 sharedbandwidth 200
dscontrol rule add 9.67.131.153:80:shbwrule type sharedbandwidth
sharelevel cluster
dscontrol server — configurar servidores

>>-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
- Para incluir o servidor em 27.65.89.42 na porta 80 em um endereço do cluster 130.40.52.153:
dscontrol server add 130.40.52.153:80:27.65.89.42
- Para configurar o servidor em 27.65.89.42 como não permanente (recurso de substituição de afinidade de porta):
dscontrol server set 130.40.52.153:80:27.65.89.42 sticky no
- Para marcar o servidor em 27.65.89.42 como inativo:
dscontrol server down 130.40.52.153:80:27.65.89.42
- Para remover o servidor em 27.65.89.42 em todos as portas, em todos os clusters:
dscontrol server remove ::27.65.89.42
- Para configurar o servidor em 27.65.89.42 como instalado (o servidor reside na mesma máquina que o Balanceador de Carga):
dscontrol server set 130.40.52.153:80:27.65.89.42 collocated yes
- Para configurar o peso como 10 para o servidor 27.65.89.42 na porta 80 no endereço do cluster 130.40.52.153:
dscontrol server set 130.40.52.153:80:27.65.89.42 weight 10
- Para marcar o servidor em 27.65.89.42 como ativo:
dscontrol server up 130.40.52.153:80:27.65.89.42
- Para incluir um servidor remoto:
dscontrol server add 130.40.52.153:80:130.60.70.1 router 130.140.150.0
- Para permitir que o orientador HTTP consulte um pedido da URL de HTTP HEAD / HTTP/1.0 para o servidor 27.65.89.42 na porta 80 HTTP:
dscontrol server set 130.40.52.153:80:27.65.89.42
advisorrequest "\"HEAD / HTTP/1.0\""
- Para mostrar o status do servidor 9.67.143.154 na porta 80:
dscontrol server status 9.67.131.167:80:9.67.143.154
Este comando produz saída semelhante à:
Server Status:
--------------
Server ......................... 9.67.143.154
Port number .................... 80
Cluster ........................ 9.67.131.167
Cluster address ................ 9.67.131.167
Quiesced ....................... N
Server up ...................... Y
Weight ......................... 10
Fixed weight ................... N
Sticky for rule ................ Y
Remote server .................. N
Network Router address ......... 0.0.0.0
Collocated ..................... N
Advisor request................. HEAD / HTTP/1.0
Advisor response................
Cookie value ................... n/a
Clone ID ....................... n/a
dscontrol set — configurar log do servidor

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

>>-dscontrol--status-------------------------------------------><
Exemplos
dscontrol subagent — configurar subagente SNMP
Nota:
Os diagramas de sintaxe de comando dscontrol
subagent aplicam-se ao componente Dispatcher.

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