Mise à niveau de la version du Hybrid Connector

Pour mettre à niveau la version du Hybrid Connector de 1.x vers 2.x, suivez les étapes ci-dessous.

Étapes préliminaires

Avant de commencer la mise à niveau, effectuez les vérifications suivantes :

1. Assurez-vous que la gestion du client est désactivée. Désactivez toute activité de gestion ou d'automatisation susceptible d'interférer avec la mise à niveau.
2. Sauvegardez le fichier de configuration de l'Hybrid Agent :
   • Localisez le fichier de configuration de l'Agent. Exemple de chemin : C:\Program Files (x86)\CoreView Agent\Forward365.Service.PowershellService.Agent.exe.config.
   • Copiez le fichier dans un emplacement de sauvegarde sûr.

Procédure de mise à niveau étape par étape

Étape 1a : désinstaller la version précédente

1. Ouvrez le “Panneau de configuration” Windows.
2. Identifiez le nom du service Windows utilisé par l'Hybrid Agent. Par exemple : “CoreView Agent”.
3. Désinstallez le service.

4. Supprimez le dossier “CoreView Agent”. Le dossier doit être vide.

4. Le service est désinstallé automatiquement. Pour une vérification supplémentaire, vérifiez qu'il n'est plus répertorié dans le panneau “Services”.

Étape 1b : désinstallation manuelle

Si le service n'est pas supprimé automatiquement, effectuez une désinstallation manuelle.

Prérequis : utilisez une invite de commandes Administrateur ou une session PowerShell avec élévation de privilèges.

1. Ouvrez “Services” en exécutant services.msc.
2. Identifiez le nom du service Windows utilisé par l'Hybrid Agent. Par exemple : “CoreView Agent”.
3. Supprimez le service en exécutant la commande suivante :

   sc delete "ServiceName"

4. Attendez quelques secondes, puis actualisez “Services” pour vérifier que le service a été supprimé.
5. Supprimez le dossier et les fichiers d'installation. Exemple de chemin : C:\Program Files (x86)\CoreView Agent.

Étape 2 : installer la nouvelle version

Pour installer la nouvelle version, suivez les étapes 1 à 4 de la procédure Installation dans le manuel du produit.

Étape 3 : arrêter le nouveau service

1. Ouvrez le panneau “Services” Windows.
2. Arrêtez le service Hybrid Agent nouvellement installé.

Étape 4 : restaurer les clés de configuration

Restaurez les valeurs de configuration qui doivent être conservées à partir de la sauvegarde d'origine de Forward365.Service.PowershellService.Agent.exe.config dans le fichier de configuration nouvellement installé.

Assurez-vous que les clés suivantes existent dans le nouveau fichier de configuration et restaurez leurs valeurs précédentes :

• CentralAuthApiUrl
• SecondsPeriodTask
• BackendApiUrl
• AppHostPort
• gMSAEnabled
• gMSAName
• gMSAImporterEnabled
• gMSAImporterName

Si le flux d'installation nécessite la réutilisation de la SecurityKey et du mot de passe LiteDB actuels, suivez la procédure Installation existante.

Étape 5 : démarrer le service

1. Ouvrez le panneau “Services” Windows.
2. Démarrez le service Hybrid Agent.

Étape 6 : configurer la clé API

1. Copiez la clé API générée depuis la section “Configuration locale”.

2. Collez la clé API dans le connecteur.

Étape 7 : vérifier la session

Exécutez “Vérifier la session” pour confirmer que le Hybrid Connector mis à niveau est correctement configuré.