ThingWorx Foundation Installationsprogramm für Windows
A.) Voraussetzungen für Windows-Installationsprogramm mit PostgreSQL
 | Wird während dieses Prozesses eine vorhandene Installation gefunden, führt das Installationsprogramm ein Upgrade für ThingWorx Foundation durch. Weitere Informationen finden Sie unter Installationsprogramm verwenden, um Upgrade für ThingWorx Foundation durchzuführen. |
| | Es wird nicht empfohlen, Leerzeichen in Dateinamen für das ThingWorx Installationsprogramm zu verwenden. Im ThingWorx Installationsprogramm treten Probleme auf, wenn Sie versuchen, ThingWorx unter einem Dateipfad zu installieren, der Leerzeichen enthält. Wenn Sie Leerzeichen verwenden müssen, sollten Administratoren Windows-Unterstützung für 8dot3 aktivieren. |
• Sie haben die Informationen gelesen und sich mit den allgemeinen Voraussetzungen vertraut gemacht, die im Hilfethema ThingWorx Foundation Installationsprogramm beschrieben sind.
• Sie benötigen Folgendes, um das ThingWorx Foundation Installationsprogramm für Windows mit PostgreSQL auszuführen. Informationen zu unterstützten Versionen finden Sie unter Systemanforderungen.
◦ Java 11 installiert
| | Java 11 ist für 9.2.0 und höher erforderlich. • Legen Sie die Variable JAVA_HOME auf das Installationsverzeichnis von Java 11 fest. |
◦ Windows mit Administratorzugriff
◦ ThingWorx Datenbank, die für Verbindungen konfiguriert und deren Kodierung auf "UTF-8" festgelegt ist
▪ Die Datenbankeigenschaft Connection_LIMIT muss auf -1 festgelegt sein. Dies ist der Standardwert, der eine unbegrenzte Anzahl von Verbindungen zur Datenbank für alle authentifizierten Benutzer erlaubt.
◦ Datenbankbenutzer, der als Besitzer der ThingWorx Datenbank konfiguriert ist und für den gilt:
▪ Diesem Benutzer wurden alle Rechte für die ThingWorx Datenbank gewährt.
▪ Die Eigenschaft can login ist auf yes festgelegt.
Dieser Datenbankbenutzer wird im Installationsprogramm als Benutzername für die ThingWorx Datenbank eingetragen.
◦ Eine lokale oder Remote-Datenbankverbindung. In der folgenden Tabelle sind die anwendbaren Voraussetzungen aufgeführt:
Datenbankverbindung | Voraussetzungen |
|---|---|
Lokal | • PostgreSQL muss installiert sein und der Pfad zu PostgreSQL/bin sollte in der Umgebungsvariable PATH vorhanden sein. • Java JDK muss installiert sein. Stellen Sie sicher, dass java/bin in der Umgebungsvariablen PATH festgelegt ist. • Lassen Sie Verbindungen zu PostgreSQL vom ThingWorx Foundation Host zu, indem Sie die Datei pg_hba.conf aktualisieren. Wenn ThingWorx Foundation beispielsweise auf dem gleichen Host wie PostgreSQL installiert ist, können Sie die Datei pg_hba.conf aktualisieren, um die Passwort-Authentifizierungsmethode auf md5, password oder trust festzulegen. Die Festlegung auf trust wird jedoch nicht empfohlen. Weitere Informationen zur Datei pg_hba.conf und zu Passwort-Authentifizierungsmethoden finden Sie auf der Website "PostgreSQL.org". Im Folgenden finden Sie ein Beispiel für die Datei pg_hba.conf, bei der die Passwortauthentifizierung auf md5 festgelegt ist: $ 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 |
Remote | • Installieren Sie den psql-Client, der mit Ihrer PostgreSQL-Version kompatibel ist. • Fügen Sie den installierten psql zur Umgebungsvariable PATH hinzu. Führen Sie die folgenden Schritte aus: a. Laden Sie pgadmin4-4.1-x86.exe vonhttps://www.postgresql.org/ftp/pgadmin/pgadmin4/v4.1/windows/ herunter. b. Installieren Sie den pgadmin-Client. c. Aktualisieren Sie die Umgebungsvariable PATH, um sie an den Pfad anzuhängen, unter dem der pgadmin-Client installiert ist. |
B.) Voraussetzungen für Windows-Installationsprogramm mit SQL Server
| | Wird während dieses Prozesses eine vorhandene Installation gefunden, führt das Installationsprogramm ein Upgrade für ThingWorx Foundation durch. Weitere Informationen finden Sie unter Installationsprogramm verwenden, um Upgrade für ThingWorx Foundation durchzuführen. |
| | Es wird nicht empfohlen, Leerzeichen in Dateinamen für das ThingWorx Installationsprogramm zu verwenden. Im ThingWorx Installationsprogramm treten Probleme auf, wenn Sie versuchen, ThingWorx unter einem Dateipfad zu installieren, der Leerzeichen enthält. Wenn Sie Leerzeichen verwenden müssen, sollten Administratoren Windows-Unterstützung für 8dot3 aktivieren. |
• Sie haben die Informationen gelesen und sich mit den allgemeinen Voraussetzungen vertraut gemacht, die im Hilfethema ThingWorx Foundation Installationsprogramm beschrieben sind.
Sie benötigen Folgendes, um das ThingWorx Foundation Installationsprogramm für Windows mit Microsoft SQL Server auszuführen. Informationen zu unterstützten Versionen finden Sie unter Systemanforderungen.
• Java 11 installiert
| | Java 11 ist für 9.2.0 und höher erforderlich. • Legen Sie die Variable JAVA_HOME auf das Installationsverzeichnis von Java 11 fest. |
• Windows mit Administratorzugriff
• Eine ThingWorx Datenbank, deren Einstellungen wie folgt zu konfigurieren sind:
◦ Legen Sie die Eigenschaft Collate auf Latin1_General_100_CS_AS_SC fest.
◦ Legen Sie die folgenden Eigenschaften auf ON fest:
▪ READ_COMMITTED_SNAPSHOT
▪ ALLOW_SNAPSHOT_ISOLATION
• Anmeldeinformationen für Microsoft SQL Server mit SQL Server-Authentifizierung
Das Passwort dieser Anmeldeinformationen ist das Passwort für die Anmeldung bei der ThingWorx Datenbank.
◦ Ein Datenbankbenutzer für diese Anmeldeinformationen, der als Besitzer konfiguriert ist und dem eine öffentliche Rolle zugewiesen ist
Dieser Benutzer sollte über ein Standardschema von dbo sowie ein Schema im Besitz von db_owner verfügen und ein Mitglied von db_owner sein.
• Eine lokale oder Remote-Datenbankverbindung. In der folgenden Tabelle sind die anwendbaren Voraussetzungen aufgeführt:
Datenbankverbindung | Voraussetzungen |
|---|---|
Lokal | • Der Host, auf dem ThingWorx Foundation installiert werden soll, hat Zugriff auf Microsoft SQL Server. • Ein gültiger Microsoft-SQL-Client (sqlcmd) ist installiert und in der Umgebungsvariable PATH verfügbar. • Java JDK muss installiert sein. java/bin befindet sich in der Umgebungsvariable PATH. |
Remote | • sqlcmd ist installiert und in der Umgebungsvariable PATH verfügbar. |
C.) Voraussetzungen für die Aktivierung von SSL/TLS im Installationsprogramm: Keystore erstellen
Im Bildschirm Eigenschaften für ThingWorx Foundation im Installationsprogramm ist das Kontrollkästchen SSL/TLS für eine sichere Verbindung verwenden standardmäßig aktiviert. Sie können die Verwendung von SSL/TLS im Installationsprogramm deaktivieren, indem Sie dieses Kontrollkästchen deaktivieren. Wenn Sie die Standardeinstellung beibehalten und SSL/TLS verwenden, müssen Sie vor dem Ausführen des Installationsprogramms eine Java Keystore-Datei (.jks) generieren. Die Java Keystore-Datei (.jks) muss über die folgenden Sicherheitsberechtigungen verfügen:
• In der Keystore-Datei müssen die Berechtigungen Lesen und Lesen und Ausführen für das Benutzerprofil Netzwerkdienst unter Windows gewährt sein.
Es gibt mehrere Möglichkeiten, einen Keystore zu generieren. Eine Möglichkeit lautet wie folgt:
1. Gehen Sie zu Java/bin.
2. Führen Sie den folgenden Befehl aus, um die Tomcat-Keystore-Datei (JKS-Datei) zu erstellen: keytool -genkey -alias selfsigned -keyalg RSA -keystore keyStore.jks -keysize 2048 -storetype jks.
3. Geben Sie ein Passwort für den Keystore ein. Sie benötigen dieses Passwort später, um den Server zu konfigurieren.
| | Das Passwort darf keine einfachen Anführungszeichen ('), doppelten Anführungszeichen ('') oder Paragrafenzeichen (§) enthalten oder in diese eingeschlossen sein. |
4. Geben Sie bei Aufforderung den Domänennamen des Servers ein. Beispiel: myserver.mycompany.com.
5. Geben Sie die anderen Werte ein, beispielsweise die Organisationseinheit und die Organisation.
6. Geben Sie bei Aufforderung das Keystore-Passwort ein.
D.) ThingWorx Foundation unter Windows installieren
1. Stellen Sie sicher, dass die in den obigen Abschnitten beschriebenen Voraussetzungen erfüllt sind.
2. Laden Sie für PostgreSQL auf der Seite support.ptc.com unter > > > > > die Datei ThingWorx-Platform-Foundation-Installer-x-x-x-Windows-postgres herunter.
ODER
Laden Sie für Microsoft SQL Server auf der Seite support.ptc.com unter > > > > > die Datei ThingWorx-Platform-Foundation-Installer-x–x-x-Windows-mssql herunter.
3. Extrahieren Sie den Build.
4. Führen Sie für PostgreSQL die Datei ThingWorxFoundationPostgres-9.x.x-x64.exe aus.
ODER
Führen Sie für Microsoft SQL Server die Datei ThingWorxFoundationMSSQL-9.x.x-x64.exe aus.
5. Gehen Sie durch die Schritte des Installationsprogramms.
| | Im Bildschirm Eigenschaften für ThingWorx Foundation ist das Kontrollkästchen SSL/TLS für eine sichere Verbindung verwenden standardmäßig aktiviert. Sie können die Verwendung von SSL/TLS im Installationsprogramm deaktivieren, indem Sie dieses Kontrollkästchen deaktivieren. Wenn Sie SSL/TLS verwenden möchten, geben Sie die Keystore-Werte ein, die Sie entsprechend den oben aufgeführten Voraussetzungen generiert haben. |
6. Im letzten Installationsfenster ist das Kontrollkästchen Open License Configurator standardmäßig aktiviert. Wenn dieses Kontrollkästchen aktiviert ist, wird der Licence Configurator geöffnet, nachdem das Installationsprogramm abgeschlossen und geschlossen wurde. Wenn Sie das Kontrollkästchen Open License Configurator deaktivieren, wird das Installationsprogramm geschlossen und der License Configurator nicht automatisch geöffnet.
a. Klicken Sie auf dem Bildschirm Setup : Configure licensing for ThingworxFoundation for Postgres oder Setup : Configure licensing for ThingworxFoundation for Mssql auf Weiter.
b. Verwenden Sie den Lizenzkonfigurator, um eine Verbindung zum PTC Lizenzserver herzustellen oder konfigurieren Sie ThingWorx Foundation so, dass es die bereits heruntergeladene Lizenz verwendet.
c. Gehen Sie durch die Schritte für die Lizenz.
7. Die Installation von ThingWorx Foundation ist abgeschlossen.
| | Informationen zum Vergrößern des Arbeitsspeichers für Tomcat nach der Installation finden Sie im PTC Support Artikel CS306401. |
E.) Verbindung zum ThingWorx Foundation Server
1. Greifen Sie auf die ThingWorx Foundation URL zu.
Beispiel: https://<Hostname>:<Port>/Thingworx/Composer.
Die ThingWorx Foundation URL ist unterschiedlich, je nachdem, ob die Konfiguration für SSL oder nicht für SSL ausgeführt wurde und welche Ports während des Setups verwendet wurden. SSL ist standardmäßig aktiviert. Sie können jedoch die Verwendung von SSL/TLS deaktivieren. Weitere Informationen finden Sie weiter oben im Abschnitt Voraussetzungen für die Aktivierung von SSL/TLS im Installationsprogramm.
2. Geben Sie Ihre Benutzeranmeldeinformationen ein.
Der Benutzername ist Administrator und das Passwort ist das Passwort, das während des Setups verwendet wurde.
F.) Weitere Installationsprogramm-Funktionen und Fehlerbehebung
ThingWorx Foundation Dienste auf Windows starten oder anhalten
1. Navigieren Sie zu Services.msc.
2. Suchen Sie den Dienst ThingWorx-Foundation.
3. Starten Sie den Dienst oder halten Sie ihn an.
Protokolldateien des Installationsprogramms suchen
• Installationsprotokolle:
◦ ${installdir}\installer\logs\ThingWorxFoundation_install.log
Beispiel: C:\Programme (x86)\ThingWorxFoundation\installer\logs\ThingWorxFoundation_install.log.
• Laufzeitprotokolle:
◦ ${installdir}\ThingworxStorage\logs\
Beispiel: C:\Programme (x86)\ThingWorxFoundation\ThingworxStorage\logs\.
• Bei Abbruch oder Fehler:
◦ ${system_temp_directory}\ThingWorxFoundation_Failed_installs\
Beispiel: C:\Users\vagrant\AppData\Local\Temp\ThingWorxFoundation_Failed_installs\.
• Deinstallation von Protokollen:
◦ ${system_temp_directory}\bitrock_installer_(pid).log
Der Name der Protokolldatei hat das Präfix bitrock. Beispiel: C:\Users\vagrant\AppData\Local\Temp\bitrock_installer_3008.log.
Per Installationsprogramm installierte ThingWorx Foundation Installationen deinstallieren
1. Navigieren Sie zum Installationsspeicherort von ThingWorx Foundation.
2. Führen Sie ThingWorxFoundation_uninstall.exe aus.
3. Klicken Sie bei der entsprechenden Aufforderung auf OK, um zu bestätigen, dass Sie mit der Deinstallation fortfahren möchten.
4. Nach Abschluss der Deinstallation ist das Setup gelöscht.
ThingWorx Datenbank aus PostgreSQL löschen
1. Öffnen Sie über die Befehlszeilenschnittstelle in Windows eine Verbindung zur PostgreSQL-Datenbank.
Geben Sie z.B. psql -U admin -h dbhost ein.
2. Wenn Sie den standardmäßigen Datenbanknamen verwenden, führen Sie den Befehl DROP DATABASE thingworx; aus.
Wenn Sie den Datenbanknamen angepasst haben, führen Sie den Befehl DROP DATABASE <your database name>; aus.
ThingWorx Datenbank aus Microsoft SQL löschen
1. Öffnen Sie über die Befehlszeilenschnittstelle in Windows eine Verbindung zur Microsoft SQL-Datenbank.
Geben Sie z.B. sqlcmd -U admin -s ‘dbhost\dbservicename,port’ ein.
2. Wenn Sie den standardmäßigen Datenbanknamen verwenden, führen Sie den Befehl DROP DATABASE thingworx; GO; aus.
Wenn Sie den Datenbanknamen angepasst haben, führen Sie den Befehl DROP DATABASE <your database name>; GO; aus.
Upgrade auf Java 11 durchführen für ThingWorx 9.0 und 9.1
Wenn Sie das Installationsprogramm verwendet haben, um ThingWorx 9.0.x oder 9.1.x mit Java 8 zu installieren oder zu aktualisieren und Java 11.0.8 verwenden möchten, führen Sie die folgenden Schritte aus:
1. Installieren Sie Java 11.
2. Legen Sie das Verzeichnis /bin in der Systemvariablen PATH fest.
3. Legen Sie die Variable JAVA_HOME auf das Installationsverzeichnis von Java 11 fest.
4. Überprüfen Sie, dass sich der Speicherort der Datei jvm.dll im Installationsverzeichnis von Java 11 befindet. Beispiel: C:\Programme\Java\jdk-11.0.8\bin\server\jvm.dll.
| | Java 11 hat kein JRE-Verzeichnis. Daher befindet sich die Datei jvm.dll nicht unter einem JRE-Ordner wie in Java 8. |
5. Halten Sie den Dienst ThingWorx-Foundation an.
6. Führen Sie CMD als Administrator aus.
7. Navigieren Sie im ThingWorx Foundation Installationsverzeichnis zum Tomcat-Verzeichnis /bin. Beispiel: cd C:\Programme (x86) \ThingWorxFoundation\tomcat\apache-Tomcat-9.0.37\bin.
8. Führen Sie Folgendes aus, um die Dienstkonfiguration von ThingWorx-Foundation zu bearbeiten: tomcat9w.exe //ES//ThingWorx-Foundation.
Die GUI-Anwendung wird geöffnet.
9. Navigieren Sie in der Anwendung zur Registerkarte Java, und gehen Sie wie folgt vor:
a. Verweisen Sie für die Java Virtual Machine auf die Datei jvm.dll der Java 11-Installation. Beispiel: C:\Programme\Java\jdk-11.0.8\bin\server\jvm.dll.
b. Entfernen Sie Folgendes aus Java Options:
-XX:+UseG1GC
-XX:+PrintGCTimeStamps
-XX:+PrintGCDetails
-Xloggc:${CATALINA_HOME}/logs/tomcat-twx-gc.log
-XX:+PrintGCTimeStamps
-XX:+PrintGCDetails
-Xloggc:${CATALINA_HOME}/logs/tomcat-twx-gc.log
${CATALINA_HOME} verweist auf das Tomcat-Verzeichnis.
c. Kopieren Sie den Pfad des Installationsverzeichnisses für ThingWorx Foundation. Beispiel: C:\Programme (x86)\ThingWorxFoundation.
d. Fügen Sie Folgendes zu Java Options hinzu:
-Xlog:gc:file=C:\Program Files
(x86)\ThingWorxFoundation/tomcat/current/logs/gc.log:time,level,tags
(x86)\ThingWorxFoundation/tomcat/current/logs/gc.log:time,level,tags
10. Wählen Sie Anwenden.
11. Wählen Sie OK.
Die Anwendung wird geschlossen.
12. Aktualisieren Sie die Dienstparameter mithilfe von tomcat9.exe wie folgt:
a. Führen Sie CMD als Administrator aus.
b. Führen Sie Folgendes aus:
tomcat9.exe //US//ThingWorx-Foundation --JavaHome=%JAVA_HOME%
tomcat9.exe //US//ThingWorx-Foundation --Environment="JRE_HOME='%JAVA_HOME%';THINGWORX_PLATFORM_SETTINGS='%THINGWORX_PLATFORM_SETTINGS%';PATH='%PATH%'"
tomcat9.exe //US//ThingWorx-Foundation --Environment="JRE_HOME='%JAVA_HOME%';THINGWORX_PLATFORM_SETTINGS='%THINGWORX_PLATFORM_SETTINGS%';PATH='%PATH%'"
13. Starten Sie den Dienst ThingWorx-Foundation.
14. Überprüfen Sie in der Datei Application.log, ob Java Version 11 verwendet wird:
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ThingWorx System Environment Settings
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS: Windows Server 2019
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS arch: amd64
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS version: 10.0
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Total Processors: 2
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Default encoding: UTF-8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA vendor: Oracle Corporation
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA version: 11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA install location: C:\Program Files\Java\jdk-11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JVM Max Memory: 750 (MB)
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ThingWorx System Environment Settings
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS: Windows Server 2019
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS arch: amd64
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] OS version: 10.0
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Total Processors: 2
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] Default encoding: UTF-8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA vendor: Oracle Corporation
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA version: 11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JAVA install location: C:\Program Files\Java\jdk-11.0.8
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] JVM Max Memory: 750 (MB)
[O: c.t.s.ThingWorxServer] [I: ] [U: SuperUser] [S: ] [P: ] [T: main] ========================================
Wenn Sie Probleme mit den Änderungen der Dienstkonfiguration unter Windows haben und weitere Informationen wünschen, führen Sie Folgendes aus, um weitere Informationen in der Datei commons-daemon.log im Verzeichnis tomat/current/logs/ zu protokollieren: tomcat9w.exe //ES//ThingWorx-Foundation --LogLevel Debug.