Datakeeper Cluster Edition for Windows Technical Documentation
Total Page:16
File Type:pdf, Size:1020Kb
SteelEye DataKeeper Cluster Edition v7.5 Technical Documentation December 2012 This document and the information herein is the property of SIOS Technology Corp. (previously known as SteelEye® Technology, Inc.) and all unauthorized use and reproduction is prohibited. SIOS Technology Corp. makes no warranties with respect to the contents of this document and reserves the right to revise this publication and make changes to the products described herein without prior notification. It is the policy of SIOS Technology Corp. to improve products as new technology, components and software become available. SIOS Technology Corp., therefore, reserves the right to change specifications without prior notice. LifeKeeper, SteelEye and SteelEye DataKeeper are registered trademarks of SIOS Technology Corp. Other brand and product names used herein are for identification purposes only and may be trademarks of their respective companies. To maintain the quality of our publications, we welcome your comments on the accuracy, clarity, organization, and value of this document. Address correspondence to: [email protected] Copyright © 2012 By SIOS Technology Corp. San Mateo, CA U.S.A. All rights reserved Table of Contents All SteelEye DataKeeper Cluster Edition Documentation xviii Introduction xviii New Features of SteelEye DataKeeper Cluster Edition v7 xviii Bug Fixes xxi Product Definitions and Platforms xxii Product Requirements xxii Requirements for Windows 2008 xxiii Known Issues xxiii SCVMM 2012 xxiii Windows Server 2012 xxiii DataKeeper Cluster Edition Quick Start Guide xxiv DataKeeper Cluster Edition Quick Start Guide xxiv Prerequisites and Installation xxiv Configuration xxiv 2-Node Replicated Cluster xxv 3- or 4-Node Multi-Site Cluster with Mixed Shared/Replicated Storage xxvi Management xxvii Troubleshooting xxvii Chapter 1: Introduction 1 DataKeeper with High Availability - Cluster Edition Overview 1 Features 2 User Interface 2 SteelEye DataKeeper User Interface 2 DataKeeper Components 3 DataKeeper Service Log On ID and Password Selection 4 Table of Contents i Understanding Replication 8 How SteelEye DataKeeper Works 8 User Accounts and Domain Considerations 9 SteelEye DataKeeper Intent Log 10 Non-Shared Volumes 10 Shared Volumes 10 Configuration Issue 11 Relocation of Intent Log 11 SteelEye DataKeeper Resynchronization 11 Initial Creation of a Mirror 12 Example: Whitespace Elimination 12 Synchronous and Asynchronous Mirroring 12 Synchronous Mirroring 13 Asynchronous Mirroring 15 Mirror PAUSED 17 Mirror RESYNCING 18 Read and Write Operations 19 Volume Considerations 20 What Volumes Cannot be Mirrored 20 Volume Size Considerations 21 Specifying Network Cards for Mirroring 21 Dedicated LAN for Replication 21 Performance Monitor Counters 21 Mirror State Counters 22 Mirror Elapsed Time 22 Mirror State 22 Mirror Type 23 Network Number of Reconnects 23 Write Queue Counters 23 Queue Current Length 23 ii Table of Contents Queue High Water 23 Queue Low Water 24 Resynchronization Control Counters 24 Resync Current Block 24 Resync Dirty Blocks 24 Resync Elapsed Time 24 Resync New Writes 25 Resync Pass 25 Resync Total Blocks 25 Resync Phase 25 Chapter 2: Installation 27 Chapter 3: Configuration 28 Requirements/Considerations 28 Sector Size 28 Network Bandwidth 28 Determine Network Bandwidth Requirements 28 Measuring Rate of Change 29 Network Adapter Settings 29 User Accounts and Domain Considerations 30 Firewall Configurations 32 Configuring Microsoft's Windows Firewall with Advanced Security - Example 32 High-Speed Storage Best Practices 36 Configure Bitmaps 36 Disk Partition Size 36 Increase the WriteQueueLowWater Tunable 37 Handling Unmanaged Shutdown Issues 38 Other Recommendations/Suggestions 38 WAN Considerations 38 Initial Synchronization of Data Across the LAN or WAN 39 Verifying Data on the Target Volume 41 Table of Contents iii Compression 41 Bandwidth Throttle 42 Chapter 4: Administration 43 DataKeeper Event Log Notification 43 Primary Server Shutdown 44 Secondary Server Failures 44 Extensive Write Considerations 45 CHKDSK Considerations 45 DKSUPPORT 45 Event Log Considerations 45 Using Disk Management 46 Registry Entries 46 Registry Entries that MAY be Modified 46 BandwidthThrottle † 47 BitmapBaseDir* 47 CompressionLevel † 47 DontFlushAsyncQueue * 48 PingInterval * 48 MaxResyncPasses * 48 TargetPortBase * 49 TargetPortIncr * 49 TargetDispatchPort * † 50 WriteQueueHighWater * † 51 WriteQueueLowWater*† 52 Registry Entries that SHOULD NOT be Modified 52 ErrorControl 53 DisplayName 53 ImagePath 53 Start 54 Type 54 iv Table of Contents ErrorControl 54 Group 55 Start 55 Tag 55 Type 55 BuildDate 56 BuildTime 56 LastStartTime 56 Version 57 BitmapFileValidOnFailover 57 Failover 58 MirrorRole 58 VolumeAttributes 58 BitmapFileEnabled 59 BitmapFileValid 59 Enabled 60 TargetDriveLetter 60 SourceDriveLetter 61 MirrorState 61 MirrorType 62 CleanShutdown 62 BreakUserRequested 62 RemoteName 63 Using EMCMD with SteelEye DataKeeper 63 Mirror State Definitions 63 BREAKMIRROR 64 EMCMD <system> BREAKMIRROR <volume letter> [<targetsystem>] 64 CHANGEMIRRORENDPOINTS 64 EMCMD <system> CHANGEMIRRORENDPOINTS <volume letter> <old target IP> <new source IP> <new target IP> 64 1x1 Mirror CHANGEMIRRORENDPOINTS Command Example 65 Table of Contents v 2x1 Mirror CHANGEMIRRORENDPOINTS Command Example 66 1x1x1 Mirror CHANGEMIRRORENDPOINTS Command Example 67 CLEARASR_OK 68 EMCMD <system> CLEARASR_OK <volume> [<target_ip>] 68 CLEARSWITCHOVER 68 EMCMD <system> CLEARSWITCHOVER <volume letter> 68 CONTINUEMIRROR 69 EMCMD <system> CONTINUEMIRROR <volume letter> [<target system>] 69 CREATEJOB 69 EMCMD <system> CREATEJOB <JobName> <Description><SysName1> <DrvLet- ter1> <IP1> <SysName2><DrvLetter2> <IP2> <MirrorType> ... 69 CREATEMIRROR 69 EMCMD <system> CREATEMIRROR <volume letter> <target system> <type> [options] 69 DELETEJOB 70 EMCMD <system> DELETEJOB [<JobId>] 70 DELETELOCALMIRRORONLY 71 EMCMD <system> DELETELOCALMIRRORONLY <volume letter>[<target system>] 71 DELETEMIRROR 71 EMCMD <system> DELETEMIRROR <volume letter> [<target system>] 71 GETASR_OK 71 EMCMD <system> GETASR_OK <volume letter> <target_ip> 71 GETCOMPLETEVOLUMELIST 72 EMCMD <system> GETCOMPLETEVOLUMELIST 72 GETCONFIGURATION 72 EMCMD <system> GETCONFIGURATION <volume letter> 72 GETEXTENDEDVOLUMEINFO 73 EMCMD <system> GETEXTENDEDVOLUMEINFO <volume letter> 73 GETJOBINFO 73 EMCMD <system> GETJOBINFO [<JobId>] 73 GETMIRRORTYPE 74 vi Table of Contents EMCMD <system> GETMIRRORTYPE <volume letter> 74 GETJOBINFOFORVOL 74 EMCMD <system> GETJOBINFOFORVOL <DrvLetter>[<FullSysname>|<IP>] 74 GETMIRRORVOLINFO 74 EMCMD <system> GETMIRRORVOLINFO <volume letter> 74 GETREMOTEBITMAP 75 EMCMD <system> GETREMOTEBITMAP <volume letter> <targetsystem> <local file> 75 GETRESYNCSTATUS 75 EMCMD <system> GETRESYNCSTATUS <volume letter> 75 GETSERVICEINFO 77 EMCMD <system> GETSERVICEINFO 77 GETSOURCEMIRROREDVOLUMES 77 EMCMD <system> GETSOURCEMIRROREDVOLUMES 77 GETTARGETMIRROREDVOLUMES 79 EMCMD <system> GETTARGETMIRROREDVOLUMES 79 GETVOLUMEDRVSTATE 79 EMCMD <system> GETVOLUMEDRVSTATE <volume letter> 79 GETVOLUMEINFO 81 EMCMD <system> GETVOLUMEINFO <volume letter> <level> 81 ISBREAKUSERREQUESTED 82 EMCMD <system> ISBREAKUSERREQUESTED <volume letter> 82 ISPOTENTIALMIRRORVOL 82 EMCMD <system> ISPOTENTIALMIRRORVOL <volume letter> 82 LOCKVOLUME 83 EMCMD <system> LOCKVOLUME <volume letter> 83 MERGETARGETBITMAP 83 EMCMD <system> MERGETARGETBITMAP <volume letter> <target system> 83 PAUSEMIRROR 83 EMCMD <system> PAUSEMIRROR <volume letter> [<target system>] 83 PREPARETOBECOMETARGET 84 Table of Contents vii EMCMD <system> PREPARETOBECOMETARGET <volume letter> 84 READREGISTRY 85 EMCMD <system>READREGISTRY <volume letter> 85 REGISTERCLUSTERVOLUME 85 EMCMD <system> REGISTERCLUSTERVOLUME <volume letter> 85 RESTARTVOLUMEPIPE 85 EMCMD <system> RESTARTVOLUMEPIPE <volume letter> 85 RESYNCMIRROR 86 EMCMD <system> RESYNCMIRROR <volume letter> [<target system>] 86 SETASR_OK 86 EMCMD <system> SETASR_OK <volume> [<target_ip>] 86 SETCONFIGURATION 87 EMCMD <system> SETCONFIGURATION <volume letter><configuration mask> 87 STOPSERVICE 88 EMCMD <system> STOPSERVICE 88 SWITCHOVERVOLUME 88 EMCMD <system> SWITCHOVERVOLUME <volume letter> [-f] 88 UNLOCKVOLUME 89 EMCMD <system> UNLOCKVOLUME <volume letter> 89 UPDATEJOB 89 EMCMD <system> UPDATEJOB <JobId> <Name> <Descr>[<SysName1> <DrvLet- ter1> <IP1> <SysName2><DrvLetter2> <IP2> <MirrorType>]... 89 UPDATEVOLUMEINFO 89 EMCMD <system> UPDATEVOLUMEINFO <volume letter> 89 Chapter 5: User Guide 91 Getting Started 91 Choose Your Configuration 91 Disk-to-Disk 91 One-to-One 92 One-to-Many (Multiple Targets) 94 Many-to-One 95 viii Table of Contents N-Shared-Disk Replicated to One 96 DataKeeper Standalone 97 DataKeeper & Failover Clustering 97 N-Shared-Disk Replicated to N-Shared-Disk 97 DataKeeper Standalone 98 DataKeeper & Failover Clustering 99 N-Shared-Disk Replicated to Multiple N-Shared-Disk Targets 99 DataKeeper Standalone 100 DataKeeper & Failover Clustering 100 Setting Up SteelEye DataKeeper 100 Connecting to a Server 101 Disconnecting from a Server 101 Creating a Job 102 Configuring Mirrors 102 Creating a Mirror 102 Creating the Mirror 102 Creating Mirrors With Shared Volumes 103 Safe Creation of a Shared-Storage Volume Resource 106 Creating Mirrors With Multiple Targets 107 Switchover and Failover with Multiple Targets 108 Manual Switchover to a Target Server 109 Source Server Failure - Manual Switchover to a Target Server 110 Working With Jobs 111 Jobs 111 Renaming a Job 112 Deleting a Job 113 Reassigning a Job 113 Switching