Bausteine mithilfe der Seite "PTC Software-Download" bereitstellen
In diesem Szenario werden Ihre Datenbank und ThingWorx auf Ihrem System installiert, und Sie stellen die Bausteine in Ihrer ThingWorx Instanz bereit, indem Sie die Bausteine von der Seite "PTC Software-Download" herunterladen und das Erweiterungspaket in ThingWorx importieren.
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.
Wenden Sie Ihre Lizenz an. Weitere Informationen finden Sie unter Lizenzierung für ThingWorx Platform im ThingWorx Hilfe-Center.
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.
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 im Abschnitt BasicSettings die Einstellung für ScriptTimeout, und legen Sie diese auf 12000 fest.
Fügen Sie die Option, wenn sie nicht bereits vorhanden ist, dem Abschnitt BasicSettings wie folgt hinzu: "ScriptTimeout": 12000
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 : 12000 seconds. Timeout configured for 12000 seconds.]
Weitere Informationen finden Sie unter platform-settings.json – Konfigurationsdetails im ThingWorx Hilfe-Center.
Sitzungs-Timeout-Einstellung aktualisieren
Standardmäßig gibt es für Sitzungen mit inaktiven Benutzern nach 30 Minuten ein Timeout. Sie können diese Einstellung ändern, um die Anforderungen Ihres Systems zu erfüllen.
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 Systeme > Untersysteme.
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.
Weitere Informationen finden Sie unter Untersystem für Benutzerverwaltung im ThingWorx Hilfe-Center.
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
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;
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"
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>;
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>"
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 über die Seite "PTC Software-Download" herunterladen
Führen Sie die folgenden Schritte aus:
1. Navigieren Sie zur Seite "PTC Software-Download" unter der folgenden URL: https://support.ptc.com/appserver/auth/it/esd/index.jsp.
2. Wählen Sie ThingWorx Foundation aus.
3. Erweitern Sie die folgenden Ordner: ThingWorx Foundation > Release 9.3 > ThingWorx Manufacturing Common 1.2 > Neuester Datumscode.
4. Laden Sie die ZIP-Datei für das Erweiterungspaket MFG-Common-1-2 herunter.
Bausteine importieren
Ein ThingWorx Administrator muss die folgenden Schritte ausführen, um die Bausteine zu importieren:
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. Navigieren Sie in ThingWorx Composer zu Importieren/Exportieren > Importieren.
3. Wählen Sie im Fenster Importieren die Option Erweiterung aus der Liste Importoption aus.
4. Klicken Sie unter Dateiname auf Durchsuchen. Navigieren Sie zur ZIP-Datei für das Erweiterungspaket, die Sie im vorherigen Abschnitt heruntergeladen haben, und wählen Sie diese aus.
5. Klicken Sie auf Importieren. Wenn der Import abgeschlossen ist, klicken Sie auf Schließen.
6. Zeigen Sie die Bausteinerweiterungen nach dem Import an, indem Sie zu Verwalten > Installierte Erweiterungen navigieren.
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
},
"overrideComponentDeploymentState": {
"types": [
"BOOLEAN"
],
"description": "If true, the current component deployment state is ignored and the DeployComponent service will be rerun.",
"optional": true
},
"databasePassword": {
"types": [
"STRING"
],
"description": "Password of the database user used for DPM database Thing",
"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.SQLThingDatabase)",
"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
databasePassword – Das Anmeldungspasswort für den Datenbankbenutzer mit Systemadministratorrechten
databaseJDBCString – Die JDBC-Verbindungszeichenfolge für die Baustein-Datenbank
databaseThing – Das standardmäßige Datenbankding (PTC.DBConnection.SQLThingDatabase)
Nachfolgend ist ein Beispiel der bearbeiteten JSON:
{
"databaseUser": "<bbadmin>",
"databasePassword": "<password>",
"databaseJDBCString": "jdbc:sqlserver://<databaseHost>:<databasePort>;databaseName=<bbdatabaseName>",
"databaseThing": "PTC.DBConnection.SQLThingDatabase"
}
Nachstehend sehen Sie ein Beispiel für das bearbeitete JSON-Objekt mit den tatsächlichen Werten:
{
"databaseUser": "BBadmin",
"databasePassword": "945DaTaBase!39525",
"databaseJDBCString": "jdbc:sqlserver://localhost:1433;databaseName=dpmdb",
"databaseThing": "PTC.DBConnection.SQLThingDatabase"
}
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
War dies hilfreich?