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 support@us.sios.com.

__________________________________________________________________________________________________________________

Mirror State Definitions

BREAKMIRROR

CHANGEMIRRORENDPOINTS

CHANGEMIRRORTYPE

CLEARBLOCKTARGET

CLEARSNAPSHOTLOCATION

CLEARSWITCHOVER

CONTINUEMIRROR

CREATEJOB

CREATEMIRROR

DELETEJOB

DELETELOCALMIRRORONLY

DELETEMIRROR

DROPSNAPSHOT

GETBLOCKTARGET

GETCOMPLETEVOLUMELIST

GETCONFIGURATION

GETEXTENDEDVOLUMEINFO

GETJOBINFO

GETJOBINFOFORVOL

GETMIRRORTYPE

GETMIRRORVOLINFO

GETREMOTEBITMAP

GETRESYNCSTATUS

GETSERVICEINFO

GETSNAPSHOTLOCATION

GETSOURCEMIRROREDVOLUMES

GETTARGETMIRROREDVOLUMES

GETVOLUMEDRVSTATE

GETVOLUMEINFO

ISBREAKUSERREQUESTED

ISPOTENTIALMIRRORVOL

LOCKVOLUME

MERGETARGETBITMAP

PAUSEMIRROR

PREPARETOBECOMETARGET

READREGISTRY

RESTARTVOLUMEPIPE

RESYNCMIRROR

SETBLOCKTARGET

SETCONFIGURATION

SETSNAPSHOTLOCATION

STOPSERVICE

SWITCHOVERVOLUME

TAKESNAPSHOT

UNLOCKVOLUME

UPDATEJOB

UPDATEVOLUMEINFO

Feedback

Was this helpful?

Yes No
You indicated this topic was not helpful to you ...
Could you please leave a comment telling us why? Thank you!
Thanks for your feedback.

Post your comment on this topic.

Post Comment