Bausteine mithilfe von Solution Central bereitstellen
In diesem Szenario werden Ihre Datenbank und ThingWorx auf Ihrem System installiert, und Sie stellen die Bausteine mit Solution Central auf Ihrer ThingWorx Instanz bereit.
Führen Sie die Schritte in den folgenden Abschnitten aus:
Voraussetzungen
Bevor Sie die Bausteine bereitstellen, schließen Sie die folgenden Voraussetzungen ab:
• Überprüfen Sie die Systemanforderungen der Bausteine, einschließlich der kompatiblen Versionen von ThingWorx. Weitere Informationen finden Sie unter Systemanforderungen.
• Überprüfen Sie die ThingWorx Systemanforderungen für eine kompatible Version von ThingWorx. Weitere Informationen finden Sie unter Systemanforderungen im ThingWorx Hilfe-Center.
• Installieren Sie eine kompatible Version von ThingWorx. Weitere Informationen finden Sie unter ThingWorx installieren.
• Konfigurieren Sie ThingWorx, um den Erweiterungsimport zu aktivieren. Weitere Informationen finden Sie unter Erweiterungen importieren im ThingWorx Hilfe-Center.
• Stellen Sie sicher, dass die Zeitzone des ThingWorx Servers auf UTC festgelegt ist. Weitere Informationen finden Sie im ThingWorx Hilfe-Center unter Java, Apache Tomcat und ThingWorx installieren.
• Wenden Sie Ihre Lizenz an. Weitere Informationen finden Sie unter Lizenzierung für ThingWorx Platform im ThingWorx Hilfe-Center.
• Erhalten Sie Zugriff auf Solution Central. Neben der Verwendung zum Bereitstellen der Bausteine ist Solution Central das empfohlene Tool, um Ihre Bereitstellung und Anpassungen zwischen ThingWorx Umgebungen zu verschieben, z.B. von einer Testumgebung in eine Produktionsumgebung. Weitere Informationen finden Sie im englischen ThingWorx Solution Central Help Center.
• Wenn Sie die Datenbank auf Linux installieren, installieren Sie das Tool sqlcmd.
• Installieren Sie das Microsoft SQL Server Management Studio. Weitere Informationen finden Sie unter https://docs.microsoft.com/de-de/sql/ssms/download-sql-server-management-studio-ssms?view=sql-server-ver15.
Skript-Timeout-Einstellung aktualisieren
Ein ThingWorx Administrator muss die folgenden Schritte ausführen, um die Skript-Timeout-Einstellung zu aktualisieren:
1. Navigieren Sie auf dem ThingWorx Server zum Ordner ThingWorxPlatform.
2. Öffnen Sie die Datei platform-settings.json in einem Texteditor.
3. Suchen Sie die Einstellung ScriptTimeout, und ändern Sie sie in 1200.
4. Speichern und schließen Sie die Datei platform-settings.json.
5. Starten Sie den ThingWorx Server neu.
 |
Wenn eine Meldung ähnlich der folgenden in Ihrem Skriptprotokoll angezeigt wird, wiederholen Sie die obigen Schritte, um die Einstellung ScriptTimeout weiter zu erhöhen:
[message: Execution of Script terminated after : 1200 seconds. Timeout configured for 1200 seconds.]
|
Weitere Informationen finden Sie unter platform-settings.json – Konfigurationsdetails im ThingWorx Hilfe-Center.
Sitzungs-Timeout-Einstellungen aktualisieren
Standardmäßig gibt es für Sitzungen mit inaktiven Benutzern nach 30 Minuten ein Timeout.
Ein ThingWorx Administrator muss die folgenden Schritte ausführen, um die Einstellung für das Sitzungs-Timeout zu ändern:
1. Navigieren Sie in ThingWorx zu > .
2. Öffnen Sie im Bearbeitungsmodus das UserManagementSubsystem.
3. Ändern Sie unter Konfiguration die Einstellung Leerlaufsitzungs-Timeout (Min.).
4. Klicken Sie auf Speichern.
5. Starten Sie den ThingWorx Server neu.
MS SQL JDBC-Treiber installieren
Wenn Ihre ThingWorx Instanz mit PostgreSQL als Persistenzanbieter konfiguriert ist, führen Sie die folgenden Schritte aus, um den MS SQL JDBC-Treiber zu installieren. Wenn Ihre ThingWorx Instanz mit MS SQL als Persistenzanbieter konfiguriert ist, fahren Sie mit dem nächsten Abschnitt fort.
1. Laden Sie die mit JRE11 kompatible Version des Microsoft JDBC-Treibers 7.4.1 für SQL Server über den folgenden Link herunter: https://docs.microsoft.com/de-de/sql/connect/jdbc/microsoft-jdbc-driver-for-sql-server-support-matrix?view=sql-server-ver15#sql-version-compatibility.
2. Kopieren Sie die JDBC-JAR-Datei in das Verzeichnis lib der Tomcat-Installation: (<TOMCAT_HOME>/lib).
3. Starten Sie den Tomcat-Server neu, um den JDBC-Treiber zu laden und ihn so für ThingWorx verfügbar zu machen.
Baustein-Datenbank und -Datenbankbenutzer erstellen
Führen Sie die folgenden Schritte aus:
1. Erstellen Sie den Benutzernamen und das Passwort für Ihren Baustein-Datenbankbenutzer in der Master-Datenbank. Befolgen Sie die Empfehlungen für die Komplexität des Passworts für Ihre Datenbank.
◦ Für Windows mit dem Transact-SQL-Befehl im Abfrage-Editor von Microsoft SQL Server Management Studio:
CREATE LOGIN <bbadmin> WITH PASSWORD = '<password>';
Ersetzen Sie im obigen Befehl <bbadmin> und <password> durch die Anmeldung und das Passwort für Ihren Baustein-Datenbankbenutzer.
◦ Für Linux:
1. Öffnen Sie die Eingabeaufforderung im Linux-Client.
2. Verwenden Sie die folgenden Befehle, um die Anmeldung auf dem SQL Server zu erstellen:
sqlcmd –S <database-server-name> -U <sql-administrator-username> -P <sql-administrator-password> \
-Q "create login <bbadmin> with password = '<bbadmin-password>'" \
GO; \
exit
-Q "create login <bbadmin> with password = '<bbadmin-password>'" \
GO; \
exit
Ersetzen Sie in den obigen Befehlen <database-server-name> durch den Namen Ihres Datenbankservers, <sql-administrator-username> und <sql-administrator-password> durch den SQL Administrator-Benutzernamen und das Passwort und <bbadmin> und <bbadmin-password> durch die Anmeldung und das Passwort für Ihren Baustein-Datenbankbenutzer.
2. Erstellen Sie die Microsoft SQL Server-Datenbank (MSSQL), die die Bausteine verwenden werden.
◦ Für Windows mit den Transact-SQL-Befehlen im Abfrage-Editor von Microsoft SQL Server Management Studio:
CREATE DATABASE <bbdb> COLLATE SQL_Latin1_General_CP1_CI_AS;
ALTER DATABASE <bbdb> SET READ_COMMITTED_SNAPSHOT ON;
ALTER DATABASE <bbdb> SET ALLOW_SNAPSHOT_ISOLATION ON;
ALTER DATABASE <bbdb> SET ARITHABORT ON;
ALTER DATABASE <bbdb> SET READ_COMMITTED_SNAPSHOT ON;
ALTER DATABASE <bbdb> SET ALLOW_SNAPSHOT_ISOLATION ON;
ALTER DATABASE <bbdb> SET ARITHABORT ON;
Ersetzen Sie in den obigen Befehlen <bbdb> durch den Namen Ihrer Datenbank.
◦ Für Linux:
1. Öffnen Sie die Eingabeaufforderung im Linux-Client.
2. Verwenden Sie die folgenden Befehle, um die SQL Server-Datenbank zu erstellen. Ersetzen Sie die Variablen durch den Namen des Datenbankservers und den SQL Administrator-Benutzernamen und das zugehörige Passwort:
sqlcmd –S <database-server-name> \
-U <sql-administrator-username> -P <sql-administrator-password> \
-Q "create database <bbdb> COLLATE SQL_Latin1_General_CP1_CI_AS; ALTER DATABASE <bbdb> SET READ_COMMITTED_SNAPSHOT ON; ALTER DATABASE <bbdb> SET ALLOW_SNAPSHOT_ISOLATION ON;ALTER DATABASE <bbdb> SET ARITHABORT ON"
-U <sql-administrator-username> -P <sql-administrator-password> \
-Q "create database <bbdb> COLLATE SQL_Latin1_General_CP1_CI_AS; ALTER DATABASE <bbdb> SET READ_COMMITTED_SNAPSHOT ON; ALTER DATABASE <bbdb> SET ALLOW_SNAPSHOT_ISOLATION ON;ALTER DATABASE <bbdb> SET ARITHABORT ON"
Ersetzen Sie im obigen Befehl <database-server-name> durch den Namen Ihres Datenbankservers, <sql-administrator-username> und <sql-administrator-password> durch den SQL Administrator-Benutzernamen und das Passwort und <bbdb> durch den Namen Ihrer Datenbank.
3. Erstellen Sie einen Datenbankbenutzer für die Anmeldung, die in Schritt 1 erstellt wurde. Verwenden Sie den gleichen Namen für den Datenbankbenutzer wie für die Anmeldung.
◦ Verwenden Sie für Windows den Transact-SQL-Befehl im Abfrage-Editor von SQL Server Management Studio, der für die Datenbank geöffnet ist, die in Schritt 2 erstellt wurde:
CREATE USER <bbadmin> FOR LOGIN <bbadmin>;
ALTER ROLE [db_owner] ADD MEMBER <bbadmin>;
ALTER ROLE [db_owner] ADD MEMBER <bbadmin>;
Ersetzen Sie im obigen Befehl <bbadmin> durch den Namen für die Anmeldung, die in Schritt 1 erstellt wurde.
◦ Für Linux:
1. Öffnen Sie die Eingabeaufforderung im Linux-Client.
2. Verwenden Sie die folgenden Befehle, um einen Datenbankbenutzer für Ihre Baustein-Datenbank zu erstellen. Ersetzen Sie die Variablen durch den Namen des Datenbankservers und den SQL Administrator-Benutzernamen und das zugehörige Passwort:
sqlcmd –S <database-server-name> \
-U <sql-administrator-username> -P <sql-administrator-password> \
-Q "use <bbdb>; create user <bbadmin> for login <bbadmin>;ALTER ROLE [db_owner] ADD MEMBER <bbadmin>"
-U <sql-administrator-username> -P <sql-administrator-password> \
-Q "use <bbdb>; create user <bbadmin> for login <bbadmin>;ALTER ROLE [db_owner] ADD MEMBER <bbadmin>"
Ersetzen Sie in den obigen Befehlen <database-server-name> durch den Namen Ihres Datenbankservers, <sql-administrator-username> und <sql-administrator-password> durch den SQL Administrator-Benutzernamen und das Passwort, <bbdb> durch den Namen Ihrer Datenbank, <bbadmin> durch den Namen für die Anmeldung, die in Schritt 1 erstellt wurde.
Bausteine mit Solution Central bereitstellen
|
|
Wenn Sie Bausteine auf einem ThingWorx HA-System bereitstellen, wird empfohlen, den Cluster auf eine einzelne Instanz zu übertragen, die Erweiterungen zu installieren und den Cluster wieder zu skalieren. Dies ist leistungsfähiger und verhindert eventuelle Konsistenzprobleme, da die neuen Erweiterungen von jedem Server beim Start geladen werden. Weitere Informationen finden Sie unter ThingWorx Erweiterungen in ThingWorx HA verwalten im ThingWorx Hilfe-Center.
|
Ein ThingWorx Administrator muss die folgenden Schritte ausführen, um mithilfe von Solution Central die Bausteine für Ihre ThingWorx Instanz bereitzustellen:
1. Stellen Sie sicher, dass Ihre Lizenz in ThingWorx Composer installiert ist. Weitere Informationen finden Sie in diesem Artikel des technischen Supports in der PTC Wissensdatenbank.
2. Richten Sie Solution Central ein. Weitere Informationen finden Sie unter Getting Started with Using Solution Central im englischen Solution Central Help Center.
3. Registrieren Sie in Solution Central Ihre ThingWorx Instanz. Weitere Informationen finden Sie unter Register Your ThingWorx Instance im englischen Solution Central Help Center.
4. Navigieren Sie in ThingWorx Composer zu > > .
5. Aktivieren Sie das Kontrollkästchen für die Bausteine, die Sie bereitstellen möchten. Die folgenden Sätze von Bausteinen sind verfügbar:
◦ Manufacturing Building Blocks
6. Klicken Sie auf Ein-Klick-Bereitstellung. Ein Fenster mit einer Liste aller Erweiterungen, die bereitgestellt werden sollen, wird geöffnet.
7. Klicken Sie auf Alle bereitstellen.
Die Erweiterungen werden heruntergeladen und installiert. Dies dauert einige Minuten. Sie werden benachrichtigt, wenn der Prozess abgeschlossen ist.
Weitere Informationen finden Sie im englischen ThingWorx Solution Central Help Center.
Dienst "InitializeSolution" ausführen
Führen Sie den Dienst InitializeSolution aus, um das Datenbankding zu konfigurieren, um eine Verbindung zu Ihrer Baustein-Datenbank herzustellen, Datenbanktabellen zu erstellen und die Manager-Dinge für die Bausteine zu registrieren.
Ein ThingWorx Administrator muss die folgenden Schritte ausführen, um den Dienst auszuführen:
1. Navigieren Sie in ThingWorx Composer zum Ding PTC.Base.Manager.
2. Rufen Sie die Konfigurationsparameter ab:
a. Suchen Sie unter Dienste nach dem Dienst GetSolutionDeploymentConfigurationParameters und führen Sie ihn aus. Der Dienst gibt eine JSON-Datei mit den Konfigurationsparametern aus, die für den Dienst InitializeSolution erforderlich sind. Dies erfolgt dynamisch basierend auf dem Satz von vorhandenen Bausteinen. Die vom Dienst ausgegebene JSON-Datei weist das folgende Format auf:
{
"databaseUser": {
"types": [
"STRING"
],
"description": "Name of the database user used for DPM database Thing",
"optional": false
},
"twxAdminUserName": {
"types": [
"STRING"
],
"description": "Thingworx Admin Username",
"optional": false
},
"overrideComponentDeploymentState": {
"types": [
"BOOLEAN"
],
"description": "If true, the current component deployment state is ignored and the DeployComponent service will be rerun.",
"optional": true
},
"twxAdminPassword": {
"types": [
"STRING"
],
"description": "Thingworx Admin Password",
"optional": false
},
"databasePassword": {
"types": [
"STRING"
],
"description": "Password of the database user used for DPM database Thing",
"optional": false
},
"twxURL": {
"types": [
"STRING"
],
"description": "Thingworx URL",
"optional": false
},
"databaseJDBCString": {
"types": [
"STRING"
],
"description": "JDBC Connection String for the DPM database Thing",
"optional": false
},
"databaseThing": {
"types": [
"STRING"
],
"description": "The default database thing (PTC.DBConnection.MSSQLDatabase)",
"optional": true
}
}
"databaseUser": {
"types": [
"STRING"
],
"description": "Name of the database user used for DPM database Thing",
"optional": false
},
"twxAdminUserName": {
"types": [
"STRING"
],
"description": "Thingworx Admin Username",
"optional": false
},
"overrideComponentDeploymentState": {
"types": [
"BOOLEAN"
],
"description": "If true, the current component deployment state is ignored and the DeployComponent service will be rerun.",
"optional": true
},
"twxAdminPassword": {
"types": [
"STRING"
],
"description": "Thingworx Admin Password",
"optional": false
},
"databasePassword": {
"types": [
"STRING"
],
"description": "Password of the database user used for DPM database Thing",
"optional": false
},
"twxURL": {
"types": [
"STRING"
],
"description": "Thingworx URL",
"optional": false
},
"databaseJDBCString": {
"types": [
"STRING"
],
"description": "JDBC Connection String for the DPM database Thing",
"optional": false
},
"databaseThing": {
"types": [
"STRING"
],
"description": "The default database thing (PTC.DBConnection.MSSQLDatabase)",
"optional": true
}
}
b. Kopieren Sie die in der Dienstausgabe zurückgegebene JSON, und fügen Sie sie in einen Texteditor ein.
c. Bearbeiten Sie die JSON und ersetzen Sie den Inhalt in den geschweiften Klammern für jeden Konfigurationsparameter durch den standortspezifischen Wert.
▪ databaseUser – Der Anmeldename des Datenbankbenutzers mit Systemadministratorrechten
▪ twxAdminUserName – Der Name des ThingWorx Administrator-Benutzers
▪ twxAdminPassword – Das Passwort für den ThingWorx Administrator-Benutzer
▪ databasePassword – Das Anmeldungspasswort für den Datenbankbenutzer mit Systemadministratorrechten
▪ databaseJDBCString – Die JDBC-Verbindungszeichenfolge für die Baustein-Datenbank
▪ twxURL – Die URL für Ihre ThingWorx Instanz
▪ databaseThing – Das standardmäßige Datenbankding (PTC.DBConnection.MSSQLDatabase)
Nachfolgend ist ein Beispiel der bearbeiteten JSON:
{
"databaseUser": "<bbadmin>",
"twxAdminUserName": "Administrator",
"twxAdminPassword": "<twxadminpassword>",
"databasePassword": "<password>",
"databaseJDBCString": "jdbc:sqlserver://<databaseHost>:<databasePort>;databaseName=<bbdatabaseName>",
"twxURL": "http://<host>:<port>/Thingworx",
"databaseThing": "PTC.DBConnection.MSSQLDatabase"
}
"databaseUser": "<bbadmin>",
"twxAdminUserName": "Administrator",
"twxAdminPassword": "<twxadminpassword>",
"databasePassword": "<password>",
"databaseJDBCString": "jdbc:sqlserver://<databaseHost>:<databasePort>;databaseName=<bbdatabaseName>",
"twxURL": "http://<host>:<port>/Thingworx",
"databaseThing": "PTC.DBConnection.MSSQLDatabase"
}
Nachstehend sehen Sie ein Beispiel für das bearbeitete JSON-Objekt mit den tatsächlichen Werten:
{
"databaseUser": "BBadmin",
"twxAdminUserName": "Administrator",
"twxAdminPassword": "ThingWorx!BB9876",
"databasePassword": "945DaTaBase!39525",
"databaseJDBCString": "jdbc:sqlserver://localhost:1433;databaseName=dpmdb",
"twxURL": "http://MyCompany.com:8080/Thingworx",
"databaseThing": "PTC.DBConnection.MSSQLDatabase"
}
"databaseUser": "BBadmin",
"twxAdminUserName": "Administrator",
"twxAdminPassword": "ThingWorx!BB9876",
"databasePassword": "945DaTaBase!39525",
"databaseJDBCString": "jdbc:sqlserver://localhost:1433;databaseName=dpmdb",
"twxURL": "http://MyCompany.com:8080/Thingworx",
"databaseThing": "PTC.DBConnection.MSSQLDatabase"
}
3. Suchen und führen Sie unter Dienste den Dienst "InitializeSolution" aus, indem Sie die bearbeitete JSON aus Schritt 2.c als Eingabeparameter deploymentConfig für den Dienst verwenden.
Nachdem der Dienst abgeschlossen wurde, zeigt die Ausgabe eine Infotable an, die die bereitgestellten Bausteine und ihre Konfigurationsstatus auflistet: Configured, Not Configured oder Error. Wenn Bausteine den Status Error oder Not Configured aufweisen, führen Sie die folgenden Schritte zur Problembehandlung aus:
a. Stellen Sie sicher, dass die in der JSON-Datei angegebenen Datenbank-Anmeldeinformationen gültig sind. Führen Sie anschließend den Dienst InitializeSolution aus.
b. Wenn Bausteine in der Dienstausgabe weiterhin den Status Error oder Not Configured aufweisen, überprüfen Sie die ThingWorx Anwendungs- und Skriptfehlerprotokolle, und beheben Sie alle dort gefundenen Fehler. Führen Sie anschließend den Dienst InitializeSolution aus.
c. Wenn Bausteine in der Dienstausgabe weiterhin den Status Error oder Not Configured aufweisen, aktualisieren Sie die JSON-Datei mit Folgendem, und führen Sie anschließend den Dienst InitializeSolution aus:
"overrideComponentDeploymentState": true
Dienst "UpdateDBSchema" ausführen
Führen Sie den Dienst UpdateDBSchema aus, um die erforderlichen Beschränkungen auf die Datenbanktabellen anzuwenden.
Ein ThingWorx Administrator muss die folgenden Schritte ausführen, um den Dienst auszuführen:
1. Navigieren Sie in ThingWorx Composer zum Ding PTC.DBConnection.Manager.
2. Suchen Sie unter Dienste nach dem Dienst UpdateDBSchema und führen Sie ihn aus.
Nach Abschluss des Diensts wird eine Infotable mit den Datenbankaktualisierungen im Ausgabefensterbereich des Diensts angezeigt.