Comando cthagsctrl

Propósito

Controla o subsistema de serviços do grupo.

Sintaxe

cthagsctrl { -a [-p port-number ] -s | -k | -d | -r | -z | -h | -t | -o }

Descrição

O comando de controle cthagsctrl controla o funcionamento do subsistema de serviços do grupo (cthags) sob o controle do controlador de recursos do sistema (SRC).

Uma instância do subsistema de serviços do grupo roda em cada nó de um cluster.

De um ponto de vista operacional, o grupo de subsistema de serviços do grupo é organizado da seguinte forma:

Subsistema

serviços de grupo

Grupo de subsistema

cthags

Subsistemas SRC

cthags

O subsistema cthags está associado ao daemon hagsd .

O nome do subsistema nos nós é cthags. Existe um subsistema por nó e cada um desses subsistemas está associado ao cluster ao qual o nó pertence.

Daemon

hagsd

Fornece as funções de serviços do grupo.

Em geral, o comando cthagsctrl não é emitido a partir da linha de comando. Ele é normalmente chamado pelo comandocthactrl durante a criação do cluster.

O comando cthagsctrl fornece uma variedade de controles para operar os subsistemas de serviços do grupo:

Adicionando, iniciando, parando e excluindo os subsistemas
Limpeza dos subsistemas (excluindo-os do cluster)
Desconfigurando os subsistemas do cluster
Ligando o rastreio e desligado

Adding the subsystem

Quando o sinalizador -a é especificado, o comando controle adiciia os subsistemas de serviços do grupo à SRC. O comando de controle:

Certifica-se que o subsistema cthags está parado.
Obtém o número da porta para o subsistema cthags a partir dos dados do cluster.
Remove o subsistema cthags da SRC (no caso de ele ainda estar lá).
Inclui o subsistema cthags para o SRC.
Não inclui atualmente uma entrada para o grupo cthags para o arquivo /etc/inittab . Como resultado, cthags é necessário que seja iniciado por outro subsistema quando for necessário.

Starting the subsystem

Quando o sinalizador -s é especificado, o comando controle usa o comando startsrc para iniciar o subsistema de serviços do grupo, cthags.

Stopping the subsystem

Quando o sinalizador -k é especificado, o comando controle usa o comando stopsrc para parar o subsistema de serviços do grupo, cthags.

Deleting or cleaning the subsystem

Quando o sinalizador -d é especificado, o comando controle usa o comando rmssys para remover os subsistemas de serviços do grupo da SRC. O comando de controle:

Certifica-se que o subsistema cthags está parado.
Remove o subsistema cthags a partir do SRC usando o comando rmssys .
Remove o número da porta a partir do arquivo /etc/services .

Turning tracing on

Quando o sinalizador -t é especificado, o comando control transforma o rastreio para o daemon hagsd usando o comando traceson .

Turning tracing off

Quando o sinalizador -o é especificado, o comando control transforma o rastreio (devolve-o ao seu nível padrão) para o daemon hagsd usando o comando tracesoff .

Refreshing the subsystem

A sinalização -r atualiza o subsistema cthags .

Logging

Enquanto eles estão em execução, os daemons de serviços do grupo fornecem informações sobre sua operação e erros ao gravar entradas em três arquivos de log no diretório /var/ct/cluster_name/log/cthags . Os arquivos de log são:

/var/ct/nome_do_cluster/log/cthags_nodenum_instnum.nome do cluster
/var/ct/nome do cluster/log/cthags_nodenum_instnum.cluster_name.long
/var/ct/nome do cluster/log/cthags.default.nodenum_instnum

Os arquivos de log contêm o log dos daemons hagsd sobre os nós.

Os nomes de arquivos de log incluem essas variáveis:

nodenum é o número do nó no qual o daemon está em execução.
instnum é o número da instância do daemon.
cluster_name é o nome do cluster no qual o daemon está em execução.

Cada daemon limita o tamanho do log a um número pré-estabelecido de linhas. O padrão é de 5000 linhas. Quando o limite é atingido, o daemon anexa a string .bak ao nome do arquivo de log atual e inicia um novo log. Se uma versão .bak já existe, ela é removida antes que o log atual seja renomeado.

Sinalizações

--a [-p número da porta]: Inclui o subsistema.
-s: Inicia o subsistema.
-k: Pára o subsistema.
-d: Exclui o subsistema.
-t: Transforma o rastreio em para o subsistema.
-o: Transforma o rastreio para o subsistema.
-r: Atualiza o subsistema.
-z: Desinstala o subsistema cthags .
-h: Grava a instrução de uso do comando para saída padrão.

Segurança

Você deve ter a autoridade root para executar este comando.

Status de saída

0: Indica que o comando foi concluído com sucesso.
um valor diferente de zero: Indica que ocorreu um erro.

Restrições

Este comando é válido apenas em um domínio de pares.

Utilize esse comando somente sob a orientação do Centro de Suporte IBM.

Saída Padrão

Quando a sinalização -h é especificada, a instrução de uso deste comando é escrita para saída padrão.

Erro Padrão

Este comando grava mensagens de erro, conforme necessário, ao erro padrão.

Exemplos

Para adicionar os subsistemas de serviços do grupo para o SRC no cluster atual, digite:
```
cthagsctrl -a
```
Para adicionar os subsistemas de serviços do grupo com um número de porta de 12347, digite:
```
cthagsctrl -a -p 12347
```
Para iniciar os subsistemas de serviços em grupo no cluster atual, digite:
```
cthagsctrl -s
```
Para parar os subsistemas de serviços do grupo no cluster atual, digite:
```
cthagsctrl -k
```
Para excluir os subsistemas de serviços do grupo a partir do SRC no cluster atual, digite:
```
cthagsctrl -d
```
Para ativar o rastreio para o daemon de serviços do grupo no cluster atual, digite:
```
cthagsctrl -t
```
Para ativar o rastreio para o daemon de serviços do grupo no cluster atual, digite:
```
cthagsctrl -o
```

Local

/opt/rsct/bin/cthagsctrl: Contém o comando cthagsctrl