mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-06-01 21:14:49 +00:00
MacRimi
5ca3463bf6
Full rewrite of the docs site under app/[locale]/ with next-intl in localePrefix:"always" mode. Every page now exists at both /en/<path> and /es/<path>; the root / shows a meta-refresh + JS redirect to /<defaultLocale>/ so GitHub Pages serves something on the apex URL. Highlights: - 107 doc pages migrated to file-per-page JSON namespaces under messages/en/ and messages/es/. Spanish content is fully translated (no copy-of-English placeholders). - New documentation for the Active Suppressions section in the Settings tab and the per-event Dismiss dropdown in the Health Monitor modal. - New screenshots: dismiss-duration-dropdown.png and an updated health-suppression-settings.png. - Pagefind integrated for client-side search; index is built on every CI deploy (not committed). - RSS feeds: per-locale at /<locale>/rss.xml plus root /rss.xml for backward compat. - Removed the dead app/[locale]/guides/[slug]/ route — every guide now has its own static page and no markdown source remains. - Fixed orphan link /guides/nvidia -> /guides/nvidia-manual in docs/hardware/nvidia-host. - Removed obsolete components (footer2, calendar, drawer). Verified locally with `npm ci && npm run build`: 2804 files in out/, 231 pages indexed by pagefind, root redirect intact, both locale roots and the new Active Suppressions docs render OK.
228 lines
8.0 KiB
JSON
228 lines
8.0 KiB
JSON
{
|
|
"meta": {
|
|
"title": "Comandos ZFS en Proxmox — zpool, zfs snapshot, send/receive, scrub | ProxMenux",
|
|
"description": "Referencia de comandos de gestión ZFS en Proxmox VE: zpool create / status / history, zfs list / get / set, snapshots, clone, zfs send y receive, scrub, clear, replace, zpool iostat, resumen de ARC.",
|
|
"ogTitle": "Comandos ZFS en Proxmox — zpool, zfs snapshot, send/receive, scrub",
|
|
"ogDescription": "Referencia de comandos zpool y zfs en Proxmox VE — pools, datasets, snapshots, replicación, mantenimiento.",
|
|
"twitterTitle": "Comandos ZFS en Proxmox | ProxMenux",
|
|
"twitterDescription": "Comandos zpool y zfs para Proxmox VE: pools, datasets, snapshots, replicación, mantenimiento."
|
|
},
|
|
"header": {
|
|
"title": "Gestión de ZFS",
|
|
"description": "Referencia curada de comandos zpool y zfs: inspección de pools, CRUD de datasets, snapshots, clone y send/receive (incremental y recursivo), scrub / clear / replace para mantenimiento, además de estadísticas de E/S y resumen de ARC.",
|
|
"section": "Ayuda e información"
|
|
},
|
|
"intro": {
|
|
"title": "Dos familias de comandos",
|
|
"body": "<code>zpool *</code> gestiona los pools de almacenamiento (capa física — discos, vdevs, redundancia). <code>zfs *</code> gestiona los datasets y snapshots que viven dentro de esos pools (capa lógica — sistemas de ficheros, volúmenes, snapshots, propiedades)."
|
|
},
|
|
"commandGroups": [
|
|
{
|
|
"title": "Información de pool",
|
|
"commands": [
|
|
{
|
|
"command": "zpool list",
|
|
"description": "Listar todos los pools ZFS"
|
|
},
|
|
{
|
|
"command": "zpool status",
|
|
"description": "Mostrar el estado y la salud detallada de los pools"
|
|
},
|
|
{
|
|
"command": "zpool status -v",
|
|
"description": "Mostrar el estado del pool en modo verboso con errores"
|
|
},
|
|
{
|
|
"command": "zpool history",
|
|
"description": "Mostrar el historial de comandos de todos los pools"
|
|
},
|
|
{
|
|
"command": "zpool history <pool>",
|
|
"description": "Mostrar el historial de comandos de un pool concreto"
|
|
},
|
|
{
|
|
"command": "zpool get all <pool>",
|
|
"description": "Mostrar todas las propiedades de un pool"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Gestión de datasets",
|
|
"commands": [
|
|
{
|
|
"command": "zfs list",
|
|
"description": "Listar todos los datasets ZFS"
|
|
},
|
|
{
|
|
"command": "zfs list -r <pool>",
|
|
"description": "Listar todos los datasets de un pool recursivamente"
|
|
},
|
|
{
|
|
"command": "zfs create <pool>/<dataset>",
|
|
"description": "Crear un nuevo dataset"
|
|
},
|
|
{
|
|
"command": "zfs destroy <pool>/<dataset>",
|
|
"description": "Destruir un dataset"
|
|
},
|
|
{
|
|
"command": "zfs rename <pool>/<dataset> <pool>/<new-name>",
|
|
"description": "Renombrar un dataset"
|
|
},
|
|
{
|
|
"command": "zfs get all <pool>/<dataset>",
|
|
"description": "Mostrar todas las propiedades de un dataset"
|
|
},
|
|
{
|
|
"command": "zfs set compression=on <pool>/<dataset>",
|
|
"description": "Activar la compresión en un dataset"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Gestión de snapshots",
|
|
"commands": [
|
|
{
|
|
"command": "zfs list -t snapshot",
|
|
"description": "Listar todos los snapshots"
|
|
},
|
|
{
|
|
"command": "zfs list -t snapshot -r <pool>",
|
|
"description": "Listar todos los snapshots de un pool"
|
|
},
|
|
{
|
|
"command": "zfs snapshot <pool>/<dataset>@<snapshot-name>",
|
|
"description": "Crear un snapshot"
|
|
},
|
|
{
|
|
"command": "zfs destroy <pool>/<dataset>@<snapshot-name>",
|
|
"description": "Borrar un snapshot"
|
|
},
|
|
{
|
|
"command": "zfs rollback <pool>/<dataset>@<snapshot-name>",
|
|
"description": "Hacer rollback a un snapshot"
|
|
},
|
|
{
|
|
"command": "zfs hold <tag> <pool>/<dataset>@<snapshot-name>",
|
|
"description": "Poner un hold en un snapshot"
|
|
},
|
|
{
|
|
"command": "zfs release <tag> <pool>/<dataset>@<snapshot-name>",
|
|
"description": "Liberar un hold en un snapshot"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Clone y send/receive",
|
|
"commands": [
|
|
{
|
|
"command": "zfs clone <pool>/<dataset>@<snapshot> <pool>/<clone-name>",
|
|
"description": "Crear un clone a partir de un snapshot"
|
|
},
|
|
{
|
|
"command": "zfs send <pool>/<dataset>@<snapshot> > backup.zfs",
|
|
"description": "Enviar un snapshot a un fichero"
|
|
},
|
|
{
|
|
"command": "zfs receive <pool>/<dataset> < backup.zfs",
|
|
"description": "Recibir un snapshot desde un fichero"
|
|
},
|
|
{
|
|
"command": "zfs send -i <pool>/<dataset>@<snap1> <pool>/<dataset>@<snap2> > incr.zfs",
|
|
"description": "Enviar un snapshot incremental"
|
|
},
|
|
{
|
|
"command": "zfs send -R <pool>/<dataset>@<snapshot> > full-recursive.zfs",
|
|
"description": "Enviar un snapshot recursivo"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Mantenimiento y reparación",
|
|
"commands": [
|
|
{
|
|
"command": "zpool scrub <pool>",
|
|
"description": "Iniciar un scrub sobre un pool"
|
|
},
|
|
{
|
|
"command": "zpool scrub -s <pool>",
|
|
"description": "Parar un scrub en curso"
|
|
},
|
|
{
|
|
"command": "zpool clear <pool>",
|
|
"description": "Limpiar los contadores de error de un pool"
|
|
},
|
|
{
|
|
"command": "zpool clear <pool> <device>",
|
|
"description": "Limpiar errores en un dispositivo concreto"
|
|
},
|
|
{
|
|
"command": "zpool replace <pool> <old-device> <new-device>",
|
|
"description": "Reemplazar un dispositivo fallido"
|
|
},
|
|
{
|
|
"command": "zpool offline <pool> <device>",
|
|
"description": "Poner un dispositivo offline"
|
|
},
|
|
{
|
|
"command": "zpool online <pool> <device>",
|
|
"description": "Poner un dispositivo online"
|
|
}
|
|
]
|
|
},
|
|
{
|
|
"title": "Rendimiento y monitorización",
|
|
"commands": [
|
|
{
|
|
"command": "zpool iostat",
|
|
"description": "Mostrar estadísticas de E/S de los pools"
|
|
},
|
|
{
|
|
"command": "zpool iostat -v",
|
|
"description": "Mostrar estadísticas de E/S detalladas"
|
|
},
|
|
{
|
|
"command": "zpool iostat 5",
|
|
"description": "Mostrar estadísticas de E/S cada 5 segundos"
|
|
},
|
|
{
|
|
"command": "arc_summary",
|
|
"description": "Mostrar estadísticas de ARC (si está instalado)"
|
|
},
|
|
{
|
|
"command": "zfs get compressratio <pool>/<dataset>",
|
|
"description": "Mostrar la ratio de compresión"
|
|
},
|
|
{
|
|
"command": "zfs get used,available,referenced <pool>/<dataset>",
|
|
"description": "Mostrar el uso de espacio"
|
|
}
|
|
]
|
|
}
|
|
],
|
|
"bestPractices": {
|
|
"title": "Buenas prácticas operativas",
|
|
"bodyRich": "Ejecuta <code>zpool scrub</code> semanal o mensualmente para detectar corrupción silenciosa. Mantén al menos un 10-15% del pool libre — el rendimiento de ZFS cae con fuerza por encima del 80% lleno. Reemplaza siempre los dispositivos fallidos con <code>zpool replace</code> (in-place) en lugar de detach + add (que pierde la redundancia temporalmente)."
|
|
},
|
|
"related": {
|
|
"heading": "Relacionado",
|
|
"items": [
|
|
{
|
|
"href": "/docs/help-info/storage-commands",
|
|
"label": "Almacenamiento y discos",
|
|
"tail": " — comandos genéricos de dispositivos de bloque y LVM."
|
|
},
|
|
{
|
|
"href": "/docs/help-info/backup-commands",
|
|
"label": "Backup y restauración",
|
|
"tail": " — vzdump, qmrestore."
|
|
},
|
|
{
|
|
"href": "/docs/help-info",
|
|
"label": "Resumen de Ayuda e información",
|
|
"tail": "."
|
|
}
|
|
]
|
|
}
|
|
}
|