UltraLite-Synchronisationsdienstprogramm (ulsync)

Synchronisiert eine UltraLite-Datenbank mit einem MobiLink-Server. Dieses Tool kann zum Testen der Synchronisation während der Anwendungsentwicklung verwendet werden.

Syntax

ulsync -c [ Optionen ]  [Synchronisationsparameter]

Option

Beschreibung

-c "Verbindungszeichenfolge"

Erforderlich. Stellt eine Verbindung mit der Datenbank her, wie im Parameter DBF oder file_name der Verbindungszeichenfolge angegeben. Wenn Sie keine Benutzer-ID und kein Kennwort angeben, werden die Standardbenutzer-ID DBA und das Standardkennwort sql verwendet.

--log

Protokolliert Vorgänge in der festgelegten Datei.

-p Profilname

ODER

--profile=profile

Führt eine Synchronisation unter Verwendung des angegebenen Synchronisationsprofils durch. Ist äquivalent mit:

synchronize profileName merge 'syncOptions'

Hier werden die Synchronisationsoptionen von den nachgestellten ulsync-Optionen übernommen. Zum Beispiel:

ulsync -p profileName "MobiLinkUid=ml;ScriptVersion=Version001...syncOptions"

Siehe Synchronisationsprofiloptionen.

-q

ODER

--quiet

Führt das Dienstprogramm im stillen Modus aus. Informative Banner, Versionsnummern und Statusmeldungen werden unterdrückt. Fehlermeldungen werden jedoch weiter angezeigt.

-r

ODER

--result

Zeigt die letzten Synchronisationsergebnisse an und beendet die Anwendung.

-v

ODER

--verbose

Zeigt Meldungen über den Synchronisationsfortschritt an. Dies legt auch fest, ob der Verarbeitungsfortschritt bei einer Synchronisation angezeigt wird, unabhängig davon, ob die C++ API oder die SQL-Anweisung für die Profilsynchronisierung verwendet wird. Siehe CREATE SYNCHRONIZATION PROFILE-Anweisung [UltraLite] [UltraLiteJ].

Bemerkungen

Wenn eine Zertifikatdatei mit der trusted_certificates- oder der e2ee_public_key-Option definiert ist, sucht die UltraLite-Laufzeitbibliothek nach diesen Dateien nur in dem Haupt-Ressourcen-Bundle, das Bestandteil jedes Anwendungs-Deployment-Packages für iPhone ist. Sie fügen diesem Bundle Elemente hinzu, indem Sie sie im /Resources-Ordner Ihres xCode-Projekts speichern. Dies ist nicht anwendbar auf Zertifikate, die in der UltraLite-Datenbank gespeichert werden, und hat keinen Einfluss auf Mac OS-Clients (nur iPhone). Siehe trusted_certificates und e2ee_type.

Die folgenden Optionen, die für die Versionen 10 und früher gültig waren, werden nicht mehr unterstützt: -a Authentifizierungsparameter, -e Synchronisationsparameter, -k Datenstromtyp, -n (keine Synchronisation) und -x Protokolloptionen. -e <keyword>=<value> ist nun Teil der Synchronisationsparameter-Zeichenfolge, während -k und -x in der Synchronisationsparameter-Zeichenfolge Stream=<stream{<stream-parms>} enthalten sind.

ulsync kann als gleichwertig mit einer der folgenden SQL-Anweisungen angesehen werden, abhängig vom Verwendungszweck:

ulsync -p <profile> "<parms>"

Diese Anweisung ist gleichwertig mit folgender Anweisung:

 SYNCHRONIZE PROFILE <profile> MERGE
<parms>

und

ulsync "<parms>"

Diese Anweisung ist gleichwertig mit folgender Anweisung:

 SYNCHRONIZE USING <parms>

Bei einer sicheren Synchronisation muss die UltraLite-Anwendung Zugriff auf das öffentliche Zertifikat haben. Sie können ein Zertifikat folgendermaßen referenzieren:

Durch Aufnahme der Zertifikatsdaten in die UltraLite-Datenbank zum Erstellungszeitpunkt mit der Option -t Datei und ulinit oder ulload.
Durch Referenzierung einer externen Zertifikatdatei während der Synchronisation mit der Datenstromoption trusted_certificates=Datei.

Dieses Dienstprogramm gibt Fehlercodes zurück. Jeder andere Wert als 0 weist darauf hin, dass der Vorgang fehlgeschlagen ist.

Siehe auch

Beispiele

Der folgende Befehl synchronisiert eine Datenbankdatei namens myuldb.udb für den MobiLink-Benutzer namens remoteA.

ulsync -c DBF=myuldb.udb "MobiLinkUid=remoteA;Stream=http;ScriptVersion=2"

Der folgende Befehl synchronisiert eine Datenbankdatei namens myuldb.udb über HTTPS unter Verwendung des Zertifikats c:\certs\rsa.crt. Die Option trusted_certificates=Datei muss verwendet werden, weil die Datei mit dem vertrauenswürdigen Zertifikat nicht der Datenbank hinzugefügt wurde, als die Datenbank erstellt wurde. Der MobiLink-Benutzername lautet remoteB.

ulsync -c DBF=myuldb.udb "Stream=https{trusted_certificates=c:\certs\rsa.crt};
MobiLinkUid=remoteB;ScriptVersion=2;UploadOnly=ON"

Der folgende Befehl zeigt die letzten Synchronisationsergebnisse für die Datenbankdatei synced.udb an.

ulsync -r -c dbf=synced.udb

Die vorherigen Synchronisationsergebnisse werden wie folgt aufgelistet:

SQL Anywhere UltraLite-Dienstprogramm zur Datenbanksynchronisation Version XX.X
    Ergebnisse der letzten Synchronisation: Erfolgreich Download-Zeitstempel:
        2006-07-25 16:39:36.708000
         Upload OK 
         Keine ignorierten Zeilen 
         Teil-Download beibehalten 
         Authentifizierungswert: 1000 (0x3e8)

Das folgende Beispiel zeigt die Verwendung der Befehlszeile, um die CustDB-Datenbank mit dem Benutzernamen 50 über TCP/IP auf dem Port 2439 zu synchronisieren. Es werden ausführliche Meldungen zum Verarbeitungsfortschritt verwendet.

ulsync -c "dbf=C:\Documents and Settings\All Users\Documents\SQL Anywhere 12\Samples\UltraLite\SyncEncrypt\custdb.udb" 
MobiLinkUid=50;ScriptVersion=custdb 12.0;Stream=tcpip{port=2439}

Der folgende Befehl veranschaulicht die Verwendung von TLS-Verschlüsselung mit E2EE:

ulsync -c "uid=dba;pwd=sql;dbf=myudb.db" "MobiLinkUid=rem1;MobiLinkPwd=password;ScriptVersion=v1;Stream=tls{host=myServer;port=2439;trusted_certificates=c:\clientcert.pem;e2ee_type=rsa;e2ee_public_key=c:\e2eepublic.pem}"

Kommentieren Sie diese Seite in DocCommentXchange.