Como visualizar e alterar propriedades de datasets

Quando usar

Quando a questão diz respeito a um disco específico de máquina virtual, e não ao pool inteiro: qual compressão ele usa, quanto espaço ocupa de fato, quanto espaço os snapshots dele retêm ou se a deduplicação está habilitada. O disco de uma máquina virtual fica em um dataset do pool, e as propriedades ZFS são lidas e alteradas no nível do dataset.

Outro motivo é alterar o algoritmo de compressão de um único disco sem afetar os demais. Por exemplo, para aumentar a compressão de um dataset com dados frios.

Este procedimento não cobre o redimensionamento de um disco nem operações de snapshot: essas são operações no nível da máquina virtual. As propriedades do dataset não as substituem.

Pré-requisitos

• Para ler propriedades — o papel de administrador de VDC (data center virtual) ou superior, e apenas para datasets do seu próprio VDC;
• Para alterar propriedades — o mesmo papel de administrador de VDC ou superior, também dentro do seu próprio VDC; um papel global pode trabalhar com datasets de qualquer VDC;
• A feature filesystem_options habilitada no cluster — sem ela, as propriedades de datasets ficam indisponíveis;
• Os algoritmos zstd e zstd-fast ficam disponíveis quando a feature zstd_enabled está habilitada no cluster;
• vStack Center versão 3.0.5.

Etapas

Etapa 1. Abra as propriedades do dataset

1. Abra a máquina virtual: Virtual Data Centers → o VDC desejado → Virtual Machines → a máquina. A partir do cluster, a mesma lista é aberta por All Virtual Machines.
2. Role até Disks na página da máquina. A tabela mostra os discos da máquina: Name, Slot, Disk size (GB), Sector size, IOps limit, MBps limit.
3. Na linha do disco desejado, expanda o menu de ações e selecione Filesystems.

O formulário de propriedades do dataset desse disco é aberto. O cabeçalho contém o GUID do disco, a data de criação e o nome completo do dataset, como pool-a/vm-100-disk-0, que identifica o pool que contém o disco.

Se Filesystems não aparecer no menu, a feature filesystem_options está desabilitada no cluster.

Etapa 2. Leia as propriedades

O formulário é organizado em blocos.

Bloco	Conteúdo
Size, Reservation	Tamanho de volume solicitado e sua reserva; o disco de uma máquina virtual não pode ser redimensionado por este formulário
Compression	Algoritmo e nível de compressão, com os valores Compressratio e Refcompressratio ao lado
Cache	Primarycache e Secondarycache — o que é armazenado em cache
Outras propriedades	Checksum, Dedup, Copies, Logbias
Used	Espaço usado, dividido em Usedbydataset, Usedbychildren, Usedbyrefreservation, Usedbysnapshots, Logicalused
Campos restantes	Available, Refreservation, Referenced, Logicalreferenced, Written, Volblocksize

Interprete o formulário da seguinte forma. Size é o tamanho de volume solicitado, que é o que o sistema convidado enxerga. Used é o espaço que o dataset ocupa atualmente no pool, e ele fica abaixo do tamanho solicitado até que o convidado tenha gravado no disco inteiro. Usedbysnapshots mostra a parte retida por snapshots; os próprios snapshots estão listados em Snapshots na página da máquina. Se o disco ocupa mais espaço no pool do que os dados dentro do convidado, a diferença quase sempre é explicada por esses campos. Compressratio mostra os ganhos com a compressão.

O conjunto completo de propriedades de datasets está descrito na referência.

Etapa 3. Altere a compressão

1. Em Compression, selecione um algoritmo: on, off, lz4, gzip, lzjb, zle e, em um cluster com a feature zstd_enabled habilitada, também zstd e zstd-fast.
2. Para gzip, zstd e zstd-fast, defina o nível ao lado do algoritmo: gzip — de 1 a 9, zstd — de 1 a 19, zstd-fast — um valor do conjunto próprio dele. Um valor menor significa compressão mais rápida; um valor maior significa compressão mais densa.
3. Clique em Apply. O botão fica ativo apenas quando o formulário contém alterações.
4. Aguarde a notificação de que o sistema de arquivos foi alterado.

Apenas as propriedades alteradas são enviadas; o formulário não sobrescreve as demais. A propriedade do dataset por um VDC é verificada antes da gravação e antes do contato com o nó: um dataset que pertence a outro VDC é rejeitado na entrada, e nenhuma alteração é aplicada em lugar algum.

Uma alteração de compressão vale para gravações futuras: os blocos já gravados permanecem no formato antigo, e o novo algoritmo se aplica às novas gravações. Por isso, Compressratio muda gradualmente após a edição, e não imediatamente.

A opção Readonly no mesmo formulário torna o dataset somente leitura. O aviso ao lado dela sobre o impacto no desempenho descreve uma limitação operacional, não uma mudança cosmética.

Verifique o resultado

Feche o formulário e abra Filesystems novamente para o mesmo disco.

Resultado esperado: Compression mostra o novo algoritmo, e o nome completo do dataset no cabeçalho não mudou. Neste momento, Compressratio ainda reflete os dados antigos — isso é normal.

Solução de problemas

O item Filesystems não aparece no menu do disco. A feature filesystem_options está desabilitada no cluster; uma solicitação à API retorna o código -87, "Filesystems methods has not been enabled". Não há solução alternativa: as propriedades de datasets continuam indisponíveis até que a feature seja habilitada.

O formulário está indisponível, os campos estão desabilitados ou o botão Apply não aparece. O papel não tem permissões suficientes. A leitura e a alteração de propriedades estão disponíveis para um administrador de VDC ou superior; uma solicitação sem essa permissão é rejeitada com o código -403, "Access denied". Um usuário de VDC recebe -403 mesmo ao ler.

O formulário não abre, e o dataset não é encontrado (-58 na leitura, -88 na gravação, "Dataset does not exist at users scope"). O dataset não existe ou pertence a outro VDC. Uma única resposta cobre os dois casos como proteção: a existência de um dataset de outro VDC não é revelada. Solução alternativa: verifique se você está abrindo um disco de máquina do seu próprio VDC; datasets de outros VDCs estão disponíveis apenas para um papel global.

O formulário abre, mas as propriedades não são obtidas (-57 na leitura, -86 na gravação, "param guid has bad value"). A mesma resposta cobre tanto um identificador de disco inválido quanto uma falha de comunicação com o nó. Atualize a página da máquina e verifique se o nó que atende o pool desse dataset responde.

A linha do dataset no banco de dados tem um nome vazio (-53 e -83, "Unable to locate the dataset"). O dispatcher encontrou a linha do dataset, mas o campo de nome está vazio, então a solicitação não chega ao nó. Um disco excluído retorna o código -58 ou -88 porque a linha não está mais no banco de dados.

O pool do dataset não tem um nó atribuído para atendê-lo (-54 e -84, "Unable to locate the pool of the dataset"). O dispatcher encontrou a linha do pool, mas o campo de nó atual está vazio, então não há para onde repassar a solicitação. Verifique Current node desse pool na tabela ZFS pools. Como abri-la está descrito em Como visualizar os pools do cluster.

Veja também

• Pools de armazenamento — onde um dataset fica e como a capacidade do pool é calculada.
• Campos e códigos de erro dos métodos de armazenamento — o conjunto completo de propriedades de datasets e um resumo dos códigos.
• Aumento do espaço usado causado por snapshots — na seção "Solução de problemas".

Métodos da API

Operações da API abordadas nesta página: filesystems-get, filesystems-set — consulte a referência da API.