Comment migrer l'installation d'ADSelfService Plus d'une machine à l'autre ?

Description

Cet article vous guidera dans le processus de migration de l'installation d'ADSelfService Plus d'une machine à une autre.

Important:

1. Avant de commencer le processus de migration, veuillez mettre à jour votre installation d’ADSelfService Plus à la dernière version (build) de la page web Service Pack.
2. Ne désinstallez pas ADSelfService Plus de l'ancienne machine avant d'avoir confirmé que la nouvelle installation fonctionne correctement.

Étapes de la migration de votre installation ADSelfService Plus

Étape 1 : Identification de la base de données

• Ouvrez le répertoire d'installation d'ADSelfService Plus (par défaut : C:\Program Files\ManageEngine\ADSelfService Plus).
• Accédez au dossier conf dans le répertoire d'installation d'ADSelfService Plus (par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\conf).
• Ouvrez le fichier database_params.conf dans un éditeur de texte et recherchez le nom du pilote pour identifier la base de données utilisée par ADSelfService Plus.
• La version de la base de données PostgreSQL doit être la même sur les anciennes et les nouvelles machines. Si la base de données de l'installation existante est plus ancienne que la base de données de la nouvelle machine, contactez l'équipe d'assistance ADSelfService Plus pour obtenir des conseils supplémentaires.
• La version de PostgreSQL peut être détectée en exécutant la commande pgsql\bin>postgres.exe -V à partir de l'invite de commande dans le dossier pgsql à l'emplacement où ADSelfService Plus est installé (généralement C:\Program Files\ManageEngine\ADSelfService Plus).
• Si la base de données principale est MySQL ou MicrosoftSQL, contactez l'équipe d'assistance ADSelfService Plus pour obtenir des conseils de migration.

Étape 2 : Enregistrer la base de données d’ADSelfService Plus à partir de l'ancienne machine

Méthode 1 : sauvegarde manuelle hors ligne

• Démarrez l'invite de commande en tant qu'administrateur en cliquant avec le bouton droit sur l'invite de commande et en sélectionnant Exécuter en tant qu'administrateur.
• Accédez au dossier bin dans le répertoire d'installation (par défaut : C:\Program Files\ManageEngine\ADSelfService Plus) à l'aide de la commande cd.
• Maintenant, exécutez la commande backupDB.bat pour sauvegarder la base de données.
• Exécutez la commande backupDB.bat. Cela sauvegardera la base de données.
• Un dossier nommé Backup sera créé dans le répertoire d'installation d'ADSelfService Plus (par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\Backup) et contiendra la sauvegarde de la base de données au format de fichier compressé (par exemple, OfflineBackup_20230926151025.ezip).

Méthode 2 : Sauvegarde à l'aide du portail d'administration ADSelfService Plus

• Connectez-vous au portail ADSelfService Plus avec les informations d'identification d'administrateur.
• Accédez à Administrateur > Paramètres du produit > Sauvegarde automatique.
• Dans la page Sauvegarde automatique, entrez votre chemin de fichier préféré (par défaut, le chemin du fichier du répertoire d'installation sera mentionné).
• Cliquez sur Sauvegarder maintenant.
• Un dossier nommé Backup sera créé dans le répertoire d'installation d'ADSelfService Plus (par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\Backup) et contiendra la sauvegarde de la base de données au format de fichier compressé (par exemple, 081224-1547.ezip). )

  

Étape 3 (facultative) :

• Sauvegardez le fichier ZohoCreator : copiez le fichier ZohoCreator.properties présent dans le dossier de configuration ADSelfService Plus sous le répertoire d'installation (emplacement par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\conf\ZohoCreator.properties).
• Sauvegardez tous les fichiers de correctifs (facultatif) : copiez le dossier de correctifs présent dans le répertoire d'installation d'ADSelfService Plus (emplacement par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\patch).
• Sauvegardez tous les fichiers de langue personnalisés (facultatif) : accédez au répertoire d'installation et copiez le dossier de ressources qu'il contient. (Emplacement par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\resources)
• Sauvegardez la page de connexion personnalisée (facultatif) : accédez au dossier adssp sous le répertoire d'installation et copiez les dossiers html, images, ressources et styles (l'emplacement par défaut est C:\Program Files\ManageEngine\ADSelfService Plus\webapps\adssp ).
• Sauvegardez tous les certificats SSL (facultatif) : si vous avez activé l'option HTTPS pour ADSelfService Plus sur l'ancienne machine, accédez au dossier conf dans le répertoire d'installation et copiez le fichier server.xml, web.xml et le magasin de clés SSL. . (Par exemple : server.keystore) (l'emplacement par défaut est C:\Program Files\ManageEngine\ADSelfService Plus\conf).
• Sauvegardez le dossier MPM (facultatif) : si vous avez activé la fonctionnalité de déploiement d'applications mobiles, sauvegardez le dossier MPM (emplacement par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\MPM).

  Remarque : Si nous sauvegardons les dossiers de l'ancienne machine, c’est en raison des risques de perte de certains dossiers pendant le processus de migration. Les fichiers perdus, comme les fichiers relatifs à la langue ou à l'agent de connexion, doivent être restaurés dans la nouvelle machine. S'ils ne sont pas restaurés, toutes les personnalisations apportées au fichier de langue ou à l'agent de connexion ne fonctionneront pas correctement sur la nouvelle machine.

Étape 4 : Restauration de la base de données d’ADSelfService Plus dans la nouvelle machine

• Installez ADSelfService Plus sur la nouvelle machine. Notez que la version, ou le numéro de build, de l'ancienne et de la nouvelle installation doit être la même.
  Remarque : Si vous ne connaissez pas le numéro de build de votre ancienne installation ADSelfService Plus, contactez notre équipe d’assistance.
• Arrêtez ADSelfService Plus, qu'il soit exécuté comme une application ou comme un service.
• Si vous avez suivi l'étape 3, alors :
  • Collez le fichier ZohoCreator.properties dans le dossier conf ADSelfService Plus sous le répertoire d'installation ADSelfService Plus (emplacement par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\conf\).
  • Collez le dossier du correctif sous le répertoire d'installation (par défaut : C:\Program Files\ManageEngine\ADSelfService Plus).
  • Collez le dossier ressources sous le répertoire d'installation (Par défaut : C:\Program Files\ManageEngine\ADSelfService Plus).
  • Collez les dossiers html, images, ressources et styles dans le dossier adssp. (Par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\webapps\adssp).
  • Collez les fichiers server.xml, web.xml et le magasin de clés SSL dans le dossier conf (emplacement par défaut : C:\Program Files\ManageEngine\ADSelfService Plus\conf).
  • Collez le dossier MPM sous le répertoire d'installation (Par défaut : C:\Program Files\ManageEngine\ADSelfService Plus).
• Copiez le fichier customer-config.xml depuis le dossier <Installation_Dir>\conf, renommez le fichier en new-customer-config.xml et placez-le dans le dossier <Installation_Dir>\conf du nouveau répertoire d'installation.
• Copiez et collez le fichier compressé (.ezip) qui contient la base de données sauvegardée de l'ancien répertoire d'installation (référez-vous à l'étape 2.v), dans le dossier <Installation_Dir>\bin (Par défaut : C:\Program Files(x86)\ManageEngine\ADSelfService Plus\bin) du nouveau répertoire d'installation.
• Ouvrez l’invite de commandes en tant qu'administrateur (clic droit sur Invite de commande et sélectionnez « Exécuter en tant qu'administrateur »).
• Allez dans le dossier <Installation_Dir>\bin (par défaut : C:\Program Files(x86)\ManageEngine\ADSelfService Plus\bin).
• Maintenant, exécutez la commande suivante :

  RestoreDB.bat <offline backup file> -p <password> true
  Par exemple :restoreDB.bat 081224-1547.zip -p <password> true

  Deux types sont possibles pour le mot de passe du fichier de sauvegarde de la base de données :

  1. Mot de passe par défaut : Il s'agit de la chaîne inverse du nom de fichier. Pour le nom de fichier mentionné ci-dessus, le mot de passe serait « 7451-422180 ».
  2. Mot de passe configuré par l’administrateur : Il s'agit du mot de passe personnalisé qui a été configuré dans le portail d'administration avant la création de la sauvegarde de la base de données. L'option Modifier le mot de passe pour les fichiers de sauvegarde de la base de données sous Admin → Connexion → Paramètres généraux est utilisée à cette fin.
• Si vous avez oublié le mot de passe du fichier de sauvegarde, mais que vous avez accès au répertoire d'installation d'ADSelfService Plus, le mot de passe chiffré peut être obtenu à partir du fichier customer-config.xml (<<r>\conf\customer-config.xml), et vous pouvez contacter support@adselfserviceplus.com pour le déchiffrer.
• Sinon, la sauvegarde sera inaccessible et une nouvelle sauvegarde devra être créée.
• Démarrer ADSelfService Plus.

Annexe

1. Étapes à suivre pour la configuration de la haute disponibilité pendant la migration

• Si vous migrez le serveur ADSelfService Plus principal qui fait partie d'une configuration de haute disponibilité, suivez les étapes suivantes :
  • Accédez à la console web d'ADSelfService Plus après avoir arrêté le serveur principal. Vous serez automatiquement redirigé vers le serveur de secours.
  • Désactiver Haute disponibilité (Allez dans Admin → Essentiels de l'entreprise → Haute disponibilité) dans le serveur de secours.
  • Le serveur principal et le serveur de secours redémarrent automatiquement.
  • Migrer l'installation principale d'ADSelfService Plus de l'ancienne machine vers la nouvelle.
  • Une fois la migration terminée, activez Haute disponibilité sur la nouvelle machine en suivant ces étapes.
• Si vous migrez un serveur ADSelfService Plus en attente qui fait partie d'une configuration de haute disponibilité, vous pouvez simplement installer ADSelfService Plus dans une nouvelle machine et l'ajouter à la configuration de haute disponibilité en modifiant la configuration de haute disponibilité à travers le serveur ADSelfService Plus principal.

2. Étapes à suivre pour la configuration de l'équilibrage de charge pendant la migration

• Si vous faites migrer le nœud principal d'ADSelfService Plus d'une configuration d'équilibrage de charge, suivez les étapes suivantes :
  • Connectez-vous à ADSelfService Plus dans l'ancienne machine qui agit comme nœud principal, en utilisant les identifiants de l'administrateur.
  • Allez dans Admin → Essentiels de l'entreprise → Équilibrage de charge. Dans la fenêtre de configuration de l'équilibrage de charge, cliquez sur Supprimer pour supprimer toute la configuration d'équilibrage de charge de l'ancienne machine.
    Remarques : La restauration de la sauvegarde ne restaurera pas automatiquement la configuration d'équilibrage de charge. Elle doit être configurée manuellement. Les nœuds secondaires doivent également être configurés à nouveau. Pendant le processus de migration, ADSelfService Plus ne sera pas accessible aux utilisateurs.
  • ADSelfService Plus va maintenant redémarrer automatiquement.
  • Faire migrer le nœud principal d'ADSelfService Plus de l'ancienne machine vers la nouvelle.
  • Une fois la migration terminée, vous pouvez configurer l'équilibrage de charge dans la nouvelle machine en suivant ces étapes.
• Pour faire migrer les nœuds secondaires d’ADSelfService Plus qui font partie d'une configuration d'équilibrage de charge, installez ADSelfService Plus dans la nouvelle machine, et ajoutez-la comme nœud secondaire en modifiant la configuration d'équilibrage de charge par le nœud principal, tout en retirant le nœud inutilisé.