Como criar, ler e excluir volumes do VDC

Quando usar este procedimento

Quando um VDC precisa de um volume em blocos: para dados de aplicações, para um disco compartilhado para um host fora do cluster ou para exportação futura via iSCSI. Um volume é criado dentro de um armazenamento do VDC já ativado, é contabilizado na cota dele e não fica visível para ninguém até ser mapeado.

Este procedimento abrange todo o ciclo de vida do volume: criação, leitura dos parâmetros e do espaço usado, e exclusão. O mapeamento de um volume para um iniciador é uma etapa separada, descrita em "Conexão de volumes via iSCSI". Se o armazenamento do VDC ainda não estiver ativado, comece pela criação de um VDC com Unified Storage.

Pré-requisitos

• A funcionalidade Unified Storage está ativada nas opções do cluster.
• O armazenamento do VDC está ativado — a aba Storage do cartão do VDC mostra o resumo dele, e não um convite para ativá-lo.
• O privilégio Create vDC Volume para a criação e Delete vDC Volume para a exclusão — 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. Verificar a cota disponível

A capacidade do armazenamento é igual à cota de armazenamento do VDC; o armazenamento não tem um limite separado. Antes de criar um volume grande, verifique quanto da cota já está em uso.

1. Abra Virtual Data Centers.
2. Observe a coluna Storage: ela mostra o espaço usado e a cota atual, com um pequeno indicador ao lado. Se nenhuma cota estiver definida, o segundo valor é "∞".
3. O filtro ao lado do campo de pesquisa filtra os VDCs pelo estado do armazenamento: All storage states, Storage enabled, Storage disabled.

A cota abrange todo o espaço usado pelo VDC, não apenas os volumes do armazenamento: os discos de máquinas virtuais são somados aos volumes. O limite é editado nas configurações do VDC usando o campo Storage (GB).

Etapa 2. Criar um volume

1. Abra o cartão do VDC → aba Storage → subaba Volumes.
2. Clique em Create volume.
3. Preencha o formulário:

Campo	O que especificar
Volume name	De 1 a 63 caracteres: letras latinas minúsculas, dígitos, pontos e hifens; o primeiro e o último caractere devem ser uma letra ou um dígito; o nome deve ser único no armazenamento deste VDC
Size	Tamanho do volume, no mínimo 1 GB; selecione a unidade ao lado do número
Protocol	iSCSI se o volume for mapeado imediatamente, ou Choose later
LUN ID	O número sob o qual o volume é visível no target; o campo vem predefinido com um número disponível
Initiator Group	Um grupo existente, um novo grupo ou Assign later

4. Clique em Create.

O pool não é selecionado no formulário — ele é obtido do armazenamento do VDC. O formulário também não pede o tamanho de bloco: a plataforma fornece o valor padrão de 32768 bytes, que aparece na coluna Block size da lista de volumes.

A capacidade é reservada na cota antes de contatar o controlador do pool. Se o controlador rejeitar a operação, a reserva é liberada e nenhum volume permanece no pool nem na lista.

Etapa 3. Ver a lista de volumes do VDC

A subaba Volumes mostra os volumes deste VDC em uma tabela simples.

Coluna	O que mostra
ID	Identificador do volume; um link para a página do volume
Name	Nome do volume no armazenamento; também é um link
Size	Tamanho do volume
Block size	Tamanho de bloco fornecido na criação
Protocol	Protocolo de exportação, ou None se o volume não estiver mapeado
Access	O grupo de iniciadores para o qual o volume é exportado
Status	Mapped ou Unmapped

A tabela oferece pesquisa, ordenação por coluna e paginação. Um armazenamento vazio mostra a mensagem "No volumes yet".

Os volumes ficam visíveis mesmo antes da configuração do iSCSI: criar um volume e mapeá-lo são etapas independentes. Uma tela separada, "All volumes", consolida os volumes de todos os VDCs: uma única tabela paginada com filtros por VDC, pool, status de mapeamento e protocolo. Cada linha mostra o VDC, o pool e o tamanho do volume. A tela está disponível apenas para o papel Cluster master. Um resultado filtrado vazio é distinguível de um cluster sem volumes.

Etapa 4. Abrir o cartão do volume

Clique no nome ou no identificador do volume na lista.

O cabeçalho da página mostra o nome do volume e seu status: Mapped ou Unmapped. Abaixo há dois cartões e uma seção de mapeamento.

Bloco	Conteúdo
Properties	Name, Pool, Size, Path — o nome completo do volume no pool. Um volume mapeado também tem Protocol, LUN ID e Target, com um link para a página do target
Capacity	Espaço usado e disponível, taxas de compressão e de deduplicação. O espaço disponível é o espaço restante no próprio volume, e não a capacidade livre do pool
Initiator Group Mapping	O nome do grupo de iniciadores com um link para a página dele, e os subcartões Initiators e Authorized networks

Leia a página da seguinte forma. O vStack Center fornece Properties e o status de mapeamento a partir dos seus registros, enquanto as métricas de Capacity são solicitadas ao controlador do pool quando a página é aberta. Um controlador indisponível não impede o carregamento da página: os valores de Capacity ficam vazios, e todo o resto é exibido.

Para um volume não mapeado, a seção Initiator Group Mapping mostra "Volume is not mapped" e o botão Map volume, enquanto Protocol em Properties é None.

O indicador de cada iniciador no subcartão Initiators reflete uma comparação da composição do grupo com o controlador, e não o estado da sessão. Connected significa que o controlador conhece essa entrada; Disconnected significa que a entrada existe apenas nos registros do vStack Center. Se o controlador estiver indisponível, não há com o que comparar, e o indicador fica vazio.

Etapa 5. Excluir o volume

A exclusão é iniciada com a ação Delete volume. Se o volume estiver mapeado, o vStack Center primeiro remove o mapeamento e, em seguida, exclui o volume.

Assim que o controlador confirma, o volume desaparece da lista e a cota do VDC é liberada. Se o controlador informar que não tem esse volume, a operação também é considerada bem-sucedida — os registros são limpos e a discrepância é resolvida.

Se o mapeamento foi removido com sucesso, mas o controlador depois rejeitou a destruição do volume (por exemplo, por causa de snapshots ou clones), o volume permanece na lista sem mapeamento. Remova a dependência e tente excluir novamente; para restaurar o acesso ao volume, mapeie-o de novo.

Verificar o resultado

Volte para a subaba Volumes.

Esperado após a etapa 2: a tabela contém uma linha com o nome do seu volume, a coluna Size mostra o tamanho especificado e a coluna Status mostra Unmapped. Esperado após a etapa 5: a tabela não contém mais uma linha para esse volume, e o espaço usado na coluna Storage da tela Virtual Data Centers diminuiu no tamanho do volume.

Solução de problemas

O que você vê	Por quê	O que fazer
"Storage is not enabled for VDC" (-45013)	O armazenamento do VDC não está ativado, portanto não há onde criar volumes	Ative o armazenamento na aba Storage — consulte as etapas em criação de um VDC com Unified Storage
"Quota exceeded" (-45017)	O tamanho solicitado excede a cota disponível do VDC; a mensagem mostra o espaço solicitado e o disponível	Reduza Size ou aumente a cota Storage (GB) nas configurações do VDC
"Volume already exists" (-45018)	O nome é usado por outro volume no mesmo armazenamento	Especifique outro Volume name; encontre o volume que usa esse nome na lista Volumes — os nomes são únicos no armazenamento do VDC, e não no cluster
"Invalid volume parameters" (-45019)	Os valores não passaram na validação: tamanho, tamanho de bloco ou formato do nome	Verifique Volume name de acordo com as regras da etapa 2 e garanta que Size seja de pelo menos 1 GB
"Unknown volume" (-45026)	O volume não existe, pertence a outro VDC ou ainda não foi confirmado pelo controlador	Atualize a lista Volumes e abra o volume novamente; a mesma resposta abrange os três casos — a propriedade de um volume de outro VDC não é revelada
"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, sem exceção para o papel Cluster master
Pool de armazenamento não encontrado (-45002)	Os registros e o estado do pool estão inconsistentes	Verifique o estado do pool na seção "Pools de armazenamento"
O controlador do pool não respondeu ou rejeitou a operação (-45020, -45021)	O pool está indisponível ou rejeitou uma das etapas da exclusão	Verifique a disponibilidade do pool, atualize o cartão do volume e verifique o status de mapeamento antes de tentar novamente
Exclusão rejeitada com uma mensagem da plataforma	Snapshots ou clones dependem do volume — a plataforma repassa o motivo sem alterações	Remova as dependências no pool e tente excluir novamente
"Access denied" (-403)	Falta um privilégio necessário, ou o VDC está fora do seu escopo	Trabalhe dentro do seu VDC; leituras entre VDCs estão disponíveis apenas para o papel Cluster master

Veja também

• Armazenamento do VDC — modelo e arquitetura — invariantes do modelo e separação de acesso.
• Conexão de volumes via iSCSI — como exportar um volume para um iniciador e remover o mapeamento.
• Como ver e alterar propriedades de datasets — propriedades ZFS no nível do dataset.

Métodos da API

Operações de API abordadas nesta página: vdc-create-volume, vdc-list-volumes, vdc-volume-get, vdc-volume-delete, vdc-storage-list, cluster-list-volumes — consulte a referência da API.