From dfe0304423bc9f98d8030abcb5d2574325aabb79 Mon Sep 17 00:00:00 2001 From: morgangch Date: Thu, 21 May 2026 09:57:19 +0200 Subject: [PATCH 1/6] FR Add OPCP how-to-install-controller --- .../how-to-install-controller/guide.en-gb.md | 120 ++++++++++++++++++ .../how-to-install-controller/guide.fr-fr.md | 120 ++++++++++++++++++ .../opcp/how-to-install-controller/meta.yaml | 2 + pages/index.md | 1 + 4 files changed, 243 insertions(+) create mode 100644 pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md create mode 100644 pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md create mode 100644 pages/hosted_private_cloud/opcp/how-to-install-controller/meta.yaml diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md new file mode 100644 index 00000000000..6673b8439f1 --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md @@ -0,0 +1,120 @@ +--- +title: "OPCP - How to install a controller" +excerpt: "Learn how to install an OPCP controller from the Debian image provided by OVHcloud" +updated: 2026-05-21 +--- + +## Objective + +This guide explains how to install an **OPCP** controller from the Debian-based installation image provided by OVHcloud. It covers preparing the installation media, cabling the server, selecting the RAID 1 disks, configuring the controller access network, and making the adjustments required after the first boot. + +> [!primary] +> +> In this guide, the **OOB** network refers to the controller access network. It is the server's first physical data interface, connected to the customer's network. +> +> It is not the server's dedicated management port (IPMI, iDRAC, iLO, and so on), which should only be used to mount the ISO or open a remote console. + +> [!warning] +> +> The installation process erases all data on the selected disks. +> +> OVHcloud provides you with services for which you are responsible. You must therefore ensure that they function correctly after the installation. + +## Prerequisites + +- A physical server intended to host the OPCP controller +- The OPCP installation image: +- A USB key, virtual media device, or any other bootable installation media +- Access to the local console or to the server's remote management console (IPMI, iDRAC, iLO, and so on) +- At least two physical disks of comparable size for the RAID 1 installation +- One network cable connected to the server's first data interface and to the customer's network +- If you use a static configuration, the IP address, subnet mask, gateway, and DNS servers for the controller access network + +## Instructions + +### 1. Download the installation image + +Download the OPCP installation image, then write it to your boot media: + +```bash +curl -O https://opcp-public-release.snc.ovh.net/releases/live-image-amd64.hybrid.iso + +sudo dd if=live-image-amd64.hybrid.iso of=/dev/sdX bs=4M status=progress oflag=sync +``` + +Replace `/dev/sdX` with the device corresponding to your installation media. + +### 2. Cable the server + +Before you start the installation: + +- connect the server's first data network interface to the customer's network +- keep the dedicated management port (IPMI, iDRAC, iLO, and so on) separate from this network configuration +- if the server has several data interfaces, use the first one so that it is easier to identify during the installation + +You can use the BMC remote console to mount the ISO and boot the server, but the BMC or IPMI port must not be used as the controller access network. + +### 3. Boot the installer + +Boot the server from the installation media, then follow the interactive installer. + +During the installation, the image: + +- detects the available physical disks +- prompts you to select the disks to use for RAID 1 +- configures the system automatically on the selected disks +- prompts you to choose the network interface used for controller access +- enables `root` SSH access on the controller at first boot + +### 4. Select the installation disks + +When prompted by the installer, select at least two physical disks for the controller. + +Use identical disks whenever possible, or disks that are as close as possible in size and performance, so that the RAID 1 configuration can be created correctly. + +The installer automatically creates the RAID 1 configuration and the system LVM layout on the selected disks. + +### 5. Configure the controller access network + +When the installer shows the list of physical network interfaces: + +1. Select the interface connected to the customer's network. +2. Choose `DHCP` if addressing is provided automatically, or `Static` if you need to enter the settings manually. +3. In static mode, enter the IP address, subnet mask, gateway, and DNS servers requested by the installer. +4. Confirm the summary before the network configuration is written. + +At the end of the base installation, this configuration is applied to the installed system to allow initial SSH access to the controller. + +### 6. Verify access after first boot + +After the server restarts: + +1. Connect from the network linked to the server's first data interface. +2. Verify that the controller IP address responds over SSH. +3. Verify that the controller can reach the network resources it needs in your environment. + +If the interface or network settings are incorrect, restart the installation and select the expected values. + +### 7. Adjust the logical volume sizes + +After the first boot, log in to the controller and adjust the logical volume sizes according to the actual disk capacity and your needs. + +> [!warning] +> +> The sizes below are example targets. Check the used and available space before reducing any volume, then adapt the values to your disk capacity. + +Start by reducing the `spare` volume, then reallocate the released space to the volumes you actually use: + +```bash +lvreduce -r -L 100G -v /dev/mapper/vg-spare +lvresize -r -L100G -v /dev/mapper/vg-home +lvresize -r -L100G -v /dev/mapper/vg-root +lvresize -r -L30G -v /dev/mapper/vg-tmp +lvresize -r -L200G -v /dev/mapper/vg-var +``` + +## Go further + +If you need training or technical assistance implementing our solutions, contact your sales representative or click [this link](/links/professional-services) to get a quote and request a custom analysis of your project from our Professional Services team. + +Join our [community of users](/links/community). \ No newline at end of file diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md new file mode 100644 index 00000000000..5f01fbf8c33 --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md @@ -0,0 +1,120 @@ +--- +title: "Installer un contrôleur OPCP" +excerpt: "Découvrez comment installer un contrôleur OPCP à partir de l'image Debian fournie par OVHcloud" +updated: 2026-05-21 +--- + +## Objectif + +Ce guide explique comment installer un contrôleur **OPCP** à partir de l'image d'installation Debian fournie par OVHcloud. Il couvre la préparation du support d'installation, le câblage du serveur, la sélection des disques pour le RAID 1, la configuration du réseau d'accès du contrôleur et les ajustements à effectuer après le premier démarrage. + +> [!primary] +> +> Dans ce guide, le réseau **OOB** correspond au réseau d'accès du contrôleur. Il s'agit du premier port réseau de données du serveur, connecté au réseau du client. +> +> Ce réseau n'est pas le port d'administration dédié du serveur (IPMI, iDRAC, iLO, etc.), qui peut uniquement servir à monter l'ISO ou à ouvrir une console distante. + +> [!warning] +> +> L'installation efface toutes les données présentes sur les disques sélectionnés. +> +> OVHcloud met à votre disposition des services dont vous êtes responsable. Vous devez donc vous assurer de leur bon fonctionnement après l'installation. + +## Prérequis + +- Un serveur physique destiné à héberger le contrôleur OPCP +- L'image d'installation OPCP : +- Une clé USB, un média virtuel ou tout autre support de démarrage +- Un accès à la console locale ou à la console distante du serveur (IPMI, iDRAC, iLO, etc.) +- Au moins deux disques physiques de taille comparable pour l'installation en RAID 1 +- Un câble réseau branché sur le premier port de données du serveur et raccordé au réseau du client +- Si vous utilisez une configuration statique, l'adresse IP, le masque, la passerelle et les serveurs DNS du réseau d'accès du contrôleur + +## En pratique + +### 1. Télécharger l'image d'installation + +Téléchargez l'image d'installation OPCP puis écrivez-la sur votre support de démarrage : + +```bash +curl -O https://opcp-public-release.snc.ovh.net/releases/live-image-amd64.hybrid.iso + +sudo dd if=live-image-amd64.hybrid.iso of=/dev/sdX bs=4M status=progress oflag=sync +``` + +Remplacez `/dev/sdX` par le périphérique correspondant à votre support d'installation. + +### 2. Câbler le serveur + +Avant de démarrer l'installation : + +- connectez le premier port réseau de données du serveur au réseau du client +- laissez le port d'administration dédié (IPMI, iDRAC, iLO, etc.) séparé de cette configuration réseau +- si le serveur dispose de plusieurs interfaces de données, utilisez la première pour faciliter son identification pendant l'installation + +Vous pouvez utiliser la console distante du BMC pour monter l'ISO et démarrer le serveur, mais le port BMC/IPMI ne doit pas être utilisé comme réseau d'accès du contrôleur. + +### 3. Démarrer l'installeur + +Démarrez le serveur sur le support d'installation puis suivez l'installeur interactif. + +Pendant l'installation, l'image : + +- détecte les disques physiques disponibles +- vous demande de sélectionner les disques à utiliser pour le RAID 1 +- configure automatiquement le système sur les disques sélectionnés +- vous demande de choisir l'interface réseau utilisée pour l'accès au contrôleur +- active l'accès SSH `root` sur le contrôleur au premier démarrage + +### 4. Sélectionner les disques d'installation + +Lorsque l'installeur vous le demande, sélectionnez au moins deux disques physiques pour le contrôleur. + +Utilisez de préférence des disques identiques, ou aussi proches que possible en taille et en performances, afin de permettre la création correcte du RAID 1. + +L'installeur crée automatiquement la configuration RAID 1 et la structure LVM du système sur les disques retenus. + +### 5. Configurer le réseau d'accès du contrôleur + +Lorsque l'installeur affiche la liste des interfaces réseau physiques : + +1. Sélectionnez l'interface connectée au réseau du client. +2. Choisissez `DHCP` si l'adressage est fourni automatiquement, ou `Static` si vous devez saisir la configuration manuellement. +3. En mode statique, renseignez l'adresse IP, le masque, la passerelle et les serveurs DNS demandés. +4. Validez le récapitulatif avant l'écriture de la configuration réseau. + +À la fin de l'installation de base, cette configuration est appliquée au système installé afin de permettre un premier accès SSH au contrôleur. + +### 6. Vérifier l'accès après le premier démarrage + +Après le redémarrage du serveur : + +1. Connectez-vous depuis le réseau relié au premier port de données du serveur. +2. Vérifiez que l'adresse IP configurée pour le contrôleur répond bien en SSH. +3. Vérifiez que le contrôleur peut joindre les ressources réseau nécessaires dans votre environnement. + +Si l'interface ou les paramètres réseau ne sont pas corrects, relancez l'installation et sélectionnez les valeurs attendues. + +### 7. Ajuster la taille des volumes logiques + +Après le premier démarrage, connectez-vous au contrôleur puis adaptez la taille des volumes logiques en fonction de la capacité réelle des disques et de vos besoins. + +> [!warning] +> +> Les tailles ci-dessous sont des exemples de destination. Vérifiez l'espace réellement utilisé et disponible avant toute réduction de volume, puis ajustez les valeurs selon la capacité de vos disques. + +Commencez par réduire le volume `spare`, puis réallouez l'espace libéré aux volumes utiles : + +```bash +lvreduce -r -L 100G -v /dev/mapper/vg-spare +lvresize -r -L100G -v /dev/mapper/vg-home +lvresize -r -L100G -v /dev/mapper/vg-root +lvresize -r -L30G -v /dev/mapper/vg-tmp +lvresize -r -L200G -v /dev/mapper/vg-var +``` + +## Aller plus loin + +Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](/links/professional-services) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services. + +Échangez avec notre [communauté d'utilisateurs](/links/community). \ No newline at end of file diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/meta.yaml b/pages/hosted_private_cloud/opcp/how-to-install-controller/meta.yaml new file mode 100644 index 00000000000..0e6d91acf83 --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/meta.yaml @@ -0,0 +1,2 @@ +id: f331bb82-32db-4f42-860e-70b3ce808fb0 +full_slug: opcp-install-controller \ No newline at end of file diff --git a/pages/index.md b/pages/index.md index 6215dae30da..7bc28a927f5 100644 --- a/pages/index.md +++ b/pages/index.md @@ -597,6 +597,7 @@ + [On-Prem Cloud Platform](products/hosted-private-cloud-hosted-private-cloud-opcp) + [Getting started](hosted-private-cloud-hosted-private-cloud-opcp-getting-started) + [Getting started with your OPCP](hosted_private_cloud/opcp/opcp-getting-started) + + [OPCP - How to install a controller](hosted_private_cloud/opcp/how-to-install-controller) + [OPCP - Node lifecycle](hosted_private_cloud/opcp/node-lifecycle) + [OPCP - How to use the APIs and obtain the credentials](hosted_private_cloud/opcp/how-to-use-api-and-get-credentials) + [OPCP - How to install an instance from the Horizon interface](hosted_private_cloud/opcp/how-to-setup-instance) From 326108af02ea1f18b8251d38bdde74a5c0dbab89 Mon Sep 17 00:00:00 2001 From: morgangch Date: Thu, 21 May 2026 14:37:20 +0200 Subject: [PATCH 2/6] docs: add instruction to select 'Auto Install' in GRUB menu for controller installation --- .../opcp/how-to-install-controller/guide.en-gb.md | 2 ++ .../opcp/how-to-install-controller/guide.fr-fr.md | 2 ++ 2 files changed, 4 insertions(+) diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md index 6673b8439f1..f3bca4524c5 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md @@ -58,6 +58,8 @@ You can use the BMC remote console to mount the ISO and boot the server, but the Boot the server from the installation media, then follow the interactive installer. +In the GRUB menu, select the `Auto Install` entry to start the installation. + During the installation, the image: - detects the available physical disks diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md index 5f01fbf8c33..85c737e3366 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md @@ -58,6 +58,8 @@ Vous pouvez utiliser la console distante du BMC pour monter l'ISO et démarrer l Démarrez le serveur sur le support d'installation puis suivez l'installeur interactif. +Dans le menu GRUB, sélectionnez l'entrée `Auto Install` pour lancer l'installation. + Pendant l'installation, l'image : - détecte les disques physiques disponibles From 45720ade92f8e33d1c2b955ae6084a7768ac131e Mon Sep 17 00:00:00 2001 From: morgangch Date: Thu, 21 May 2026 14:37:45 +0200 Subject: [PATCH 3/6] fix: ensure newline at end of community link in installation guides --- .../opcp/how-to-install-controller/guide.en-gb.md | 2 +- .../opcp/how-to-install-controller/guide.fr-fr.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md index f3bca4524c5..34be4ec23c9 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md @@ -119,4 +119,4 @@ lvresize -r -L200G -v /dev/mapper/vg-var If you need training or technical assistance implementing our solutions, contact your sales representative or click [this link](/links/professional-services) to get a quote and request a custom analysis of your project from our Professional Services team. -Join our [community of users](/links/community). \ No newline at end of file +Join our [community of users](/links/community). diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md index 85c737e3366..fb7c5fca6c6 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md @@ -119,4 +119,4 @@ lvresize -r -L200G -v /dev/mapper/vg-var Si vous avez besoin d'une formation ou d'une assistance technique pour la mise en oeuvre de nos solutions, contactez votre commercial ou cliquez sur [ce lien](/links/professional-services) pour obtenir un devis et demander une analyse personnalisée de votre projet à nos experts de l’équipe Professional Services. -Échangez avec notre [communauté d'utilisateurs](/links/community). \ No newline at end of file +Échangez avec notre [communauté d'utilisateurs](/links/community). From b042ecc2c36d41d8d71ee73806d300442311d771 Mon Sep 17 00:00:00 2001 From: morgangch Date: Fri, 22 May 2026 12:16:54 +0200 Subject: [PATCH 4/6] docs: update installation guide for OPCP controller with new S3 access instructions and clarify network interface references --- .../how-to-install-controller/guide.en-gb.md | 111 +++++++++++++++--- .../how-to-install-controller/guide.fr-fr.md | 111 +++++++++++++++--- 2 files changed, 194 insertions(+), 28 deletions(-) diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md index 34be4ec23c9..4d6864ce4de 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md @@ -1,7 +1,7 @@ --- title: "OPCP - How to install a controller" excerpt: "Learn how to install an OPCP controller from the Debian image provided by OVHcloud" -updated: 2026-05-21 +updated: 2026-05-22 --- ## Objective @@ -10,7 +10,7 @@ This guide explains how to install an **OPCP** controller from the Debian-based > [!primary] > -> In this guide, the **OOB** network refers to the controller access network. It is the server's first physical data interface, connected to the customer's network. +> In this guide, the **OOB** network refers to the controller access network. It is the server's first physical data interface, connected to your network. > > It is not the server's dedicated management port (IPMI, iDRAC, iLO, and so on), which should only be used to mount the ISO or open a remote console. @@ -23,21 +23,105 @@ This guide explains how to install an **OPCP** controller from the Debian-based ## Prerequisites - A physical server intended to host the OPCP controller -- The OPCP installation image: +- Read-only access to the OPCP delivery S3 bucket, including the S3 endpoint, bucket name, region, and OPCP version to download +- A dedicated S3 access key and secret key, restricted to read-only access on that bucket and delivery prefix - A USB key, virtual media device, or any other bootable installation media - Access to the local console or to the server's remote management console (IPMI, iDRAC, iLO, and so on) - At least two physical disks of comparable size for the RAID 1 installation -- One network cable connected to the server's first data interface and to the customer's network +- One network cable connected to the server's first network interface and to your network - If you use a static configuration, the IP address, subnet mask, gateway, and DNS servers for the controller access network ## Instructions -### 1. Download the installation image +### 1. Download and verify the installation image -Download the OPCP installation image, then write it to your boot media: +Before writing the image to your boot media, download the ISO and its SHA-256 checksum from the read-only S3 bucket provided to you. + +> [!primary] +> +> The published artifacts are stored in the delivery bucket under the `opcp-controller-debian-image//` prefix. +> +> Use a dedicated credential pair restricted to read-only access on that bucket and prefix. Load it only into your current shell or through your secret manager, then remove it after the download. + +Set your environment variables first: ```bash -curl -O https://opcp-public-release.snc.ovh.net/releases/live-image-amd64.hybrid.iso +export S3_ENDPOINT="" +export S3_BUCKET="" +export S3_REGION="" +export OPCP_VERSION="" +export S3_PREFIX="opcp-controller-debian-image/${OPCP_VERSION}" +export S3_ACCESS_KEY="" +export S3_SECRET_KEY="" +``` + +Then download the files with `s3cmd` (the recommended method for authenticated S3 access): + +```bash +sudo apt-get update +sudo apt-get install -y s3cmd + +s3cfg=$(mktemp) +chmod 600 "$s3cfg" + +cat >"$s3cfg" <"$curl_config" < [!warning] > -> The sizes below are example targets. Check the used and available space before reducing any volume, then adapt the values to your disk capacity. +> The sizes below are example targets for 900 GB disks. Check the used and available space before reducing any volume, then adapt the values to your disk capacity. Start by reducing the `spare` volume, then reallocate the released space to the volumes you actually use: diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md index fb7c5fca6c6..df34ce9a794 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md @@ -1,7 +1,7 @@ --- title: "Installer un contrôleur OPCP" excerpt: "Découvrez comment installer un contrôleur OPCP à partir de l'image Debian fournie par OVHcloud" -updated: 2026-05-21 +updated: 2026-05-22 --- ## Objectif @@ -10,7 +10,7 @@ Ce guide explique comment installer un contrôleur **OPCP** à partir de l'image > [!primary] > -> Dans ce guide, le réseau **OOB** correspond au réseau d'accès du contrôleur. Il s'agit du premier port réseau de données du serveur, connecté au réseau du client. +> Dans ce guide, le réseau **OOB** correspond au réseau d'accès du contrôleur. Il s'agit du premier port réseau de données du serveur, connecté à votre réseau. > > Ce réseau n'est pas le port d'administration dédié du serveur (IPMI, iDRAC, iLO, etc.), qui peut uniquement servir à monter l'ISO ou à ouvrir une console distante. @@ -23,21 +23,105 @@ Ce guide explique comment installer un contrôleur **OPCP** à partir de l'image ## Prérequis - Un serveur physique destiné à héberger le contrôleur OPCP -- L'image d'installation OPCP : +- Un accès en lecture seule au bucket S3 de livraison OPCP, avec l'endpoint S3, le nom du bucket, la région et la version OPCP à récupérer +- Une access key et une secret key S3 dédiées, limitées en lecture à ce bucket et à son préfixe de livraison - Une clé USB, un média virtuel ou tout autre support de démarrage - Un accès à la console locale ou à la console distante du serveur (IPMI, iDRAC, iLO, etc.) - Au moins deux disques physiques de taille comparable pour l'installation en RAID 1 -- Un câble réseau branché sur le premier port de données du serveur et raccordé au réseau du client +- Un câble réseau branché sur la première interface réseau du serveur et raccordé à votre réseau - Si vous utilisez une configuration statique, l'adresse IP, le masque, la passerelle et les serveurs DNS du réseau d'accès du contrôleur ## En pratique -### 1. Télécharger l'image d'installation +### 1. Télécharger et vérifier l'image d'installation -Téléchargez l'image d'installation OPCP puis écrivez-la sur votre support de démarrage : +Avant d'écrire l'image sur votre support de démarrage, téléchargez l'ISO et son checksum SHA-256 depuis le bucket S3 en lecture seule qui vous a été communiqué. + +> [!primary] +> +> Les artefacts sont publiés dans le bucket de livraison sous le préfixe `opcp-controller-debian-image//`. +> +> Utilisez une paire de credentials dédiée, limitée en lecture à ce bucket et à ce préfixe. Chargez-la uniquement dans votre shell courant ou depuis votre gestionnaire de secrets, puis supprimez-la après le téléchargement. + +Renseignez d'abord les variables de votre environnement : ```bash -curl -O https://opcp-public-release.snc.ovh.net/releases/live-image-amd64.hybrid.iso +export S3_ENDPOINT="" +export S3_BUCKET="" +export S3_REGION="" +export OPCP_VERSION="" +export S3_PREFIX="opcp-controller-debian-image/${OPCP_VERSION}" +export S3_ACCESS_KEY="" +export S3_SECRET_KEY="" +``` + +Téléchargez ensuite les fichiers avec `s3cmd` (méthode recommandée pour un accès S3 authentifié) : + +```bash +sudo apt-get update +sudo apt-get install -y s3cmd + +s3cfg=$(mktemp) +chmod 600 "$s3cfg" + +cat >"$s3cfg" <"$curl_config" < [!warning] > -> Les tailles ci-dessous sont des exemples de destination. Vérifiez l'espace réellement utilisé et disponible avant toute réduction de volume, puis ajustez les valeurs selon la capacité de vos disques. +> Les tailles ci-dessous sont des exemples de destination sur des disques de 900 Go. Vérifiez l'espace réellement utilisé et disponible avant toute réduction de volume, puis ajustez les valeurs selon la capacité de vos disques. Commencez par réduire le volume `spare`, puis réallouez l'espace libéré aux volumes utiles : From f7df886589d1b8780b4170d4cd0b2d69fd3c13d8 Mon Sep 17 00:00:00 2001 From: morgangch Date: Fri, 22 May 2026 12:22:22 +0200 Subject: [PATCH 5/6] docs: add common S3 endpoint examples to installation guides for OPCP controller --- .../opcp/how-to-install-controller/guide.en-gb.md | 1 + .../opcp/how-to-install-controller/guide.fr-fr.md | 1 + 2 files changed, 2 insertions(+) diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md index 4d6864ce4de..7c3265f152a 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md @@ -42,6 +42,7 @@ Before writing the image to your boot media, download the ISO and its SHA-256 ch > The published artifacts are stored in the delivery bucket under the `opcp-controller-debian-image//` prefix. > > Use a dedicated credential pair restricted to read-only access on that bucket and prefix. Load it only into your current shell or through your secret manager, then remove it after the download. +> Common base endpoints include `s3.sbg.io.cloud.ovh.net` and `s3.gra.io.cloud.ovh.net`. Set your environment variables first: diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md index df34ce9a794..4c238abd7cd 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md @@ -42,6 +42,7 @@ Avant d'écrire l'image sur votre support de démarrage, téléchargez l'ISO et > Les artefacts sont publiés dans le bucket de livraison sous le préfixe `opcp-controller-debian-image//`. > > Utilisez une paire de credentials dédiée, limitée en lecture à ce bucket et à ce préfixe. Chargez-la uniquement dans votre shell courant ou depuis votre gestionnaire de secrets, puis supprimez-la après le téléchargement. +> Les endpoints de base peuvent par exemple être `s3.sbg.io.cloud.ovh.net` ou `s3.gra.io.cloud.ovh.net`. Renseignez d'abord les variables de votre environnement : From 303cb3e64542e495a4c826fc6536602227939f99 Mon Sep 17 00:00:00 2001 From: morgangch Date: Fri, 22 May 2026 15:24:12 +0200 Subject: [PATCH 6/6] docs: clarify network interface terminology in installation guides for OPCP controller --- .../opcp/how-to-install-controller/guide.en-gb.md | 10 ++++------ .../opcp/how-to-install-controller/guide.fr-fr.md | 10 ++++------ 2 files changed, 8 insertions(+), 12 deletions(-) diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md index 7c3265f152a..8f659220e9f 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md @@ -10,7 +10,7 @@ This guide explains how to install an **OPCP** controller from the Debian-based > [!primary] > -> In this guide, the **OOB** network refers to the controller access network. It is the server's first physical data interface, connected to your network. +> In this guide, the **OOB** network refers to the controller access network. It is the server's first physical network interface, connected to your network. > > It is not the server's dedicated management port (IPMI, iDRAC, iLO, and so on), which should only be used to mount the ISO or open a remote console. @@ -29,7 +29,7 @@ This guide explains how to install an **OPCP** controller from the Debian-based - Access to the local console or to the server's remote management console (IPMI, iDRAC, iLO, and so on) - At least two physical disks of comparable size for the RAID 1 installation - One network cable connected to the server's first network interface and to your network -- If you use a static configuration, the IP address, subnet mask, gateway, and DNS servers for the controller access network +- The IP address, subnet mask, gateway, and DNS servers for the controller access network ## Instructions @@ -133,10 +133,8 @@ Replace `/dev/sdX` with the device corresponding to your installation media. Before you start the installation: -- connect the server's first data network interface to your network -- if the server has several data interfaces, use the first one so that it is easier to identify during the installation, and do not connect any other one - -You can use the BMC remote console to mount the ISO and boot the server, but the BMC or IPMI port must not be used as the controller access network. +- connect the server's first network interface to your network +- if the server has several network interfaces, use the first one so that it is easier to identify during the installation, and do not connect any other one ### 3. Boot the installer diff --git a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md index 4c238abd7cd..25f14ae7dd5 100644 --- a/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md @@ -10,7 +10,7 @@ Ce guide explique comment installer un contrôleur **OPCP** à partir de l'image > [!primary] > -> Dans ce guide, le réseau **OOB** correspond au réseau d'accès du contrôleur. Il s'agit du premier port réseau de données du serveur, connecté à votre réseau. +> Dans ce guide, le réseau **OOB** correspond au réseau d'accès du contrôleur. Il s'agit de la première interface réseau physique du serveur, connectée à votre réseau. > > Ce réseau n'est pas le port d'administration dédié du serveur (IPMI, iDRAC, iLO, etc.), qui peut uniquement servir à monter l'ISO ou à ouvrir une console distante. @@ -29,7 +29,7 @@ Ce guide explique comment installer un contrôleur **OPCP** à partir de l'image - Un accès à la console locale ou à la console distante du serveur (IPMI, iDRAC, iLO, etc.) - Au moins deux disques physiques de taille comparable pour l'installation en RAID 1 - Un câble réseau branché sur la première interface réseau du serveur et raccordé à votre réseau -- Si vous utilisez une configuration statique, l'adresse IP, le masque, la passerelle et les serveurs DNS du réseau d'accès du contrôleur +- L'adresse IP, le masque, la passerelle et les serveurs DNS du réseau d'accès du contrôleur ## En pratique @@ -133,10 +133,8 @@ Remplacez `/dev/sdX` par le périphérique correspondant à votre support d'inst Avant de démarrer l'installation : -- connectez le premier port réseau de données du serveur à votre réseau -- si le serveur dispose de plusieurs interfaces de données, utilisez la première pour faciliter son identification pendant l'installation, et n'en connectez aucune autre - -Vous pouvez utiliser la console distante du BMC pour monter l'ISO et démarrer le serveur, mais le port BMC/IPMI ne doit pas être utilisé comme réseau d'accès du contrôleur. +- connectez la première interface réseau du serveur à votre réseau +- si le serveur dispose de plusieurs interfaces réseau, utilisez la première pour faciliter son identification pendant l'installation, et n'en connectez aucune autre ### 3. Démarrer l'installeur