Déploiement de DPM à l'aide de la page Télécharger un logiciel PTC
Dans ce scénario, votre base de données et ThingWorx sont installés sur votre système et vous déployez DPM dans votre instance ThingWorx en téléchargeant la solution à partir de la page Télécharger un logiciel PTC et en important le package d'extension dans ThingWorx.
Effectuez les procédures des sections suivantes :
Configuration requise
Avant de déployer DPM, effectuez les conditions requises suivantes :
• Examinez la configuration requise de DPM, et notamment les versions de ThingWorx compatibles avec DPM. Pour plus d'informations, consultez la rubrique Configuration requise de DPM.
• Examinez la configuration requise de ThingWorx pour une version compatible de ThingWorx. Pour plus d'informations, consultez la rubrique Configuration requise du Centre d'aide ThingWorx.
• Installez une version compatible de ThingWorx. Pour plus d'informations, consultez la rubrique Installation de ThingWorx.
• Appliquez la licence appropriée pour DPM. Pour plus d'informations, consultez la rubrique Licences pour ThingWorx Platform du Centre d'aide ThingWorx.
• Configurez ThingWorx pour autoriser l'importation d'extensions. Pour plus d'informations, consultez la rubrique Importation d'extensions du Centre d'aide ThingWorx.
• Assurez-vous que le fuseau horaire du serveur ThingWorx est défini sur UTC. Pour plus d'informations, consultez la rubrique Installer Java, Apache Tomcat et ThingWorx dans le Centre d'aide ThingWorx.
• Si vous installez votre base de données sur Linux, installez l'outil sqlcmd.
• Installez Microsoft SQL Server Management Studio. Pour plus d'informations, rendez-vous sur https://docs.microsoft.com/en-us/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver15.
Mettre à jour le paramètre de délai d'expiration d'un script
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. Dans la section BasicSettings, recherchez le paramètre ScriptTimeout et mettez-le à jour sur 12000.
Si l'option n'est pas déjà présente, ajoutez-la à la section BasicSettings, comme suit : "ScriptTimeout": 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.
Mettre à jour le paramètre de délai d'inactivité de la session
Par défaut, les sessions utilisateur inactives expirent au bout de 30 minutes. Vous pouvez modifier ce paramètre en fonction des besoins de votre système.
Pour modifier le paramètre de délai d'inactivité de la session, un administrateur ThingWorx doit procéder comme suit :
1. Dans ThingWorx, accédez à > .
2. Ouvrez UserManagementSubsystem en mode Edition.
3. Sous Configuration, modifiez la valeur du paramètre Délai d'inactivité de la session (min).
4. Cliquez sur Enregistrer.
5. Redémarrez le serveur ThingWorx.
Pour plus d'informations, consultez la rubrique Sous-système de gestion des utilisateurs dans le Centre d'aide ThingWorx.
Installer le pilote MS SQL JDBC
Si votre instance ThingWorx est configurée avec PostgreSQL en tant que fournisseur de persistance, procédez comme suit pour installer le pilote MS SQL JDBC. Si votre instance ThingWorx est configurée avec MS SQL en tant que fournisseur de persistance, passez à la section suivante.
1. Téléchargez la version compatible JRE11 du pilote Microsoft JDBC Driver 7.4.1 for SQL Server à partir du lien suivant : https://docs.microsoft.com/en-us/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server-support-matrix?view=sql-server-ver15#sql-version-compatibility.
2. Copiez le fichier JAR du pilote JDBC dans le répertoire lib de l'installation de Tomcat : (<TOMCAT_HOME>/lib).
3. Redémarrez le serveur Tomcat pour charger le pilote JDBC afin de le rendre disponible pour ThingWorx.
Créer votre base de données DPM et votre utilisateur de la base de données
Procédez comme suit :
1. Créez le nom de connexion et le mot de passe de l'utilisateur de la base de données de votre DPM dans la base de données principale. Suivez les recommandations en matière de complexité du mot de passe pour votre base de données.
◦ Sous Windows, utilisation de la commande Transact-SQL dans l'Editeur de requête de Microsoft SQL Server Management Studio :
CREATE LOGIN <dpmadmin> WITH PASSWORD = '<password>';
Dans la commande ci-dessus, remplacez <dpmadmin> et <password> par le nom de connexion et le mot de passe de votre utilisateur de la base de données DPM.
◦ Sous Linux :
1. Ouvrez l'invite de commande dans le client Linux.
2. Créez la connexion sur SQL Server à l'aide des commandes suivantes :
sqlcmd –S <database-server-name> -U <sql-administrator-username> -P <sql-administrator-password> \
-Q "create login <dpmadmin> with password = '<dpmadmin-password>'" \
GO; \
exit
-Q "create login <dpmadmin> with password = '<dpmadmin-password>'" \
GO; \
exit
Dans les commandes ci-dessus, remplacez la chaîne <database-server-name> par le nom de votre serveur de base de données, les chaînes <sql-administrator-username> et <sql-administrator-password> par le nom d'utilisateur et le mot de passe de l'administrateur SQL, et les chaînes <dpmadmin> et <dpmadmin-password> par le nom de connexion et le mot de passe de votre utilisateur de la base de données DPM.
2. Créez la base de données Microsoft SQL Server (MSSQL) que DPM utilisera.
◦ Sous Windows, utilisation des commandes Transact-SQL dans l'Editeur de requête de Microsoft SQL Server Management Studio :
CREATE DATABASE <dpmdb> COLLATE SQL_Latin1_General_CP1_CI_AS;
ALTER DATABASE <dpmdb> SET READ_COMMITTED_SNAPSHOT ON;
ALTER DATABASE <dpmdb> SET ALLOW_SNAPSHOT_ISOLATION ON;
ALTER DATABASE <dpmdb> SET ARITHABORT ON;
ALTER DATABASE <dpmdb> SET READ_COMMITTED_SNAPSHOT ON;
ALTER DATABASE <dpmdb> SET ALLOW_SNAPSHOT_ISOLATION ON;
ALTER DATABASE <dpmdb> SET ARITHABORT ON;
Dans les commandes ci-dessus, remplacez la chaîne <dpmdb> par le nom de votre base de données.
◦ Sous Linux :
1. Ouvrez l'invite de commande dans le client Linux.
2. Utilisez les commandes suivantes pour créer la base de données SQL Server, en remplaçant les variables par le nom du serveur de base de données et par le nom d'utilisateur et le mot de passe de l'administrateur SQL :
sqlcmd –S <database-server-name> \
-U <sql-administrator-username> -P <sql-administrator-password> \
-Q "create database <dpmdb> COLLATE SQL_Latin1_General_CP1_CI_AS; ALTER DATABASE <dpmdb> SET READ_COMMITTED_SNAPSHOT ON; ALTER DATABASE <dpmdb> SET ALLOW_SNAPSHOT_ISOLATION ON;ALTER DATABASE <dpmdb> SET ARITHABORT ON"
-U <sql-administrator-username> -P <sql-administrator-password> \
-Q "create database <dpmdb> COLLATE SQL_Latin1_General_CP1_CI_AS; ALTER DATABASE <dpmdb> SET READ_COMMITTED_SNAPSHOT ON; ALTER DATABASE <dpmdb> SET ALLOW_SNAPSHOT_ISOLATION ON;ALTER DATABASE <dpmdb> SET ARITHABORT ON"
Dans la commande ci-dessus, remplacez la chaîne <database-server-name> par le nom de votre serveur de base de données, les chaînes <sql-administrator-username> et <sql-administrator-password> par le nom d'utilisateur et le mot de passe de l'administrateur SQL, et la chaîne <dpmdb> par le nom de votre base de données.
3. Créez un utilisateur de base de données pour la connexion créée à l'étape 1. Utilisez le même nom pour l'utilisateur de la base de données que celui utilisé pour le nom de connexion.
◦ Sous Windows, utilisation de la commande Transact-SQL dans l'Editeur de requête de SQL Server Management Studio ouvert pour la base de données qui a été créée à l'étape 2 :
CREATE USER <dpmadmin> FOR LOGIN <dpmadmin>;
ALTER ROLE [db_owner] ADD MEMBER <dpmadmin>;
ALTER ROLE [db_owner] ADD MEMBER <dpmadmin>;
Dans la commande ci-dessus, remplacez la chaîne <dpmadmin> par le nom de connexion créé à l'étape 1.
◦ Sous Linux :
1. Ouvrez l'invite de commande dans le client Linux.
2. Utilisez les commandes suivantes pour créer un utilisateur de base de données pour votre base de données DPM, en remplaçant les variables par le nom du serveur de base de données et par le nom d'utilisateur et le mot de passe de l'administrateur SQL :
sqlcmd –S <database-server-name> \
-U <sql-administrator-username> -P <sql-administrator-password> \
-Q "use <dpmdb>; create user <dpmadmin> for login <dpmadmin>;ALTER ROLE [db_owner] ADD MEMBER <dpmadmin>"
-U <sql-administrator-username> -P <sql-administrator-password> \
-Q "use <dpmdb>; create user <dpmadmin> for login <dpmadmin>;ALTER ROLE [db_owner] ADD MEMBER <dpmadmin>"
Dans les commandes ci-dessus, remplacez la chaîne <database-server-name> par le nom de votre serveur de base de données, les chaînes <sql-administrator-username> et <sql-administrator-password> par le nom d'utilisateur et le mot de passe de l'administrateur SQL, la chaîne <dpmdb> par le nom de votre base de données et la chaîne <dpmadmin> par le nom de connexion créé à l'étape 1.
Télécharger la solution DPM à l'aide de la page Télécharger un logiciel PTC
Procédez comme suit :
1. Accédez à la page Télécharger un logiciel PTC à l'URL suivante : https://support.ptc.com/appserver/auth/it/esd/index.jsp.
2. Sélectionnez ThingWorx Foundation.
3. Développez les dossiers suivants : > > > .
4. Téléchargez le fichier ZIP du package d'extension DPM-1-2.
Importer la solution DPM
Pour importer la solution DPM, un administrateur ThingWorx doit suivre les étapes suivantes :
1. Assurez-vous que votre licence est installée dans ThingWorx Composer. Pour plus d'informations, consultez cet article du support technique dans la base de connaissances PTC.
2. Dans ThingWorx Composer, accédez à > .
3. Dans la fenêtre Importer, sélectionnez Extension dans la liste Option d'importation.
4. Sous Nom de fichier, cliquez sur Parcourir. Accédez au fichier ZIP du package d'extension que vous avez téléchargé dans la section précédente et sélectionnez-le.
5. Cliquez sur Importer. Une fois l'importation terminée, cliquez sur Fermer.
6. Affichez les extensions de la solution DPM après leur importation en accédant à > .
Exécuter le service InitializeSolution
Exécutez le service InitializeSolution pour configurer l'objet de base de données afin qu'il se connecte à votre base de données DPM, qu'il crée des tables de base de données et qu'il enregistre les objets de gestionnaire pour les blocs de construction qui composent DPM.
Pour exécuter le service, un administrateur ThingWorx doit procéder comme suit :
1. Dans ThingWorx Composer, accédez à l'objet PTC.Base.Manager.
2. Obtenez les paramètres de configuration :
a. Sous Services, recherchez et exécutez le service GetSolutionDeploymentConfigurationParameters. La sortie du service est un code JSON contenant les paramètres de configuration requis pour le service InitializeSolution, 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
},
"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
},
"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
}
}
b. Copiez le code JSON renvoyé dans la sortie du service et collez-le dans un éditeur de texte.
c. 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).
Voici un exemple de modification du code JSON précédent :
{
"databaseUser": "<dpmadmin>",
"databasePassword": "<password>",
"databaseJDBCString": "jdbc:sqlserver://<databaseHost>:<databasePort>;databaseName=<DPMdatabaseName>",
"databaseThing": "PTC.DBConnection.SQLThingDatabase"
}
"databaseUser": "<dpmadmin>",
"databasePassword": "<password>",
"databaseJDBCString": "jdbc:sqlserver://<databaseHost>:<databasePort>;databaseName=<DPMdatabaseName>",
"databaseThing": "PTC.DBConnection.SQLThingDatabase"
}
Voici un exemple de modification du code JSON précédent avec des valeurs réelles :
{
"databaseUser": "DPMadmin",
"databasePassword": "945DaTaBase!39525",
"databaseJDBCString": "jdbc:sqlserver://localhost:1433;databaseName=dpmdb",
"databaseThing": "PTC.DBConnection.SQLThingDatabase"
}
"databaseUser": "DPMadmin",
"databasePassword": "945DaTaBase!39525",
"databaseJDBCString": "jdbc:sqlserver://localhost:1433;databaseName=dpmdb",
"databaseThing": "PTC.DBConnection.SQLThingDatabase"
}
3. Sous Services, recherchez et exécutez le service InitializeSolution en utilisant le code JSON que vous avez modifié à l'étape 2.c comme paramètre d'entrée deploymentConfig pour le service.
Une fois le service exécuté, la sortie affiche une table d'informations répertoriant les blocs de construction qui ont été déployés et leur statut de configuration : Configured, Not Configured ou Error. Si des blocs de construction présentent un statut Error ou Not Configured, 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 InitializeSolution.
b. Si des blocs de construction présentent toujours un statut Error ou Not Configured 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 InitializeSolution.
c. Si des blocs de construction présentent toujours un statut Error ou Not Configured dans la sortie du service, mettez à jour le JSON pour inclure les éléments suivants et exécutez le service InitializeSolution :
"overrideComponentDeploymentState": true