Installer l'agent Backup and DR sur un hôte Linux pour les sauvegardes gérées par l'appliance

Cette page explique comment installer l'agent Backup and DR pour le stockage géré par l'appliance sur un hôte Linux, et comment effectuer d'autres opérations, comme régénérer une clé secrète, vérifier l'état de l'agent Backup and DR et le redémarrer.

Fonctionnement

L'agent Backup and DR pour Linux s'exécute en tant que processus de démon sous le nom d'utilisateur racine. Il écoute sur le port TCP 5106 pour la communication avec l'appliance de sauvegarde/récupération. L'agent écrit dans un fichier journal du répertoire d'installation /var/act/log/UDSAgent.log et publie les événements importants dans le dépôt /var/log/messages.

Après avoir installé l'agent, vous devez initialiser les communications fiables entre l'appliance de sauvegarde/restauration et l'agent Backup and DR. Vous n'aurez à le faire qu'une seule fois. La clé secrète doit être ajoutée dans les deux heures suivant sa génération. Si la clé secrète expire, vous devez en générer une autre.

Il peut arriver que vous deviez régénérer une clé secrète. Par exemple, si un hôte reste hors connexion pendant une période prolongée, l'état de son certificat peut passer à "Non initialisé". Si cela se produit, vous devez générer une nouvelle clé pour rétablir un certificat valide et reprendre le fonctionnement normal.

Installer l'agent sur un hôte Linux

Suivez les instructions ci-dessous pour installer l'agent sur un hôte Linux :

  1. Téléchargez le fichier du programme d'installation de l'agent. Pour en savoir plus, consultez Obtenir l'agent Backup and DR adapté à votre hôte.

  2. Importez le fichier d'installation sur votre serveur Linux.

  3. Pour installer l'agent, choisissez l'une des options suivantes :

    • Pour une installation Linux 32 bits, exécutez la commande suivante.

        rpm -ivh connector-Linux_x86-version.rpm

    • Pour installer le package sur Linux 64 bits, exécutez la commande suivante.

        rpm -ivh connector-Linux-version.rpm

    • Pour installer Linux Ubuntu, exécutez la commande suivante.

        dpkg -i connector-linux_ubuntu_amd64-version.deb

    L'agent est toujours installé dans /opt/act. Une fois l'installation terminée, une clé secrète s'affiche.

  4. Enregistrez la clé secrète dans un bloc-notes ou un éditeur de texte. Vous devrez l'ajouter dans la section de l'agent Backup and DR. Pour en savoir plus, consultez Ajouter un hôte Linux.

Régénérer la clé secrète

La clé secrète générée dans la section Installer l'agent sur un hôte Linux n'est valable que deux heures. Vous devez l'ajouter à la console de gestion des appliances dans ce délai ou en générer un nouveau.

Suivez les instructions ci-dessous pour générer une clé et l'ajouter à la console de gestion.

  1. Sur l'hôte Linux, connectez-vous en tant qu'utilisateur racine et exécutez l'une des commandes du répertoire :

    • Pour réinitialiser la clé secrète après avoir confirmé l'action, exécutez la commande suivante :

        /opt/act/bin/udsagent secret --reset

    • Pour réinitialiser le secret immédiatement sans confirmation, exécutez la commande suivante :

        /opt/act/bin/udsagent secret --reset --restart

  2. Enregistrez la clé secrète dans un bloc-notes ou un éditeur. Cette clé secrète est valide pendant deux heures.

Ajouter une clé secrète

Si vous souhaitez mettre à jour la clé secrète ou si vous ne l'avez pas ajoutée la première fois, vous pouvez l'ajouter à l'hôte Linux en suivant les instructions ci-dessous.

  1. Dans la console de gestion des appliances, sélectionnez Gérer, puis Hôtes.

  2. Effectuez un clic droit sur l'hôte Linux, puis sélectionnez Modifier.

  3. Accédez à la section Paramètres de l'agent Backup and DR, puis recherchez le champ Secret.

  4. Collez la clé secrète que vous avez enregistrée précédemment dans le champ Secret, puis cliquez sur Enregistrer. Vérifiez que l'état du certificat passe à Valide. Si un message de réussite partielle s'affiche, suivez les instructions pour valider la connectivité de l'appliance de sauvegarde/restauration à l'agent Backup and DR.

Vérifier l'état de l'agent Backup and DR

Une fois l'agent installé, vous pouvez vérifier son état sur les hôtes Linux à l'aide de la commande suivante.

systemctl status udsagent

La sortie ressemble à ceci :

[root@postgres ~]# systemctl status udsagent
● udsagent.service - Google Cloud Backup and DR service
   Loaded: loaded (/usr/lib/systemd/system/udsagent.service; enabled; vendor preset: disabled)
   Active: active (running) since Wed 2025-11-09 22:13:45 UTC; 17min ago
   Process: 1056 ExecStart=/opt/act/initscripts/udsagent.init start (code=exited, status=0/SUCCESS)
   Main PID: 1128 (udsagent)
        CGroup: /system.slice/udsagent.service
            ├─1128 /opt/act/bin/udsagent start
            └─1132 /opt/act/bin/udsagent start

    Nov 09 22:13:44 postgres systemd[1]: Starting Google Cloud Backup and DR…
    Nov 09 22:13:45 postgres udsagent.init[1056]: Starting /opt/act/bin/udsagent as a daemon. It may take a few minutes for the service to start completely.

Redémarrer l'agent Backup and DR sur un hôte Linux

Pour redémarrer l'agent Backup and DR sur un hôte Linux, exécutez la commande suivante sur l'hôte.

systemctl restart udsagent

Configurer le multipath pour l'agent

Avant d'installer l'agent, configurez le multipath comme suit :

  1. Ajoutez les modifications suivantes à /etc/multipath.conf sur l'hôte :

     blacklist {
      device {
      vendor "ACTIFIO|SCST_FIO|SCST_BIO"
      product "ActifioSky|LUN0"
      }
 }

  2. Redémarrez multipathd :

     systemctl status multipathd

Désactiver le chemin multiple à partir de la configuration de l'agent

 ```none
 /act/config/connector.conf

 DisableMultipathCheck = true
 ```

Désinstaller l'agent Backup and DR d'un hôte Linux à l'aide de la ligne de commande

Suivez les instructions ci-dessous pour désinstaller l'agent Backup and DR d'un hôte Linux :

CentOS/RHEL/SLES

  1. Connectez-vous en tant qu'utilisateur racine et arrêtez l'agent Backup and DR en exécutant la commande suivante :

    systemctl stop udsagent

    Pour les anciennes versions de Linux, vous devrez peut-être utiliser la commande suivante :

    /etc/init.d/udsagent stop

  2. Vérifiez le nom RPM de l'agent Linux Backup and DR installé à l'aide de la commande suivante :

    yum list installed | grep udsagent

    Vous pouvez également utiliser la commande suivante pour vérifier le nom du RPM :

    rpm -qa udsagent

    La sortie ressemble à ceci :

    udsagent-11.0.15-8756.x86_64

  3. Désinstallez le package en utilisant le nom que vous avez obtenu à partir de la requête. Exemple :

    yum remove udsagent

    Vous pouvez également utiliser la commande suivante pour désinstaller le package :

    rpm -e udsagent

Ubuntu

  1. Connectez-vous en tant qu'utilisateur racine et arrêtez l'agent Backup and DR en exécutant la commande suivante :

    systemctl stop udsagent

  2. Désinstallez l'agent à l'aide de la commande suivante :

    dpkg --remove udsagent

Étapes suivantes