Befehlszeilenscripts für DB2 Everyplace Sync Server

In den folgenden Tabellen sind die Scripts aufgelistet, die für den Betrieb und die Verwaltung von DB2 Everyplace Sync Server zur Verfügung stehen. Ferner wird die korrekte Syntax zur Ausführung dieser Scripts angegeben. Die übergeordneten Verzeichnisse der Scripts lauten wie folgt:

Speicherposition für DB2 Everyplace Sync Server- und Mobile Devices Administration Center-Befehle

Verwaltungsbefehle des DB2 Everyplace Sync Server-Exemplars

Die Befehle für UNIX/Linux- und Windows-Plattformen unterscheiden sich nur darin, dass UNIX- und Linux-Scripts die Erweiterung .sh und Windows-Stapeldateien die Erweiterung .bat aufweisen. In den folgenden Tabellen wird von Windows ausgegangen, Befehle und Syntax sind auf UNIX/Linux-Plattformen jedoch funktional identisch.

Tabelle 219. Befehle für UNIX, Linux und Windows

Befehl Zweck Syntax
dsyadmin.bat

Dieser Befehl startet DB2 Everyplace Mobile Device Administration Center (MDAC). MDAC stellt eine GUI für die Verwaltung von Benutzern, Gruppen, Subskriptionsgruppen und Subskriptionen zur Verfügung.

Weitere Informationen zur Verwendung von MDAC finden Sie in Was ist Mobile Devices Administration Center?.

Bei Linux-Servern muss DB2 JDBC Applet Server vor dem Starten von MDAC gestartet werden. Geben Sie zum Starten von DB2 JDBC Applet Server db2jstrt ein. Der Standardport für DB2 JDBC Applet Server ist 6789. Für dieses Script können Sie einen freien Port als optionalen Parameter angeben. Nach dem Neustart des Computers muss DB2 JDBC Applet Server erneut gestartet werden. Wenn DB2 JDBC Applet Server nicht an Port 6789 gestartet wird, müssen Sie diesen Port für dsyadmin.sh angeben.

Unter Windows:

dsyadmin.bat

Unter Linux:

db2jstrt [freie Portnummer]
./dsyadmin.sh [DB2 JDBC Applet Server-Port]
 

Unter Solaris und AIX:

./dsyadmin.sh
dsyadminxml.bat

Mit diesem Befehl wird MDAC-XML ausgeführt, um MDAC-Konfigurationen unter Verwendung von XML-Dateien über die Befehlszeile zu verwalten. Mit dem XML-Tool können MDAC-Objekte hinzugefügt, entfernt und geändert werden. MDAC-Objekte umfassen DB2 Everyplace-Benutzer, -Gruppen, -Subskriptionsgruppen und -Subskriptionen.

Umfassende Syntaxinformationen finden Sie in Einsetzen des XML Scripting Tools.

Wenn Sie Hilfe benötigen, geben Sie Folgendes ein:

dsyadminxml.bat

(ohne Argumente)

Befehlszeilenparameter:

-x|-d dateiname
-x dateiname [-add] [-remove]
  • -x erstellt eine XML-Datei aus der Steuerungsdatenbank.
  • -d führt eine XML-Datei für die Steuerungsdatenbank aus.
  • dateiname ist der XML-Dateiname, der verarbeitet werden soll. -x überschreibt die Datei, sollte diese bereits vorhanden sein.
  • [-add] und [-remove] sind XML-Typen zum Hinzufügen von Daten zur Sync Server-Steuerungsdatenbank bzw. zum Entfernen bereits vorhandener Daten.
dsyblocksubscription.bat Dieser Befehl blockiert den im Befehlsargument angegebenen Subskriptionsnamen. In der Befehlszeile können mehrere Subskriptionen gleichzeitig angegeben werden. Durch das Blockieren einer Subskription wird Sync Server angewiesen, keine neuen Änderungen an den Subskriptionsdaten zuzulassen.
dsyblocksubscription.bat  [subskription]

[subskription] ist die Subskription, die auf dem Server blockiert wird.

Beispiel:

dsyblocksubscription subskriptionsname1

Dieser Befehl blockiert die Subskription mit dem Namen 'subskriptionsname1'.

dsyctldb.bat Mit diesem Befehl wird die DB2 Everyplace-Steuerungsdatenbank erstellt. Dieser Befehl wird normalerweise von der DB2 Everyplace-Installation automatisch ausgeführt.
dsyctldb.bat <db2exemplar> <db2exemplar kennwort>
dsyjdbcmigration.bat Mit diesem Befehl werden JDBC-Subskriptionen von Sync Server Version 8.1.2 oder früher auf Sync Server Version 8.1.4 oder höher migriert.
dsyjdbcmigration.bat [quellendatenbank-url
quellentabellenbereich][quellendatenbank-url quellentabellenbereich quellentabellenname]

Dabei gilt Folgendes:

  • quellendatenbank-url ist die URL der Quellendatenbank, die migriert werden soll.
  • quellentabellenbereich ist der Name des Tabellenbereichs, in dem die Sync Server-Steuertabellen erstellt werden sollen.
  • quellentabellenname ist der Name der Quellentabelle, die migriert werden soll.

Geben Sie zum Migrieren aller Subskription beispielsweise Folgendes ein:

dsyjdbcmigration.bat

Geben Sie zum Migrieren der Subskriptionen in der Datenbank MPFLEGE unter Verwendung des Tabellenbereichs 'meintabellenbereich' Folgendes ein:

dsyjdbcmigration.bat jdbc:db2:MPFLEGE meintabellenbereich

Geben Sie zum Migrieren der Subskriptionen in der Tabelle DSYSAMPLE.MPKRANKENAKTE in der Datenbank MPFLEGE unter Verwendung des Tabellenbereichs 'meintabellenbereich' Folgendes ein:

dsyjdbcmigration.bat jdbc:db2:MPFLEGE meintabellenbereich
    dsysample.mpkrankenakte
dsymigratemessagestore.bat Dieser Befehl wird von der Installation nur im Falle einer Migration verwendet. Benutzer, die ihre letzte Synchronisation nicht abgeschlossen haben, werden zurückgesetzt. Dadurch wird bei der nächsten Synchronisation eine Aktualisierung erzwungen. Daten, die von der unvollständigen Synchronisation hochgeladen wurden, können verloren gehen.
dsymigratemessagestore.bat
dsymsgclean.bat In einer Umgebung mit mehreren Servern entfernt dieser Befehl alle Nachrichten aus der Nachrichtenspeicherdatenbank.
dsymsgclean.bat
dsymsgdb.bat Dieser Befehl wird von der Installation für Umgebungen mit mehreren Servern verwendet. Er erstellt die erforderliche Nachrichtenspeicherdatenbank. dsymsgdb.bat
dsyreplicate.bat Mit diesem Befehl wird DB2 Everyplace angewiesen, die Daten in der Spiegeldatenbank bei der ersten Gelegenheit in die Quelle zu replizieren.
dsyreplicate.bat [spiegeldatenbank]
dsyreset.bat

Mit diesem Befehl wird ein Benutzer, ein Gerät oder eine Benutzergruppe zurückgesetzt.

Wenn Sie Hilfe benötigen, geben Sie dsyreset.bat ohne Argumente ein.

dsyreset.bat {[benutzername]} {-gerät [geräte-id]}
 {-gruppe [gruppenname]} {-all}

Dabei gilt Folgendes:

  • [benutzername] ist der Benutzername, der zurückgesetzt werden soll.
  • [geräte-id] ist die Geräte-ID, die zurückgesetzt werden soll.
  • [gruppenname] ist der Name der Gruppe, deren Benutzer zurückgesetzt werden sollen.

Geben Sie beispielsweise Folgendes ein, um den Benutzer 'bob' zurückzusetzen:

dsyreset.bat bob

Geben Sie Folgendes ein, um alle Benutzer zurückzusetzen, die zur Gruppe 'Verkauf' gehören:

dsyreset.bat -group Verkauf
dsyResetUserMigration.bat Generiert ein XML-Script, um die Benutzer zurückzusetzen, deren letzte Synchronisationen unvollständig waren. Dieser Befehl erfordert die Eingabe der URL, der Benutzer-ID und des Kennworts für den Zugriff auf die Steuerungsdatenbank sowie eines absoluten Dateinamens für die XML-Ausgabedatei. Dieses XML-Script kann jederzeit ausgeführt werden. Dieser Befehl wird normalerweise während der Installation ausgeführt.
dsyResetUserMigration jdbc:db2:dsyctldb <benutzer-id> 
<kennwort> <dateiname.xml>

Dabei gilt Folgendes:

  • benutzer-id ist die Benutzer-ID eines DB2-Administrators.
  • kennwort ist das Kennwort für die angegebene Benutzer-ID.
  • dateiname.xml ist die XML-Ausgabedatei.
dsysetenv.bat Mit diesem Script werden die Umgebungsvariablen für DB2 Everyplace Sync Server festgelegt.
dsysetenv.bat
dsysetjavahome.bat Dieser Scriptbefehl kann geändert werden, um dem Klassenpfad für MDAC JDBC-Treiber hinzuzufügen. Wenn Sie native Bibliotheken hinzufügen möchten, die von diesen Treibern unter Umständen benötigt werden, fügen Sie diese Einträge dsysetenv.bat hinzu. Beachten Sie, dass die JDBC-Treiber auch dem Klassenpfad des Anwendungsservers hinzugefügt werden müssen, der die DB2 Everyplace-Servlets ausführt.
dsysetproperty.bat Führen Sie eine Abfrage durch, oder legen Sie ein Merkmal in der Tabelle DSY.PROPERTIES der Steuerungsdatenbank fest. Geben Sie
 dsysetproperty.bat
ohne Argumente ein, um Anweisungen zu erhalten.
dsysync.bat

Dieser Befehl startet die eingebettete Version von WebSphere Application Server Version 5 zur Ausführung der DB2 Everyplace-Servlets. Der Serverprozess wird im Hintergrund gestartet, dann wird der Befehl beendet. Dieser Befehl erfordert keine Argumente.

Wenn DB2 Everyplace auf einem anderen Anwendungsserver installiert ist (z. B. WebSphere Application Server Version 5), verwenden Sie die entsprechenden Befehle für diesen Server.

dsysync.bat
dsysyncmonitor.bat Mit diesem Befehl wird ein GUI-Tool zum Anzeigen von Protokolldaten zu Benutzern gestartet, die momentan Synchronisationen durchführen. Die GUI kann so konfiguriert werden, dass sie in unterschiedlichen Intervallen aktualisiert wird, damit immer die aktuellen Informationen angezeigt werden.
dsysyncmonitor.bat
dsysyncstatus.bat

Mit diesem Befehl wird der Ausführungsstatus des DB2 Everyplace-Servers ausgegeben, der in der eingebetteten Version von WebSphere Application Server Version 5 installiert ist. Der Server kann gestartet, aktiv oder gestoppt sein. Dieser Befehl erfordert keine Argumente.

Wenn DB2 Everyplace auf einem anderen Anwendungsserver installiert ist (z. B. WebSphere Application Server Version 5), verwenden Sie die entsprechenden Befehle für diesen Server.

dsysyncstatus.bat
dsysyncstop.bat

Dieser Befehl stoppt die eingebettete Version von WebSphere Application Server Version 5 zur Ausführung der DB2 Everyplace-Servlets. Die Stoppanforderung für den aktiven Serverprozess wird abgesetzt, der Status ausgegeben und der Befehl anschließend beendet. Dieser Befehl erfordert keine Argumente.

Wenn DB2 Everyplace auf einem anderen Anwendungsserver installiert ist (z. B. WebSphere Application Server Version 5), verwenden Sie die entsprechenden Befehle für diesen Server.

dsytrace [0 | 1] [-console]
 

Dabei gilt Folgendes:

  • 0 inaktiviert die Traceverarbeitung mit Ausnahme von Fehlern.
  • 1 aktiviert die Traceverarbeitung für alle Funktionen.
  • -console inaktiviert die Traceverarbeitung im Konsolfenster.

Wenn die Traceverarbeitung beispielsweise für alle Funktionen aktiviert und nicht im Konsolfenster angezeigt werden soll, geben Sie Folgendes ein:

dsytrace 1 -console 
dsytraceprocess.bat Mit diesem Befehl wird das Zeitmarkenformat in den Tracedateien durch das Format "jjjjmmtt hh:mm:ss.ms" ergänzt.
dsytraceprocess.bat -F <tracedateiname> -O <true|false> 
 

Die Option -O gibt die Markierung zum Überschreiben an. Wenn sie auf "true" gesetzt ist, wird die ursprüngliche Tracedatei mit der konvertierten Tracedatei mit erweiterten Zeitmarken überschrieben. Andernfalls erhalten die resultierenden Tracedateien den Namen ursprüngliche-tracedatei.new.

dsyunblocksubscription.bat Dieser Befehl entblockt den im Befehlsargument angegebenen Subskriptionsnamen. In der Befehlszeile können mehrere Subskriptionen gleichzeitig angegeben werden. Durch das Entblocken einer zuvor blockierten Subskription wird Sync Server angewiesen, neue Änderungen von den Clients wieder als Teil dieser Subskription(en) zu akzeptieren.
dsyunblocksubscription [subskription]+

Dabei gilt Folgendes:

  • [subskription] ist die Subskription, die auf dem Server entblockt wird.

Wenn Sie beispielsweise die Subskription mit dem Namen 'bob' entblocken möchten, geben Sie Folgendes ein:

dsyunblocksubscription bob

Wenn Sie die Subskriptionen 'bob' und 'sally' entblocken möchten, geben Sie Folgendes ein:

dsyunblocksubscription bob sally
dsyversion.bat Dieser Befehl ermittelt die Version der Steuerungsdatenbank durch Abfragen der Tabelle dsy.properties.
dsyversion.bat
useUdb8.bat Dieses Script legt den Klassenpfad für Mobile Devices Administration Center fest, der mit DB2 UDB Version 8.1 verwendet wird.
useUdb8.bat
useUdbFp7_8.bat Dieses Script legt den Klassenpfad für Mobile Devices Administration Center fest, der mit DB2 UDB Version 7.2 Fixpack 7 oder höher verwendet wird.
useUdbFp7_8.bat

In der folgenden Tabelle sind die Scripts für DB2 Everyplace Sync Server auf UNIX- und Linux-Servern aufgelistet.

Tabelle 220. Verwaltungsscripts für DB2 Everyplace Sync Server-Exemplare

Befehl Zweck Syntax
dsyidrop.sh Mit diesem Script wird ein DB2 Everyplace Sync Server-Exemplar gelöscht.
dsyidrop.sh <dsy-exemplar>
wobei <dsy-exemplar> der Name des
DB2 Everyplace Sync Server- 
Exemplars ist, das gelöscht werden soll.
dsyicreate.sh Mit diesem Script wird ein DB2 Everyplace Sync Server-Exemplar erstellt. Beim DB2 Everyplace Sync Server-Exemplar muss es sich um einen vorhandenen Benutzer im System und ein DB2 UDB-Exemplar handeln.

Geben Sie zum Anzeigen der Parameter für die Erstellung eines DB2 Everyplace Sync Server-Exemplars Folgendes ein:

dsyicreate.sh
dsyilist.sh Mit diesem Script werden die aktuell definierten DB2 Everyplace Sync Server-Exemplare aufgelistet.
dsyilist.sh