Mettre à jour la version de MySQL pour Tekla PowerFab

Tekla PowerFab prend officiellement en charge MySQL jusqu’à la version 8.0.35. Pour mettre à niveau la version MySQL à partir de 5.0.90, vous devez exécuter Tekla PowerFab 2020 SP2 ou version ultérieure.

Versions MySQL prises en charge


Version de Tekla PowerFab/EPM	MySQL 8.0.35¹	MySQL 5.7.41	MySQL 5.7.29	MySQL 5.6.36	MySQL 5.0.90
2023i	✓²	✓	✓	✓	✓
2023	✓²	✓	✓	✓	✓
2022i	✓²	✓	✓	✓	✓
2022	✓²	✓	✓	✓	✓
2021i	-	✓	✓	✓	✓
2021	-	-	✓	✓	✓
2020i	-	-	✓	✓	✓
2020	-	-	-	✓	✓

¹ L’utilisation de MySQL 8 est limitée aux ordinateurs 64 bits. Les versions 32 bits de MySQL 8 ne sont pas disponibles.

²Tekla PowerFab 2023i SP3, Tekla PowerFab 2023 SP8, Tekla EPM 2022i SP9, Tekla EPM 2022 SP10 ou supérieur est requis pour la prise en charge de MySQL 8.

Nous vous recommandons d’effectuer la mise à jour vers la dernière version Tekla PowerFab disponible avant de mettre à niveau la version MySQL. Nous vous recommandons également de réparer les erreurs de programme et de comprimer la base de données Tekla PowerFab avant de la sauvegarder. Pour obtenir des instructions, voir :

Remarque : Toutes les étapes doivent être effectuées à partir du serveur sur lequel MySQL est installé. Lors de la mise à jour de la version MySQL, tous les utilisateurs doivent être déconnectés de Tekla PowerFab et MySQL.

Option 1 : mise à jour MySQL propre

Cette mise à jour comprend la désinstallation de l’ancienne version et l’installation d’une nouvelle version de MySQL.

Remarque : Avant de commencer :

Lors de la mise à jour de la version MySQL, vérifiez que tous les utilisateurs se sont déconnectés de Tekla PowerFab et MySQL avant d’enregistrer une copie de sauvegarde de la base de données Tekla PowerFab jusqu’à ce que la base de données Tekla PowerFab ait été restaurée dans la nouvelle version.

Consultez les instructions suivantes :

Localisez le programme d’installation pour la version MySQL que vous souhaitez installer.
Dans l’emplacement d’installation par défaut des répertoires par défaut pour la sauvegarde (C:\Users\Public\Documents\Tekla\Backup), vous devriez trouver mysql_setup_<version>.exe.

Si vous ne disposez pas de la version du programme d’installation souhaitée, contactez l’assistance pour la recevoir.

Pour plus d’informations, voir :
- Répertoires par défaut
- Contacter l’assistance
Sur le serveur, ouvrez Tekla PowerFab en tant qu’administrateur.
(Facultatif, recommandé) Réparer les erreurs du programme.
(Facultatif, recommandé) Compresser la base de données Tekla PowerFab.
Enregistrer une copie de sauvegarde de la base de données Tekla PowerFab.

Ne l’enregistrez pas dans l’emplacement d’installation de MySQL.
Fermez Tekla PowerFab.
Ouvrez l’application Services Windows, recherchez le service MySQL pour la base de données Tekla PowerFab et arrêtez le service.

Selon la version avec laquelle vous avez commencé, le nom du service peut être MySQL_TeklaPowerFab, MySQL_TeklaEPM ou MySQL_Fabsuite. Le nom du service peut être personnalisé avec MySQL Service Manager, il peut donc s’agir de n’importe quoi.
(Facultatif) Pour désinstaller la version actuelle de MySQL, exécutez uninstall.exe à partir de l’emplacement d’installation MySQL.

Généralement, l’emplacement l’est C:\mysql\, mais pourrait être personnalisé.

Remarque : Avant de désinstaller la version actuelle de MySQL, assurez-vous qu’aucun autre programme ou service ne l’utilise également. Si c’est le cas, vous devez installer une seconde MySQL pour la nouvelle version.
Pour installer MySQL, exécutez mysql_setup_<version>.exe situé dans l’emplacement d’installation par défaut des répertoires par défaut pour la sauvegarde.

Référez-vous à l’étape 2.

Si vous installez une deuxième instance du programme MySQL, vous devez spécifier un nouveau répertoire par défaut, C:\MySQL8 par exemple. L’exécution de mysql_setup_8.exe fourni par Trimble crée un nouveau service MySQL_TeklaPowerFab sur le port 3306.
Ouvrir Tekla PowerFab en tant qu’administrateur
Restauration de la base de données Tekla PowerFab.

Utilisez la sauvegarde de base de données créée à l’étape 6.
Recréez le service Tekla PowerFab Remote Server.
1. Ouvrez Tekla PowerFab Remote Monitor.
  
  Il se trouve normalement dans le répertoire d’installation Tekla PowerFab et le nom de l’application est Tekla.PowerFab.Remote.Monitor.exe.
  
  Voir aussi Tekla PowerFab Remote Monitor.
2. Pour supprimer le service existant, sélectionnez-le dans le menu déroulant et cliquez sur le bouton moins (-).
3. Pour créer un service, cliquez sur le bouton plus (+).
  
  La dépendance de service doit être MySQL_TeklaPowerFab.
Configurez et démarrez Tekla PowerFab Remote Server.

Après avoir effectué toutes ces étapes, les utilisateurs peuvent se reconnecter à l’application de bureau Tekla PowerFab et Tekla PowerFab Go.

Option 2 : mise à niveau avec l’utilitaire MySQL_Upgrade

Les utilisateurs qui ne souhaitent pas désinstaller la version MySQL existante et installer la nouvelle version peuvent utiliser l’utilitaire MySQL_Upgrade.exe.

Remarque : Avant de commencer :

Assurez-vous que tous les utilisateurs se sont déconnectés de Tekla PowerFab et qu’aucun utilisateur ne se connectera tant que la mise à niveau n’est pas terminée.

Consultez les instructions suivantes :

Téléchargez et extrayez mysql-upgrade-<version>.exe à partir de MySQL Upgrade pour Tekla PowerFab dans Tekla Warehouse.
Sur le serveur, ouvrez Tekla PowerFab en tant qu’administrateur.
(Facultatif, recommandé) Réparer les erreurs du programme.
(Facultatif, recommandé) Compresser la base de données Tekla PowerFab.
Enregistrer une copie de sauvegarde de la base de données Tekla PowerFab.

Ne l’enregistrez pas dans l’emplacement d’installation de MySQL.
Ouvrez Windows Explorateur et accédez au répertoire d’installation du programme Tekla PowerFab.

L’emplacement par défaut est C:\Program Files\Tekla\Tekla PowerFab.
Fermez toutes les instances de Tekla PowerFab, y compris Tekla PowerFab Remote Monitor et MySQL Service Manager.
Exécutez MySQL_Upgrade.exe à partir du répertoire d’installation du programme Tekla PowerFab.

L’emplacement par défaut est C:\Program Files\Tekla\Tekla PowerFab.

La boîte de dialogue Paramètres de mise à niveau s’ouvre.
Pour ouvrir la boîte de dialogue de sélection de fichier, cliquez sur le bouton de sélection à droite du programme d’installation de mise à niveau et sélectionnez mysql-upgrade-<version>.exe obtenu à l’étape 1.
Dans la section MySQL de la boîte de dialogue Paramètres de mise à niveau, entrez les informations suivantes :

Adresse IP maître : conservez localhost.

Port maître : le port par défaut de MySQL est 3306. Ne modifiez cette option que si vous avez spécifiquement défini MySQL pour qu’il s’exécute sur un autre port.

Mise à jour de l’adresse IP et Mise à jour du port : Ceux-ci sont rarement utilisés et doivent être laissés vides, sauf instruction contraire du support technique.

Nom d’utilisateur et Mot de passe : entrez les informations d’identification d’un utilisateur Tekla PowerFab disposant d’autorisations d’administrateur.

Nom du service : il s’agit du nom du service Windows qui gère le processus MySQL.

Le nom de service par défaut lors de l’installation de Tekla PowerFab MySQL est MySQL_TeklaPowerFab.

Selon la version avec laquelle vous avez commencé, le nom du service peut être MySQL_TeklaPowerFab, MySQL_TeklaEPM ou MySQL_Fabsuite. Le nom du service peut être personnalisé avec MySQL Service Manager, il peut donc s’agir de n’importe quoi.

Certains utilisateurs installent un deuxième service MySQL sur le même serveur, utilisant le même ensemble d’exécutables MySQL, mais travaillant sur des répertoires de données différents et écoutant sur un port différent.

Si tel est le cas avec votre système, ce service supplémentaire doit être ajouté aux Paramètres de mise à niveau afin que les deux répertoires de données soient mis à niveau. Si un autre service MySQL s’exécute à l’aide du même ensemble d’exécutables MySQL et qu’il n’est pas spécifié dans ces paramètres, la mise à niveau échoue ou ce deuxième service MySQL ne fonctionne plus correctement.
Pour installer un deuxième service MySQL, procédez comme suit :
1. Cliquez sur le bouton plus (+) pour ajouter un ensemble supplémentaire d’entrées serveur MySQL.
2. Entrez l’Adresse IP maître, le Port maître, le Nom d’utilisateur, le Mot de passe et le Nom du service.
  
  Répétez ces étapes pour tous les services supplémentaires de MySQL qui fonctionnent à partir du même ensemble d’exécutables MySQL.
Pour commencer la mise à niveau, cliquez sur Mise à jour du serveur MySQL.

La boîte de dialogue Paramètres de mise à niveau se ferme et des messages d’état s’affichent.

Remarque : N’essayez pas d’arrêter le programme de mise à niveau pendant qu’il est en cours. Sinon, l’installation de MySQL risque de ne pas fonctionner.

Les étapes de mise à niveau sont terminées sans qu’aucune autre action ne soit requise de la part de l’utilisateur.

Les étapes effectuées automatiquement sont les suivantes :

Vérifier les paramètres entrés sur l’écran précédent.
Effectuer une sauvegarde de la base de données.
Arrêter le service MySQL.
Copier dans les fichiers pour la nouvelle version de MySQL.
Ajuster les paramètres de configuration de MySQL.
Démarrer le service MySQL.
Restaurer la base de données.
Terminer la mise à niveau des fichiers de données.

Une fois la mise à niveau terminée, un message Mise à jour terminée ! s’affiche dans la boîte de dialogue d’état. Vous pouvez maintenant fermer en toute sécurité le programme de mise à niveau, l’ouvrir et vous connecter à Tekla PowerFab.

Échec de la mise à jour

Si la mise à niveau échoue, le message La mise à jour a échoué ! s’affiche.

Cliquez sur OK.

Un autre message s’affiche indiquant que la mise à jour est restaurée à son état précédent.
Pour poursuivre la restauration, cliquez sur OK.

Toutes les étapes qui ont été franchies jusqu’à ce stade sont inversées. Cela laisse MySQL dans le même état qu’avant la mise à jour et la boîte de dialogue Paramètres de mise à niveau réapparaît.

Vous pouvez ensuite ajuster des paramètres et réessayer la mise à niveau ou contacter le support technique pour obtenir de l’aide.