Avant d'installer

Ce que fait l'installation

Le portail donne une commande d'installation quand vous ajoutez une machine à un client. Cette commande télécharge l'agent, vérifie le fichier téléchargé, pose le service du système, enrôle la machine, puis démarre le service.

L'installation ne demande rien d'autre : pas de redémarrage, pas de compte de service à créer, pas de paquet à préparer.

Cette page donne ce qu'il faut vérifier avant de lancer la commande.

Systèmes acceptés

Système	Architecture	Ce qu'il faut sur la machine
Linux	x86-64 seulement	systemd, curl, sha256sum
Windows	x64 seulement	Windows PowerShell 5.1 ou PowerShell 7, en 64 bits

L'installation s'arrête avec un message précis sur un autre système, sur une autre architecture, ou quand un de ces outils manque.

Une version de systemd antérieure à la 236 est acceptée. L'installation pose alors un fichier de réglage en plus pour le service.

Droits

Système	Comment lancer la commande
Linux	En root.
Windows	Dans un PowerShell ouvert en tant qu'administrateur.

L'installation s'arrête tout de suite quand ces droits manquent.

Le service tourne ensuite avec les droits les plus élevés du système : root sur Linux, LocalSystem sur Windows. L'agent lit ainsi tous les fichiers de la machine, et il restaure les fichiers avec leurs droits.

Accès réseau sortant

L'agent ouvre toutes les connexions. Vous n'ouvrez aucun port entrant sur la machine, et vous ne publiez aucun port.

De	Vers	Port
La machine	Le serveur BaaStide	443 (HTTPS)
La machine	L'adresse des données de sauvegarde, quand l'instance en a une séparée	443 (HTTPS)

Votre MSP donne ces adresses. Elles suffisent : l'agent n'atteint jamais le stockage objet directement. Il envoie ses données au serveur BaaStide, qui les écrit dans le dépôt de la machine.

L'agent accepte un proxy HTTPS. Il suit les variables d'environnement HTTPS_PROXY et NO_PROXY de son service. L'enrôlement, les sauvegardes, les restaurations et les mises à jour passent alors par le proxy.

Vérifier qu'une machine Linux est prête

1. Ouvrez une session sur la machine, en root.
2. Lancez uname -s -m. La réponse doit être Linux x86_64.
3. Lancez systemctl --version. La commande doit répondre une version.
4. Lancez command -v curl sha256sum. Les deux chemins doivent s'afficher.
5. Lancez curl -fsS -o /dev/null <adresse du serveur BaaStide>. La commande ne doit rien écrire : l'accès HTTPS sortant fonctionne. Prenez l'adresse dans la commande d'installation que le portail affiche.

Vérifier qu'une machine Windows est prête

1. Ouvrez une session sur la machine, avec un compte administrateur local.
2. Ouvrez PowerShell avec Exécuter en tant qu'administrateur.
3. Lancez [Environment]::Is64BitProcess. La réponse doit être True.
4. Lancez $PSVersionTable.PSVersion. La version doit être 5.1 ou plus récente.
5. Lancez Invoke-WebRequest -UseBasicParsing -Uri <adresse du serveur BaaStide>. La commande ne doit pas donner d'erreur de réseau. Prenez l'adresse dans la commande d'installation que le portail affiche.

Ce que l'installation pose sur la machine

	Linux	Windows
Programme	/usr/local/bin/baastide	%ProgramFiles%\BaaStide\baastide.exe
Identité de la machine	/etc/baastide/agent.conf	%ProgramData%\BaaStide\agent.conf
État et cache	/var/lib/baastide, /var/cache/baastide	%ProgramData%\BaaStide\state, ...\cache
Journal	Journal du système (journalctl -u baastide)	%ProgramData%\BaaStide\log\agent.log
Service	Unité systemd baastide.service	Service BaaStide, LocalSystem, démarrage automatique différé
Entrée de désinstallation	Aucune	Dans Applications installées

Ces dossiers et ces fichiers sont privés. Seuls root (Linux), ou SYSTEM et les administrateurs locaux (Windows), les lisent et les écrivent.

Le service redémarre tout seul après un arrêt en erreur. Le programme se met à jour tout seul quand la plateforme publie une nouvelle version, et il revient à la version précédente quand la nouvelle ne démarre pas.

Quand votre MSP a changé les noms de l'agent, les noms du programme, du service et des dossiers suivent ces noms. Les dossiers racines du tableau ne changent pas.

Limites et précautions

• L'agent sauvegarde les fichiers locaux de la machine, et les partages réseau que vous déclarez sur l'agent. Il ne sauvegarde pas les fichiers d'un chemin UNC écrit directement dans une politique.
• Un jeton d'enrôlement sert une seule fois, et il expire au bout de 7 jours. Il est affiché une seule fois, dans la commande d'installation. Copiez la commande à ce moment.
• Un jeton d'enrôlement est un secret. Ne l'écrivez pas dans un ticket, un message ou un dépôt de code.
• Une licence en défaut refuse une nouvelle machine. Le portail répond alors une erreur à la création du jeton et à l'enrôlement. Voir BaaStide en bref.
• Sur Windows, l'installation refuse un dossier %ProgramFiles% ou %ProgramData% qui contient déjà les fichiers d'un autre programme.
• L'enrôlement est refusé quand une autre machine active du même client a déjà le même identifiant machine. Une machine clonée garde l'identifiant de son modèle : donnez-lui un nouvel identifiant avant d'installer l'agent. L'identifiant vient de /etc/machine-id sur Linux, et de la valeur MachineGuid de la clé HKLM\SOFTWARE\Microsoft\Cryptography sur Windows.
• La sauvegarde d'une image complète d'une machine Windows demande Windows 10, Windows 11, ou Windows Server 2016 ou plus récent.
• La commande d'installation du portail contient toujours un jeton d'enrôlement. Ne la relancez pas : le jeton ne sert qu'une fois, et l'installation s'arrête sur l'enrôlement. L'installation garde l'identité de la machine seulement quand elle est lancée sans jeton d'enrôlement.