ThingWorx Konfigurationsressourcen
Speicherort des Ordners "ThingWorxStorage" ändern
ThingWorx verwendet zwei Verzeichnisordner der obersten Ebene für die Speicherung: In ThingworxStorage werden alle aktiven Informationen gespeichert (Daten, Protokolle, Erweiterungen usw.) und in ThingworxBackupStorage alle Sicherungsinformationen. Standardmäßig erstellt ThingWorx diese Ordner im Stammverzeichnis.
• Unter Microsoft Windows ist das Stammverzeichnis <Laufwerk>:\\, wobei <Laufwerk> das Tomcat-Installationslaufwerk ist.
• Auf einem Nicht-Microsoft Windows-System ist das Stammverzeichnis /
Passen Sie den Speicherort des Ordners ThingworxStorage an, bevor Sie Tomcat starten. Wenn Sie den Speicherort ändern und Tomcat nicht angehalten wurde, starten Sie Tomcat neu, nachdem Sie den Speicherort von ThingworxStorage geändert haben.
.
Benutzerdefinierten Speicherort für ThingworxStorage angeben
Um den Speicherort von ThingWorxStorage im Dateisystem zu ändern, verweisen Sie auf den Speicherort der JSON-Konfigurationsdatei, die die Speicherorte angibt. Sie haben hierzu zwei Möglichkeiten:
1. Erstellen Sie ein Stammverzeichnis namens ThingworxPlatform.
◦ Unter Microsoft Windows ist dies <Laufwerk>:\\ThingworxPlatform, wobei <Laufwerk> das Tomcat-Installationslaufwerk ist.
◦ Auf einem Nicht-Microsoft Windows-System ist dies /ThingworxPlatform.
-ODER-
2. Definieren Sie eine Umgebungsvariable als Systemvariable (nicht als Benutzer). Die Umgebungsvariable darf nur den Pfad enthalten. Schließen Sie den Dateinamen platform-settings.json nicht mit ein.
◦ %THINGWORX_PLATFORM_SETTINGS% (Microsoft Windows)
◦ $THINGWORX_PLATFORM_SETTINGS (Nicht-Microsoft Windows) mit Verweis auf den Speicherort der JSON-Konfigurationsdatei
 |
Ubuntu empfiehlt, systemweite Umgebungsvariablen in /etc/environment zu definieren. In dieser Datei müssen Sie die Variable THINGWORX_PLATFORM_SETTINGS definieren und exportieren. Beispiel: export THINGWORX_PLATFORM_SETTINGS=/usr/share/tomcatx/x.x.xx/conf, wobei "x" die Version von Tomcat ist, die Sie verwenden.
|
3. Nur unter RHEL: Definieren Sie die Variable THINGWORX_PLATFORM_SETTINGS dort, wo der Tomcat-Dienst auf sie zugreifen kann, beispielsweise in der Datei tomcat.service oder im Startskript.
|
|
Systemdienste erben keinen Kontext (wie die Umgebungsvariablen HOME und PATH) vom aufrufenden Benutzer und dessen Sitzung. Jeder Dienst wird in einem neuen ("sauberen") Ausführungskontext ausgeführt.
|
Formatbeispiel
Nachdem Sie den Speicherort der JSON-Konfigurationsdatei definiert haben, erstellen Sie eine Datei platform-settings.json am oben angegebenen Speicherort. Ändern Sie die Speicherorte der Ordner ThingworxStorage und ThingworxBackupStorage unter Verwendung des Formats im folgenden Beispiel. In diesem Beispiel ist alles unter einem Stammverzeichnis namens /ThingworxStorage enthalten.
Jede Einstellung in dieser Datei ist optional. Wenn eine Einstellung nicht in dieser Datei angegeben ist, verwendet ThingWorx zur Laufzeit standardmäßig einen hartcodierten Wert.
|
EINSTELLUNG
|
BESCHREIBUNG
|
DEFAULT
|
||
|---|---|---|---|---|
|
Grundlegende Plattformeinstellungen
|
||||
|
BackupStorage
|
Verzeichnis, in dem das Sicherungsverzeichnis erstellt wird/sich befindet.
|
/ThingworxBackupStorage
|
||
|
DatabaseLogRetentionPolicy
|
Anzahl von Tagen, die Datenbankprotokolle beibehalten werden sollen. Ändern Sie diesen Wert nicht, es sei denn, Sie werden vom ThingWorx Support dazu aufgefordert.
|
7
|
||
|
EnableBackup
|
Steuert, ob Sicherungen aktiviert sind.
|
True
|
||
|
EnableHA
|
Steuert, ob die Plattform für eine hochverfügbare Umgebung (High Availability, HA) konfiguriert werden soll.
|
False
|
||
|
EnableSystemLogging
|
Steuert, ob die Systemprotokollierung aktiviert ist.
|
False
|
||
|
HTTPRequestHeaderMaxLength
|
Die maximale zulässige Länge für Werte von HTTP-Anforderungskopfzeilen.
|
2000
|
||
|
HTTPRequestParameterMaxLength
|
Die maximale zulässige Länge für Werte von HTTP-Anforderungsparametern.
|
2000
|
||
|
Storage
|
Verzeichnis, in dem alle Speicherverzeichnisse erstellt werden/sich befinden (ausgenommen Sicherungsspeicher).
|
/ThingworxStorage
|
||
|
HA-Einstellungen
Einstellungen, die für die Konfiguration einer hochverfügbaren Umgebung (High Availability, HA) spezifisch sind. Optional; wird ignoriert, wenn die Einstellung EnableHA (oben) auf "Falsch" festgelegt ist.
|
||||
|
CoordinatorConnectionTimeout
|
Wartezeit (in Millisekunden) auf die Herstellung einer Verbindung mit dem Prozess/Server, der zum Koordinieren der Plattformpriorität verwendet wird
|
15000
|
||
|
CoordinatorHosts
|
Eine kommagetrennte Liste von IP-Adressen der Server, auf denen die Prozesse vorhanden sind, die zum Koordinieren der Plattformpriorität verwendet werden (z.B. "127.0.0.1:2181, 127.0.0.2:2181").
|
127.0.0.1:2181
|
||
|
CoordinatorMaxRetries
|
Die maximale zulässige Anzahl an Wiederholungen, die ausgeführt werden, um eine Verbindung mit dem Prozess/Server herzustellen, der zum Koordinieren der Plattformpriorität verwendet wird.
|
3
|
||
|
CoordinatorRetryTimeout
|
Wartezeit (in Millisekunden) auf die einzelnen Wiederholungsversuche.
|
1000
|
||
|
CoordinatorSessionTimeout
|
Zeitraum (in Millisekunden), den die Sitzung der Plattform warten soll, ohne einen Takt von dem Prozess/Server zu erhalten, der zum Koordinieren der Plattformpriorität verwendet wird
|
60000
|
||
|
LoadBalancerBase64EncodedCredentials
|
Base64-codierte Anmeldeinformationen für den HA-Lastenausgleich im Format "<Benutzer>:<Passwort>".
|
|||
|
PersistenceProviderPackageConfigs
Abhängig von der Datenbankoption.
Alle möglichen Konfigurationen finden Sie unter
Persistenzanbieter.
|
||||
Skriptbeispiel für Nicht-Windows-System
Vermeiden Sie das Einfügen unnötiger Formatierungszeichen, wenn Sie Folgendes in eine gültige JSON-Datei kopieren.
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "/home/johndoe/Developer/thingworx/platform/backup",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"Storage": "/home/johndoe/Developer/thingworx/platform/storage"
},
"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 60000,
"LoadBalancerBase64EncodedCredentials": "QWRtbW4pc1RyYXRvajphZG1pbg=="
}
}
}
Skriptbeispiel für Windows-System
{
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "C:\\Users\\John Doe\\Developer\\thingworx\\platform\\backup",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"Storage": "C:\\Users\\John Doe\\Developer\\thingworx\\platform\\storage"
},
"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 60000,
"LoadBalancerBase64EncodedCredentials": "QWRtbW4pc1RyYXRvajphZG1pbg=="
}
}
}
"PlatformSettingsConfig": {
"BasicSettings": {
"BackupStorage": "C:\\Users\\John Doe\\Developer\\thingworx\\platform\\backup",
"DatabaseLogRetentionPolicy": 7,
"EnableBackup": true,
"EnableHA": false,
"EnableSystemLogging": false,
"HTTPRequestHeaderMaxLength": 2000,
"HTTPRequestParameterMaxLength": 2000,
"Storage": "C:\\Users\\John Doe\\Developer\\thingworx\\platform\\storage"
},
"HASettings": {
"CoordinatorConnectionTimeout": 15000,
"CoordinatorHosts": "127.0.0.1:2181",
"CoordinatorMaxRetries": 3,
"CoordinatorRetryTimeout": 1000,
"CoordinatorSessionTimeout": 60000,
"LoadBalancerBase64EncodedCredentials": "QWRtbW4pc1RyYXRvajphZG1pbg=="
}
}
}