Das Programm SOGSync erlaubt
Einen Verzeichnisbaum vollständig auf ein definiertes Ziel synchronisieren. Dabei werden auch alte Dateien und Verzeichnisse auf dem Ziel gelöscht, sowie Dateiattribute wie „Schreibgeschützt“ und „Versteckt“ angepasst.
Nur eine Teilmenge zu synchronisieren. Dies basiert auf Dateimengenregeldateien.
Nur eine Teilmenge zu synchronisieren. Dabei auf dem Ziel nur bestimmte Dateien löschen (2. Dateimengenregeldatei!)
Per Option kann das Löschen von Dateien auf dem Ziel unterdrückt werden.
Während der Bearbeitung entsteht eine Liste, in der evt. Fehler aufgeführt sind.
sogsync [-minimum] [-vb n] [-r] Steuerdatei [Listdatei]
sogsync -src SourceDirectory -dest DestDirectory [-rule RuleFile] [-delrule DelRuleFile] [-normdir]
sogsync -asetup [-asproj] [-nodel] [-tools] [-install] [-domcfgonly] -src SourceShare -dest DestDirectory [-ziponly ZipDatei] [-umfang Umfang]
sogsync -asetupfilelist -src SourceShare -dest DestFile [-umfang Umfang]
sogsync -filelist SourceDirectory RuleFile Listdatei
sogsync -dbrebuild -src SourceDirectory
sogsync -dbupdate -src SourceDirectory
sogsync -dbcheck [-checksum] -src SourceDirectory
sogsync -dbcalc -src SourceDirectory Summendatei SyncDateiliste
sogsync -dbzip -src SourceDirectory SyncDateiliste ZipDatei
sogsync -dbunzip ZipDatei ZielDirectory
sogsync -dbzipdir SourceDirectory ZipDatei
Minimale Ausgabe von Statusinformationen während des Kopierens.
Konfiguration des Vergleichsverfahrens. (Initialwert: -vb 1024)
-vb 0 => Es wird nur Datum und Größe der Datei für den Vergleich herangezogen.
-vb 1 => Es werden zusätzlich die vollständigen Dateiinhalte verglichen.
-vb n => Es werden nur die ersten und letzten n Bytes der Dateien verglichen.
Keine Dateien oder Verzeichnisse auf dem Ziel löschen.
XML Steuerdatei in folgendem Format:
<?xml version="1.0" encoding="utf-8"?>
<Config OutputDirectory="c:\hdloo" LastFileCount="16400" Rules="g:\hdl\etc\copytar\_hhups.hhrule" DeleteRules="g:\hdl\etc\copytar\_oonodel.hhrule">
</Config>
OutputDirectory: Legt das Zielverzeichnis fest.
Rules: Legt die Regeldatei für den Kopiervorgang fest.
DeleteRules: Legt die Regeldatei für das Löschen von Dateien auf dem Ziel fest
(Hinweis: In den DeleteRules können keine Verzeichnisse ausgeschlossen werden, das sich die Verzeichnisstruktur der Bearbeitung über das Quellverzeichnis ergibt).
List: Angabe der Listdatei
MailServer: Name eines Mailserver (für Protokollversand)
MailFrom: Name eine Mail-Absenders (Email-Adresse)
MailTo: Email-Adressen für Mailempfänger (Liste von Empfängern mit ";")
Name der Ausgabeliste. Ist keine Listedatei angegeben, wird automatisch eine Listdatei im Temp-Verzeichnis angelegt.
Quellverzeichnis.
Zielverzeichnis.
Regeldatei für Datei löschen.
Erstellen einer Dateiliste auf Basis einer Regeldatei. (Test einer Regeldatei)
Normlerweise werden am Ende der Verarbeitung leere Verzeichnisse im Ziel gelöscht. Mit dieser Option unterbleibt dies.
Optionen für die Dateisyncronisation über ActiveSetup
Aktiviert den ActiveSetup-Modus. In diesem Modus muss als Quelle ein freigegtebener ActiveSetup.Share (meist = sogpubproj Projektname) angegebenen werden.
Nach der Übertragung werden projektspezifische Veränderungen vorgenommen. Dazu gehört das Anlegen einer hhproj.txt, sowie das Weiterschalten von Bin-Verzeichnissen und das Anlegen ensprechender Use-Dateien.
Kein Löschen von nicht mehr in der Quelle vorhandenen Dateien.
Anstelle des Projektes werden die aktuellen Tools abgerufen.
Anstelle des Projektes werden die aktuellen Installationskomponenten abgerufen.
Nur Abruf der ActiveSetup DomCfg-Konfigurationsinformation. Ausgabe der Informationen unter dem über -destdir angegebenen Datenpfad.
Optionen für die Dateisyncronisation über "lose" Verbindungen (z.B. per Download oder Email)
Auf dem Server-System
Erstellen einer Datei-Datenbank mit Namen, Größen und Checksummen der Dateien eines Verzeichnisses, und seiner Unterstrukturen. Die Datenbank wird im Text und im Zip-Format erstellt.
Aktualisieren einer Datei-Datenbank. Die Datenbank wird im Text und im Zip-Format erstellt.
Die Prüfsummendatenbank wird überprüft.
Bei der Prüfung sollen auch alle Prüfsummen neu ermittelt werden.
Auf dem Client-System (z.B. Kundenserver)
Erzeugt eine Liste von zu kopierenden Dateien (SyncDateiliste) auf Basis einer Remote-Datei-Datenbank (vom Server-System) und dem lokalen Verzeichnis (des Kunden). Die Liste enthält die Dateien, die von der Remote-Quelle (dem Server) zu holen sind, um alle lokalen Dateien auf den gleichen Stand zu bringen, der Remote verfügbar ist.
Erzeugt auf Basis einer per "-dbcalc" erzeugten Dateiliste, und dem Quellverzeichnis eine Zip-Datei, in der alle Dateien enthalten sind, die über die Dateiliste definiert wurden. Zusätzlich ist eine Datei Namens "__info.sogfliinfo" enthalten, die die Kopfinformationen der Dateiliste enthält.
Auf dem Client-System (z.B. Kundenserver)
Entpackt eine Zip-Datei in ein Verzeichnis.
Komprimiert ein vollständiges Verzeichnis in eine Zip-Datei.
Tritt während des Synchronisationsvorganges ein Fehler auf, ist der Exist-Status nicht = 0
Aktualisierung eines Projektes über einen Client
Mit sogsync kann im Notfall ein Server, der keinen eigenen Internet-Zugriff hat, über einen Client mit Internetzugang aktualisiert werden.
Dabei muss sehr vorsichtig vorgegangen werden, da bei der Aktualisierung über diesen Weg auch schnell alle Dateien auf dem Server gelöscht werden können.
Hier ist ein Beispiel für die auszuführenden Kommandos:
Auf dem Client:
// Tools aktualisieren (direkt, synchron)
sogsync -asetup -tools -src KUNDENPROJEKT -dest s:\tools
// Setup-Komponenten herunterladen (direkter Update in das bin\SOGERPControl Verzeichnis!)
sogsync -asetup -install -src KUNDENPROJEKT -dest S:\vacos\bin\SOGERPControl
// Projektaktualisierung herunterladen:
sogsync -asetup -nodel -src KUNDENPROJEKT -dest s:\vacos -ziponly s:\temp\vacos_upd.zip
Auf dem Server:
ini vacos
// PreInst-Check durchführen (kann auch entfallen)
!!! S:\vacos\bin\SOGERPControl\SOGERPControl.exe -preinst
// Installation der Dateien durchführen
!!! S:\vacos\bin\SOGERPControl\SOGERPInstall.exe -X -typ vacos -hhproj vacos s:\temp\vacos_upd.zip
Sollen die Tools ebenfalls asynchron aktualisiert werden, kann folgendermaßen vorgegangen werden:
Auf dem Client:
// Tools aktualisieren (indirekt, synchron)
sogsync -asetup -tools -src KUNDENPROJEKT -dest s:\tools -ziponly s:\temp\toolsupd.zip
Auf dem Server:
ini tools
!!! soginstproj.exe -X -typ sogwt -hhproj sogwt s:\temp\toolsupd.zip
Wird bei dem Herunterladen der Projektaktualisierung die Option "-ziponly" weggelassen, so wird direkt eine Expansion in das Zielverzeichnis stattfinden.
Aber Achtung: In diesem Falle UNBEDINGT die Option "-nodel" angegeben, da sonst im Ziel alle Dateien gelöscht werden, die nicht auf dem Server bereitgestellt wurden!!
Abschaltung der Lock-Datei bei Verwendung der Datei-Datenbank-Optionen
Durch Angabe der Option "-nolock" kann bei den Dateidatenbankaktionen die Verwendung einer Lock-Datei abgeschaltet werden.
Das sollte nur dann genutzt werden, wenn die datei bereits durch eine Umliegende Verarbeitung (z.B. sogconstep) geschützt wurde.
Verwendung der ActiveSetup-Optionen ohne Installation von ActiveSetup
Um die ActiveSetup-Optionen verwenden zu können ist es normalerweise notwendig, ActiveSetup zu installieren und einzustellen.
Ist ActiveSetup nicht installiert können die benötigten Einstellungen aber auch durch Setzen bestimmter Umgebungsvariablen vorgenommen werden:
set HHENVDOMAIN=xyz
set SOGActiveSetup_sogurl=http://install.sog.de/SOGActiveSetupWeb
set SOGActiveSetup_soguser=download
set SOGActiveSetup_sogpwd=CLEAR:ActiveSetup-Kennwort in Klarschrift
set SOGActiveSetup_envdompwd=Ihre SOG Kundennummer
Installation eines Test-Tools Standes
Mit folgenden Kommandos kann eine Testversion der Tools bei einem Kunden in einem 2. Verzeichnis installiert werden:
mkdir d:\sog\tools_test
sogsync -asetup -tools -src KUNDENPROJEKT -dest d:\sog\tools_test
Abruf der DomCfg Konfiguration
sogsync -asetup -src hdlfrg1703 -dest c:\temp\domcfg.xml -domcfgonly
Abrufen einer Dateiliste eines Projektes
Mit der folgenden Option kann die Liste der auszuliefernden Datei incl. ihrer Prüfsummen vom ActiveSetup Server abgerufen werden.
sogsync -asetupfilelist -src hdlfrg2109 -dest c:\temp\hdlfrg2109.sogcsum.zip [-umfang Umfang]