Como mapear um volume via iSCSI e remover o mapeamento

Quando usar este procedimento

Quando um volume foi criado, mas o host ainda não o vê. O mapeamento é a última etapa da sequência: ele adiciona o volume ao target do VDC sob o número de LUN selecionado e limita sua visibilidade a um grupo de iniciadores. Antes desta etapa, o volume existe e consome cota, mas não está acessível para ninguém.

A operação inversa é o desmapeamento. Ela remove o LUN do target, mas mantém o volume: nenhum dado é excluído. O desmapeamento é necessário quando o volume precisa ser mantido, mas o acesso a ele precisa ser bloqueado ou alterado. Quando um volume mapeado é excluído, o vStack Center remove o mapeamento automaticamente.

Pré-requisitos

• A funcionalidade Unified Storage está ativada nas opções do cluster.
• Um target iSCSI está configurado para o VDC — consulte "Como configurar um target iSCSI e a proteção por senha CHAP".
• Existe um grupo de portais no pool do armazenamento do VDC — consulte "Grupos de iniciadores e de portais".
• O volume foi criado e ainda não está mapeado: seu Status na lista Volumes é Unmapped (consulte "Volumes do VDC").
• O privilégio Map vDC Volume para o mapeamento e Unmap vDC Volume para o desmapeamento — ambos estão disponíveis para o papel Cluster master e para um administrador de VDC dentro do seu VDC.
• Versão do vStack Center — 3.0.4.

Etapa 1. Selecionar um número de LUN e um grupo de iniciadores

O número de LUN é único no target e fica no intervalo 0..255. O formulário de mapeamento fornece automaticamente um número disponível; os números já em uso são mostrados no campo LUN ID em Properties nas páginas dos volumes mapeados deste VDC.

Use um grupo de iniciadores existente ou crie um durante o mapeamento — as duas opções estão disponíveis na mesma linha de seleção do formulário.

O que você precisa	O que selecionar no formulário	Quando é útil
Exportar o volume para hosts já definidos em um grupo	Um grupo existente na lista Initiator Group	O grupo é reutilizado; a composição é editada separadamente na página dele
Criar imediatamente um grupo para este volume	Create e preencha a composição no próprio formulário	O primeiro mapeamento em um VDC; evita ir para outra tela

Etapa 2. Mapear o volume

1. Abra o cartão do VDC → aba Storage → subaba Volumes e clique no nome do volume.
2. Na seção Initiator Group Mapping, clique em Map volume.
3. Preencha o formulário:

Campo	O que especificar
Protocol	iSCSI; a opção NVMe não está disponível nesta versão e está marcada como Coming soon
LUN ID	Um número disponível em 0..255; o campo já vem preenchido com um valor sugerido
Initiator Group	Um grupo existente ou Create — nesse caso, preencha Group name, Allowed Initiators (IQN) e Authorized networks

4. Confirme o mapeamento.

Você não seleciona um grupo de portais no formulário: é usado o grupo vinculado ao pool do armazenamento do VDC.

O formulário aguarda a conclusão de toda a operação, e não apenas sua aceitação. Durante essa espera, o controlador do pool executa uma sequência de etapas em uma ordem deliberada:

1. O grupo de iniciadores é criado, se a criação tiver sido solicitada.
2. A associação "target — grupo de portais — grupo de iniciadores" é criada, se ainda não existir.
3. O volume é adicionado ao target como um LUN.
4. A visibilidade do LUN é limitada a esse grupo de iniciadores.

O mascaramento vem por último porque a máscara é aplicada a um LUN que já foi adicionado. O volume só é considerado mapeado depois que todas as etapas são bem-sucedidas: até que a sequência seja concluída, seu Status permanece Unmapped. Se a máscara não puder ser aplicada, o LUN adicionado é removido por uma etapa de compensação — não resta nenhum mapeamento parcial.

Etapa 3. Verificar o isolamento

A máscara limita a visibilidade do LUN a um grupo de iniciadores: outros grupos no mesmo target não veem esse volume. Um volume é exportado para exatamente um grupo — ele não pode ser mapeado para um segundo grupo.

Isso sugere uma abordagem prática: para ampliar o conjunto de hosts, adicione IQNs ao grupo já associado, em vez de desmapear o volume. Na página do volume, use o botão Edit group members na seção Initiator Group Mapping. As alterações afetam o volume imediatamente.

cuidado

Um grupo de iniciadores é um recurso compartilhado: editar a composição por meio de Edit group members afeta todos os volumes mapeados para esse grupo.

Não é possível alterar o grupo de um volume mapeado em uma única operação. Para alterar o grupo, use Unmap e, em seguida, Map volume com outro grupo.

Etapa 4. Remover o mapeamento

1. Abra a página do volume.
2. Na seção Initiator Group Mapping, clique em Unmap.
3. Confirme o desmapeamento na caixa de diálogo.

A sequência de desmapeamento espelha o mapeamento e consiste em duas etapas: primeiro, a máscara do LUN é removida e, depois, o próprio LUN. Essa ordem é obrigatória — a máscara não é removida automaticamente com o LUN, e inverter a ordem deixaria uma associação pendente. Se o controlador informar que não tem o LUN ou a máscara, isso é considerado um sucesso: os registros são limpos e a discrepância é resolvida.

O grupo de iniciadores, o target e a associação "target — grupo de portais — grupo de iniciadores" sobrevivem ao desmapeamento. A associação é reutilizada no próximo mapeamento; por isso, reconectar o mesmo volume exige menos trabalho do que a primeira conexão.

Verificar o resultado

Permaneça na página do volume.

Esperado após a etapa 2: o cabeçalho mostra Mapped; Properties agora contém Protocol, LUN ID com o número especificado e Target com um link para a página do target. A seção Initiator Group Mapping mostra o nome do grupo e os subcartões Initiators e Authorized networks.

Esperado após a etapa 4: o cabeçalho mostra Unmapped, a seção de mapeamento mostra "Volume is not mapped" e o botão Map volume, e Protocol em Properties é None.

O indicador do iniciador no subcartão Initiators reflete uma comparação da composição do grupo com o controlador: Disconnected 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
"iSCSI is not configured for VDC" (-45032)	O VDC não tem target, portanto não há onde adicionar o LUN	Configure o iSCSI na subaba Overview da aba Storage
"Unknown portal group" (-45010)	O grupo de portais não foi encontrado ou não está no pool do armazenamento deste VDC	Verifique o pool do grupo na seção Unified Storage → Protocols → iSCSI do cluster, na coluna Pool
"LUN ID … is already in use on target …" (-45029)	O número é usado por outro volume no mesmo target; a mensagem mostra o target e o número	Especifique um número disponível no intervalo 0..255 — os números já em uso são mostrados em Properties dos volumes mapeados
"Volume is already mapped" (-45027)	O volume já está mapeado, e um volume é exportado para exatamente um grupo	Amplie a composição do grupo associado por meio de Edit group members, em vez de criar um segundo mapeamento
"Volume is not mapped" (-45028)	Não há o que desmapear: o volume não está mapeado	Verifique o Status do volume na lista Volumes — provavelmente o desmapeamento já foi concluído
"Unknown volume" (-45026)	O volume não existe, pertence a outro VDC ou ainda não foi confirmado pelo controlador	Atualize a lista Volumes; a mesma resposta abrange os três casos — o volume de outro VDC não é revelado
"Unknown initiator group" (-45022)	O grupo selecionado não existe ou pertence a outro VDC	Selecione um grupo na tabela Initiator Groups do seu VDC
"Initiator group already exists" (-45023)	O nome do novo grupo já está em uso neste VDC	Especifique outro Group name ou selecione um grupo existente
"Invalid initiator group parameters" (-45025)	A composição do novo grupo não passou na validação	Verifique o nome, o formato do IQN e o formato CIDR
"Invalid volume map parameters" (-45031)	O conjunto de parâmetros não corresponde ao protocolo	Verifique se LUN ID está em 0..255 e se exatamente um grupo está selecionado — um grupo existente ou um novo com uma lista de iniciadores não vazia
"Volume map protocol is out of scope: nvme" (-45030)	O protocolo NVMe não é suportado nesta versão	O mapeamento só está disponível via iSCSI; não há alternativa
"Storage is not enabled for VDC" (-45013)	O armazenamento do VDC não está ativado	Ative o armazenamento na aba Storage
O controlador do pool não respondeu ou rejeitou a operação (-45020, -45021)	O pool está indisponível ou rejeitou uma etapa da sequência	Durante o mapeamento, o volume permanece não mapeado; durante o desmapeamento, o registro de mapeamento é mantido; verifique a disponibilidade do pool e tente novamente
Desmapeamento rejeitado com uma mensagem da plataforma	O controlador rejeitou a remoção da máscara ou do LUN e repassou o motivo sem alterações	O registro de mapeamento é mantido e o volume permanece mapeado — investigue a causa no pool
"Unified Storage feature is disabled" (-45001)	A funcionalidade Unified Storage está desativada nas opções do cluster	O administrador do cluster deve ativá-la; enquanto a funcionalidade estiver desativada, as operações de armazenamento são rejeitadas
"Access denied" (-403)	Falta o privilégio Map vDC Volume ou Unmap vDC Volume, ou outro VDC está aberto	Trabalhe dentro do seu VDC; a resposta não revela se outro VDC existe

Veja também

• Volumes do VDC — criação de volumes, o cartão e a exclusão.
• Grupos de iniciadores e de portais — as regras de acesso nas quais o mapeamento se baseia.
• Armazenamento do VDC — modelo e arquitetura — invariantes de mapeamento e separação de acesso.

Métodos da API

Operações de API abordadas nesta página: vdc-volume-map, vdc-volume-unmap, vdc-list-volumes, vdc-volume-get, iscsi-initiator-group-set — consulte a referência da API.