Migration de ThingWorx Flow
Vous pouvez migrer ThingWorx Flow 8.4.x installé sur un ordinateur donné vers ThingWorx Flow 8.5.x installé sur une autre machine en exportant le stockage de ThingWorx Flow 8.4.x et en l'important dans ThingWorx Flow 8.5.x.
* 
Aux fins de ce document, nous allons considérer que la machine sur laquelle ThingWorx Flow 8.4.x est installé est la machine A et que la machine sur laquelle ThingWorx Flow 8.5 est installé est la machine B.
Configuration requise
Avant de procéder à la migration de ThingWorx Flow, assurez-vous que les conditions requises suivantes sont respectées :
sur la machine A, qu'il existe une installation de ThingWorx Flow 8.4.x avec différents processus créés avec des connexions, des déclencheurs, des autorisations et utilisant des conditions, boucles, actions personnalisées, connexions privées (via des utilisateurs), etc ;
sur l'ordinateur B, que vous disposez des privilèges nécessaires pour installer ThingWorx Foundation et ThingWorx Flow ;
que vous disposez de la version appropriée de ThingWorx Foundation 8.5.x, téléchargée depuis le site Web des téléchargements de logiciels de PTC.
que vous disposez de la version appropriée de ThingWorx Flow 8.5.x, téléchargée depuis le site Web des téléchargements de logiciels de PTC.
Les principales étapes de la procédure sont les suivantes :
Etape 1 : Exportation des données de ThingWorx Flow vers ThingworxStorage
1. Sur la machine A, connectez-vous à ThingWorx Composer en tant qu'administrateur. L'administrateur doit appartenir au groupe Administrateurs.
2. Cliquez sur Importer/Exporter > Exporter. La fenêtre Exporter s'ouvre.
3. Dans la liste Option d'exportation, sélectionnez Vers ThingworxStorage.
4. Cochez la case Exportation universelle pour prévenir l'exportation des informations sensibles.
5. Cliquez sur Exporter. Le dossier exporté, nommé avec l'horodatage actuel, est créé sous <chemin_installation_ThingWorx>\ThingWorx<TypeBD>-<8.4.x>\ThingworxStorage\exports.
6. Dans <chemin_installation_ThingWorx>\ThingWorx<TypeBD>-<8.4.x>\ThingworxStorage\logs, ouvrez le fichier ApplicationLog.log approprié pour vérifier que le processus d'exportation a été correctement mené à bien.
7. Sauvegardez le dossier exporté sur une machine ou sur un stockage différent.
Etape 2 : Installation de ThingWorx Foundation et de ThingWorx Flow sur la machine B
1. Installez ThingWorx Foundation 8.5.x. Pour plus d'informations, consultez la rubrique Installation de ThingWorx.
2. Installez ThingWorx Flow 8.5.x. Pour plus d'informations, consultez la rubrique Installation de ThingWorx Flow.
* 
Vous pouvez installer ThingWorx Foundation et ThingWorx Flow sur la même machine ou sur des ordinateurs différents. Toutefois, veillez à ce que ThingWorx Foundation et ThingWorx Flow résident sur le même domaine.
3. Démarrez le serveur ThingWorx Flow.
4. Exécutez le service LoadOAuthConfiguration dans ThingWorx Composer pour charger les OAuths sur le serveur ThingWorx Flow.
(Facultatif) Etape 3 : Déploiement de connecteurs personnalisés sur la machine B
* 
Ne suivez les étapes de cette section que si vous avez développé des connecteurs personnalisés à l'aide du SDK ThingWorx Flow.
1. Copiez le code source du connecteur personnalisé sur la machine B.
2. Accédez au répertoire racine du connecteur, puis exécutez la commande flow-deploy connector.
Pour plus d'informations, consultez la rubrique Déploiement des connecteurs.
3. Exécutez la commande suivante pour amorcer le connecteur personnalisé dans la base de données :
flow-deploy migrate -u <nom d'utilisateur base de données Flow> -p <mot de passe base de données Flow> -s <répertoire d'installation Flow>
Etape 4 : Importation des données exportées dans l'installation de ThingWorx Foundation 8.5.x sur la machine B
1. Copiez le dossier de stockage exporté sauvegardé à l'étape 1 dans <chemin_installation_ThingWorx>\ThingWorx<TypeBD>-<8.5.x>\ThingworxStorage\exports sur la machine B.
2. Sur la machine B, connectez-vous en tant qu'administrateur à ThingWorx Composer. L'administrateur doit appartenir au groupe Administrateurs.
3. Cliquez sur Importer/Exporter > Importer. La fenêtre Importer s'ouvre.
4. Dans la liste Option d'importation, sélectionnez A partir de ThingworxStorage.
5. Sélectionnez le dossier que vous avez copié dans <chemin_installation_ThingWorx>\ThingWorx<TypeBD>-<8.5.x>\ThingworxStorage\exports.
6. Cliquez sur Importer.
7. Dans <chemin_installation_ThingWorx>\ThingWorx<TypeBD>-<8.5.x>\ThingworxStorage\logs, ouvrez le fichier ApplicationLog.log approprié pour vérifier que le processus d'importation a été correctement mené à bien.
(Facultatif) Etape 5 : Modification de la configuration de ThingWorx Foundation et de ThingWorx Flow
Si nécessaire, apportez des modifications à la configuration des services ThingWorx Foundation et ThingWorx Flow. Pour plus d'informations concernant ThingWorx Flow, consultez la rubrique Administration de ThingWorx Flow. Pour plus d'informations concernant les mises à jour de ThingWorx Foundation, consultez la rubrique Ressources de configuration de ThingWorx.
Etape 6 : Mise à jour des autorisations, connexions et déclencheurs sur la machine B
1. Sur la machine B, connectez-vous à ThingWorx Flow en tant qu'administrateur.
2. Sur le tableau de bord de ThingWorx Flow, cliquez sur le menu utilisateur dans l'en-tête, puis sur Paramètres.
3. Vérifiez que l'ensemble des autorisations, connexions et déclencheurs ont été importés. Notez que chaque élément est précédé d'une icône . Cette icône signifie que leur configuration est incomplète dans la mesure où les informations sensibles n'ont pas été exportées, résultat de la sélection de l'option Exportation universelle lors de l'exportation.
4. Modifiez toutes les autorisations et connexions, et fournissez les informations d'identification appropriées pour chaque autorisation et connexion.
5. Modifiez tous les déclencheurs de manière à fournir une autorisation ou une connexion appropriée, et fournissez les informations de lookup.
Etape 7 : Vérification que toutes les données de ThingWorx Foundation et de ThingWorx Flow ont été importées et que les processus peuvent être exécutés sur la machine B
1. Sur la machine B, connectez-vous à ThingWorx Composer en tant qu'administrateur.
2. Dans ThingWorx Composer, accédez à Objets et assurez-vous que les processus sous les entités Objet ont été importées.
3. Sur le tableau de bord de ThingWorx Flow, vérifiez que tous les processus ont été importés.
Vous pouvez également ouvrir l'entité Processus, cliquer sur Services, puis ouvrir un service. Le processus doit apparaître et s'exécuter correctement.
4. Ouvrez les processus et vérifiez que vous pouvez les modifier et les exécuter.
5. Vérifiez que les déclencheurs fonctionnent correctement.
6. Vérifiez que vous pouvez créer un processus, et lors de sa création, ajoutez une catégorie dans l'éditeur de processus.
Vous avez migré ThingWorx Flow sur la machine B.