Migration d’un même serveur avec l’outil de migration HIS

L’outil de migration HIS vous permet de migrer d’une édition antérieure de Host Integration Server vers Host Integration Server 2020 ou 2016 sur le même serveur. L’outil de migration prend les informations de configuration avant de désinstaller l’ancienne version de Host Integration Server. Ces informations de configuration peuvent être appliquées à la nouvelle installation de Host Integration Server.

Étapes de la migration d’un même serveur

  • Ces instructions supposent que l’outil de migration est téléchargé dans un répertoire c:\Files local.

  • Vérifiez que la plateforme existante répond à la configuration système requise de HIS 2020. Notez que .NET Framework 4.8 est obligatoire.

  • Ouvrez une invite de commandes en tant qu’administrateur, accédez à c:\Files et exécutez la commande suivante :

    HisMigration.exe c:\Files\HIS_Migrate /Save
    

    Notes

    c:\Files\HIS_Migrate doit être là et ne contenir aucun fichier.

  • Désinstallez l’ancienne version de HIS (Panneau de configuration>Programmes).

  • Installez Host Integration Server 2020 ou 2016. N’exécutez pas l’Assistant Configuration.

  • Modifiez le fichier c:\Files\HIS_Migrate\savedConfig.config pour insérer le ou les mots de passe corrects du compte sous lequel les services s’exécutent. Pour des raisons de sécurité, le ou les mots de passe sont remplacés par PasswordReplacedByThis. Le ou les mots de passe corrects doivent être entrés, sans quoi les services ne démarreront pas. Il peut y avoir plusieurs instances de l’élément de mot de passe.

  • Pour actualiser les nouvelles variables d’environnement à partir de l’installation de Host Integration Server, puis enregistrer la configuration :

    1. Ouvrez une nouvelle invite de commandes en tant qu’administrateur, puis accédez à c:\Files.
    2. Exécutez : HisMigration.exe c:\Files\HIS_Migrate /Apply.

Considérations supplémentaires

  • Lors de la migration d’un sous-domaine multiserveur, démarrez la migration avec le serveur secondaire. Lorsque tous ces serveurs sont migrés, migrez le serveur principal. Veillez à migrer le serveur principal en dernier.

  • La migration des serveurs configurés pour utiliser une passerelle SNA distante n’est pas prise en charge actuellement. La prise en charge est prévue dans la prochaine mise à jour cumulative.

  • Après la migration, lorsque vous êtes prêt à autoriser l’accès aux services, activez manuellement les règles de pare-feu.

  • Pour les services HIP, l’outil de migration examine le contenu de HIPService.exe.config à la recherche du assemblyPath des objets HIP. Si assemblyPath pointe vers le chemin du produit HIS, par exemple %snaroot%\TIM, les objets HIP sont déplacés vers le nouveau dossier TIM de HIS. Si assemblyPath est dans un répertoire personnalisé, ce répertoire est créé et les objets y sont copiés.

  • L’outil de migration n’examine pas le serveur à la recherche de programmes WIP (Windows Initiated Programs) d’intégration des applications. Si ces programmes existent sur le serveur, recherchez-les dans les fichiers app.config. Confirmez que le contenu du fichier app.config utilise les emplacements à jour sur le serveur.

  • Si vous effectuez une mise à niveau de HIS 2013 vers HIS 2020 ou 2016, les programmes WIP et HIP, ainsi que les assemblys TI, doivent être recompilés pour fonctionner avec ces versions.

    Veillez à :

    • Ajouter de nouvelles références aux assemblys de runtime TI de HIS.
    • Mettre à jour les fichiers .config pour utiliser la version 10.0 au lieu de la version 9.0.
    • Les projets doivent utiliser .NET 4.8 ou 4.6.
    • Dans le concepteur HIS, ouvrez n’importe quel fichier .hidx TI et enregistrez-le. Cette étape génère la ou les dll mises à jour. Cette étape n’est pas requise lors de la migration de HIS 2016 vers HIS 2020.
  • Pour WIP et HIP, toute la configuration doit être effectuée dans les fichiers .config. Aucune information de configuration n’est lue dans le Registre.

  • La fonctionnalité d’intégration de Visual Studio n’est plus migrée par cet outil. Dans HIS 2020, les extensions de Visual Studio sont réécrites sous la forme d’un package VSIX. Il n’est pas possible de prendre en charge la migration à partir d’anciens packages VSIP. Pour restaurer cette fonctionnalité, exécutez l’Assistant Configuration et activez la fonctionnalité d’intégration de Visual Studio.

Étapes suivantes

Outil de migration HIS
Migration de serveur à serveur