Mettre à niveau le Hybrid Connector : étapes de migration

Utilisez cette procédure pour migrer le CoreView Hybrid Connector de votre serveur actuel vers un nouveau, par exemple lorsque vous effectuez une mise à niveau vers une version plus récente du Hybrid Connector (2019, 2022 ou 2025) ou lorsque vous devez déplacer le Connector vers un autre Windows Server.

Étape 1 : Obtenez votre clé API

• Accédez au portail CoreView et ouvrez : : “paramètres” > “Mon organisation” > “Sur site” > “Configuration locale”.
• Cliquez sur le bouton “Modifier” et notez votre clé API :

Vous aurez besoin de cette clé API ultérieurement lors de la configuration du Hybrid Connector 2019.

Étape 2 : Déployez le Hybrid Connector

• Déployez le Hybrid Connector sur votre nouveau serveur en suivant les instructions de la documentation officielle sur le déploiement du Hybrid Connector. Cette procédure permet d'effectuer une mise à niveau vers les versions 2019 et 2022. 
• Lorsqu'il vous est demandé de saisir votre clé API, interrompez-vous et passez à l'étape suivante.

Retournez au portail CoreView pour fermer votre session de gestion. Il est conseillé de désactiver l'option “Activer automatiquement la session de gestion” pendant la migration. Désactivez-la et enregistrez vos modifications.
 

Après cela, désactivez la gestion CoreView en cliquant sur “Désactiver la gestion”.

Étape 3 : Désactivez le CoreView Connector

• Arrêtez le service Windows CoreView Connector sur votre serveur à mettre hors service.
• Pour empêcher un redémarrage automatique, définissez l'état du service sur désactivé.

Étape 4 : Transférez les paramètres de clés personnalisées

• Sur votre serveur, accédez à C:\Program Files (x86)\CoreView Agent 
• Ouvrez Forward365.Service.PowershellService.Agent.exe.config avec le Bloc-notes.
• Copiez tous les paramètres de clés personnalisées de la section appSettings vers le fichier correspondant sur votre Windows Server cible.

Exemple de paramètres personnalisés à copier :

<add key="gMSAEnabled" value="true" />
<add key="gMSAName" value="CoreViewHybrid" />
<add key="gMSAImporterEnabled" value="true" />
<add key="gMSAImporterName" value="CoreViewImporter! />

Vérifiez également la présence d'un fichier config.json dans le répertoire C:\Temp. S'il existe, copiez-le au même emplacement sur le nouveau serveur.

Voici un exemple de ce à quoi pourrait ressembler le contenu du fichier :

{
"BackwardCompatibility.SingleForest.ActiveDirectory": "domaincontroller.yourdomain.local",    
"BackwardCompatibility.SingleForest.Exchange": "http://exchangesrv.yourdomain.local/powershell"
}

Étape 5 : Ajoutez le SKU

• Migration de 2019 vers 2022 : ajoutez uniquement le SKU FT:HYBRIDOS2022
• Migration de 2019 vers 2025 : ajoutez uniquement le SKU FT:HYBRIDOS2025
• Migration de 2022 vers 2025 : supprimez le SKU FT:HYBRIDOS2022 et ajoutez uniquement le SKU FT:HYBRIDOS2025

Ces étapes sont nécessaires pour que le nouveau service CoreView Hybrid Connector récupère l'image Docker appropriée.

• Une fois le SKU géré, appliquez la clé API notée précédemment sur la page de configuration de votre nouveau serveur CoreView Hybrid Connector.

Vous devriez obtenir le message de confirmation suivant :

Étape 6 : Vérifiez la configuration

• Dans le portail CoreView, accédez à “Mon organisation” > “Sur site”.
• Vérifiez à nouveau votre configuration en cliquant sur le bouton bleu Vérifier. 

Pour suivre la progression, vérifiez les fichiers journaux dans le répertoire C:\Temp sur votre serveur de destination.

Lorsque vous obtenez le message suivant, votre configuration est terminée.

Étape 7 : Désinstallez le Connector précédent (facultatif)

Vous pouvez éventuellement désinstaller le CoreView Hybrid Connector de votre Windows Server à mettre hors service, sur lequel le service a été précédemment désactivé.

Étape 8 : Réactivez la session de gestion

• Réactivez votre session de gestion CoreView.
• Si vous avez des tâches en attente, elles seront traitées une fois la session de nouveau active.

Réactivez la fonctionnalité “Activer automatiquement la session de gestion” que vous aviez désactivée précédemment.