SANmelody CLI HowTo
In einigen Situationen ist es wichtig, dass man mittels CLI Snapshots innerhalb von Datacore steuern kann. Hierzu gibt es mit dem Befehl dcsrcmd.exe die Möglichkeit Befehle zur Snapshot-Steuerung zu übermitteln. Voraussetzung hierfür ist zunächst, dass auf dem zu steuernden Datacore SDS der Dienst DataCore Remote Command Service gestartet ist. Standardmäßig ist dieser Dienst gestoppt und steht auf "Manuell".
Wichtig ist außerdem, dass die Datei DCSRCMD.INI konfiguriert. Diese liegt in dem Verzeichnis C:\PROGRAMME (x86)\DATACORE SOFTWARE\SANMELODY und muss nach dem editieren eine Verzeichnisebene höher abgelegt werden. Im Ausgangszustand sieht die Datei so aus:
* this file should go into \program files\datacore software\ * This section defines the commands that are * authorized for this service. If the section * contains no commands, no commands can be executed. * The format for this section is: * computer,command * * Note: spaces are significant. * [server commands] opaq,dir opaq,type dueces-wild,dir dueces-wild,type [end] * * This section defines the access to the server * listen pipe. If the section contains no * usernames, no access is allowed. * The format for this section is: * computer,user * * Note: spaces are significant. * [access] localhost,administrator opaq,administrator opaq,sgoodwin dueces-wild,administrator [end]
In der ersten Sektion muss nun definiert werden, welche Befehle von welchen Rechner aus ausgeführt werden dürfen. Die Syntax ist dabei immer Rechnername,Befehl . In der zweiten Sektion wird angegeben, welcher Benutzer von welchem Computer Befehle ausführen darf. Das geschieht nach der Syntax Rechnername,Benutzer .
Hinweis: Der DataCore Remote Command Service muss nach jeder Änderung der INI-Datei neu gestartet werden!
Sobald diese Konfiguration vorgenommen wurde kann mit dem Befehl dcsrcmd.exe von jedem erlaubten Rechner aus gearbeitet werden.
Nehmen wir an, wir wollen einen Snapshop aktivieren (enableSnap), dann müssen wir zuerst in der DCSRCMD.INI den Befehl "enablesnap" für unseren Computer erlauben. Danach suchen wir uns aus der GUI die sogenannte Snapshot-Relationship-Nummer heraus. Diese finden wir im Snapshot-Manager unter "SnapshotSets":
Wichtig ist, dass wir direkt vor der Relationship-Nummer den Parameter "DcsSnap" voranstellen. Wenn der Datacore-Server "SDS1" heißt, ergibt sich dann folgende Syntax, um den Snapshot zu aktivieren:
dcsrcmd -c \\SDS1 "enablesnap DcsSnap1"
Folgende Befehle sind für die Verwaltung von Snapshots über diesen Weg verfügbar:
DisableSnap EnableNewSnap EnableSnap FreeDestNMVBNlocks GetLastErrors GetSnapExtendedStatus GetSnapStatus SetCompleteImageDelay SetSourceUpdateDelay StartCompleteImage StartImageUpdate StartSourceUpdate StopSourceUpdate StopImageUpdate StopSourceUpdate
Die genaue Syntax und die Funktionsweise kann hierbei direkt aus der Hilfe von SANmelody im Kapitel Snapshots \ Snapshot Commands entnommen werden.
Hinweis: Mit dem DcsRCMD-Kommando können nicht nur Snapshot-Befehle ausgeführt werden. Es können auch andere Befehle und Programme ausgeführt werden, sofern diese in der INI-Datei erlaubt wurden (siehe oben). Z.B. kann man so auch remote einen DIR-Befehl ausführen und bekommt die Ausgabe direkt zurückgeliefert.