Registry Entries - SIOS

Registry Entries that MAY be Modified

HKEY_LOCAL_MACHINE\SYSTEM

     \CurrentControlSet

          \Services

               \ExtMirr

                    \Parameters

                        \Volumes

                            \{Volume GUID}

                                \Targets

                                    \{Target IP}

The SteelEye DataKeeper driver uses the Parameters key and those below it. The values within the Parameters key (denoted with *) are global for all volumes on the system. The values under each of the Target IP registry keys (denoted with †) are specific to a mirror only. Values denoted with both * and † appear under both keys. (The target-specific value overrides the global value in this case.)

BandwidthThrottle † 

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\Volumes\{Volume GUID}\Targets\{Target IP}\BandwidthThrottle
Name Type Default Data
BandwidthThrottle  REG_DWORD 0
Specifies the maximum amount of network bandwidth (in kilobits per second) that a particular mirror is allowed to use. A value of 0 means unlimited.

 

BitmapBaseDir*

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\BitmapBaseDir
Name Type Default Data
BitmapBaseDir REG_SZ C:\%EXTMIRRBASE%\Bitmaps (usually C:|Program Files\SteelEye\DataKeeper\Bitmaps but may be different when upgrading a system or if you install SteelEye DataKeeper to a different path)
Specifies a directory where SteelEye DataKeeper stores its Intent Log files. (Note: The drive letter must be in uppercase.) To disable the intent log feature, clear this registry entry (set it to an empty string) on all current and potential mirror endpoint servers. Disabling the intent log requires a reboot on each of these systems in order for this setting to take effect.

 

CompressionLevel †

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\Volumes\{Volume GUID}\Targets\{Target IP}\CompressionLevel
Name Type Default Data
CompressionLevel REG_DWORD 0
Specifies the compression level for the given mirror.  Valid values are 0 to 9.  Level 0 is "no compression". Values from 1 to 9 specify increasingly CPU-intensive levels of compression.  Compression level 1 is a "fast" compression - it does not require as much CPU time to compress the data, but results in larger (less compressed) network packets.  Level 9 is the maximum amount of compression - it results in the smallest network packets but requires the most CPU time.  The level can be set to somewhere in between, to balance CPU usage and network efficiency based on your system, network and workload. 

 

DontFlushAsyncQueue * 

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\DontFlushAsyncQueue
Name Type Default Data
DontFlushAsyncQueue REG_SZ empty <drive letter> [<drive letter>]
Allows the user to specify a volume or volumes that should not flush their async queues when the driver receives a flush request. This value should contain the drive letter(s) of the volume(s) to which this applies. Drive letters may be adjacent to each other (i.e. XY), or space separated (i.e. X Y), with no colons. After updating this registry value, execute the READREGISTRY command so that DataKeeper immediately starts using the new value. (Note: When setting DontFlushAsyncQueue, data and database logs should be on the same partition.)

 

PingInterval *

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\PingInterval
Name Type Default Data
PingInterval REG_DWORD 3000 (0xBB8)
Specifies the interval in milliseconds between pings. Use a higher value for Wide Area Networks (WANs) or unreliable networks.  Along with the MaxPingMisses, you may customize them to adjust mirroring to the network performance.

 

MaxResyncPasses *

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\MaxResyncPasses
Name Type Default Data
MaxResyncPasses REG_DWORD 200 (0xc8)
Specifies the maximum number of resync passes before SteelEye DataKeeper will give up trying to resynchronize the mirror while there is traffic on the source volume.  In every pass, SteelEye DataKeeper marks the volume blocks that were written to during the pass.  In the next pass, it will send to the target only the marked blocks.

 

TargetPortBase *

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\TargetPortBase
Name Type Default Data
TargetPortBase REG_DWORD 10000

Specifies the base TCP port number for target volume connections. This number may need to be adjusted if the default port is used by another service or is blocked by a firewall. The actual port that the target listens on is calculated as follows:

Port = TargetPortBase + (Volume Letter - A:)

For example:

TargetPortBase = 10000

Volume Letter = HPort = 10000 + (H: -A:) = 10007

 

TargetPortIncr *

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\TargetPortIncr
Name Type Default Data
TargetPortIncr REG_DWORD 256
Specifies the increment to the base TCP port number.  This is used only when a TCP port is found to be in use.  For example, if the target is attempting to listen on port 10005 and that port is in use, it will retry listening on port 10005 + TargetPortIncr

 

TargetDispatchPort * †

Locations:

On Target System:HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\TargetDispatchPort

On Source System Creating Mirror to Above Target: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\TargetDispatchPort

AND

HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\Volumes\{Volume GUID}\Targets\(Target IP}\TargetDispatchPort

Name Type Default Data
TargetDispatchPort REG_DWORD 9999

There are two places where this should be set if you are changing the dispatch port from 9999. On the target system, place it in the ExtMirr\Parameters key. The new setting will apply to all existing and new targets on that server. A target reboot is required when the target Parameters key has been changed for this setting to take effect. On any source system that will be creating the mirror to this target, place it in the ExtMirr\Parameters key and also in the ExtMirr\Parameters\Targets\{TargetIP} key if the mirror already exists. Note: Make sure the ports are the SAME on both the source and the target.

A firewall port must also be opened manually on all source and target servers for the new dispatch port to work.

 

WriteQueueHighWater * †

Note: Do not change this value while the mirror is actively being resynced; you must pause the mirror prior to changing this value.

Locations:

For New Mirrors: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\WriteQueueHighWater

AND

For Existing Mirrors: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\Volumes\{Volume GUID}\Targets\{Target IP}\WriteQueueHighWater

Note: If editing this entry under Parameters, all NEW mirrors created will inherit this value. If editing this entry under Target, the value pertains to that one Target only. Any Target values override Parameter values.
Name Type Default Data
WriteQueueHighWater REG_DWORD 20000 (0x4e20)

Specifies the high water mark of the asynchronous write queue. During intensive I/O traffic, if the queue length reaches this value, the SteelEye DataKeeper driver momentarily pauses the mirror, drains the queue and automatically starts a partial resync. This value represents the number of write requests in the queue, not the number of bytes. After updating this registry value, execute the READREGISTRY command so that DataKeeper immediately starts using the new value.

Note: This value depends on the available memory in the system. You can monitor the mirroring behavior using the SteelEye DataKeeper Performance Monitor counters and set this value accordingly.

 

WriteQueueLowWater*†

Note: Do not change this value while the mirror is actively being resynced; you must pause the mirror prior to changing this value. Do not set this value higher than WriteQueueHighWater.

Locations:

For New Mirrors: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\WriteQueueLowWater

AND

For Existing Mirrors: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\Volumes\{Volume GUID}\Targets\{Target IP}\WriteQueueLowWater

Note: If editing this entry under Parameters, all NEW mirrors created will inherit this value. If editing this entry under Target, the value pertains to that one Target only. Any Target values override Parameter values.
Name Type Default Data
WriteQueueLowWater REG_DWORD 150 (0x96)

This value is used to specify the maximum number of resync block requests that can be queued up at the same time. Changing this value may change the speed of mirror resynchronizations - a higher value often leads to a faster resync at the cost of increased memory usage during resync. The value specified in WriteQueueLowWater is half the number of resync block requests. After updating this registry value, execute the READREGISTRY command so that DataKeeper immediately starts using the new value.

 

SnapshotLocation *

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\Volumes\{Volume GUID}\SnapshotLocation
Name Type Default Data
SnapshotLocation REG_SZ <drive letter>
Specifies the folder where the target snapshot file for this volume will be stored.

 

TargetSnapshotBlocksize *

Location: HKEY_LOCAL_MACHINE\SYSTEM\<CurrentControlSet>\Services\ExtMirr\Parameters\Volumes\{Volume GUID}\TargetSnapshotBlocksize
Name Type Default Data
TargetSnapshotBlocksize REG_DWORD None

DataKeeper target snapshot uses a default block size of 64KB for all entries that are written to the snapshot file. This block size can be modified by creating this TargetSnapshotBlocksize registry key.

The value should always be set to a multiple of the disk sector size, which is usually 512 bytes. Certain workloads and write patterns can benefit from changing the block size. For example, a volume that is written in a sequential stream of data (e.g. SQL Server log files) can benefit from a larger block size. A large block size results in fewer reads from the target volume when consecutive blocks are written. But a volume that is written in a random pattern may benefit from a smaller value or the default 64KB. A smaller block size will result in less snapshot file usage for random write requests.

 

Tag » What Does Reg_sz Stand For