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'appareil sur un hôte Linux et effectuer d'autres opérations, telles que la régénération d'une clé secrète, la vérification de l'état de l'agent Backup and DR et le redémarrage de l'agent Backup and DR.

Fonctionnement

L'agent Backup and DR pour Linux s'exécute en tant que processus daemon sous le nom d'utilisateur root. Il écoute sur le port TCP 5106 les communications provenant de l'appareil 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 de confiance entre l'appareil de sauvegarde/récupération et l'agent Backup and DR. Cette opération ne doit être effectuée 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 nouvelle.

Vous devrez peut-être parfois regé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 un 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. Consultez Obtenir l'agent Backup and DR adapté à votre hôte.

  2. Importez le fichier du programme 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 une installation Linux 64 bits, exécutez la commande suivante.

        rpm -ivh connector-Linux-version.rpm

    • Pour l'installation de Linux Ubuntu, exécutez la commande suivante.

        dpkg -i connector-linux_ubuntu_amd64-version.deb

    L'agent s'installe toujours 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 devez l'ajouter dans la section de l'agent Backup and DR. Consultez Ajouter un hôte Linux.

Regé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 valide que pendant deux heures. Vous devez l'ajouter à la console de gestion de l'appareil dans ce délai ou en générer un nouveau.

Suivez les instructions ci-dessous pour générer une nouvelle 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 dans le 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 de l'appareil, sélectionnez Manage (Gérer), puis Hosts (Hôtes).

  2. Effectuez un clic droit sur l'hôte Linux et sélectionnez Edit (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. Assurez-vous que l'état du certificat passe à Valide. Si vous recevez un message de réussite partielle, suivez les instructions pour valider la connectivité de l'appliance de sauvegarde/récupération à 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 multipathing pour l'agent

Avant d'installer l'agent, configurez le multipathing 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 d'accès multiple dans 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 du RPM de l'agent Backup and DR Linux 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 à l'aide du 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