Mise à niveau de DPM à l'aide de Solution Central
Pour effectuer une mise à niveau de DPM 1.1 vers DPM 1.2 à l'aide de Solution Central, procédez comme indiqué dans les sections suivantes :
 |
PTC vous recommande d'abord de mettre à niveau un système de test avant de passer au système de production.
Solution Central est l'outil recommandé pour déplacer votre déploiement et vos personnalisations entre les environnements ThingWorx, par exemple d'un environnement de test à un environnement de production. Pour plus d'informations, consultez le ThingWorx Solution Central Help Center.
|
Avant de commencer le processus de mise à niveau
Avant de commencer le processus de mise à niveau, consultez les informations suivantes :
• Configuration requise pour la version 9.3 de ThingWorx dans le Centre d'aide ThingWorx.
• Mise à niveau de ThingWorx dans le Centre d'aide ThingWorx.
• Les personnalisations apportées à DPM sont affectées par le processus de mise à niveau. Pour plus d'informations, consultez la rubrique Personnalisation et mise à niveau.
Avant de procéder à la mise à niveau de ThingWorx
Avant de mettre à niveau ThingWorx, procédez comme suit :
• Si vous avez personnalisé l'un des blocs de construction, sauvegardez vos personnalisations.
• Les tables de localisation sont écrasées lors d'une mise à niveau. Si vous avez personnalisé des jetons dans des tables de localisation, exportez les tables de localisation personnalisées avant d'effectuer la mise à niveau. Vous pouvez importer les tables de localisation exportées une fois la mise à niveau terminée pour conserver vos modifications.
Mise à niveau de ThingWorx
Procédez comme suit :
1. Mettez à niveau votre installation de ThingWorx. Pour plus d'informations, consultez la rubrique Mise à niveau de ThingWorx du Centre d'aide ThingWorx.
Pour les versions ThingWorx compatibles avec DPM 1.2, consultez la rubrique Configuration requise de DPM.
2. Redémarrez le serveur ThingWorx.
Avant la mise à niveau de DPM
Avant de procéder à la mise à niveau de DPM, consultez les informations suivantes et exécutez les actions nécessaires :
• DPM n'est pas disponible pendant le processus de mise à niveau, ce qui signifie que les données de production ne peuvent pas être saisies pendant cette période. PTC vous recommande d'abord de mettre à niveau un système de test avant de mettre à niveau votre système de production. Cette opération vous aidera à déterminer la durée pendant laquelle votre système de production sera indisponible.
• Augmentez la durée du paramètre de délai d'expiration d'un script avant de procéder à la mise à niveau. La valeur précédente de ce paramètre peut être rétablie une fois la mise à niveau terminée. Pour mettre à jour le paramètre de délai d'expiration d'un script, un administrateur ThingWorx doit procéder comme suit :
1. Sur le serveur ThingWorx, accédez au dossier ThingWorxPlatform.
2. Ouvrez le fichier platform-settings.json dans un éditeur de texte.
3. Recherchez le paramètre ScriptTimeout et mettez à jour sa valeur sur 12000.
4. Enregistrez le fichier platform-settings.json et fermez-le.
5. Redémarrez le serveur ThingWorx.
|
|
Si un message semblable au suivant apparaît dans votre journal de script, répétez les étapes ci-dessus pour augmenter davantage le paramètre ScriptTimeout :
[message: Execution of Script terminated after : 12000 seconds. Timeout configured for 12000 seconds.]
|
Pour plus d'informations, consultez la rubrique Détails de la configuration du fichier platform-settings.json dans le Centre d'aide ThingWorx.
Mise à niveau de DPM
Pour mettre à niveau DPM, procédez comme suit :
1. Déployez la nouvelle version de DPM à l'aide de Solution Central.
|
|
Si vous déployez DPM sur un système ThingWorx haute disponibilité, il est recommandé de passer le cluster à une instance unique, d'installer les extensions, puis de repasser le cluster à l'échelle. Cette approche sera plus performante et empêchera les problèmes de cohérence éventuelle dans la mesure où les nouvelles extensions seront chargées par chaque serveur au démarrage. Pour plus d'informations, consultez la rubrique Gestion des extensions ThingWorx dans ThingWorx haute disponibilité dans le Centre d'aide ThingWorx.
|
Pour déployer la solution DPM sur votre instance de ThingWorx à l'aide de Solution Central, un administrateur ThingWorx doit procéder comme suit :
a. Assurez-vous que votre licence DPM est installée dans ThingWorx Composer. Pour plus d'informations, consultez cet article du support technique dans la base de connaissances PTC.
b. Configurez Solution Central. Pour plus d'informations, consultez la rubrique Getting Started with Using Solution Central du Solution Central Help Center (en anglais).
c. Enregistrez votre instance ThingWorx dans Solution Central. Pour plus d'informations, consultez la rubrique Register Your ThingWorx Instance du Solution Central Help Center (en anglais).
d. Dans ThingWorx Composer, accédez à > > .
e. Cochez la case en regard de l'option Digital Performance Management, puis cliquez sur Déployer en un clic. Cette opération ouvre une fenêtre répertoriant toutes les extensions à déployer dans le cadre de la solution DPM.
f. Cliquez sur Déployer tout.
Les extensions sont téléchargées et installées. Cela peut prendre plusieurs minutes. Vous serez averti lorsque le processus sera terminé.
Pour plus d'informations, consultez le ThingWorx Solution Central Help Center.
2. Redémarrez le serveur ThingWorx.
3. Obtenez les paramètres de configuration du service UpgradeSolution.
a. Dans ThingWorx Composer, accédez à l'objet PTC.Base.Manager.
b. Sous Services, recherchez et exécutez le service GetSolutionUpgradeConfigurationParameters. La sortie du service est un code JSON contenant les paramètres de configuration requis pour le service UpgradeSolution, qui s'appuient de façon dynamique sur l'ensemble des blocs de construction présents. Le JSON de sortie du service ressemble à ce qui suit :
{
"databaseUser": {
"types": [
"STRING"
],
"description": "Name of the database user used for DPM database Thing",
"optional": false
},
"automatedMigration": {
"types": [
"Boolean"
],
"description": "When TRUE, the MigrateSolution service is automatically called by the UpgradeSolution service after the upgrade action completes. When FALSE, the MigrateSolution service must be manually executed.",
"optional": false
},
"overrideComponentDeploymentState": {
"types": [
"BOOLEAN"
],
"description": "If true, the current component deployment state is ignored and the DeployComponent service will be rerun.",
"optional": true
},
"databasePassword": {
"types": [
"STRING"
],
"description": "Password of the database user used for DPM database Thing",
"optional": false
},
"databaseJDBCString": {
"types": [
"STRING"
],
"description": "JDBC Connection String for the DPM database Thing",
"optional": false
},
"databaseThing": {
"types": [
"STRING"
],
"description": "The default database thing (PTC.DBConnection.SQLThingDatabase)",
"optional": true
}
}
"databaseUser": {
"types": [
"STRING"
],
"description": "Name of the database user used for DPM database Thing",
"optional": false
},
"automatedMigration": {
"types": [
"Boolean"
],
"description": "When TRUE, the MigrateSolution service is automatically called by the UpgradeSolution service after the upgrade action completes. When FALSE, the MigrateSolution service must be manually executed.",
"optional": false
},
"overrideComponentDeploymentState": {
"types": [
"BOOLEAN"
],
"description": "If true, the current component deployment state is ignored and the DeployComponent service will be rerun.",
"optional": true
},
"databasePassword": {
"types": [
"STRING"
],
"description": "Password of the database user used for DPM database Thing",
"optional": false
},
"databaseJDBCString": {
"types": [
"STRING"
],
"description": "JDBC Connection String for the DPM database Thing",
"optional": false
},
"databaseThing": {
"types": [
"STRING"
],
"description": "The default database thing (PTC.DBConnection.SQLThingDatabase)",
"optional": true
}
}
c. Copiez le code JSON renvoyé dans la sortie du service et collez-le dans un éditeur de texte.
d. Modifiez le code JSON en remplaçant le contenu entre accolades de chaque paramètre de configuration par la valeur propre à votre site.
▪ databaseUser : nom de connexion de l'utilisateur de la base de données doté des droits d'administration système.
▪ databasePassword : mot de passe de connexion de l'utilisateur de la base de données doté des droits d'administration système.
▪ databaseJDBCString : chaîne de connexion JDBC de la base de données DPM.
▪ databaseThing : objet de base de données par défaut (PTC.DBConnection.SQLThingDatabase).
▪ overrideComponentDeploymentState : cette valeur doit être false.
▪ automatedMigration : lorsque cette valeur est true, le service MigrateSolution est automatiquement exécuté et les données de la solution sont migrées vers le schéma de base de données mis à jour. Cette migration peut prendre un certain temps, en fonction de la quantité de données à migrer. Lorsque cette valeur est false, le service MigrateSolution n'est pas exécuté automatiquement et doit être exécuté manuellement ultérieurement.
Voici un exemple du code JSON en entrée :
{
"databaseUser": "DPMadmin",
"databasePassword": "945DaTaBase!39525",
"databaseJDBCString": "jdbc:sqlserver://localhost:1433;databaseName=dpmdb",
"databaseThing": "PTC.DBConnection.SQLThingDatabase",
"overrideComponentDeploymentState": false,
“automatedMigration”: true
}
"databaseUser": "DPMadmin",
"databasePassword": "945DaTaBase!39525",
"databaseJDBCString": "jdbc:sqlserver://localhost:1433;databaseName=dpmdb",
"databaseThing": "PTC.DBConnection.SQLThingDatabase",
"overrideComponentDeploymentState": false,
“automatedMigration”: true
}
4. Exécutez le service UpgradeSolution en utilisant le JSON modifié de l'étape 3.d comme paramètre d'entrée config pour le service.
Lorsque le service est terminé, la sortie affiche une table d'informations répertoriant les blocs de construction qui ont été mis à niveau, déployés et migrés (si le service MigrateSolution a été exécuté automatiquement) et leur statut de configuration : Successful, Not Processed ou Error. Si une erreur est détectée pendant que le service traite un bloc de construction, le service s'arrête. Le statut du bloc de construction est affiché sous la forme Error, et les blocs de construction restants présentent un statut Not Processed.
Si des blocs de construction présentent un statut Error ou Not Processed, effectuez les étapes de dépannage suivantes :
a. Assurez-vous que les informations d'identification de la base de données spécifiées dans le JSON sont valides, puis exécutez le service UpgradeSolution.
b. Si des blocs de construction présentent toujours un statut Error ou Not Processed dans la sortie du service, consultez les journaux des erreurs des applications et des scripts ThingWorx et corrigez les éventuelles erreurs qui y sont signalées. Ensuite, exécutez le service UpgradeSolution.
c. Si des blocs de construction présentent toujours un statut Error ou Not Processed dans la sortie du service, mettez à jour le JSON pour inclure les éléments suivants et exécutez le service UpgradeSolution :
"overrideComponentDeploymentState": true
5. Si le service MigrateSolution n'a pas été exécuté automatiquement par le service UpgradeSolution, exécutez le service MigrateSolution. Ce service ne dispose d'aucun paramètre d'entrée requis.
La sortie de service, les statuts et les étapes de dépannage du service MigrateSolution sont identiques à ceux du service UpgradeSolution, comme illustré à l'étape 4. Répétez les étapes de dépannage jusqu'à ce que tous les blocs de construction aient un statut Successful.
 |
La mise à niveau n'est pas terminée tant que le service MigrateSolution n'a pas été exécuté avec succès. DPM 1.2 ne peut pas être utilisé tant que les données n'ont pas été migrées.
|
Activités de post-mise à niveau
Une fois que DPM a été mis à niveau et avant de rendre le système mis à jour accessible aux utilisateurs, procédez comme suit :
1. Agrégez les événements dans la base de données. Procédez comme suit :
a. Dans ThingWorx Composer, accédez à PTC.OperationKPIImpl.EventsAggregationScheduler.
b. Sous Services, exécutez le service AggregateEvents. L'exécution de ce service peut prendre un certain temps.
L'exécution du service est terminée lorsque le message Aucun résultat s'affiche dans le volet de sortie.
Si le service rencontre une erreur, corrigez l'erreur, puis exécutez à nouveau le service.
2. Si vous avez personnalisé DPM, reportez-vous à la rubrique Personnalisation et mise à niveau pour résoudre tout impact possible de la mise à niveau sur vos personnalisations.
3. Importez les éventuelles tables de localisation personnalisées que vous avez exportées depuis ThingWorx Composer avant de procéder à la mise à niveau de ThingWorx.
4. Si vous avez augmenté le paramètre de délai d'expiration d'un script avant de mettre à niveau DPM, rétablissez la valeur précédente.
5. Examinez les activités d'administration initiales et effectuez toutes les activités nécessaires à la nouvelle fonctionnalité. Pour en savoir plus, consultez le manuel anglais Opérations d'administration initiales de DPM.
6. Mettez à jour les noms des matières et les sites auxquels elles appartiennent, si nécessaire.
Dans DPM 1.1, les matières individuelles ne pouvaient appartenir à qu'un seul site, et les noms de matière devaient être uniques dans chaque site. Cela signifie qu'il pouvait y avoir plusieurs matières portant le même nom, chacune appartenant à un site différent. Dans DPM 1.2, les matières peuvent désormais appartenir à un, plusieurs ou tous les sites, et les noms des matières doivent être uniques dans l'ensemble de l'entreprise. Les services de migration des données gèrent les matières avec des noms en double comme suit :
◦ La première matière rencontrée présentant un nom particulier est migrée telle quelle.
◦ Les matières suivantes portant le même nom voient le site auquel elles appartiennent ajouté à leur nom lors de la migration, au format NomMatière_NomSite.
Une fois la migration terminée, vous pouvez facilement trouver ces doublons de matières migrées en triant ou en filtrant le tableau Matières. Vous pouvez modifier les matières pour changer leur nom et les ajouter à des sites supplémentaires selon les besoins. Vous pouvez désactiver les doublons de matières que vous ne souhaitez pas utiliser.
Par exemple, dans DPM 1.1, il existe trois matières nommées Material1, qui appartiennent respectivement aux sites Boston, London et Berlin. Le tableau ci-dessous présente, pour chaque matière, son nom et son site dans DPM 1.1, ainsi que son nom et son site après la migration vers DPM 1.2. Dans cet exemple, les services de migration des données rencontrent d'abord Material1 appartenant au site Boston.
|
Nom et site de la matière dans DPM 1.1
|
Nom et site de la matière après migration vers DPM 1.2
|
|---|---|
|
Material1, Boston
|
Material1, Boston
|
|
Material1, London
|
Material1_London, London
|
|
Material1, Berlin
|
Material1_Berlin, Berlin
|
Dans le tableau Matières, vous pouvez filtrer sur "Material1" pour rechercher toutes les instances de ces matières. Si vous souhaitez utiliser une seule matière nommée Material1 appartenant aux trois sites, vous pouvez modifier Material1 pour ajouter les sites London et Berlin puis désactiver Material1_London et Material1_Berlin.
7. Conseillez aux utilisateurs de vider le cache du navigateur sur les ordinateurs clients.