The EMCMD utility that ships with SIOS DataKeeper provides users with a command line method to manipulate the mirror. Because these scripts run in situations where the “normal” validation rules may not apply, EMCMD does not perform the same kinds of sanity checks that the user would experience using the SIOS DataKeeper User Interface. EMCMD simply passes commands to the SIOS DataKeeper Replication service allowing the service to make any decisions. It is this lack of checks that also makes this a useful diagnostic and support tool – though it is potentially dangerous for someone not very experienced with the inner workings of SIOS DataKeeper.
The following sections detail the operation of the EMCMD SIOS DataKeeper Command Line. You must be in the EM directory or the directory must be in your path to issue these commands.
Note: The following style conventions will be utilized throughout.
|<system>||Use the system’s NetBIOS name, IP address or fully qualified domain name to attach to a given system. You can also use a period (.) to attach to the local system where emcmd is being executed.|
|<drive>||Refers to the drive letter that is being referenced. EMCMD parses out everything after the first character, therefore, any “:” (colon) would be extraneous.|
In some cases a series of EMCMD commands should be run to perform a function.
Example: To clean up a deleted mirror the following three commands should be run on each cluster node.
- emcmd . deletelocalmirroronly <volume letter of mirror to clean up>
- emcmd . clearswitchover <volume letter of mirror to clean up>
- emcmd . updatevolumeinfo <volume letter of mirror to clean up>
Then, you can recreate the mirror by using the emcmd createmirror command (example: emcmd <address of source of mirror> createmirror <volume letter> <address of target of mirror> <Type of Mirror – either S for sync or A for async>. This command will recreate the mirror and connect it to the existing DataKeeper Job.
Note: Run these commands with caution. If you have any questions please contact Support at firstname.lastname@example.org.