MSSQL-Datenbank-Setup für ThingWorx: Windows
In MSSQL Server muss eine Anmeldung erstellt werden, bevor ein Benutzer erstellt werden kann. Die Anmeldung wird außerhalb der Datenbank erstellt. Anschließend wird eine Datenbank erstellt. Innerhalb der Datenbank wird ein Benutzer erstellt, und ihm wird die erstellte Anmeldung zugewiesen. Anschließend wird ein Schema innerhalb der Datenbank erstellt. Der Besitzer des Schemas ist nun der Benutzer, der oben erstellt wurde. In Bezug auf ThingWorx wird die twadmin-Anmeldung manuell von SSMS erstellt. Die verbleibenden Schritte werden durch Ausführen von BAT-Skripts durchgeführt.
 |
Wenn Sie Windows nicht verwenden, wechseln Sie zum Abschnitt MSSQL-Datenbank-Setup für ThingWorx: Linux.
|
twadmin-Anmeldung erstellen
|
|
Bevor Sie die folgenden Schritte ausführen, verifizieren Sie, ob die Schritte aus Abschnitt SQL Server Management Studio (Datenbank-Admin-Client) auf Windows-Rechner installieren ausgeführt wurden.
|
Sie können die GUI oder Befehlszeile verwenden, um die Anmeldung zu erstellen.
|
|
Die GUI-Schritte finden Sie unten. Wenn Sie den Abfrage-Editor in SSMS verwenden, geben Sie den folgenden Transact-SQL-Befehl ein:
CREATE LOGIN twadmin WITH PASSWORD = '<password>';
|
1. Öffnen Sie in SQL Server Management Studio (SSMS) den Objekt-Explorer, und erweitern Sie den Ordner der Serverinstanz, in dem die neue Anmeldung erstellt werden soll.
2. Klicken Sie mit der rechten Maustaste auf den Ordner "Sicherheit", zeigen Sie auf "Neu", und klicken Sie auf "Anmelden".
3. Geben Sie auf der Seite "Allgemein" einen Namen für die neue Anmeldung in das Feld "Anmeldename" ein.
4. Wählen Sie "SQL Server-Authentifizierung" aus.
5. Geben Sie ein Passwort für die Anmeldung ein.
6. Klicken Sie auf OK.
Datenbank-Setup-Skript konfigurieren und ausführen
1. Rufen Sie das Datenbank-Setup-Skript (thingworxMssqlDBSetup.bat) im ThingWorx Software-Download ab.
2. Öffnen Sie die Eingabeaufforderung, und ändern Sie das Verzeichnis in den Skriptordner.
3. Geben Sie den folgenden Befehl ein:
thingworxMssqlDBSetup.bat -h <server> -i <server-instance> -p <port> -a <database-admin-user-name> -r <password> -l <login-name> -d <thingworx-database-name> -u <thingworx-user-name> -s <schema-name>
4. Bei Ausführung wird nach dem Passwort für database-admin-user gefragt. Geben Sie das Passwort ein, und drücken Sie die Eingabetaste.
5. Legen Sie die Sortierung fest. Wenn Sie die Sortierung mit SQL Server Management Studio festlegen möchten, wählen Sie Datenbank > Eigenschaften > Optionen aus, und wählen Sie anschließend im Dropdown-Menü die Option Latin1_General_100_CS_AS_SC aus.
6. Legen Sie für die folgenden Eigenschaften ON fest:
◦ READ_COMMITTED_SNAPSHOT
◦ ALLOW_SNAPSHOT_ISOLATION
Nachdem das Skript ausgeführt wurde, wird eine Datenbank erstellt, die den Benutzer mit einer zugeordneten Anmeldung enthält. Diesem Benutzer wird die Rolle db_owner für die erstellte Datenbank zugewiesen. Ein Schema wird bei Bereitstellung in der Befehlszeile ebenfalls erstellt. Der erstellte Benutzer ist für dieses Schema autorisiert.
|
Option
|
Parameter
|
Standard
|
Beschreibung
|
Beispiel
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
FQDN oder IP des Datenbankservers
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<leer>
|
Während der Datenbankinstallation bereitgestellter Instanzname
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
Port von SQL Server
|
-p 1433
|
||
|
-a
|
database-admin-user-name
|
sa
|
Admin-Benutzername, der über die entsprechenden Rechte verfügt
|
-a sa
|
||
|
-l
|
login-name
|
twadmin
|
Name der oben manuell erstellten Anmeldung
|
-l twadmin
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
Name der Datenbank
|
-d thingworx
|
||
|
-u
|
thingworx-user-name
|
<entspricht Anmeldename>
|
Name des Benutzers, der innerhalb der Datenbank erstellt wird
|
-u twadmin
|
||
|
-s
|
schema-name
|
twschema
|
Name des in der Datenbank thingworx erstellten Schemas
|
-s twschema
|
||
|
-r
|
password
|
Password@123
|
Passwort von database-admin-user
|
"Password@123"
|
Modell-/Datenanbieter-Schemaskript konfigurieren und ausführen
1. Führen Sie in der Eingabeaufforderung die BAT-Datei (thingworxMssqlSchemaSetup.bat) mit den entsprechenden Parametern aus (in der Tabelle unten aufgeführt):
thingworxMssqlSchemaSetup.bat -h <server> -i <server-instance> -p <port> -l <login-name> -r <password> -d <thingworx-database-name> -o <option (all,model,data,property,modelwithproperty)>
Nach der Ausführung der BAT-Datei werden Sie für jedes Skript nach dem Anmeldepasswort (oben manuell erstellt) gefragt. Geben Sie das Passwort ein, und drücken Sie jedes Mal die Eingabetaste.
|
|
Beim Ausführen des Skripts wird die folgende erwartete Warnung angezeigt: Warning! The maximum key length for a clustered index is 900 bytes. The index 'data_table_indexes_pkey' has maximum length of 902 bytes. For some combination of large values, the insert/update operation will fail.
|
Bei der Ausführung dieser Skripts werden alle Tabellen, Indizes, Verfahren usw., die zum Einrichten von ThingWorx Platform erforderlich sind, innerhalb der Datenbank thingworx mit dem Standardschema twschema erstellt.
|
Option
|
Parameter
|
Standard
|
Beschreibung
|
Beispiel
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
FQDN oder IP des Datenbankservers
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<leer>
|
Während der Datenbankinstallation bereitgestellter Instanzname
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
Port von SQL Server
|
-p 1433
|
||
|
-l
|
login-name
|
twadmin
|
Name der oben manuell erstellten Anmeldung
|
-l twadmin
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
Name der Datenbank
|
-d thingworx
|
||
|
-o
|
option
|
all
|
Zum Ausführen aller Skripts. Modell, Daten, Eigenschaft und Modell mit Eigenschaft werden ausgeführt.
|
-o all
|
||
|
-r
|
password
|
Password@123
|
Passwort für login-name
|
"Password@123"
|
Skript für Datenbankbereinigung konfigurieren und ausführen
Das BAT-Skript für die Datenbankbereinigung (thingworxMssqlDBCleanup.bat) wird für Benutzerfreundlichkeit und Entwicklungs-/Testzwecke bereitgestellt. Das Ausführen der Schritte in diesem Abschnitt ist nur erforderlich, wenn das gesamte Datenbankobjekt und die Daten gelöscht werden müssen, damit Sie neu beginnen können.
1. Führen Sie in der Eingabeaufforderung die BAT-Datei mit den entsprechenden Parametern aus (in der Tabelle unten aufgeführt):
thingworxMssqlDBCleanup.bat -h <server> -i <server-instance> -p <port> -a <database-admin-user-name> -r <password> -d <thingworx-database-name>
|
Option
|
Parameter
|
Standard
|
Beschreibung
|
Beispiel
|
||
|---|---|---|---|---|---|---|
|
-h
|
server
|
localhost
|
FQDN oder IP des Datenbankservers
|
-h 10.0.0.221
|
||
|
-i
|
server-instance
|
<leer>
|
Während der Datenbankinstallation bereitgestellter Instanzname
|
-i SQLEXPRESS
|
||
|
-p
|
port
|
1433
|
Port von SQL Server
|
-p 1433
|
||
|
-a
|
database-admin-user-name
|
sa
|
Admin-Benutzername, der über die entsprechenden Rechte verfügt
|
-a sa
|
||
|
-d
|
thingworx-database-name
|
thingworx
|
Name der Datenbank
|
-d thingworx
|
||
|
-r
|
password
|
Password@123
|
Passwort von database-admin-user
|
"Password@123"
|