Como gerenciar grupos de iniciadores e de portais

Quando usar este procedimento

Quando você precisa definir quem se conecta ao armazenamento do VDC e por quais endereços. Os dois grupos respondem a duas perguntas diferentes. Um grupo de iniciadores define "quem está autorizado": uma lista de IQNs de hosts e as redes a partir das quais eles podem se conectar. Um grupo de portais define "onde o target escuta": um conjunto de pares "endereço + porta TCP" no pool.

A diferença se reflete tanto no escopo de propriedade quanto no lugar em que os grupos aparecem na interface. Um grupo de iniciadores pertence a um VDC — o administrador do VDC o gerencia na aba Storage. Um grupo de portais pertence a um pool e afeta todos os VDCs desse pool; por isso, ele fica na seção Unified Storage do cluster. Somente o papel Cluster master pode criar e excluir grupos de portais. Um administrador de VDC também pode ler a composição dos grupos de portais, em todos os pools do cluster.

Ambos os grupos são necessários antes que o primeiro volume seja mapeado. O mapeamento em si é descrito em "Conexão de volumes via iSCSI".

Pré-requisitos

• A funcionalidade Unified Storage está ativada nas opções do cluster.
• O armazenamento do VDC está ativado — os grupos de iniciadores residem dentro do armazenamento.
• Para criar e excluir grupos de portais — o papel Cluster master com os privilégios iSCSI Create Portal Group (13004) e iSCSI Delete Portal Group (13005).
• Para ler grupos de portais — os privilégios iSCSI View Portal Group (13006) e iSCSI List Portal Groups (13007); eles também são concedidos a um administrador de VDC em todo o cluster.
• Para grupos de iniciadores — um privilégio do domínio Unified Storage com escopo no seu VDC.
• Os IQNs dos hosts iniciadores e as redes a partir das quais eles se conectam são conhecidos.
• Versão do vStack Center — 3.0.4.

Grupos de iniciadores

Etapa 1. Criar um grupo

1. Abra o cartão do VDC → aba Storage → subaba iSCSI.
2. Acima da tabela Initiator Groups, clique em Create IG.
3. Na janela Create Initiator Group, preencha os campos:

Campo	O que especificar
Group name	De 1 a 63 caracteres: letras latinas minúsculas, dígitos, pontos e hifens; único no VDC
Allowed Initiators (IQN)	Uma lista de IQNs de hosts; adicione cada linha usando o link Add; os IQNs podem ter até 223 caracteres
Authorized networks	Uma lista de redes em notação CIDR a partir das quais as conexões são permitidas

4. Confirme a criação.

O pool não é especificado no formulário — ele é obtido do armazenamento do VDC. O grupo não tem um estado intermediário de "criação": ele só aparece na tabela depois que o controlador confirma. Se o grupo está na lista, o controlador o conhece.

Etapa 2. Ver os grupos do VDC

A tabela Initiator Groups na subaba iSCSI mostra os grupos deste VDC de forma resumida: Name, Allowed Initiators, Authorized Networks, Status. As colunas de composição contêm contagens: o número de iniciadores e de redes no grupo.

A página do grupo mostra a composição completa: clique em uma linha da tabela. A página tem duas tabelas — Allowed Initiators (IQN) e Authorized Networks — cada uma com sua própria paginação e seu botão Add.

Etapa 3. Alterar a composição do grupo

1. Abra a página do grupo.
2. Para iniciadores: Add adiciona linhas; o menu da linha oferece Edit e Delete.
3. Para redes: use as mesmas ações na tabela Authorized Networks.
4. Para renomear o grupo: Actions → Edit Group name.

A plataforma aplica a nova composição inteira, e não uma diferença: o controlador faz a alteração recriando o grupo com o mesmo identificador. As alterações afetam imediatamente os volumes exportados para esse grupo — não é necessário desmapear e remapear os volumes.

cuidado

Um grupo de iniciadores é um recurso compartilhado. Editar a composição dele afeta todos os volumes mapeados para esse grupo, e não apenas o volume de cuja página você veio.

Se a composição não mudou, o controlador não é chamado: se um nome for especificado, apenas o nome muda. Se o controlador rejeitar a etapa de recriação, a composição anterior é mantida.

Etapa 4. Excluir um grupo

1. Na página do grupo, abra Actions → Delete.
2. Confirme a exclusão.

Um grupo associado a um target não pode ser excluído: a plataforma informa quantos targets o estão usando. A associação "target — grupo de portais — grupo de iniciadores" é criada quando o primeiro volume é mapeado e, depois, existe de forma independente. O botão Unmap remove o mapeamento do volume, mas não afeta a associação; por isso, o grupo continua em uso depois que todos os mapeamentos são removidos. Ele só é liberado quando o VDC é excluído. Se o controlador informar que não tem esse grupo, a exclusão também é considerada bem-sucedida. Os registros são limpos.

Grupos de portais

Etapa 5. Criar um grupo de portais

1. Na árvore do cluster, abra Unified Storage → aba Protocols → seletor iSCSI.
2. Na lista Portal groups, clique em Create portal group.
3. Preencha o formulário:

Campo	O que especificar
Name	De 1 a 256 caracteres
Pool	Um pool do cluster; o pool selecionado determina a qual VDC o grupo pode atender
Portals	Um bloco repetível com pelo menos uma linha: IP address (IPv4) e Port no intervalo 1000–65535, com o padrão 3260. O link Add adiciona uma linha

4. Clique em Create.

Não é necessário criar portais antecipadamente: um portal não é um objeto independente; ele existe apenas como uma linha na composição do grupo. Pares "endereço + porta" duplicados são consolidados em um só, e os pares já conhecidos pelo cluster são reutilizados.

O grupo é imutável: a plataforma não oferece suporte à edição da composição de um grupo existente. Para alterar o conjunto de endereços, crie um novo grupo e mova os mapeamentos para ele.

cuidado

Um grupo de portais pertence a um pool, e não a um VDC. Todos os VDCs cujo armazenamento reside nesse pool podem vê-lo e usá-lo; por isso, alterar o conjunto de endereços é uma operação no nível do cluster.

Etapa 6. Ver os grupos de portais

A lista Portal groups mostra três colunas: Name, Pool e Portals — o número de portais no grupo. Para grupos criados antes da introdução das associações com pools, a coluna Pool fica vazia: são registros legados, e não uma falha. A lista oferece pesquisa, ordenação por coluna, paginação e exportação para CSV.

Clique no nome de um grupo — o cartão somente leitura dele é aberto à direita: Name, Pool e uma tabela Portals com as colunas IP address e Port. O cartão não tem campos de entrada nem botões de edição da composição pelo mesmo motivo — a composição do grupo é imutável. A ação Delete portal group fica na parte inferior do cartão.

A seção só é visível para o papel Cluster master: sem os privilégios de visão geral do cluster, o nó Unified Storage nem aparece na árvore.

Etapa 7. Excluir um grupo de portais

A exclusão pode ser iniciada em dois lugares — pelo ícone de lixeira na linha da lista ou pela ação Delete portal group no cartão. Ambos abrem a mesma caixa de diálogo de confirmação com o nome do grupo.

Assim que o controlador confirma, a composição do grupo, o próprio grupo e todos os portais que não pertencem a outros grupos são removidos dos registros. Os clientes que usavam esses endereços perdem imediatamente a descoberta de caminhos — por isso, a caixa de diálogo de confirmação avisa sobre isso.

Um grupo legado sem pool é excluído apenas do banco de dados: nesse caso, o controlador não é chamado, e a resposta é imediata.

Verificar o resultado

Após as etapas 1–4, abra a página do grupo de iniciadores. Esperado: a tabela Allowed Initiators (IQN) contém exatamente os IQNs especificados na sua última edição, e Authorized Networks contém as redes especificadas.

Após as etapas 5–7, atualize a lista Portal groups. Esperado após a criação: a lista contém uma linha com o nome do seu grupo, a coluna Pool preenchida e uma contagem diferente de zero na coluna Portals. Esperado após a exclusão: a linha não está mais na lista.

Uma verificação adicional para volumes mapeados é o subcartão Initiators na página do volume: Disconnected para um iniciador significa que a entrada existe nos registros do vStack Center, mas não no controlador.

Solução de problemas

O que você vê	Por quê	O que fazer
"Portal group not found. Refresh the list." (-45010)	O grupo não existe mais — a lista exibida está desatualizada	Atualize a lista Portal groups. Ao mapear um volume, o mesmo código significa outra coisa: o grupo existe, mas está em outro pool, e não no pool do armazenamento do VDC
"Portal group … is in use by a target and cannot be deleted." (-45016)	O grupo está associado a um target; a exclusão não chega ao controlador	Remova os mapeamentos que usam esse target ou mantenha o grupo: a associação "target — grupo de portais" é criada uma vez e reutilizada
"Unknown initiator group" (-45022)	O grupo não existe ou pertence a outro VDC	Verifique o grupo na tabela Initiator Groups do seu VDC; a mesma resposta abrange os dois casos — o grupo de outro VDC não é revelado
"Initiator group already exists" (-45023)	O nome do grupo já está em uso neste VDC	Especifique outro Group name — os nomes são únicos no VDC, e não no cluster
"Initiator group is in use by … target(s)" (-45024)	O grupo está associado a um target; a mensagem mostra o número de targets que o usam	O botão Unmap remove o mapeamento do volume, mas não remove a associação. O grupo só é liberado quando o VDC é excluído; portanto, mantenha-o até lá
"Invalid initiator group parameters" (-45025)	A composição não passou na validação	Insira pelo menos um iniciador e uma rede e verifique o formato do IQN, o formato CIDR e o nome do grupo
"Storage is not enabled for VDC" (-45013)	Os grupos de iniciadores residem no armazenamento do VDC, que não existe	Ative o armazenamento na aba Storage
Pool não encontrado (-45002)	O pool selecionado não existe ou não tem nome	Selecione o pool novamente; os estados dos pools são descritos na seção "Pools de armazenamento"
O formulário não aceita os valores (-32602)	Um valor não pode ser interpretado: nome vazio ou longo demais, nenhuma linha de portal ou endereço IPv4 inválido	Verifique os campos de acordo com as regras da etapa 5; o formulário sinaliza um par "endereço + porta" duplicado na segunda linha coincidente
O controlador do pool não respondeu ou rejeitou a operação (-45020, -45021)	O pool está indisponível ou rejeitou a etapa de recriação do grupo; a composição permanece inalterada	Verifique a disponibilidade do pool e tente a operação novamente
Rejeição com uma mensagem da plataforma	O controlador retornou um motivo próprio — por exemplo, que já tem um grupo com esse número	O grupo não aparece na lista, e não resta discrepância entre os registros e o controlador; resolva a causa e tente novamente
"Access denied" (-403)	A criação e a exclusão de grupos de portais estão disponíveis apenas para o papel Cluster master; para grupos de iniciadores, falta um privilégio ou o VDC está fora do seu escopo	Entre com um papel no nível do cluster ou trabalhe dentro do seu VDC; essa rejeição não bloqueia a leitura dos grupos de portais

Veja também

• Conexão de volumes via iSCSI — onde os dois grupos são usados em conjunto.
• Como configurar um target iSCSI e a proteção por senha CHAP — o ponto de acesso ao qual os grupos são associados.
• Armazenamento do VDC — modelo e arquitetura — escopos de propriedade das entidades e invariantes.

Métodos da API

Operações de API abordadas nesta página: iscsi-initiator-group-create, iscsi-initiator-group-list, iscsi-initiator-group-get, iscsi-initiator-group-set, iscsi-initiator-group-delete, iscsi-portal-group-create, iscsi-portal-group-list, iscsi-portal-group-get, iscsi-portal-group-delete — consulte a referência da API.