Cómo ver y cambiar las propiedades de un dataset

Cuándo usarlo

Cuando la pregunta se refiere a un disco concreto de una máquina virtual y no al pool completo: qué compresión usa, cuánto espacio ocupa realmente, cuánto espacio retienen sus instantáneas o si la deduplicación está habilitada. El disco de una máquina virtual reside en un dataset del pool, y las propiedades de ZFS se leen y se cambian a nivel de dataset.

Otro motivo es cambiar el algoritmo de compresión de un solo disco sin afectar a los demás. Por ejemplo, para aumentar la compresión de un dataset con datos fríos.

Este procedimiento no trata el cambio de tamaño de un disco ni las operaciones con instantáneas: son operaciones a nivel de máquina virtual. Las propiedades del dataset no pueden sustituirlas.

Requisitos previos

• Para leer las propiedades: el rol de administrador de VDC (centro de datos virtual) o superior, y solo para los datasets de su propio VDC;
• Para cambiar las propiedades: el mismo rol de administrador de VDC o superior, también dentro de su propio VDC; un rol global puede trabajar con datasets de cualquier VDC;
• La funcionalidad filesystem_options habilitada en el clúster: sin ella, las propiedades del dataset no están disponibles;
• Los algoritmos zstd y zstd-fast están disponibles cuando la funcionalidad zstd_enabled está habilitada en el clúster;
• vStack Center versión 3.0.5.

Pasos

Paso 1. Abra las propiedades del dataset

1. Abra la máquina virtual: Virtual Data Centers → el VDC correspondiente → Virtual Machines → la máquina. Desde el clúster, la misma lista se abre a través de All Virtual Machines.
2. Desplácese hasta Disks en la página de la máquina. La tabla muestra los discos de la máquina: Name, Slot, Disk size (GB), Sector size, IOps limit, MBps limit.
3. En la fila del disco correspondiente, despliegue el menú de acciones y seleccione Filesystems.

Se abre el formulario de propiedades del dataset de este disco. Su encabezado contiene el GUID del disco, la fecha de creación y el nombre completo del dataset, como pool-a/vm-100-disk-0, que identifica el pool que contiene el disco.

Si Filesystems no aparece en el menú, la funcionalidad filesystem_options está deshabilitada en el clúster.

Paso 2. Lea las propiedades

El formulario está organizado en bloques.

Bloque	Contenido
Size, Reservation	Tamaño de volumen solicitado y su reserva; el tamaño del disco de una máquina virtual no se puede cambiar mediante este formulario
Compression	Algoritmo y nivel de compresión, con los valores Compressratio y Refcompressratio al lado
Cache	Primarycache y Secondarycache: qué se almacena en caché
Otras propiedades	Checksum, Dedup, Copies, Logbias
Used	Espacio ocupado, desglosado en Usedbydataset, Usedbychildren, Usedbyrefreservation, Usedbysnapshots, Logicalused
Campos restantes	Available, Refreservation, Referenced, Logicalreferenced, Written, Volblocksize

Interprete el formulario de la siguiente manera. Size es el tamaño de volumen solicitado, que es lo que ve el sistema invitado. Used es el espacio que el dataset ocupa actualmente en el pool, y se mantiene por debajo del tamaño solicitado hasta que el sistema invitado haya escrito en todo el disco. Usedbysnapshots muestra la parte retenida por las instantáneas; las propias instantáneas se enumeran en Snapshots en la página de la máquina. Si el disco ocupa más espacio en el pool que los datos dentro del sistema invitado, la diferencia casi siempre se explica por estos campos. Compressratio muestra la ganancia obtenida por la compresión.

El conjunto completo de propiedades del dataset se describe en la referencia.

Paso 3. Cambie la compresión

1. En Compression, seleccione un algoritmo: on, off, lz4, gzip, lzjb, zle y, en un clúster con la funcionalidad zstd_enabled habilitada, también zstd y zstd-fast.
2. Para gzip, zstd y zstd-fast, establezca el nivel junto al algoritmo: gzip, de 1 a 9; zstd, de 1 a 19; zstd-fast, un valor de su propio conjunto. Un valor más bajo significa una compresión más rápida; un valor más alto, una compresión más densa.
3. Haga clic en Apply. El botón solo está activo cuando el formulario contiene cambios.
4. Espere la notificación de que el sistema de archivos se ha modificado.

Solo se envían las propiedades modificadas; el formulario no sobrescribe las demás. La pertenencia del dataset a un VDC se comprueba antes de escribir y antes de contactar con el nodo: un dataset que pertenece a otro VDC se rechaza en la entrada, y no se aplica ningún cambio en ninguna parte.

Un cambio de compresión se aplica a las escrituras futuras: los bloques ya escritos se mantienen en el formato anterior, y el nuevo algoritmo se aplica a las nuevas escrituras. Por ello, Compressratio cambia gradualmente después de la modificación y no de inmediato.

El conmutador Readonly del mismo formulario pone el dataset en modo de solo lectura. La advertencia junto a él sobre el impacto en el rendimiento describe una limitación operativa, no un cambio estético.

Verifique el resultado

Cierre el formulario y vuelva a abrir Filesystems para el mismo disco.

Resultado esperado: Compression muestra el nuevo algoritmo, y el nombre completo del dataset en el encabezado no ha cambiado. En este momento, Compressratio sigue reflejando los datos antiguos; esto es normal.

Solución de problemas

El elemento Filesystems no aparece en el menú del disco. La funcionalidad filesystem_options está deshabilitada en el clúster; una solicitud a la API devuelve el código -87, "Filesystems methods has not been enabled". No hay solución alternativa: las propiedades del dataset siguen sin estar disponibles hasta que se habilite la funcionalidad.

El formulario no está disponible, los campos están deshabilitados o falta el botón Apply. El rol no tiene permisos suficientes. La lectura y el cambio de propiedades están disponibles para un administrador de VDC o superior; una solicitud sin este permiso se rechaza con el código -403, "Access denied". Un usuario de VDC recibe -403 incluso al leer.

El formulario no se abre y no se encuentra el dataset (-58 al leer, -88 al escribir, "Dataset does not exist at users scope"). El dataset no existe o pertenece a otro VDC. Una misma respuesta abarca ambos casos como medida de protección: no se revela la existencia de un dataset de otro VDC. Solución alternativa: compruebe que está abriendo un disco de una máquina de su propio VDC; los datasets de otros VDC solo están disponibles para un rol global.

El formulario se abre, pero no se obtienen las propiedades (-57 al leer, -86 al escribir, "param guid has bad value"). La misma respuesta abarca tanto un identificador de disco no válido como un fallo de comunicación con el nodo. Actualice la página de la máquina y compruebe si responde el nodo que sirve el pool de este dataset.

La fila del dataset en la base de datos tiene el nombre vacío (-53 y -83, "Unable to locate the dataset"). El despachador encontró la fila del dataset, pero su campo de nombre está vacío, por lo que la solicitud no llega al nodo. Un disco eliminado devuelve el código -58 o -88 porque la fila ya no está en la base de datos.

El pool del dataset no tiene asignado un nodo que lo sirva (-54 y -84, "Unable to locate the pool of the dataset"). El despachador encontró la fila del pool, pero su campo de nodo actual está vacío, por lo que no hay adónde retransmitir la solicitud. Compruebe Current node de este pool en la tabla ZFS pools. Cómo abrirla se describe en Cómo ver los pools del clúster.

Véase también

• Pools de almacenamiento: dónde reside un dataset y cómo se calcula la capacidad del pool.
• Campos y códigos de error de los métodos de almacenamiento: el conjunto completo de propiedades del dataset y un resumen de los códigos.
• Crecimiento del espacio ocupado a causa de las instantáneas: en la sección "Solución de problemas".

Métodos de la API

Operaciones de la API tratadas en esta página: filesystems-get, filesystems-set; consulte la referencia de la API.