mirror of
https://github.com/MacRimi/ProxMenux.git
synced 2026-11-02 10:52:22 +00:00
docs: review disk manager documentation in all seven translations
This commit is contained in:
Jonatan
@@ -0,0 +1,128 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Ajouter un contrôleur ou un NVMe à une VM | Documentation ProxMenux",
|
||||
"description": "Attribuez un contrôleur de stockage SATA/SAS HBA ou un périphérique NVMe à une VM Proxmox par passthrough PCI avec ProxMenux. L’outil gère l’activation d’IOMMU, la détection des conflits et l’affectation avec qm set --hostpci.",
|
||||
"ogTitle": "Ajouter un contrôleur ou un NVMe à une VM | Documentation ProxMenux",
|
||||
"ogDescription": "Attribuez un HBA SATA/SAS complet ou un périphérique NVMe à une VM Proxmox. ProxMenux gère IOMMU, la détection des conflits et l’affectation hostpci."
|
||||
},
|
||||
"header": {
|
||||
"title": "Ajouter un contrôleur ou un NVMe à une VM",
|
||||
"description": "Attribuez un adaptateur de bus SATA/SAS (HBA) complet ou un périphérique NVMe à une VM Proxmox par passthrough PCI. ProxMenux vérifie IOMMU et l’active avec votre accord, recense les périphériques compatibles, écarte les conflits et configure l’affectation avec qm set --hostpci.",
|
||||
"section": "Gestionnaire de disque · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que cela fait (et ne fait pas)",
|
||||
"body": "Il s’agit d’un <strong>passthrough au niveau du périphérique</strong> : la carte PCIe quitte le contrôle du noyau de l’hôte et est liée à <code>vfio-pci</code>. La VM voit le contrôleur lui-même, au lieu de disques transmis individuellement, et charge son propre pilote pour ce modèle précis. Tous les disques qui y sont raccordés suivent automatiquement, avec les données SMART natives, toutes les fonctions du firmware et aucune couche Proxmox intermédiaire."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Comment fonctionne le script",
|
||||
"body": "Le flux a deux phases avec une séparation claire entre \"collecter l'information, vérifier IOMMU et lister les candidats\" et \"en fait fixer l'appareil PCI\". Jusqu'à la confirmation finale rien n'est écrit à la config VM."
|
||||
},
|
||||
"iommu": {
|
||||
"heading": "Les groupes IOMMU — pourquoi la carte entière part à la fois",
|
||||
"body": "La limite d’isolation du passthrough PCI est le <strong>groupe IOMMU</strong>, la plus petite unité que l’IOMMU du CPU peut isoler. Les périphériques d’un même groupe ne peuvent pas être isolés les uns des autres. Si un contrôleur SATA partage son groupe avec un contrôleur USB, le passthrough SATA peut exiger de libérer aussi l’USB de l’hôte, ou être impossible. Il n’attribue pas automatiquement tous les périphériques du groupe à la VM.",
|
||||
"outro": "ProxMenux montre le groupe IOMMU à côté de chaque appareil et vous avertit lorsqu'un groupe porte plus que le contrôleur que vous voulez. Vous pouvez toujours procéder si les périphériques supplémentaires du groupe sont acceptables (tous les contrôleurs de disque, par exemple), ou revenir en arrière s'ils ne le sont pas."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Préalables",
|
||||
"items": [
|
||||
"<strong>Le CPU et la carte mère prennent en charge</strong> VT-d (Intel) ou AMD-Vi, et la fonction est activée dans le firmware (BIOS/UEFI). ProxMenux peut activer la partie noyau, mais ne peut pas modifier le réglage du firmware.",
|
||||
"La VM cible est <strong>éteinte</strong> avant l’affectation de périphériques PCI.",
|
||||
"Le contrôleur/NVMe <strong> n'est pas celui qui détient le système de fichiers racine Proxmox</strong>. Le script cache tout ce qui est utilisé par l'hôte.",
|
||||
"Le système invité dispose des pilotes du contrôleur. Linux prend en charge presque tous les HBA sans ajout de pilote ; sous Windows, le pilote du fabricant doit être installé <em>avant</em> le démarrage avec le contrôleur affecté."
|
||||
],
|
||||
"warnTitle": "La migration à chaud est impossible",
|
||||
"warnBody": "Un VM avec PCI passethrough est lié au noeud qui détient physiquement la carte. La migration en direct à travers les nœuds échouera. Planifiez les sauvegardes / réplication en conséquence."
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Étape par étape",
|
||||
"stepLabel": "Étape",
|
||||
"list": [
|
||||
{
|
||||
"title": "Choisir la VM cible",
|
||||
"bodyRich": "ProxMenux lit <code>qm list</code> et affiche chaque VM. Choisissez celui qui recevra le contrôleur.",
|
||||
"img": "/disk/nvme-passthrough/vm-selection.png",
|
||||
"alt": "Boîte de dialogue de sélection VM",
|
||||
"caption": "Boîte de dialogue de sélection VM"
|
||||
},
|
||||
{
|
||||
"title": "Vérification IOMMU",
|
||||
"bodyRich": "Si IOMMU n’est pas activé dans la ligne de commande du noyau, ProxMenux propose de l’activer. Il modifie <code>/etc/kernel/cmdline</code> pour systemd-boot ou <code>/etc/default/grub</code> pour GRUB et ajoute le paramètre adapté au CPU :",
|
||||
"items": [
|
||||
"<code>intel_iommu=on</code> pour les processeurs Intel.",
|
||||
"<code>amd_iommu=on</code> pour processeurs AMD."
|
||||
],
|
||||
"outro": "Un redémarrage est nécessaire après cette modification. Le script propose de redémarrer maintenant ou plus tard ; le passthrough ne peut continuer que lorsque la nouvelle ligne de commande du noyau est active.",
|
||||
"img": "/disk/nvme-passthrough/iommu-warning.png",
|
||||
"alt": "Boîte de dialogue IOMMU requis",
|
||||
"caption": "IOMMU requis : proposition d’activation et de redémarrage"
|
||||
},
|
||||
{
|
||||
"title": "Énumération du périphérique",
|
||||
"body": "ProxMenux liste tous les contrôleurs de stockage (SATA / SAS HBA) et tous les périphériques NVMe du bus PCI. Pour chaque appareil, il affiche :",
|
||||
"items": [
|
||||
"Adresse PCI (<code>00:17.0</code>, <code>01:00.0</code>, ...).",
|
||||
"Description du fournisseur / de l'appareil.",
|
||||
"Groupe IOMMU, avec un avertissement ⚠ s’il est partagé avec d’autres périphériques sans rapport.",
|
||||
"Les disques actuellement derrière le contrôleur (pour que vous sachiez ce qui va le suivre au VM)."
|
||||
],
|
||||
"img": "/disk/nvme-passthrough/device-list.png",
|
||||
"alt": "Liste des contrôleurs et périphériques NVMe",
|
||||
"caption": "Liste des contrôleurs et périphériques NVMe avec les groupes IOMMU"
|
||||
},
|
||||
{
|
||||
"title": "Détection des conflits",
|
||||
"bodyRich": "Le script bloque les périphériques manifestement dangereux : ceux déjà attribués à une autre VM via <code>hostpci</code> dans sa configuration, ceux utilisés par l’hôte comme le contrôleur du disque racine, ou ceux d’un groupe IOMMU dont les autres membres ne peuvent pas être identifiés de façon sûre. Les périphériques admissibles sont proposés à la sélection.",
|
||||
"img": "/disk/nvme-passthrough/conflict-warning.png",
|
||||
"alt": "Avertissement de détection des conflits",
|
||||
"caption": "Détection des conflits — dispositif bloqué avec raison"
|
||||
},
|
||||
{
|
||||
"title": "Affecter et terminer",
|
||||
"bodyRich": "Pour chaque appareil sélectionné ProxMenux exécute <code>qm set <VMID> --hostpciN <pci-addr>,pcie=1</code>, en choisissant la prochaine fente libre <code>hostpci</code>. Si IOMMU a été activé pendant cette session, on vous rappelle de redémarrer avant de démarrer le VM.",
|
||||
"img": "/disk/nvme-passthrough/assignment.png",
|
||||
"alt": "Résumé de l'attribution",
|
||||
"caption": "Résumé de l’affectation : emplacements hostpciN et adresses PCI attribuées"
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Équivalent manuel"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Dépannage",
|
||||
"noGroupsTitle": "IOMMU activé, mais aucun groupe dans /sys/kernel/iommu_groups/",
|
||||
"noGroupsBody": "Redémarrer est nécessaire pour que le noyau cmdline prenne effet. Si les groupes sont encore manquants après le redémarrage, VT-d / AMD-Vi est probablement désactivé dans le firmware — vérifiez la configuration BIOS/UEFI.",
|
||||
"busyTitle": "La VM ne démarre pas : \"hostpciN: device busy\"",
|
||||
"busyBody": "Un autre processus utilise encore le périphérique PCI. Les causes courantes sont une VM ayant planté sans le libérer ou le noyau de l’hôte l’ayant repris au dernier démarrage. Exécutez <code>lspci -nnk -s <addr></code> pour identifier le pilote associé ; il devrait s’agir de <code>vfio-pci</code>. Un redémarrage complet de l’hôte résout généralement le problème.",
|
||||
"noDisksTitle": "Invité voit le contrôleur mais pas les disques",
|
||||
"noDisksBody": "Le système invité ne dispose pas du pilote de ce contrôleur. Ce cas est rare sous Linux, mais se présente sous Windows : installez le pilote du fabricant, par exemple LSI/Broadcom pour les anciens HBA SAS, lorsque la carte n’est pas affectée, puis redémarrez avec la carte affectée.",
|
||||
"sharedTitle": "Le groupe IOMMU contient un périphérique sans rapport",
|
||||
"sharedBody": "Options : (a) déplacer la carte vers un autre emplacement PCIe pour changer son groupe, (b) activer <em>ACS override</em> dans le noyau pour diviser les groupes (compromis de sécurité : se renseigner avant de l’appliquer), ou (c) choisir une autre carte dans un groupe mieux isolé."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importer le disque vers la VM",
|
||||
"tail": "— modèle alternatif: attachez un disque physique via Proxmox sans passage PCIe complet."
|
||||
},
|
||||
{
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"label": "Ajouter GPU à VM (Passthrough)",
|
||||
"tail": "— les mêmes concepts IOMMU/VFIO appliqués à un GPU."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/gpu-commands",
|
||||
"label": "commandes GPU Passthrough",
|
||||
"tail": "— Les commandes de vérification IOMMU s'appliquent également au contrôleur / NVMe passant."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Aperçu du gestionnaire de disque",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,142 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Formater ou effacer un disque physique | Documentation ProxMenux",
|
||||
"description": "Effacez et formatez les disques physiques sur Proxmox VE avec ProxMenux. Quatre modes, des filtres stricts excluant les disques système, montés ou utilisés, et une double confirmation avec saisie du chemin complet.",
|
||||
"ogTitle": "Formater ou effacer un disque physique | Documentation ProxMenux",
|
||||
"ogDescription": "Effacez ou formatez un disque physique sur Proxmox. Filtres de sécurité, quatre modes et double confirmation."
|
||||
},
|
||||
"header": {
|
||||
"title": "Formater ou effacer un disque physique",
|
||||
"description": "Effacez ou formatez un disque physique sur l’hôte Proxmox. ProxMenux ne montre que les disques entièrement libres : aucun usage par le système, aucune référence dans les invités et aucun montage. Il impose une double confirmation, oui/non puis saisie du chemin complet du disque, avant toute destruction de données.",
|
||||
"section": "Gestionnaire de disques · Utilitaires"
|
||||
},
|
||||
"danger": {
|
||||
"title": "Outil destructif",
|
||||
"body": "Chaque opération ici écrit sur le disque. Il n'y a pas d'annulation. ProxMenux applique des filtres de sécurité stricts et des confirmations, mais la responsabilité de choisir le bon disque est à vous. Lisez le chemin du disque deux fois avant de le taper."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Comment fonctionne le script",
|
||||
"body": "Le processus comporte deux phases séparées par un filtre de sécurité à trois contrôles. La première recueille le choix du disque, le mode et les détails du système de fichiers. Aucune écriture n’a lieu avant la validation finale de la seconde phase, juste avant l’exécution."
|
||||
},
|
||||
"visibility": {
|
||||
"heading": "Règles de visibilité",
|
||||
"intro": "Avant même que le menu apparaisse, ProxMenux filtre la liste des disques. Seuls les candidats qui sont en sécurité sont présentés :",
|
||||
"items": [
|
||||
"<strong>Affichés</strong> : les disques <em>non</em> utilisés par l’hôte (pool racine, swap, montages, ZFS/LVM/RAID actifs) et <em>non</em> référencés dans une configuration VM/LXC, que l’invité soit démarré ou arrêté.",
|
||||
"<strong>Masqués</strong> : disques de l’hôte et du système.",
|
||||
"<strong>Masqués</strong> : disques référencés dans une configuration VM/LXC."
|
||||
],
|
||||
"safetyTitle": "Sécurité lors de la confirmation et de l'exécution",
|
||||
"safetyItems": [
|
||||
"Les disques contenant des métadonnées anciennes ou actives déclenchent des avertissements détaillés <em>avant</em> la confirmation.",
|
||||
"Les disques utilisés par une VM <strong>en cours d’exécution</strong> sont <strong>strictement bloqués</strong> à la confirmation.",
|
||||
"Les disques comportant des partitions montées sont <strong>strictement bloqués</strong> à l’exécution. Une nouvelle validation a lieu juste avant toute écriture.",
|
||||
"Deux confirmations sont toujours nécessaires : un dialogue <em>oui/non</em> et la saisie exacte du chemin complet du disque."
|
||||
]
|
||||
},
|
||||
"modes": {
|
||||
"heading": "Modes de fonctionnement",
|
||||
"intro": "Après avoir choisi un disque, vous choisissez l'un des quatre modes. Ils diffèrent dans ce qu'ils détruisent et ce qu'ils laissent derrière eux:",
|
||||
"headerMode": "Mode",
|
||||
"headerPart": "Table de partitions",
|
||||
"headerData": "Données",
|
||||
"headerUseCase": "Cas d'utilisation",
|
||||
"rows": [
|
||||
{
|
||||
"mode": "1. Tout effacer",
|
||||
"part": "Détruite",
|
||||
"data": "Signatures effacées",
|
||||
"useCase": "Supprimer le partitionnement et les métadonnées pour préparer une nouvelle organisation. Cela n’écrase pas toutes les données utilisateur."
|
||||
},
|
||||
{
|
||||
"mode": "2. Supprimer les étiquettes FS",
|
||||
"part": "Préservé",
|
||||
"data": "Préservé",
|
||||
"useCase": "Supprime les anciennes signatures ZFS / LVM / RAID pour empêcher la prise en charge automatique du disque. Les données utilisateur ne sont pas écrasées en bloc, mais la suppression des signatures peut les rendre inaccessibles."
|
||||
},
|
||||
{
|
||||
"mode": "3. Écraser les données avec des zéros",
|
||||
"part": "Préservé",
|
||||
"data": "Détruites (écrasées par des zéros)",
|
||||
"useCase": "Écraser les partitions existantes avec des zéros en conservant la table de partitions. Les espaces non alloués et les zones de réserve des SSD ne sont pas couverts ; cela ne garantit pas un assainissement complet du périphérique."
|
||||
},
|
||||
{
|
||||
"mode": "4. Format complet",
|
||||
"part": "Nouvelle GPT",
|
||||
"data": "Détruite",
|
||||
"useCase": "Disque prêt à utiliser avec une seule nouvelle partition et un nouveau système de fichiers."
|
||||
}
|
||||
],
|
||||
"fullFormatOutro": "<strong>Format complet</strong> continue avec deux dialogues supplémentaires:",
|
||||
"fullFormatItems": [
|
||||
"<strong>Système de fichiers</strong> : <code>ext4</code>, <code>xfs</code>, <code>exfat</code> (portable) ou <code>btrfs</code>. Si un outil manque, par exemple <code>mkfs.btrfs</code>, l’opération s’arrête avec un message explicite.",
|
||||
"<strong>Étiquette</strong> : nom facultatif du système de fichiers pour l’identifier."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Étape par étape",
|
||||
"stepLabel": "Étape",
|
||||
"list": [
|
||||
{
|
||||
"title": "Choisir un disque libre",
|
||||
"body": "ProxMenux liste les disques qui passent les filtres ci-dessus. Ceux marqués ⚠ contiennent d’anciennes métadonnées dont les détails sont affichés pour vous indiquer ce que vous allez écraser."
|
||||
},
|
||||
{
|
||||
"title": "Choisir un mode d'opération",
|
||||
"bodyRich": "Choisissez <strong>Tout effacer</strong>, <strong>Supprimer les étiquettes FS</strong>, <strong>Écraser les données avec des zéros</strong> ou <strong>Format complet</strong> selon le tableau ci-dessus."
|
||||
},
|
||||
{
|
||||
"title": "(Format complet seulement) Choisir le système de fichiers et l'étiquette",
|
||||
"body": "ext4 / xfs / exfat / btrfs, plus une étiquette en option."
|
||||
},
|
||||
{
|
||||
"title": "Confirmer deux fois",
|
||||
"bodyRich": "ProxMenux présente un résumé de ce qui va se passer. Vous acceptez avec une boîte de dialogue oui/non et <strong> tapez le chemin complet du disque</strong> exactement comme indiqué (par exemple <code>/dev/sdc</code>). Tout le reste avorte."
|
||||
},
|
||||
{
|
||||
"title": "Revalidation et exécution",
|
||||
"body": "Juste avant d'écrire, le script revérifie l'état du disque. Si une partition a été montée ou un VM a commencé dans l'intervalle, l'exécution est interrompue. Sinon, l'opération choisie tourne et un résumé est imprimé à la fin."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Équivalents manuels",
|
||||
"body": "Si vous préférez exécuter les commandes équivalentes à la main :"
|
||||
},
|
||||
"troubleshoot": {
|
||||
"notListedTitle": "Disque non listé dans le menu",
|
||||
"notListedBody": "Il a été filtré pour la sécurité. Raisons courantes : il est monté (même à <code>/mnt/tmp</code>), il est un membre actif ZFS / LVM / RAID, il est référencé par une config VM ou LXC, ou c'est votre disque racine Proxmox. Exécutez <code>lsblk -f</code> et <code>cat /proc/mdstat</code> sur l'hôte pour comprendre pourquoi.",
|
||||
"busyTitle": "\"Disk may be busy\" / échec du démontage",
|
||||
"busyBody": "Quelque chose tient toujours un fichier ouvert sur une partition de ce disque — le plus souvent un conteneur ou un shell dont cwd est à l'intérieur d'un point de montage. Identifiez-le avec <code>lsof | grep /dev/sdX</code> ou <code>fuser -vm /dev/sdX1</code>, arrêtez-le, puis lancez l'outil."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/smart-disk-test",
|
||||
"label": "Santé et test du disque SMART",
|
||||
"tail": "— vérifier un disque avant / après l'essuyage pour confirmer qu'il est sain."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importer le disque vers la VM",
|
||||
"tail": "— passer un disque fraîchement formaté à un VM."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/host-local-disk",
|
||||
"label": "Ajouter le disque local comme stockage Proxmox",
|
||||
"tail": " — enregistrer un disque essuyé comme stockage Proxmox pool."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Commandes de stockage et de disques",
|
||||
"tail": " — référence de lsblk, blkid et parted."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Aperçu du gestionnaire de disque",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,110 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importer une image disque dans une VM | Documentation ProxMenux",
|
||||
"description": "Importez un fichier image disque (.img / .qcow2 / .vmdk / .raw) dans une VM Proxmox existante avec ProxMenux. Interface, émulation SSD et option de démarrage par image, avec qm importdisk en arrière-plan.",
|
||||
"ogTitle": "Importer une image disque dans une VM | Documentation ProxMenux",
|
||||
"ogDescription": "Importer des images disque .img / .qcow2 / .vmdk / .raw dans un VM existant avec ProxMenux. Utilise qm importdisk sous le capot."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importer l'image disque vers la VM",
|
||||
"description": "Importer un fichier image disque (.img, .qcow2, .vmdk ou .raw) dans un Proxmox VM existant. ProxMenux recueille toutes les décisions dès le départ — cible VM, stockage Proxmox, répertoire source, interface, émulation SSD, ordre de démarrage — et exécute ensuite qm importdisk pour chaque image sélectionnée.",
|
||||
"section": "Gestionnaire de disque · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que ça fait",
|
||||
"body": "Contrairement à <em>Importer le disque vers la VM</em>, qui affecte un disque physique brut, ce processus utilise un <strong>fichier</strong> sur l’hôte, exporté d’un autre hyperviseur, téléchargé comme image cloud ou extrait d’une sauvegarde. Il le convertit en disque de VM Proxmox sur le stockage choisi. L’original est conservé : ProxMenux le copie sans le déplacer."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Comment fonctionne le script",
|
||||
"body": "Le flux a deux phases. La phase 1 recueille toutes les décisions (VM, stockage, répertoire source, images, options par image) directement via des dialogues. La phase 2 exécute <code>qm importdisk</code> pour chaque image sélectionnée. Jusqu'à ce que la phase 2 commence, rien n'est copié et la configuration VM n'est pas touchée."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Préalables",
|
||||
"items": [
|
||||
"Au moins une VM est définie sur l’hôte. La VM cible doit être <strong>éteinte</strong>.",
|
||||
"Au moins un fichier image d'un format pris en charge dans le répertoire source. Prise en charge: <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code>, <code>.raw</code>.",
|
||||
"Assez d'espace libre sur le stockage Proxmox cible pour tenir chaque disque importé.",
|
||||
"ProxMenux recherche des images dans <code>/var/lib/vz/template/iso</code> par défaut. Vous pouvez le pointer vers n'importe quel autre répertoire de l'hôte quand il le demande."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Étape par étape",
|
||||
"stepLabel": "Étape",
|
||||
"list": [
|
||||
{
|
||||
"title": "Choisir la VM cible",
|
||||
"bodyRich": "ProxMenux lit <code>qm list</code> et affiche chaque VM. Choisissez celui qui recevra le ou les disques importés."
|
||||
},
|
||||
{
|
||||
"title": "Choisir le stockage Proxmox",
|
||||
"bodyRich": "La liste contient chaque stockage qui a le type de contenu <code>images</code> activé. S'il n'y a qu'un seul candidat, il est sélectionné automatiquement et le dialogue est ignoré."
|
||||
},
|
||||
{
|
||||
"title": "Choisir le répertoire source",
|
||||
"bodyRich": "Choisissez le répertoire par défaut (<code>/var/lib/vz/template/iso</code>) ou saisissez un autre chemin, généralement celui où vous avez téléchargé ou envoyé l’image. Le script refuse les chemins inexistants."
|
||||
},
|
||||
{
|
||||
"title": "Choisissez une ou plusieurs images",
|
||||
"bodyRich": "Le répertoire est scanné pour les fichiers <code>.img</code> / <code>.qcow2</code> / <code>.vmdk</code> / <code>.raw</code>. Vous pouvez en sélectionner plusieurs à la fois; chacun d'eux passera par les options par image dans la prochaine étape."
|
||||
},
|
||||
{
|
||||
"title": "Options par image",
|
||||
"intro": "Pour chaque image sélectionnée ProxMenux demande:",
|
||||
"items": [
|
||||
"<strong>Interface</strong> — <code>scsi</code> (par défaut), <code>virtio</code>, <code>sata</code> ou <code>ide</code>. Correspond à la façon dont l'invité verra le disque.",
|
||||
"<strong>Émulation SSD</strong> : proposée uniquement pour les interfaces autres que VirtIO. Ajoute <code>ssd=1</code> pour que l’invité reconnaisse un disque SSD. La prise en charge de discard/TRIM doit être configurée séparément.",
|
||||
"<strong>Amorçable</strong> : si vous répondez oui, ProxMenux place le disque en tête de l’ordre de démarrage de la VM."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Importer et connecter",
|
||||
"bodyRich": "ProxMenux exécute <code>qm importdisk</code> pour chaque image, en convertissant le format si nécessaire. Il connecte le disque au prochain emplacement libre (<code>scsiN</code>, <code>sataN</code>, …) avec les options choisies et met à jour l’ordre de démarrage si un disque a été marqué comme amorçable. La progression s’affiche dans le terminal."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Équivalent manuel",
|
||||
"body": "L’importation d’une seule image correspond à trois commandes <code>qm</code> :",
|
||||
"warnTitle": "Conversion du format d'image",
|
||||
"warnBody": "Lorsque le stockage cible ne peut pas contenir le format source nativement (par exemple, le stockage LVM ne peut pas contenir <code>.qcow2</code>), <code>qm importdisk</code> convertit l'image de manière transparente. Cela peut prendre plusieurs minutes pour les images multi-GB; planifier en conséquence et ne pas interrompre le script."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Dépannage",
|
||||
"noImagesTitle": "\"Aucune image disque compatible trouvée\"",
|
||||
"noImagesBody": "Le script n’a trouvé aucun fichier <code>.img</code>, <code>.qcow2</code>, <code>.vmdk</code> ou <code>.raw</code>. Vérifiez la casse de l’extension, la présence du fichier directement dans le répertoire choisi (les sous-répertoires ne sont pas parcourus) et les droits de lecture de root.",
|
||||
"slowTitle": "L'importation est lente",
|
||||
"slowBody": "Les conversions entre VMDK, QCOW2 et raw peuvent être limitées par le CPU et les entrées-sorties. La vitesse dépend des lectures à la source, des écritures à destination et de la décompression éventuelle. Préférez des sources raw ou qcow2 si possible.",
|
||||
"uefiTitle": "Le disque importé démarre dans le shell UEFI",
|
||||
"uefiBody": "L’image a été créée pour le mode hérité (SeaBIOS), mais la VM utilise OVMF, ou inversement. Changez le BIOS de la VM dans Proxmox pour correspondre à l’image, ou recréez l’image dans le bon mode avant l’importation."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importer le disque vers la VM",
|
||||
"tail": "— même flux mais pour les disques physiques bruts (passthrough)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils/import-vm",
|
||||
"label": "Importer VM de OVA / OVF",
|
||||
"tail": "— lorsque vous avez un paquet complet VM, pas seulement une image de disque."
|
||||
},
|
||||
{
|
||||
"href": "/docs/utils/UUp-Dump-ISO-Creator",
|
||||
"label": "Créateur d’ISO UUP Dump",
|
||||
"tail": "— générer une ISO Windows si vous en avez besoin pour une nouvelle installation."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Commandes de stockage et de disques",
|
||||
"tail": " — référence de qm importdisk et qemu-img convert."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Aperçu du gestionnaire de disque",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,115 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importer le disque vers LXC | ProxMenux Documentation",
|
||||
"description": "Joindre un disque physique à un conteneur LXC existant sur Proxmox VE en utilisant ProxMenux. Gestion de la détection de système de fichiers / formatage, point de montage, non privilégié → conversion privilégiée et chemins de périphériques persistants.",
|
||||
"ogTitle": "Importer le disque vers LXC | ProxMenux Documentation",
|
||||
"ogDescription": "Connectez un disque physique à un conteneur LXC existant. Gestion du système de fichiers, du point de montage et de la conversion de non privilégié à privilégié."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importer un disque vers LXC",
|
||||
"description": "Connectez un disque physique à un conteneur LXC existant sur l’hôte Proxmox. ProxMenux détecte les disques libres, propose de les formater avec un système de fichiers pris en charge, puis relie la partition à un point de montage dans le conteneur à l’aide de chemins de périphériques persistants.",
|
||||
"section": "Gestionnaire de disque · LXC"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Passthrough VM vs Passthrough LXC",
|
||||
"body": "Ce passthrough LXC <strong>ne fournit pas un périphérique bloc brut</strong>. Le conteneur reçoit un <em>point de montage</em>, c’est-à-dire un répertoire reposant sur une partition choisie sur l’hôte. Contrairement à une VM, il utilise le noyau de l’hôte ; le système de fichiers (ext4/xfs/btrfs) est donc lu et géré par l’hôte Proxmox puis exposé au conteneur."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Comment fonctionne le script",
|
||||
"body": "Le processus comporte deux phases distinctes : collecte des informations et des choix, puis modification effective de la configuration du conteneur. Rien n’est monté dans le CT avant la confirmation finale.",
|
||||
"summary": "ProxMenux exclut le disque racine, les disques montés et ceux référencés dans une configuration VM/LXC. Les membres actifs de ZFS/LVM/RAID sont masqués ; les anciennes signatures portent un symbole ⚠ pour pouvoir les effacer avant le formatage."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Préalables",
|
||||
"items": [
|
||||
"Au moins un conteneur LXC défini sur l'hôte.",
|
||||
"Le conteneur est <strong>privilégié</strong>, ou vous acceptez la conversion proposée par le script.",
|
||||
"Au moins un disque physique non utilisé par l'hôte ou tout autre invité."
|
||||
],
|
||||
"warnTitle": "Conteneur privilégié requis",
|
||||
"warnBody": "Ce script exige un conteneur <strong>privilégié</strong> pour connecter directement le disque. S’il détecte <code>unprivileged: 1</code>, il propose de modifier <code>/etc/pve/lxc/<CTID>.conf</code> sur place. Cela change le modèle de sécurité sans remapper les propriétaires des fichiers existants. Sauvegardez le conteneur et vérifiez les propriétaires avant d’accepter, ou recréez-le en mode privilégié."
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Étape par étape",
|
||||
"stepLabel": "Étape",
|
||||
"list": [
|
||||
{
|
||||
"title": "Choisir le conteneur cible",
|
||||
"img": "/disk/select-container.png",
|
||||
"caption": "Menu de sélection des conteneurs",
|
||||
"bodyRich": "ProxMenux liste tous les conteneurs LXC de l’hôte (<code>pct list</code>). Choisissez celui qui recevra le disque. S’il est non privilégié, le script propose de le convertir maintenant."
|
||||
},
|
||||
{
|
||||
"title": "Choisir le disque physique",
|
||||
"img": "/disk/disk-selection-ct.png",
|
||||
"caption": "Disques libres détectés sur l’hôte, avec ⚠ pour les anciennes métadonnées",
|
||||
"bodyRich": "Seuls les candidats sûrs sont affichés. Contrairement au processus pour VM, ce script connecte <strong>un disque par exécution</strong>. Relancez-le pour chaque disque supplémentaire."
|
||||
},
|
||||
{
|
||||
"title": "Formater ou réutiliser",
|
||||
"intro": "Le script inspecte le disque :",
|
||||
"items": [
|
||||
"S'il porte déjà un système de fichiers supporté (ext4 / xfs / btrfs), vous pouvez le réutiliser tel quel (les fichiers existants sont conservés).",
|
||||
"S'il n'a pas de système de fichiers pris en charge, vous êtes offert pour le formater. Choisir ext4 / xfs / btrfs."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Choisir le point de montage",
|
||||
"bodyRich": "Tapez le chemin où le conteneur doit voir le disque, par exemple. <code>/mnt/data</code> ou <code>/mnt/disk_passthrough</code>. C'est le chemin <em>dans le conteneur</em> ; l'hôte voit déjà la partition sous <code>/dev/disk/by-id/…</code>."
|
||||
},
|
||||
{
|
||||
"title": "Connecter et vérifier",
|
||||
"img": "/disk/assignment-ct.png",
|
||||
"caption": "Attribution à CT",
|
||||
"bodyRich": "ProxMenux ajoute une nouvelle entrée <code>mpN:</code> à la configuration du conteneur, saute les index déjà utilisés et relise la configuration pour la confirmer. Si le conteneur est en cours d'exécution, le montage est en direct; sinon, il prend effet au prochain départ.",
|
||||
"extraImg": "/disk/result-point.png",
|
||||
"extraAlt": "Point de montage créé avec succès",
|
||||
"extraCaption": "Point de montage créé et vérifié"
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Équivalent manuel",
|
||||
"body": "Le script enveloppe <code>pct set</code>. Une invocation directe pour un seul disque ressemble à :"
|
||||
},
|
||||
"important": {
|
||||
"heading": "Considérations importantes",
|
||||
"items": [
|
||||
"<strong>Un disque par exécution</strong>. Relancez le script pour chaque disque supplémentaire.",
|
||||
"Ne connectez <strong>pas</strong> la même partition à plusieurs conteneurs susceptibles de la monter simultanément : les écritures concurrentes corrompent le système de fichiers.",
|
||||
"<strong>Les anciennes métadonnées</strong> (signature RAID / ZFS / LVM) doivent être effacées manuellement avant que le script ne vous laisse formater, sinon <code>mkfs</code> refuse d'écraser. Utilisez l'outil <wipeLink>Format / Wipe Physical Disk</wipeLink> pour cela."
|
||||
]
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Dépannage",
|
||||
"unprivTitle": "\"Ne peut pas continuer avec un conteneur non privilégié\"",
|
||||
"unprivBody": "Vous avez refusé la conversion. Le paramètre de <code>/etc/pve/lxc/<CTID>.conf</code> passe de <code>unprivileged: 1</code> à <code>unprivileged: 0</code>, mais cela ne convertit pas à lui seul les UID/GID des fichiers existants. Sauvegardez et traitez le mappage des propriétaires avant une conversion sur place ; sinon, restaurez ou recréez le conteneur en mode privilégié.",
|
||||
"permsTitle": "Les autorisations à l'intérieur du conteneur sont erronées",
|
||||
"permsBody": "Le montage dans un conteneur privilégié conserve les propriétaires des fichiers existants ; un système de fichiers neuf appartient souvent à <code>root:root</code>. Si le service utilise un autre compte, par exemple <code>www-data</code> pour Nextcloud, vérifiez son UID/GID et ajustez les fichiers nécessaires avec <code>chown</code>/<code>chmod</code>. Ces changements affectent aussi le disque sous-jacent."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"label": "Importer le disque vers la VM",
|
||||
"tail": " — processus équivalent pour les VM."
|
||||
},
|
||||
{
|
||||
"href": "/docs/storage-share/lxc-mount-points",
|
||||
"label": "Points de montage LXC (hôte ↔ CT)",
|
||||
"tail": "— partager les répertoires hôtes avec un CT au lieu de fixer un disque entier."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/vm-ct-commands",
|
||||
"label": "Commandes de gestion VM et CT",
|
||||
"tail": "— pct config / push / pull reference."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Aperçu du gestionnaire de disque",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,113 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Importer le disque vers VM | ProxMenux Documentation",
|
||||
"description": "Connectez un disque physique à une VM Proxmox existante avec ProxMenux. Détection excluant les disques système, montés, utilisés ou membres actifs ZFS/RAID/LVM, chemins persistants /dev/disk/by-id et interfaces SATA / SCSI / VirtIO / IDE.",
|
||||
"ogTitle": "Importer le disque vers VM | ProxMenux Documentation",
|
||||
"ogDescription": "Joindre un disque physique à un Proxmox VM existant. Utilise des chemins de /dev/disk/by-id persistants et prend en charge SATA / SCSI / VirtIO / IDE."
|
||||
},
|
||||
"header": {
|
||||
"title": "Importer le disque vers la VM",
|
||||
"description": "Joindre un disque physique qui existe déjà sur l'hôte Proxmox à une machine virtuelle existante. ProxMenux détecte les disques libres, vous permet de choisir la cible VM, le type de bus (SATA / SCSI / VirtIO / IDE) et fixe tout en utilisant des chemins de /dev/disk/by-id persistants afin que la cartographie survive aux reboots et aux changements d'ordre des appareils.",
|
||||
"section": "Gestionnaire de disque · VM"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce que ça fait",
|
||||
"body": "Cette méthode utilise un disque physique brut comme support d’une interface de disque virtuel. L’invité ne reçoit pas automatiquement les données SMART natives ni les fonctions du contrôleur physique ; utilisez le passthrough PCI du contrôleur si elles sont nécessaires. Le disque est connecté via <code>/dev/disk/by-id/…</code> et non <code>/dev/sdX</code>, pour préserver l’affectation si l’ordre des périphériques change au démarrage."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Comment fonctionne le script",
|
||||
"body": "Le processus comporte deux phases distinctes : collecte des informations et des choix, puis connexion des disques à la VM. La configuration reste inchangée jusqu’à la confirmation finale.",
|
||||
"summary": "ProxMenux exclut les candidats non sûrs : disque racine, disques montés sur l’hôte, membres actifs ZFS/LVM/RAID et disques référencés dans une configuration VM/LXC. Ceux comportant d’<em>anciennes</em> métadonnées ZFS/RAID/LVM inutilisées sont marqués ⚠, sans être bloqués."
|
||||
},
|
||||
"prereqs": {
|
||||
"heading": "Préalables",
|
||||
"items": [
|
||||
"Au moins un VM défini sur l'hôte (le script envoie directement à <code>qm list</code>).",
|
||||
"La <strong>VM cible est éteinte</strong>. Si elle fonctionne, le script s’arrête avec un message ; l’ajout à chaud de disques n’est pas pris en charge par ce processus.",
|
||||
"Au moins un disque physique sur l'hôte qui n'est pas utilisé par l'hôte ou tout autre invité."
|
||||
]
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Étape par étape",
|
||||
"stepLabel": "Étape",
|
||||
"list": [
|
||||
{
|
||||
"title": "Choisir la VM cible",
|
||||
"bodyRich": "ProxMenux liste toutes les VM de l’hôte avec <code>qm list</code>. Choisissez celle qui recevra le disque. Si elle fonctionne, le script s’arrête et demande de l’éteindre d’abord."
|
||||
},
|
||||
{
|
||||
"title": "Choisissez le ou les disques physiques à attacher",
|
||||
"img": "/disk/disk-selection.png",
|
||||
"caption": "Disques libres détectés sur l’hôte, avec ⚠ pour les anciennes métadonnées",
|
||||
"body": "Le script examine les disques de l’hôte et ne propose que ceux pouvant être connectés sans conflit. La liste permet d’en sélectionner plusieurs. Les disques avec d’anciennes signatures ZFS/LVM/RAID restent affichés avec ⚠ pour indiquer qu’il faut effacer ces signatures avant leur formatage par l’invité."
|
||||
},
|
||||
{
|
||||
"title": "Choisissez l'interface du bus",
|
||||
"img": "/disk/disk-assigment.png",
|
||||
"caption": "Sélection de l'interface de bus",
|
||||
"intro": "Choisissez comment l'invité devrait voir le disque:",
|
||||
"items": [
|
||||
"<strong>SCSI</strong> — par défaut moderne pour Linux et Windows avec les pilotes VirtIO-SCSI installés.",
|
||||
"<strong>SATA</strong> — large compatibilité, fonctionne hors de la boîte sur presque tous les invités.",
|
||||
"<strong>VirtIO</strong> : périphérique bloc paravirtualisé efficace ; nécessite des pilotes dans l’invité.",
|
||||
"<strong>IDE</strong> — pour les anciens clients qui n'ont aucun des pilotes ci-dessus."
|
||||
]
|
||||
},
|
||||
{
|
||||
"title": "Connecter et vérifier",
|
||||
"bodyRich": "ProxMenux attache chaque disque sélectionné avec son meilleur chemin <code>/dev/disk/by-id/</code>, saute les index des fentes qui sont déjà utilisés dans la config VM (<code>scsi0</code>, <code>sata0</code>, ...) et relis la config pour confirmer l'assignation. Un résumé est imprimé à la fin."
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Équivalent manuel",
|
||||
"body": "Le script est un wrapper autour de <code>qm set</code>. La commande exacte pour un seul disque ressemble à ceci :",
|
||||
"migrationTitle": "La migration à chaud est impossible",
|
||||
"migrationBody": "Une VM avec un disque physique connecté directement est <strong>liée à l’hôte qui expose ce disque</strong>. Un autre nœud ne dispose généralement ni du même chemin <code>/dev/disk/by-id/…</code> ni des données. Sauvegardez et transférez ces données séparément, ou utilisez des disques virtuels gérés sur stockage partagé ou avec réplication prise en charge. Ne supposez pas que la réplication Proxmox couvre ce périphérique.",
|
||||
"shareTitle": "Ne partagez pas de disque physique entre VMs",
|
||||
"shareBody": "La fixation du même disque physique à deux VMs en même temps corrompra les données sur l'écriture suivante. ProxMenux détecte cette situation et la bloque, mais si vous contournez le script (direct <code>qm set</code>), assurez-vous qu'un seul invité monte le disque."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Dépannage",
|
||||
"noDisksTitle": "\"Aucun disque disponible pour ce VM\"",
|
||||
"noDisksIntro": "Le script a trouvé des disques, mais chaque candidat a été filtré. Raisons communes:",
|
||||
"noDisksItems": [
|
||||
"Chaque disque restant est déjà référencé dans la configuration de la cible VM.",
|
||||
"Chaque disque restant est monté sur l'hôte ou fait partie d'un ZFS / LVM / RAID actif.",
|
||||
"L'hôte a seulement le disque racine installé."
|
||||
],
|
||||
"noDisksOutro": "Exécutez <code>lsblk -f</code> sur l'hôte pour examiner l'état de chaque disque.",
|
||||
"noVisibleTitle": "VM ne voit pas le disque après le démarrage",
|
||||
"noVisibleBody": "Si vous avez choisi <strong>SCSI</strong> ou <strong>VirtIO</strong>, l'invité a besoin du pilote correspondant. Sur Linux qui est natif du noyau; sur Windows vous avez besoin de l'ISO VirtIO et d'un pilote d'installation (voir la page <winLink>Créer VM: Système Windows</winLink>). Le passage à SATA dans l'onglet matériel du VM est une solution rapide pour confirmer que le disque est physiquement attaché."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-image-vm",
|
||||
"label": "Importer l'image disque vers la VM",
|
||||
"tail": " — même processus pour les fichiers image (qcow2 / vmdk / raw / img)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/import-disk-lxc",
|
||||
"label": "Importer un disque vers LXC",
|
||||
"tail": " — processus équivalent pour les conteneurs LXC."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"label": "Ajouter un contrôleur ou un NVMe à une VM",
|
||||
"tail": "— lorsque vous avez besoin d'un PCIe complet / NVMe passthrough plutôt que le disque attaché."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Commandes de stockage et de disques",
|
||||
"tail": " — référence de qm importdisk et des commandes shell associées."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Aperçu du gestionnaire de disque",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,135 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "Gestionnaire de disques Proxmox : VM/LXC, tests SMART et effacement | ProxMenux",
|
||||
"description": "Gérez les disques physiques d’un hôte Proxmox VE avec ProxMenux : connexion aux VM ou LXC (qm set scsi/sata/virtio, pct mp), import d’images img / qcow2 / vmdk / raw, passthrough de HBA ou contrôleurs NVMe complets, effacement avec contrôles de sécurité et autotests SMART.",
|
||||
"ogTitle": "Gestionnaire de disques Proxmox : VM/LXC, tests SMART et effacement",
|
||||
"ogDescription": "Connecter des disques aux VM/LXC, importer des images, utiliser le passthrough PCI des contrôleurs, effacer avec contrôles de sécurité et lancer des tests SMART sur Proxmox VE.",
|
||||
"twitterTitle": "Gestionnaire de disques Proxmox | ProxMenux",
|
||||
"twitterDescription": "Connexion de disques aux VM/LXC, import d’images, passthrough PCI, effacement avec contrôles de sécurité et tests SMART."
|
||||
},
|
||||
"header": {
|
||||
"title": "Gestionnaire de disque",
|
||||
"description": "Le menu Gestionnaire de disques regroupe les outils ProxMenux pour les disques physiques de l’hôte : connexion aux VM et LXC, import d’images, passthrough d’un contrôleur complet ou d’un périphérique NVMe, effacement avec contrôles de sécurité et tests SMART.",
|
||||
"section": "Gestionnaire de disque"
|
||||
},
|
||||
"intro": {
|
||||
"title": "Ce menu sert à",
|
||||
"body": "Ces outils utilisent les <strong>disques physiques visibles par l’hôte Proxmox et les fichiers image qui y sont stockés</strong>. Le menu comporte trois groupes : <strong>VM</strong> (connexion de disques ou import d’images), <strong>LXC</strong> (connexion à un conteneur) et <strong>Utilitaires</strong> (formatage et état SMART). Les opérations de connexion et d’effacement masquent ou bloquent les disques système et utilisés ; SMART peut les examiner sans les effacer."
|
||||
},
|
||||
"opening": {
|
||||
"heading": "Ouverture du menu",
|
||||
"body": "Dans le menu principal de ProxMenux, sélectionnez <strong>Disk Manager</strong>. Vous verrez ceci :",
|
||||
"imageAlt": "Menu Gestionnaire de disque avec blocs VM, LXC et Utilitaires"
|
||||
},
|
||||
"groups": {
|
||||
"heading": "Trois groupes d'outils",
|
||||
"intro": "Le menu est organisé en trois groupes : <strong>VM</strong>, <strong>LXC</strong> et <strong>Utilitaires</strong>. Cliquez sur une carte pour accéder directement aux outils du groupe.",
|
||||
"vmTitle": "VM",
|
||||
"vmBody": "Outils qui fonctionnent sur des machines virtuelles existantes. Le VM doit être éteint; ProxMenux le valide avant de toucher la configuration.",
|
||||
"vmItems": [
|
||||
"Importer le disque vers la VM",
|
||||
"Importer l'image disque vers la VM",
|
||||
"Ajouter un contrôleur ou un NVMe à une VM"
|
||||
],
|
||||
"lxcTitle": "LXC",
|
||||
"lxcBody": "Outils pour conteneurs LXC existants. Ce script exige un conteneur privilégié et propose de changer le paramètre si nécessaire. Lisez d’abord les précautions sur la conversion et les propriétaires des fichiers sur la page de l’outil.",
|
||||
"lxcItems": [
|
||||
"Importer un disque vers LXC"
|
||||
],
|
||||
"utilitiesTitle": "Utilitaires",
|
||||
"utilitiesBody": "Outils côté hôte qui fonctionnent sur les disques eux-mêmes, indépendamment de tout VM ou conteneur.",
|
||||
"utilitiesItems": [
|
||||
"Formater ou effacer un disque physique",
|
||||
"Santé et test du disque SMART"
|
||||
]
|
||||
},
|
||||
"vm": {
|
||||
"heading": "VM",
|
||||
"intro": "Outils qui fonctionnent sur des machines virtuelles existantes. Le VM doit être éteint; ProxMenux le valide avant de toucher la configuration.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "HardDrive",
|
||||
"href": "/docs/disk-manager/import-disk-vm",
|
||||
"title": "Importer le disque vers la VM",
|
||||
"description": "Joindre un disque physique non assigné à un VM existant. Prend en charge SATA / SCSI / VirtIO / IDE, utilise des chemins de /dev/disk/by-id persistants."
|
||||
},
|
||||
{
|
||||
"icon": "FileDown",
|
||||
"href": "/docs/disk-manager/import-disk-image-vm",
|
||||
"title": "Importer l'image disque vers la VM",
|
||||
"description": "Importez des images disque (.img / .qcow2 / .vmdk / .raw) dans une VM existante. Processus en deux phases utilisant qm importdisk."
|
||||
},
|
||||
{
|
||||
"icon": "Cpu",
|
||||
"href": "/docs/disk-manager/add-controller-nvme-vm",
|
||||
"title": "Ajouter un contrôleur ou un NVMe à une VM",
|
||||
"description": "Passthrough PCI d’un HBA SATA/SAS complet ou d’un périphérique NVMe à une VM. Gestion de l’activation d’IOMMU et de la détection des conflits."
|
||||
}
|
||||
]
|
||||
},
|
||||
"lxc": {
|
||||
"heading": "LXC",
|
||||
"intro": "Outils pour conteneurs LXC existants. Ce script exige un conteneur privilégié et propose de changer le paramètre si nécessaire. Lisez d’abord les précautions sur la conversion et les propriétaires des fichiers sur la page de l’outil.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "Boxes",
|
||||
"href": "/docs/disk-manager/import-disk-lxc",
|
||||
"title": "Importer un disque vers LXC",
|
||||
"description": "Joindre un disque physique non assigné à un conteneur LXC existant comme point de montage. Gérer la détection de système de fichiers / format et la conversion privilégiée."
|
||||
}
|
||||
]
|
||||
},
|
||||
"utilities": {
|
||||
"heading": "Utilitaires",
|
||||
"intro": "Outils côté hôte qui fonctionnent sur les disques eux-mêmes, indépendamment de tout VM ou conteneur.",
|
||||
"options": [
|
||||
{
|
||||
"icon": "Eraser",
|
||||
"href": "/docs/disk-manager/format-disk",
|
||||
"title": "Formater/effacer le disque physique (sûr)",
|
||||
"description": "Effacement de disques avec des contrôles stricts : seuls les disques entièrement libres sont affichés et une double confirmation est toujours requise."
|
||||
},
|
||||
{
|
||||
"icon": "Activity",
|
||||
"href": "/docs/disk-manager/smart-disk-test",
|
||||
"title": "Santé et test du disque SMART",
|
||||
"description": "Exécutez des contrôles de santé SMART et des auto-tests courts/longs sur les disques SATA, SAS et NVMe. Exporte JSON pour le moniteur."
|
||||
}
|
||||
]
|
||||
},
|
||||
"safety": {
|
||||
"title": "Règles de sécurité pour la connexion et l’effacement des disques",
|
||||
"intro": "Les opérations de connexion et d’effacement excluent les périphériques susceptibles de nuire à l’hôte :",
|
||||
"items": [
|
||||
"Le <strong>disque système</strong> et les membres actifs du pool racine, du swap et de ZFS/LVM/RAID sont toujours masqués.",
|
||||
"Les disques <strong> montés</strong> n'importe où sur l'hôte sont cachés ou bloqués lors de l'exécution.",
|
||||
"Les disques <strong> référencés par un VM ou LXC</strong> en cours d'exécution ne peuvent pas être réaffectés ou effacés.",
|
||||
"Les opérations qui peuvent modifier l'état hôte (activer IOMMU, effacer) nécessitent une confirmation explicite."
|
||||
]
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/storage-share",
|
||||
"label": "Gestionnaire de stockage et de partage",
|
||||
"tail": "— enregistrer le stockage dans Proxmox lui-même (NFS / Samba / iSCSI / local) et partager les dossiers entre hôte et CT."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Commandes de stockage et de disques",
|
||||
"tail": " — référence des périphériques bloc, LVM, pvesm et SMART."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"label": "Commandes de gestion ZFS",
|
||||
"tail": "— pour les pools et ensembles de données ZFS."
|
||||
},
|
||||
{
|
||||
"href": "/docs/hardware/gpu-vm-passthrough",
|
||||
"label": "Ajouter GPU à VM (Passthrough)",
|
||||
"tail": "— les mêmes concepts IOMMU/VFIO appliqués aux GPU."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@@ -0,0 +1,146 @@
|
||||
{
|
||||
"meta": {
|
||||
"title": "État et tests SMART des disques | Documentation ProxMenux",
|
||||
"description": "Effectuez des contrôles SMART et des tests de disques sur Proxmox VE avec ProxMenux. Prise en charge de SATA/SAS avec smartmontools et de NVMe avec nvme-cli, autotests courts et longs et export JSON pour ProxMenux Monitor.",
|
||||
"ogTitle": "État et tests SMART des disques | Documentation ProxMenux",
|
||||
"ogDescription": "SMART contrôles de santé et auto-tests pour les disques SATA / SAS et NVMe sur Proxmox. Exportation de JSON pour le moniteur."
|
||||
},
|
||||
"header": {
|
||||
"title": "Santé et test du disque SMART",
|
||||
"description": "Lisez les données SMART et lancez des autotests sur les disques physiques de l’hôte Proxmox. ProxMenux installe automatiquement smartmontools pour SATA/SAS et nvme-cli pour NVMe, lance les tests dans le firmware du disque (les tests longs continuent après la fermeture du terminal) et exporte les résultats JSON pour ProxMenux Monitor.",
|
||||
"section": "Gestionnaire de disques · Utilitaires"
|
||||
},
|
||||
"intro": {
|
||||
"title": "C'est pour quoi ?",
|
||||
"body": "SMART (Autosurveillance, analyse et technologie de rapport) permet au lecteur lui-même de signaler sa santé et de faire des auto-tests. Cet outil expose ces données sans que vous ayez besoin de vous souvenir de la bonne invocation <code>smartctl</code> / <code>nvme</code> et persiste la sortie en tant que JSON afin que le moniteur puisse grapher les tendances au fil du temps."
|
||||
},
|
||||
"howRuns": {
|
||||
"heading": "Comment fonctionne le script",
|
||||
"body": "Toutes les actions ici sont non destructives — SMART lit les compteurs de firmware de disque, et les auto-tests sont en attente dans le lecteur lui-même. Aucune séparation de phase n'est nécessaire. Le flux est: vérification de dépendance → sélection de disque → sélection d'action → invocation d'outil (smartctl ou nvme-cli selon le bus disque) → sortie imprimée plus l'exportation de JSON pour le moniteur."
|
||||
},
|
||||
"deps": {
|
||||
"heading": "Dépendances",
|
||||
"body": "L'outil installe automatiquement ce dont il a besoin à la première fois. Les lecteurs SATA / SAS dépendent de <code>smartmontools</code>; les lecteurs NVMe dépendent de <code>nvme-cli</code>. Les deux :"
|
||||
},
|
||||
"actions": {
|
||||
"heading": "Actions disponibles",
|
||||
"headerAction": "Action",
|
||||
"headerWhat": "Ce qu'il lit / exécute",
|
||||
"headerDur": "Durée",
|
||||
"rows": [
|
||||
{
|
||||
"action": "État de santé rapide",
|
||||
"whatRich": "État global PASSED/FAILED et attributs clés.<br /><code>smartctl -H</code> + <code>-A</code> (SATA/SAS) ou <code>nvme smart-log</code> (NVMe).",
|
||||
"dur": "Instantané"
|
||||
},
|
||||
{
|
||||
"action": "Rapport complet",
|
||||
"whatRich": "Données complètes SMART, scrollable. <code>smartctl -x</code> pour SATA/SAS ou <code>nvme smart-log</code> + <code>id-ctrl</code> pour NVMe.",
|
||||
"dur": "Instantané"
|
||||
},
|
||||
{
|
||||
"action": "Essai court",
|
||||
"what": "Contrôle élémentaire de la surface et des circuits, lancé dans le firmware du disque.",
|
||||
"dur": "~2 minutes"
|
||||
},
|
||||
{
|
||||
"action": "Essai long",
|
||||
"what": "Analyse complète de la surface. Elle s’exécute sur le disque et continue même si vous fermez le terminal.",
|
||||
"dur": "Heures (selon la taille du disque)"
|
||||
},
|
||||
{
|
||||
"action": "Vérifier la progression du test",
|
||||
"what": "Statut de l'auto-essai actif ou le plus récent.",
|
||||
"dur": "Instantané"
|
||||
}
|
||||
],
|
||||
"tipTitle": "Les longs essais survivent à la fermeture du terminal",
|
||||
"tipBody": "Un test long s’exécute <em>dans le disque</em> sans dépendre du maintien du processus ProxMenux. Vous pouvez fermer le terminal et revenir à <strong>Vérifier la progression du test</strong>. Un redémarrage de l’hôte, une réinitialisation du contrôleur ou une coupure de courant peut interrompre le test et la collecte des résultats ; ne présumez pas d’une reprise automatique."
|
||||
},
|
||||
"json": {
|
||||
"heading": "Exportation de JSON pour le moniteur",
|
||||
"intro": "Les actions d’état, de test court et de progression écrivent un JSON horodaté dans <code>/usr/local/share/proxmenux/smart/<disk>/</code> ; les résultats des tests longs sont collectés en arrière-plan. Le rapport complet est uniquement affiché. Structure :",
|
||||
"outro": "ProxMenux Monitor utilise ces fichiers pour afficher l’évolution de l’état de chaque disque. Les anciens fichiers sont supprimés automatiquement lorsque la limite de conservation est atteinte."
|
||||
},
|
||||
"steps": {
|
||||
"heading": "Étape par étape",
|
||||
"stepLabel": "Étape",
|
||||
"list": [
|
||||
{
|
||||
"title": "Choisir un disque",
|
||||
"body": "ProxMenux répertorie chaque disque physique de l'hôte avec son modèle et sa taille. Contrairement à l'outil Format, cette liste n'est pas filtrée par sécurité — lire SMART est une opération non destructive.",
|
||||
"img": "/disk/smart/disk-selection.png",
|
||||
"alt": "Menu de sélection de disque SMART",
|
||||
"caption": "Menu de sélection de disque SMART"
|
||||
},
|
||||
{
|
||||
"title": "Choisir une action",
|
||||
"body": "Choisissez entre état de santé rapide, rapport complet, test court, test long ou vérifier les progrès. Le menu reste ouvert après chaque action afin que vous puissiez enchaîner plusieurs requêtes contre le même disque.",
|
||||
"img": "/disk/smart/action-menu.png",
|
||||
"alt": "Menu d'action SMART",
|
||||
"caption": "Menu d'action SMART (actions 5 + annulation)"
|
||||
},
|
||||
{
|
||||
"title": "(Test long seulement) Confirmer l'exécution de fond",
|
||||
"body": "ProxMenux indique que le test continuera après la fermeture du terminal et montre où sera enregistré le résultat JSON. Confirmez pour lancer le test.",
|
||||
"img": "/disk/smart/long-test-warning.png",
|
||||
"alt": "Boîte de dialogue de confirmation de test longue",
|
||||
"caption": "Confirmation de test longue — fonctionne en arrière-plan, résultat enregistré en JSON"
|
||||
},
|
||||
{
|
||||
"title": "Examen des résultats",
|
||||
"bodyRich": "L’état et les rapports s’affichent dans le terminal ; le JSON est exporté pour les actions décrites plus haut, sauf Rapport complet. Pour les tests longs, revenez à <strong>Vérifier la progression du test</strong> sur le même disque.",
|
||||
"img": "/disk/smart/quick-status.png",
|
||||
"alt": "État de santé rapide",
|
||||
"caption": "État de santé rapide (SATA — smartctl -H + -A)"
|
||||
}
|
||||
]
|
||||
},
|
||||
"manual": {
|
||||
"heading": "Équivalents manuels",
|
||||
"nvmeWarnTitle": "Les autotests NVMe dépendent du firmware du disque",
|
||||
"nvmeWarnBody": "Chaque lecteur NVMe ne supporte pas la commande d'auto-test courte/long. Si un lecteur refuse le test, le journal SMART et les données du contrôleur ID (<code>nvme smart-log</code> + <code>id-ctrl</code>) sont toujours le signal de santé le plus fiable."
|
||||
},
|
||||
"troubleshoot": {
|
||||
"heading": "Dépannage",
|
||||
"noSmartTitle": "\"Ne pouvait pas lire les données SMART de /dev/sdX\"",
|
||||
"noSmartBody": "Le disque est probablement derrière un contrôleur RAID / SAS qui ne passe pas SMART à travers. Avec des cartes à base de megaraid, essayez <code>smartctl -d megaraid,N /dev/sdX</code>. Pour les HBA en mode IT, l'invocation directe fonctionne.",
|
||||
"longTitle": "Un long test ne se termine jamais",
|
||||
"longBody": "Le disque exécute le test dans son firmware et une forte activité peut le retarder. Essayez pendant une période calme, par exemple la nuit. Pour SATA/SAS, <code>smartctl -c</code> indique le pourcentage restant ; le journal des autotests contient l’état final et les éventuels LBA en erreur. Une erreur de lecture doit être examinée ; la lenteur seule ne prouve pas un secteur défectueux."
|
||||
},
|
||||
"related": {
|
||||
"heading": "Voir aussi",
|
||||
"items": [
|
||||
{
|
||||
"href": "/docs/disk-manager/format-disk",
|
||||
"label": "Formater ou effacer un disque physique",
|
||||
"tail": "— réutiliser un disque après avoir confirmé sa santé."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/storage-commands",
|
||||
"label": "Commandes de stockage et de disques → État SMART",
|
||||
"tail": "— référence smartctl / nvme."
|
||||
},
|
||||
{
|
||||
"href": "/docs/help-info/zfs-commands",
|
||||
"label": "Commandes de gestion ZFS",
|
||||
"tail": " — zpool scrub vérifie les sommes de contrôle des données ZFS et complète les tests matériels SMART."
|
||||
},
|
||||
{
|
||||
"href": "/docs/monitor/dashboard/storage",
|
||||
"label": "ProxMenux Monitor — onglet de stockage",
|
||||
"tail": " — vue détaillée du disque utilisant le JSON exporté ici : table SMART complète, historique et rapport PDF."
|
||||
},
|
||||
{
|
||||
"href": "/docs/monitor/dashboard/hardware",
|
||||
"label": "ProxMenux Monitor — Onglet matériel",
|
||||
"tail": "— Sommaire de stockage avec modèle, capacité et vitesse de liaison négociée (courant vs maximum sur NVMe)."
|
||||
},
|
||||
{
|
||||
"href": "/docs/disk-manager",
|
||||
"label": "Aperçu du gestionnaire de disque",
|
||||
"tail": "."
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user