Programme d'installation de ThingWorx Foundation pour Windows
A.) Conditions requises pour le programme d'installation Windows avec le serveur flexible Azure PostgreSQL
 | Si une installation existante est détectée au cours de ce processus, le programme d'installation mettra à niveau ThingWorx Foundation. Pour plus d'informations, consultez la rubrique Utilisation du programme d'installation pour mettre à niveau ThingWorx Foundation. |
| | Il n'est pas recommandé d'utiliser des espaces dans les noms de fichier pour le programme d'installation de ThingWorx. Le programme d'installation de ThingWorx rencontrera des problèmes si vous tentez d'installer ThingWorx avec un chemin d'accès qui inclut des espaces. Si vous devez utiliser des espaces, un administrateur doit activer la prise en charge Windows des noms de fichiers 8dot3. |
• Vous avez passé en revue les informations et les conditions requises générales décrites dans la rubrique d'aide Programme d'installation de ThingWorx Foundation.
• Pour exécuter le programme d'installation de ThingWorx Foundation pour Windows avec le serveur flexible Azure PostgreSQL, vous devez disposer de la configuration ci-après. Pour plus d'informations sur les versions prises en charge, consultez la rubrique Configuration requise.
◦ Java 11 installé
| | Java 11 est requis pour les versions 9.3.0 et ultérieures. • Définissez la variable Java_Home pour qu'elle utilise le répertoire d'installation de Java 11. |
◦ Windows avec accès administrateur.
◦ La base de données ThingWorx configurée avec les connexions autorisées.
◦ Un utilisateur de base de données configuré en tant que propriétaire de la base de données ThingWorx, avec :
▪ Tous les privilèges accordés à cet utilisateur sur la base de données ThingWorx.
▪ La propriété can login définie sur yes.
Cet utilisateur de base de données sera utilisé pour spécifier le nom d'utilisateur de base de données ThingWorx dans le programme d'installation.
La table suivante répertorie les prérequis applicables :
Connexion à la base de données | Conditions requises |
|---|---|
Distant | • Installez le client psql compatible avec votre version de PostgreSQL. • Ajoutez le client psql installé à la variable d'environnement PATH en procédant comme suit : b. Installez le client pgadmin. c. Mettez à jour la variable d'environnement PATH à ajouter au chemin d'installation du client pgadmin. |
B.) Conditions requises pour le programme d'installation Windows avec PostgreSQL
| | Si une installation existante est détectée au cours de ce processus, le programme d'installation mettra à niveau ThingWorx Foundation. Pour plus d'informations, consultez la rubrique Utilisation du programme d'installation pour mettre à niveau ThingWorx Foundation. |
| | Il n'est pas recommandé d'utiliser des espaces dans les noms de fichier pour le programme d'installation de ThingWorx. Le programme d'installation de ThingWorx rencontrera des problèmes si vous tentez d'installer ThingWorx avec un chemin d'accès qui inclut des espaces. Si vous devez utiliser des espaces, un administrateur doit activer la prise en charge Windows des noms de fichiers 8dot3. |
• Vous avez passé en revue les informations et les conditions requises générales décrites dans la rubrique d'aide Programme d'installation de ThingWorx Foundation.
• Pour exécuter le programme d'installation de ThingWorx Foundation pour Windows avec PostgreSQL, vous devez disposer de la configuration ci-après. Pour plus d'informations sur les versions prises en charge, consultez la rubrique Configuration requise.
◦ Java 11 installé
◦ Windows avec accès administrateur.
◦ Base de données ThingWorx configurée avec connexions autorisées et codage défini sur UTF-8.
▪ La propriété de base de données Connection_LIMIT doit être définie sur -1, valeur par défaut qui autorise un nombre illimité de connexions à la base de données pour tous les utilisateurs authentifiés.
◦ Un utilisateur de base de données configuré en tant que propriétaire de la base de données ThingWorx, avec les paramètres suivants :
▪ Tous les privilèges accordés à cet utilisateur sur la base de données ThingWorx.
▪ La propriété can login définie sur yes.
Cet utilisateur de base de données sera utilisé pour spécifier le nom d'utilisateur de base de données ThingWorx dans le programme d'installation.
◦ Connexion de base de données locale ou distante. La table suivante répertorie les prérequis applicables :
Connexion à la base de données | Prérequis |
|---|---|
Local | • PostgreSQL installé, avec le chemin vers PostgreSQL/bin renseigné dans la variable d'environnement PATH. • JDK Java installé. Assurez-vous que java/bin est renseigné dans la variable d'environnement PATH. • Autorisez les connexions à PostgreSQL à partir de l'hôte ThingWorx Foundation en mettant à jour le fichier pg_hba.conf. Par exemple, si ThingWorx Foundation est installé sur le même hôte que PostgreSQL, vous pouvez mettre à jour le fichier pg_hba.conf pour définir la méthode d'authentification par mot de passe sur md5, password ou trust. Il n'est cependant pas recommander de la définir sur trust. Pour plus d'informations sur le fichier pg_hba.conf et les méthodes d'authentification par mot de passe, consultez le site Web PostgreSQL.org. Voici un exemple de fichier pg_hba.conf mis à jour avec une authentification par mot de passe définie sur md5 : $ Edit pg_hba.conf for following: ... # "local" is for Unix domain socket connections only local all all md5 # IPv4 local connections: host all all 127.0.0.1/32 md5 # IPv6 local connections: host all all ::1/128 md5 |
Distant | • Installez le client psql compatible avec votre version de PostgreSQL. • Ajoutez le psql installé à la variable d'environnement PATH. Vous pouvez procéder comme suit : a. Téléchargez pgadmin4-4.1-x86.exe à partir de l'adresse https://www.postgresql.org/ftp/pgadmin/pgadmin4/v4.1/windows/. b. Installez le client pgadmin. c. Mettez à jour la variable d'environnement PATH à ajouter au chemin d'installation du client pgadmin. |
C.) Conditions requises pour le programme d'installation Windows avec SQL Server
| | Si une installation existante est détectée au cours de ce processus, le programme d'installation mettra à niveau ThingWorx Foundation. Pour plus d'informations, consultez la rubrique Utilisation du programme d'installation pour mettre à niveau ThingWorx Foundation. |
| | Il n'est pas recommandé d'utiliser des espaces dans les noms de fichier pour le programme d'installation de ThingWorx. Le programme d'installation de ThingWorx rencontrera des problèmes si vous tentez d'installer ThingWorx avec un chemin d'accès qui inclut des espaces. Si vous devez utiliser des espaces, un administrateur doit activer la prise en charge Windows des noms de fichiers 8dot3. |
• Vous avez passé en revue les informations et les conditions requises générales décrites dans la rubrique d'aide Programme d'installation de ThingWorx Foundation.
Pour exécuter le programme d'installation de ThingWorx Foundation pour Windows avec Microsoft SQL Server, vous devez disposer de la configuration ci-après. Pour plus d'informations sur les versions prises en charge, consultez la rubrique Configuration requise.
• Java 11 installé
| | Java 11 est requis pour les versions 9.3.0 et ultérieures. • Définissez la variable JAVA_HOME pour qu'elle utilise le répertoire d'installation de Java 11. |
• Windows avec accès administrateur.
• Base de données ThingWorx configurée avec les paramètres suivants :
◦ Définissez la propriété Collate sur Latin1_General_100_CS_AS_SC.
◦ Définissez les propriétés suivantes sur ON :
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• Connexion à Microsoft SQL Server avec authentification SQL Server.
Le mot de passe de cette connexion est le Mot de passe de connexion à la base de données ThingWorx.
◦ Un utilisateur de base de données pour cette connexion, configuré en tant que propriétaire avec rôle public.
Cet utilisateur doit avoir un schéma par défaut dbo, un schéma détenu de db_owner, tout en étant un membre de db_owner.
• Connexion de base de données locale ou distante. La table suivante répertorie les prérequis applicables :
Connexion à la base de données | Conditions requises |
|---|---|
Local | • L'hôte sur lequel vous voulez installer ThingWorx Foundation doit avoir accès à Microsoft SQL Server. • Un client Microsoft SQL valide (sqlcmd) doit être installé et doit être accessible via la variable d'environnement PATH. • JDK Java installé. java/bin renseigné dans la variable d'environnement PATH. |
Distant | • sqlcmd est installé et disponible dans la variable d'environnement PATH. |
D.) Conditions requises pour l'activation de SSL/TLS dans le programme d'installation : création d'un KeyStore
| | Définissez les valeurs de -Xms et -Xmx sur 75 % de la mémoire du système d'exploitation disponible (par ex., 12 Go pour un système doté de 16 Go de RAM). Les valeurs Xms et Xmx doivent être en Mo. Pour plus d'informations, consultez la rubrique Réglage de la JVM. |
Dans l'écran Propriétés de ThingWorx Foundation du programme d'installation, la case Utiliser SSL/TLS pour sécuriser la connexion est cochée par défaut. Vous pouvez désactiver l'utilisation de SSL/TLS dans le programme d'installation en décochant cette case. Si vous choisissez de conserver le paramètre par défaut et d'utiliser SSL/TLS, vous devez générer un fichier KeyStore Java (.jks) avant d'exécuter le programme d'installation. Le fichier KeyStore Java (.jks) doit disposer des autorisations de sécurité suivantes :
• Sous Windows, les autorisations de lecture (Read) et de lecture et d'exécution (Read & Execute) du fichier KeyStore doivent être accordées au profil utilisateur Service réseau.
Vous pouvez générer un KeyStore de plusieurs façons, dont la suivante :
1. Placez-vous dans Java/bin.
2. Pour créer le fichier KeyStore Tomcat (.jks), exécutez la commande suivante : keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048 -storetype jks.
3. Spécifiez un mot de passe pour le KeyStore. Vous aurez besoin de ce mot de passe ultérieurement pour configurer le serveur.
| | Le mot de passe ne peut pas être composé de guillemets simples ('), de guillemets doubles ('') ou de symboles de paragraphe (§). |
4. Lorsque vous y êtes invité, spécifiez le nom de domaine du serveur. Par exemple, myserver.mycompany.com.
5. Spécifiez les autres informations, telles que l'unité d'organisation et l'organisation.
6. Lorsque vous y êtes invité, fournissez le mot de passe du KeyStore.
E.) Installation de ThingWorx Foundation sur Windows
1. Assurez-vous que les prérequis décrits dans les sections ci-dessus sont remplies.
2. Pour PostgreSQL ou le serveur flexible Azure PostgreSQL, depuis le site support.ptc.com, sous > > > > > , téléchargez ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-postgres.
OU
Pour Microsoft SQL Server, depuis le site support.ptc.com, sous > > > > > , téléchargez ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-mssql.
3. Extrayez les fichiers.
4. Pour PostgreSQL ou le serveur flexible Azure PostgreSQL, exécutez ThingWorxFoundationPostgres-9.x.x-x64.exe.
OU
Pour Microsoft SQL Server, exécutez ThingWorxFoundationMSSQL-9.x.x-x64.exe.
5. Parcourez les écrans du programme d'installation.
| | Dans l'écran Propriétés de ThingWorx Foundation, la case Utiliser SSL/TLS pour sécuriser la connexion est cochée par défaut. Vous pouvez désactiver l'utilisation de SSL/TLS dans le programme d'installation en décochant cette case. Si vous choisissez d'utiliser SSL/TLS, spécifiez les valeurs de KeyStore générées lors de la configuration préalable décrite ci-dessus. |
| | Le paramètre Mode SSL est obligatoire pour le serveur flexible Azure PostgreSQL. sslRootCert est requis pour les modes SSL verify-ca et verify-full. Pour plus d'informations sur la sécurisation des communications avec le serveur flexible Azure PostgreSQL et sur le téléchargement du certificat, consultez la page Connectivité chiffrée à l'aide du protocole TLS dans Azure Database pour PostgreSQL - Serveur flexible. |
6. Dans le dernier écran du programme d'installation, la case Open License Configurator est cochée par défaut. Si cette case est cochée, le configurateur de licences s'ouvre lorsque le programme d'installation a rempli sa fonction et se ferme. Si vous décochez la case Open License Configurator, le programme d'installation se ferme et le configurateur de licences ne s'ouvre pas automatiquement.
a. Cliquez sur Suivant dans l'écran Setup : Configure licensing for ThingworxFoundation for Postgres ou Setup : Configure licensing for ThingworxFoundation for Mssql.
b. Utilisez le configurateur de licences pour vous connecter au serveur de licences PTC ou configurer ThingWorx Foundation pour utiliser la licence prétéléchargée.
c. Parcourez les écrans de licence.
7. Votre installation de ThingWorx Foundation est maintenant terminée.
| | Pour plus d'informations sur l'augmentation de la mémoire pour Tomcat après l'installation, consultez l'article de support PTC CS306401. |
F.) Connexion à ThingWorx Foundation Server
1. Accédez à l'URL de ThingWorx Foundation.
Par exemple : https://<hostname>:<port>/Thingworx/Composer.
L'URL de ThingWorx Foundation sera différente selon votre configuration (SSL ou non SSL) et les ports utilisés lors de l'installation. Le SSL est activé par défaut. Vous pouvez toutefois désactiver l'utilisation de SSL/TLS. Consultez la section Configuration requise pour l'activation de SSL/TLS dans le programme d'installation ci-dessus.
2. Fournissez les informations d'identification de l'utilisateur.
Le nom d'utilisateur est Administrateur et le mot de passe est celui qui a été entré lors de l'installation.
G.) Fonctions supplémentaires du programme d'installation et dépannage
Démarrage et arrêt des services ThingWorx Foundation sur Windows
1. Accédez à Services.msc.
2. Recherchez le service ThingWorx-Foundation.
3. Démarrez ou arrêtez ce service.
Localisation des fichiers journaux du programme d'installation
• Journaux d'installation :
◦ ${installdir}\installer\logs\ThingWorxFoundation_install.log
Par exemple : C:\Program Files (x86)\ThingWorxFoundation\installer\logs\ThingWorxFoundation_install.log.
• Journaux d'exécution :
◦ ${installdir}\ThingworxStorage\logs\
Par exemple : C:\Program Files (x86)\ThingWorxFoundation\ThingworxStorage\logs\.
• Pour un abandon ou un échec :
◦ ${system_temp_directory}\ThingWorxFoundation_Failed_installs\
Par exemple : C:\Users\vagrant\AppData\Local\Temp\ThingWorxFoundation_Failed_installs\.
• Journaux de désinstallation :
◦ ${system_temp_directory}\bitrock_installer_(pid).log
Le nom du fichier journal possède le préfixe bitrock. Par exemple : C:\Users\vagrant\AppData\Local\Temp\bitrock_installer_3008.log.
Désinstallation d'une installation réalisée avec le programme d'installation de ThingWorx Foundation
1. Accédez à l'emplacement d'installation de ThingWorx Foundation.
2. Exécutez ThingWorxFoundation_uninstall.exe.
3. Lorsque vous y êtes invité, cliquez sur OK pour confirmer que vous souhaitez poursuivre la désinstallation.
4. Une fois la désinstallation terminée, le programme d'installation est supprimé.
Suppression de la base de données ThingWorx depuis PostgreSQL
1. Depuis la ligne de commande sous Windows, ouvrez une connexion à la base de données PostgreSQL.
Par exemple, entrez psql -U admin -h dbhost.
2. Si vous utilisez le nom par défaut de la base de données, exécutez la commande DROP DATABASE thingworx;.
Ou, si vous avez personnalisé le nom de la base de données, exécutez la commande DROP DATABASE <your database name>;.
Suppression de la base de données ThingWorx depuis Microsoft SQL
1. Depuis la ligne de commande sous Windows, ouvrez une connexion à la base de données Microsoft SQL.
Par exemple, entrez sqlcmd -U admin -s ‘dbhost\dbservicename,port’.
2. Si vous utilisez le nom par défaut de la base de données, exécutez la commande DROP DATABASE thingworx; GO;.
Ou, si vous avez personnalisé le nom de la base de données, exécutez la commande DROP DATABASE <your database name>; GO;.
Si vous rencontrez des problèmes avec les modifications de configuration de service sous Windows et que vous souhaitez obtenir plus d'informations, exécutez la commande suivante pour consigner plus d'informations dans le fichier commons-daemon.log du répertoire /tomcat/current/logs/ : tomcat9w.exe //ES//ThingWorx-Foundation --LogLevel Debug.