Installation de ThingWorx (Ubuntu/RHEL)
1. Créez des répertoires /ThingworxStorage et /ThingworxBackupStorage. Si ce n'est déjà fait, créez également un répertoire /ThingworxPlatform :
$ sudo mkdir /ThingworxStorage /ThingworxBackupStorage /ThingworxPlatform
2. Modifiez le propriétaire de /ThingworxPlatform, /ThingworxStorage et /ThingworxBackupStorage ainsi que les autorisations d'accès associées. Sans ces autorisations, le serveur ne pourra pas démarrer.
$ sudo chown tomcat8.5:tomcat8.5 /ThingworxStorage /ThingworxBackupStorage /ThingworxPlatform
$ sudo chmod 775 /ThingworxStorage /ThingworxBackupStorage /ThingworxPlatform
4. Déplacez le fichier Thingworx.war dans $CATALINA_HOME/webapps.
$ sudo mv Thingworx.war $CATALINA_HOME/webapps
$ sudo chown tomcat8.5:tomcat8.5 $CATALINA_HOME/webapps/Thingworx.war
$ sudo chmod 775 $CATALINA_HOME/webapps/Thingworx.war
5. Placez le fichier platform-settings.json dans le dossier ThingworxPlatform.
6. Configurez le mot de passe administrateur.
{
"PlatformSettingsConfig": {
"AdministratorUserSettings": {
"InitialPassword": "changeme"
}
}
}
|
Si Tomcat ne démarre pas et signale le message d'erreur Check the InitialPassword setting in the AdministratorUserPassword section in platform-settings.json..., vérifiez les informations suivantes :
• Le paramètre de mot de passe existe dans platform-settings.json
• Le mot de passe est valide (au moins 14 caractères, par défaut)
• Le format du fichier platform-settings.json est correct (un problème de formatage peut entraîner des erreurs)
|
7. Autorisez l'importation d'extensions. Par défaut, l'importation d'extensions est désactivée pour tous les utilisateurs.
Ajoutez les informations suivantes dans le fichier
platform-settings.json. Mettez à jour les paramètres
ExtensionPackageImportPolicy suivants en les définissant sur
true pour autoriser l'importation d'extensions. Pour connaître les bonnes pratiques de configuration,
consultez la rubrique
Importation d'extensions .
"ExtensionPackageImportPolicy": {
"importEnabled": <true or false>,
"allowJarResources": <true or false>,
"allowJavascriptResources": <true or false>,
"allowCSSResources": <true or false>,
"allowJSONResources": <true or false>,
"allowWebAppResources": <true or false>,
"allowEntities": <true or false>,
"allowExtensibleEntities": <true or false>
},
8. Configurez la gestion des licences :
"LicensingConnectionSettings":{
"username":"PTC Support site user name",
"password":"PTC Support site password"
}
|
Si les paramètres ne sont pas renseignés correctement ou si le serveur ne peut pas se connecter, un fichier texte de demande de licence (licenseRequestFile.txt) est créé dans le dossier ThingworxPlatform. Dans ce scénario, une licence doit être créée manuellement. (A défaut, ThingWorx démarrera en mode limité. Le mode limité ne vous permet pas de rendre les entités sous licence persistances dans la base de données. Les entités sous licence sont les objets, les applications composites, les modèles de base, les gadgets, les utilisateurs et les fournisseurs de persistance.)
|
10. Si vous utilisez Azure SQL pour votre base de données, procédez comme suit pour télécharger le pilote JDBC. Ignorez cette étape si vous n'utilisez pas Azure SQL.
a. Rendez-vous sur le portail Azure et accédez à votre base de données ThingWorx.
b. Sélectionnez Chaînes de connexion.
c. Sélectionnez l'onglet JDBC.
d. Sélectionnez Télécharger le pilote JDBC pour SQL Server.
e. Sélectionnez Microsoft JDBC Driver 6.0 pour SQL Server.
f. Extrayez et copiez le binaire téléchargé sur votre VM ThingWorx vers votre répertoire Tomcat lib.
11. Démarrez Tomcat.
(UBUNTU) sudo service tomcat8.5 start
(RHEL) $ sudo systemctl start tomcat
Vérifiez qu'un fichier de licence (successful_license_capability_response.bin) est créé dans le dossier ThingworxPlatform.
12. Pour lancer ThingWorx, accédez à http://<nom_de_serveur>:<port>/Thingworx dans un navigateur Web.
13. Modifiez le mot de passe par défaut :
a. Dans Composer, sélectionnez Administrateur > .
b. Dans la fenêtre Changer le mot de passe, entrez votre Mot de passe actuel, votre Nouveau mot de passe et confirmez votre nouveau mot de passe dans le champ Confirmer le mot de passe.
| Veillez à ce que ce mot de passe soit difficile à deviner et comprenne au moins 14 caractères, avec une combinaison de caractères majuscules et minuscules, de chiffres et de caractères spéciaux. |
14. Cliquez sur Terminé.
15. (ETAPE FACULTATIVE) Pour déterminer le statut de votre licence, choisissez Surveillance > Sous-système > Paramètres du sous-système de licence dans Composer pour confirmer la liste des fonctionnalités (entités sous licence) incluses avec la licence. Si aucune entité sous licence n'est affichée, vous êtes en mode limité.