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.
• 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.
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 > .
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.
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 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:
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
},
"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