ThingWorx Foundation Dateispeicher
Für eine unabhängige ThingWorx Installation sind in der Regel drei festgelegte Dateispeicherorte vorhanden:
• /ThingworxPlatform
• /ThingworxStorage
• /ThingworxBackupStorage
Am Speicherort /ThingworxStorage wird standardmäßig das erste Datei-Repository erstellt. Für eine Clustering-Bereitstellung müssen Sie Änderungen vornehmen und einige Regeln befolgen.
/ThingworxPlatform
Der Ordner ThingworxPlatform wird für jede Serverinstanz lokal verwaltet und sollte nicht geteilt werden. Der Ordner enthält die folgenden erforderlichen Dateien, die beim Start einer ThingWorx Instanz gelesen werden:
• platform-settings.json
• keystore-password
• license_capability_response.bin (oder Varianten dieses Dateinamens)
Der folgende Inhalt muss stets auf allen ThingWorx HA-Servern synchronisiert sein.
• platform-settings.json
• keystore-password
Sobald die Dateien erstellt oder generiert wurden und auf einem ThingWorx Server geändert werden, muss der Inhalt auf allen anderen ThingWorx Servern in der HA-Konfiguration aktualisiert werden.
Für den Lizenzierungsinhalt muss jeder ThingWorx Server sowohl seine eigene Lizenzdatei als auch die Vertrauensspeicher verwalten, die bei der ersten Aktivierung erstellt werden.
Sie können den folgenden Prozess verwenden, um diese Dateien in /ThingworxPlatform jedes ThingWorx Servers einzurichten:
1. Erstellen Sie /ThingworxPlatform auf allen ThingWorx Servern. Die Ordnerstruktur muss auf allen ThingWorx Servern in der HA-Konfiguration gleich sein.
2. Erstellen Sie platform-settings.json entsprechend der Systemumgebung, und speichern Sie sie in /ThingworxPlatform des ersten ThingWorx Servers (der erste ThingWorx Server, der in der HA-Konfiguration gestartet werden soll).
3. Starten Sie den ersten ThingWorx Server, und stellen Sie sicher, dass er voll funktionsfähig ist und alle erwarteten lizenzierten Funktionen verwenden kann. An diesem Punkt sollten drei Dateien in /ThingworxPlatform vorhanden sein:
◦ platform-settings.json
◦ keystore-password
◦ successful_license_capability_response.bin
4. Beenden Sie den ersten ThingWorx Server.
5. Kopieren Sie die drei Dateien vom ersten Server in den Ordner /ThingworxPlatform des anderen Servers bzw. der anderen Server.
 |
In der Datei platform-settings.json müssen Sie die Einstellung PlatformId so aktualisieren, dass sie eine eindeutige ID für jeden Server ist. Weitere Informationen finden Sie unter Plattformeinstellungen für ThingWorx HA.
|
6. Benennen Sie auf den anderen Servern die Lizenzdatei von successful_license_capability_response.bin in license_capability_response.bin um.
7. Starten, testen und beenden Sie die anderen ThingWorx Server einzeln, um sicherzustellen, dass alle lizenzierten Funktionen verfügbar sind.
Der Standardspeicherort für den Ordner ThingworxPlatform ist /ThingworxPlatform. Sie können einen nicht standardmäßigen Speicherort über die Umgebungsvariable THINGWORX_PLATFORM_SETTINGS festlegen. Die Variable muss in der Benutzerumgebung des Tomcat-Betriebssystems eingerichtet werden, bevor Tomcat mit ThingWorx gestartet wird. Stellen Sie sicher, dass der Ordner, auf den von THINGWORX_PLATFORM_SETTINGS verwiesen wird, vorhanden ist und dass der Tomcat-Betriebssystembenutzer über Lese-/Schreibberechtigungen verfügt.
/ThingworxStorage
Der Ordner /ThingworxStorage muss sich auf einem geteilten Dateisystem-Volume befinden, für das alle ThingWorx Server den gleichen Lese-/Schreibzugriff haben.
Die Datei keystore.pfx wird in diesem Ordner gespeichert und enthält die von der Plattform geforderten Verschlüsselungswörter. Die Datei ist mit der Datei keystore-password verknüpft. Sie sollten beide Dateien gut aufbewahren und sichern. Wenn eine der Dateien verloren geht, können die in der Datenbank gespeicherten Informationen nicht entschlüsselt werden.
Protokolldateien enthalten alle Protokolle von allen Servern und werden von platformId in den Protokolleinträgen identifiziert.
Der Speicherort von /ThingworxStorage wird im Abschnitt BasicSettings von platform-settings.json verwaltet.
Nur für Windows: Führen Sie die folgenden Schritte aus, wenn sich der ThingWorx Platform Host und der Host, auf dem sich das gemeinsam genutzte Speicherverzeichnis befindet, nicht in einer Domäne befinden:
|
|
Führen Sie die folgenden Schritte nur aus, wenn Sie ein lokales Benutzerkonto verwenden, um Apache Tomcat auszuführen.
|
1. Erstellen Sie ein lokales Benutzerkonto, das auf dem ThingWorx Platform Host und dem Host vorhanden ist, auf dem sich das gemeinsam genutzte Verzeichnis befindet.
|
|
Dieses Benutzerkonto muss auf beiden Hosts dasselbe Passwort aufweisen.
|
2. Konfigurieren Sie Apache Tomcat so, dass das Tool als das lokale Benutzerkonto aus Schritt 1 ausgeführt wird.
a. Suchen Sie innerhalb von Services den Apache Tomcat-Dienst, und wählen Sie > aus.
b. Geben Sie das lokale Benutzerkonto mit dem Benutzerpasswort ein.
3. Erteilen Sie dem lokalen Benutzerkonto Berechtigungen vom Typ Full Control für die Datei tomcat9.exe im Ordner "Apache Tomcat", um einen Plattformspeicher-Initialisierungsfehler zu vermeiden.
4. Geben Sie den Netzwerkspeicherort für das lokale Benutzerkonto frei, und erteilen Sie Berechtigungen vom Typ Full Control.
a. Klicken Sie mit der rechten Maustaste auf den Netzwerkspeicherort, und wählen Sie Properties aus. Klicken Sie auf die Registerkarte Share.
b. Suchen Sie das lokale Benutzerkonto, und wählen Sie Read/Write aus.
c. Stellen Sie auf der Registerkarte "Security" sicher, dass das lokale Benutzerkonto über die Berechtigungen Full Control verfügt.
5. Legen Sie den Wert des Storage-Schlüssels unter BasicSettings in der Datei platform-settings.json so fest, dass der vollständige UNC-Pfad des Netzwerkspeicherorts verwendet wird. Schließen Sie zusätzliche umgekehrte Schrägstriche für jedes \ im Pfad ein. Beispiel:
◦ Netzwerkfreigabe-Speicherort: \\ShareHost\MyThingworxShare
◦ Storage-Wert in platform-settings.json: \\\\ShareHost\\MyThingworxShare
6. Starten Sie Apache Tomcat neu.
/ThingworxBackupStorage
Die primäre Verwendung von /ThingworxBackupStorage ist die Sicherung der H2-Datenbank. Da H2 für ThingWorx HA-Konfigurationen nicht unterstützt wird, wird dieser Speicherort nicht verwendet. Trotzdem wird zur Laufzeit erwartet, dass er vorhanden ist.
• Es genügt, diesen Speicherort auf jedem ThingWorx Server zu erstellen, um protokollierte Fehler zu vermeiden.
• Legen Sie "EnableBackup": false in der Datei platform-settings.json fest, um die unnötige Verarbeitung in einer HA-Umgebung zu vermeiden.
Der Speicherort von /ThingworxBackupStorage wird in platform-settings.json verwaltet. Die Ordnerstruktur muss auf allen ThingWorx Servern gleich sein.
Stammdatei-Repository
Das Stammdatei-Repository muss sich auf einem gemeinsam benutzten Dateisystem-Volume befinden, für das alle ThingWorx Server gleichwertigen Lese-/Schreibzugriff haben.
Der Speicherort des Stammdatei-Repository-Ordners muss zur Dateiplatform-settings.json des Systems hinzugefügt werden. Der Parameter FileRepositoryRoot und ein geteilter Dateispeicherort müssen dem Abschnitt BasicSettings hinzugefügt werden. Der Wert sollte den Ordnerspeicherort enthalten, an dem das Repository eingerichtet werden soll. Wenn beispielsweise der anfängliche Repository-Ordner in /ThingworxFileRepository/repository erstellt werden soll, muss die Erweiterung zu platform-settings.json folgendermaßen lauten: "FileRepositoryRoot":"/ThingworxFileRepository".
|
|
Wenn der Parameter FileRepositoryRoot nicht in der Datei platform-settings.json angegeben ist, wird der Standard-Repository-Speicherort /ThingworxStorage verwendet.
Wenn der in FileRepositoryRoot definierte Speicherort aus irgendeinem Grund nicht verfügbar ist, wird ThingWorx beim Start abgebrochen.
|
Überlegungen zur Dateifreigabe:
• Network Attached Storage (NAS) oder das Cloud-Äquivalent ist eine häufige Lösung zur Bereitstellung eines gemeinsam genutzten Dateisystems.
• Das NAS-Angebot sollte über eine eigene Hochverfügbarkeitslösung verfügen, um diese ThingWorx HA-Implementierung zu unterstützen.
• Das Volume muss auf dem Server bereitgestellt werden, bevor eine ThingWorx Instanz gestartet wird.
• Der Betriebssystembenutzer, der Tomcat-Dienste auf jedem ThingWorx Server ausführt, muss über Lese-/Schreibberechtigungen für den Dateifreigabe-Speicherort verfügen, an dem das Repository eingerichtet ist.
• Der Bereitstellungsspeicherort muss auf jedem ThingWorx Server gleich sein.