comando mkcomg

Propósito

Cria uma nova definição de grupo de comunicação para um domínio de pares.

Sintaxe

mkcomg [-s sensitivity] [-p period ] [ -g grace ] [-t priority] [ ' -x ' b | ' r | ' br ] [ -N UseForNodeMembership ] [-e NIM_path] [-m NIM_parameters ] [ -M media_type ] [ -i {h | n}:interface1[:node1][,interface2[:node2]...] | -S {h | n}:"interface_selection_string" [ -6 ] [-h] [-TV] communication_group

Descrição

O comando mkcomg cria uma nova definição de grupo de comunicação para um domínio de pares online com o nome especificado pelo parâmetro comunication_group . O grupo de comunicação é usado para definir anéis de pulsação para uso por serviços de topologia e para definir os ajustes para cada anel de pulsação. O grupo de comunicação determina quais dispositivos são usados para pulsação no domínio de pares. Pode haver mais de um grupo de comunicação em um domínio de pares.

O comando mkcomg deve ser executado em um nó que está atualmente online no domínio de pares onde o grupo de comunicação deve ser definido. Mais da metade dos nós deve estar online para criar um novo grupo de comunicação para o domínio.

As bandeiras -e e -m são usadas para configurar o caminho e os parâmetros do módulo de interface de rede (NIM). O caminho NIM é o caminho para o NIM que suporta os tipos de adaptador utilizados no grupo de comunicação. Os parâmetros NIM são transmitidos para NIM quando ele é iniciado. Se -m não for especificado, os parâmetros predefinidos pelos serviços de topologia são usados.

O grupo de comunicação pode ser atribuído a um ou mais recursos de interface. Use a sinalização -i para atribuir o grupo de comunicação a um nome de recurso de interface específico. O recurso de interface pode ser limitado a um em um determinado nó. Um recurso de interface também pode ser especificado usando a sinalização -S e uma string de seleção. Isso é usado ao especificar o nome do recurso da interface não é suficiente. As bandeiras -i e -S não podem ser usadas juntas. O comando chcomg também pode ser usado para designar um grupo de comunicação para um recurso de interface.

Sinalizações

- sensibilidade-s

Especifica a sensibilidade de pulsação. Este é o número de batimentos perdidos que constituem uma falha. O valor de sensibilidade é um número inteiro maior ou igual a 2. O valor padrão é 4.

--p período

Especifica a quantidade de tempo entre os batimentos cardíos. O período é especificado em segundos e é significativo para milissegundos. Ele pode ser especificado como um número inteiro ou como um número de ponto flutuante.

- graça-g

Especifica o período de carência que é usado quando os batimentos cardíos não são mais recebidos. Quando um heartbeat é perdido, um pacote de eco Internet Control Message Protocol (ICMP) é enviado para o nó com falha. Se o eco for devolvido, o período de carência é iniciado.

O período de carência é especificado em segundos e é significativo para milisegundos. Ele pode ser especificado como um número inteiro, um número de ponto flutuante ou um desses valores:

0: Especifica que o período de carência está desativado.
-1 | D: Especifica que o subsistema de serviços de topologia controla o período de carência. Esse é o padrão.

- prioridade-t

Especifica a prioridade. Esse valor indica a importância deste grupo de comunicação com relação aos outros. É usado para ordenar os anéis de batimento cardíaco. Quanto menor o número significa maior a prioridade. A maior prioridade é 1. O valor padrão é de 1 para redes IP e de 255 para redes RS232 .

--x b | r | br

Exclui controles para mecanismos de batimento cardíaco. Esta sinalização indica que um ou mais controles para mecanismos de batimento cardíaco não devem ser usados mesmo que a mídia subjacente o suporte. Os seguintes recursos podem ser excluídos:

b: Especifica que o recurso de transmissão não deve ser usado mesmo se a mídia subjacente o suporte. Se -x b não for especificado, o recurso de transmissão será usado se a mídia subjacente apoiá-lo.
r: Especifica que o recurso de roteamento de origem não deve ser usado mesmo se a mídia subjacente o suporte. Se -x r não for especificado, o recurso de roteamento de origem será usado se a mídia subjacente apoiá-lo.

Para excluir mais de um controle, especifique os caracteres do recurso consecutivamente: -x br.

-N UseForNodeMembership

Especifica se os serviços do grupo utilizarão o grupo de comunicação no cálculo da adesão ao nó. Define o atributo de recurso persistente UseForNodeMembership para o recurso de grupo de comunicação. Os valores válidos são:

0: Indica que, independentemente dos resultados das verificações de vivacidade executadas nos recursos NetworkInterface que são membros desse grupo de comunicação, os serviços de grupo não usarão esses resultados para calcular se o nó que possui as interfaces está online.
1: Indica que os serviços de grupo usarão os resultados das verificações de atividade executadas nos recursos NetworkInterface no cálculo do estado on-line de seus nós de propriedade.

--e NIM_path

Especifica o nome do caminho do módulo de interface de rede (NIM). Esta string de caracteres especifica o nome do caminho para o NIM que suporta os tipos de adaptador no grupo de comunicação.

--m NIM_parameters

Especifica os parâmetros de início do NIM. Essa sequência de caracteres é passada para o NIM ao iniciá-lo.

--M media_type

Especifica o tipo de interfaces que formam o comunication_group. Os valores válidos são:

0: Indica que comunication_group consiste em recursos de interface diferente de IP ou disco.
1: Indica que comunication_group consiste em recursos de interface IPv4 ou IPv6 .
Se a sinalização -M não for especificada, este é o padrão.
2: Indica que comunication_group consiste em recursos de interface em disco.

--i {h | n}:interface1[:node1] [,interface2[:node2]...

Designa comunication_group para um ou mais recursos de interface de pulsação ou de rede e, opcionalmente, para os nós onde esses recursos podem ser encontrados. Especificar -i h para recursos de interface pulsante ou -i n para recursos de interface de rede.

Por padrão, o sinalizador -i n adiciona recursos de interface de rede que possuem endereços IPv4 para comunication_group. Se a sinalização -6 for especificada, a bandeira -i n adicionará recursos de interface de rede que possuem endereços IPv6 para comunication_group.

Se -i for especificado, -S não pode ser especificado.

--S {h | n}:"network_selection_string"

Designa comunication_group para a pulsação ou interface de rede que é especificado por interface_selection_string. Especificar -S h para interfaces de pulsação ou -S n para interfaces de rede.

Por padrão, a sinalização -S n adiciona recursos de interface de rede que possuem endereços IPv4 para comunication_group. Se o sinalizador -6 for especificado, o sinalizador -S n adicionará recursos de interface de rede que tenham endereços IPv6 a communication_group.

Se -S for especificado, -i não pode ser especificado.

-6

Especifica que os endereços IPv6 representados como recursos em cada interface têm seu grupo de comunicação alterado para o especificado. IPv4 endereços representados como recursos nas interfaces seriam pouco afetados.

Por padrão (sem -6 especificado), o inverso é verdadeiro. Apenas os endereços IPv4 representados como recursos na interface teriam seu grupo de comunicação alterado.

-h

Grava a instrução de uso do comando para saída padrão.

-T

Escreve as mensagens de rastreio do comando para erro padrão. Para o uso de sua organização de serviço de software apenas.

-V

Grava as mensagens verbosas do comando para a saída padrão.

Parâmetros

comunication_group: Especifica o nome do novo grupo de comunicação que deve ser criado para o domínio de pares online. O nome pode conter qualquer caráter imprimível.

Segurança

O usuário do comando mkcomg precisa de permissão de gravação para a classe de recursos IBM.CommunicationGroup . Permissão de gravação para a classe de recursos IBM.NetworkInterface é necessária para configurar o grupo de comunicação para um recurso de interface de rede. Por padrão, root em qualquer nó no domínio peer tem acesso de leitura e gravação a essas classes de recursos através do gerenciador de recursos de configuração.

Status de saída

0: O comando correu com sucesso.
1: Ocorreu um erro com a RMC.
2: Ocorreu um erro com um script de interface da linha de comandos.
3: Uma sinalização incorreta foi inserida na linha de comando.
4: Um parâmetro incorreto foi inserido na linha de comando.
5: Ocorreu um erro que foi baseado em entrada de linha de comandos incorreta.

Variáveis de ambiente

CT_CONTACT: Determina o sistema onde ocorre a sessão com o daemon de monitoramento e controle de recursos (RMC). Quando o CT_CONTACT é configurado para um nome de host ou endereço IP, o comando entra em contato com o daemon RMC no host especificado. Se CT_CONTACT não estiver configurado, o comando entra em contato com o daemon RMC no sistema local onde o comando está sendo executado. O alvo da sessão do daemon RMC e o escopo de gerenciamento determinam as classes de recursos ou recursos que são processados.
CT_IP_AUTHENT: Quando a variável de ambiente CT_IP_AUTHENT existe, o daemon RMC usa autenticação de rede baseada em IP para entrar em contato com o daemon RMC no sistema que é especificado pelo endereço IP ao qual a variável de ambiente CT_CONTACT está configurada. CT_IP_AUTHENT só tem significado se CT_CONTACT for configurado para um endereço IP; ele não depende do serviço de DNS (domain name system).

Restrições

Este comando deve ser executado em um nó que é definido e online para o domínio de pares onde o grupo de comunicação deve ser definido.

Especificações de implementação

Esse comando faz parte do conjunto de arquivos RSCT (Reliable Scalable Cluster Technology ) para AIX.

entrada padrão

Quando o sinalizador -f "-" ou -F "-" é especificado, este comando lê um ou mais nomes de nós da entrada padrão.

Saída Padrão

Quando a sinalização -h é especificada, a instrução de uso deste comando é escrita para saída padrão. Todas as mensagens de verbose são gravadas na saída padrão.

Erro Padrão

Todas as mensagens de rastreio são escritas para erro padrão.

Exemplos

Para definir o grupo de comunicação ComGrp1 para o domínio peer ApplDomain e nodeA é definido e online para ApplDomain, execute este comando em nodeA:
```
mkcomg ComGrp1
```
Para definir o grupo de comunicação ComGrp1 para o domínio peer ApplDomain, usando uma sensibilidade de 1 e período de 3, e nodeA é definido e online para ApplDomain, execute este comando em nodeA:
```
mkcomg -s 1 -p 3 ComGrp1
```
Para definir o grupo de comunicação ' ComGrp1 para o domínio de pares ' ApplDomain, sem usar broadcast, usando uma prioridade de 3, e ' nodeA está definido e on-line para ' ApplDomain, execute este comando no nodeA:
```
mkcomg -x b -t 3 ComGrp1
```
Para definir o grupo de comunicação ComGrp1 para o domínio do peer ApplDomain, não usando broadcast, não usando roteamento de origem, e nodeA é definido e online para ApplDomain, execute o seguinte comando em nodeA:
```
mkcomg -x br ComGrp1
```
Para definir o grupo de comunicação ComGrp1 para o domínio do peer ApplDomain, usando um caminho NIM de /opt/rsct/bin/hats_nim, os parâmetros NIM -l 5 para configurar o nível de criação de log, e nodeA é definido e online para ApplDomain, execute este comando em nodeA:
```
mkcomg -e /opt/rsct/bin/hats_nim -m "-l 5" ComGrp1
```
Para definir o grupo de comunicação ComGrp1 para ApplDomain e atribuir ComGrp1 ao recurso de interface de heartbeat chamado hbi0 no nodeC, execute este comando no nodeA:
```
mkcomg -i h:hbi0:nodeC ComGrp1
```
Para definir o grupo de comunicação ComGrp1 para o domínio do peer ApplDomain, atribua ComGrp1 ao recurso de interface de rede denominado eth0 em nodeB, e nodeA é definido e online para ApplDomain, execute este comando em nodeA:
```
mkcomg -i n:eth0:nodeB ComGrp1
```
Para definir o grupo de comunicação ComGrp1 para ApplDomain e atribuir ComGrp1 ao recurso de interface de heartbeat que usa a sub-rede 9.345.67.812, execute este comando no nodeA:
```
mkcomg -S h:"Subnet == 9.345.67.812" ComGrp1
```
Para definir o grupo de comunicações ComGrp1 para o domínio do mesmo nível ApplDomain, designe ComGrp1 ao recurso da interface de rede que usa a sub-rede 9.123.45.678e nodeA está definido e on-line para ApplDomain, execute este comando em nodeA:
```
mkcomg -S n:"Subnet == 9.123.45.678" ComGrp1
```
Para definir o grupo de comunicação ComGrp1 para ApplDomain, usando um período de 500 milissegundos, execute este comando no nodeA:
```
mkcomg -p 0.5 ComGrp1
```

Local

/opt/rsct/bin/mkcomg