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..8f659220e9f --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.en-gb.md @@ -0,0 +1,204 @@ +--- +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-22 +--- + +## 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 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. + +> [!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 +- 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 network interface and to your network +- The IP address, subnet mask, gateway, and DNS servers for the controller access network + +## Instructions + +### 1. Download and verify the installation image + +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. +> Common base endpoints include `s3.sbg.io.cloud.ovh.net` and `s3.gra.io.cloud.ovh.net`. + +Set your environment variables first: + +```bash +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 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: + +```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). 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..25f14ae7dd5 --- /dev/null +++ b/pages/hosted_private_cloud/opcp/how-to-install-controller/guide.fr-fr.md @@ -0,0 +1,204 @@ +--- +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-22 +--- + +## 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 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. + +> [!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 +- 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 la première interface réseau du serveur et raccordé à votre réseau +- 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 et vérifier l'image d'installation + +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. +> 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 : + +```bash +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 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 : + +```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). 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)