Endurance FTvirtual Server Commands

Transcription

1 Endurance FTvirtual Server Commands Marathon Technologies Corporation Fault and Disaster Tolerant Solutions for Windows Environments Release June 2005

2 NOTICE Marathon Technologies Corporation reserves the right to make improvements to this guide and the product it describes at any time and without further notice. COPYRIGHT Marathon Technologies Corporation All rights reserved. This guide is copyrighted, and all rights are reserved. No part of this guide or the products it describes may be reproduced by any means or in any form, without prior consent in writing from Marathon Technologies Corporation. Printed in the U.S.A. U.S. Patent Numbers: 5,600,784; 5,615,403; 5,787,485; 5,790,397; 5,896,523; 5,956,474; 5,983,371; 6,038,685; 6,205,565; and 6,728,898. European Patent Numbers: EP ; EP ; EP ; EP ; and EP Other patents pending. SOFTWARE COPYRIGHT NOTICE The software described in this document is covered by the following copyright: Marathon Technologies Corporation TRADEMARK NOTICE Endurance, Marathon Assured Availability, SplitSite, Marathon FTvirtual Server, and the Marathon logo are either registered trademarks or trademarks of Marathon Technologies Corporation in the United States and/or other countries. Microsoft, MS-DOS, and Windows are registered trademarks of Microsoft Corporation in the United States and/or other countries. All other brands and product names are trademarks of their respective companies or organizations. SOFTWARE REVISION The revision of the software that this document supports is Revision Marathon Technologies Corporation, Inc. 295 Foster Street, Littleton, MA (978) or (888) ii

3 Contents Preface Chapter 1 Introduction to Endurance Commands Issuing Endurance MTCCONS Commands Verifying Endurance MTCCONS Commands MTCCONS Command Summary Chapter 2 Endurance_Configuration Commands Chapter 3 FTvirtual_Server Commands Chapter 4 Virtual_Server Commands Chapter 5 CoServer Commands Chapter 6 CoServerLink Commands Chapter 7 DatagramService Commands Chapter 8 Disk Commands Chapter 9 Ethernet Commands Chapter 10 Provider Commands CoServern.EthernetProvider Commands CoServern.EventProvider Commands CoServern.InputProvider Commands CoServern.ProviderAPI Commands Contents iii

4 CoServern.ScsiProvider Commands Chapter 11 SCP Commands Chapter 12 Management Commands Chapter 13 Quorum Manager Commands iv Endurance FTvirtual Server Commands

5 Preface This manual lists and describes the Endurance FTvirtual Server commands. Audience This manual is written for experienced technical personnel responsible for installing, configuring, administering, and managing network server hardware and software, including Microsoft Windows. This manual assumes that you are familiar with the Endurance terminology. Endurance Documentation Set The Endurance FTvirtual Server documentation is available online in the \Docs directory on the CD that was shipped with your Endurance server. If you have installed the documentation, you can launch the online manuals from the Windows Start menu by selecting Start All Programs Marathon Endurance Documentation (for Windows 2003) or Start Programs Marathon Endurance Documentation (for other versions of Windows). For note-taking purposes, we recommend that you print the Endurance documentation and any other manuals you expect to use. The online manuals are in Acrobat.pdf format; to read or print them, you need Acrobat Reader installed. Preface v

6 Endurance Manuals The Endurance manuals include: Endurance FTvirtual Server Administrator s Guide (Admin.pdf), which describes how to manage and administer the Endurance FTvirtual Server and use its related Endurance tools and utilities; and provides complete documentation of the Endurance SNMP software and MIB files. Endurance FTvirtual Server Commands (Commands.pdf), which lists and describes the Endurance FTvirtual Server commands used with the MTCCONS utility within scripts you write. Endurance FTvirtual Server Configuration and Installation Guide (Install.pdf), which explains how to configure the Endurance FTvirtual Server and install the software. Endurance FTvirtual Server Messages (Messages.pdf), which lists and describes the Endurance FTvirtual Server messages that may be displayed or are written to the Windows Event Logs. Endurance Release Notes (ReleaseNotes.pdf), which describes release-specific information, installation requirements, release considerations and limitations, and information that is not documented in the Endurance documentation set. Getting Started with Endurance FTvirtual Server (GettingStarted.pdf), which introduces the architecture and the general concepts of the Endurance FTvirtual Server. Upgrading Endurance Software to Release 6.1 (Upgrade.pdf), which explains how to upgrade the Endurance Release 5.0.1or 6.0. software to Endurance Release 6.1. Glossary (Glossary.pdf), which lists and defines the Endurance terminology. vi Endurance FTvirtual Server Commands

7 Conventions The following conventions are used in the Endurance documentation set: Convention Italics, Courier font Bold, Courier font Description Indicates a variable that you replace in a path name or command Indicates actions or commands that you must type. For example, type A:\ETX Courier font Represents examples of screen text. For example, scsiid = 0, 1. Bold Italics Blue text Caution Warning Is used to: Emphasize important information. Indicate menu, pathname, or button selections. Indicate actions you perform. Is used to: Highlight the state of the Endurance server component. Refer to manual, chapter, or section titles. (Available only in online documentation.) Indicates a hyperlink (cross-reference to another section of the Endurance documentation set). Clicking on the link takes you to the appropriate place in the documentation set. Is used to indicate procedures you should not perform or situations you should avoid in order to avoid personal injury. Is used to indicate procedures or actions that could cause file or data corruption, loss of data, or damage to server components. Unless noted otherwise, all cross-references are to chapters and pages within this book. Comments About the Documentation If you notice an error in or omission from the documentation, if you have suggestions for future releases of the documentation, or if you have any other documentation comments, please send to documentation@marathontechnologies.com. Preface vii

8 For Technical Support For technical support, contact your certified Endurance FTvirtual Server support provider. You can also consult the Marathon Support web site at for additional documentation and information. Refer to the section For Technical Support for detailed information about the contents of the Support web site. Login to the Support web site using your license key number. Additional Information on the Support Web Site Visit the Support web site at to obtain the most recent updates to information about the release, including: Tested Server List Supported Windows Service Packs Supported operating systems on which you can run the Endurance Manager remotely Qualified language variations Tools and utilities available for problem diagnosis and resolution Packaging of event logs and.hrl files for transmission to Marathon for analysis and problem resolution Technical Information Knowledgebase Documentation of other versions of Endurance software viii Endurance FTvirtual Server Commands

9 Introduction to Endurance Commands 1 This guide describes Endurance FTvirtual Server commands invoked from the MTCCONS utility. This chapter assumes that you are familiar with Endurance terminology. This chapter describes the Endurance MTCCONS commands in alphabetical order in the following sections: Issuing Endurance MTCCONS Commands Verifying Endurance MTCCONS Commands MTCCONS Command Summary Introduction to Endurance Commands 1-1

10 Issuing Endurance MTCCONS Commands You issue Endurance commands using the MTCCONS utility in an MS-DOS window. You use the utility primarily within scripts to execute system tests or routine system management activities. For efficiency, we recommend that you set your current directory to the Marathon Endurance area in Program Files before using MTCCONS commands. When using MTCCONS, enter the command syntax and any required parameters. Each command has the following components: Prefix, Target, Verb, Operation type, Executed from and any associated Parameters. For example: MTCCONS VirtualServer1 Remove From Configuration From CoServer2 -disable_safeguard Prefix Target* Verb* Operation Type Executed from Parameter * Target and Verb are not order dependent. The command line syntax allows you to enter target, then verb, or vice versa. To use MTCCONS commands, you must enter MTCCONS as the Prefix for every Endurance console command. Depending on the command, the other fields vary. Table 1-1 lists and describes the MTCCONS parameters. Table 1-1 MTCCONS Parameters Parameter Description -a Appends data to a file -all -desc -height Shows all data fields Prints a description of the command Screen buffer height -o Writes data to a file -disable_safeguard Allows you to execute commands that may compromise the availability of the FTvirtual Server. For example, you might remove the only active CoServer from the Endurance Configuration. -v Verbose displays output labels, values, and units -width Screen buffer width 1-2 Endurance FTvirtual Server Commands

11 Table 1-1 MTCCONS Parameters (Continued) Parameter interval flag Description Integer from 0 to n True = on; False = off When issuing MTCCONS commands, note the following: An example of a command line is MTCCONS Show CoServer1.SCP Computer Names The MTCCONS syntax is not case sensitive. You can use abbreviated syntax by entering the minimum characters that make the command unique. For example, for the CoServer Enable command, you can type either: MTCCONS CoServern Enable Operation From CoServerx MTCCONS CoServern E O From CoServerx To access MTCCONS command help, type a question mark (?). General command help and specific command help is available. For example, to list all commands, type: MTCCONS? To run MTCCONS on a remote workstation, you must install the Endurance Manager on the remote workstation. Once the program is installed and subject to the same security requirements that apply to the Endurance Manager, you execute a command by typing: MTCCONS \\computername command where computername is the name of the node you want to access (e.g., CoServer1) and command is the command you want to execute. You must enter the backslashes (\\) where shown in this example. The complete command syntax for invoking an MTCCONS command is documented in the section of each command. Refer to Table 1-1 for MTCCONS information, including a description of the MTCCONS parameters. Using the MTCCONS utility, you can issue commands from: The FTvirtual Server operating system environment A CoServer that is active in the Endurance Configuration A properly configured remote workstation that is running the Endurance Manager Introduction to Endurance Commands 1-3

12 Verifying Endurance MTCCONS Commands After issuing an Endurance MTCCONS command, you can verify that it executed successfully by completing one of the following. Use the Endurance Manager to make sure that the status of the Endurance component reports the state that you expect. Verify that the expected output is displayed in the command output window. If you issued a Set command, you can execute the corresponding Show command to verify that the command was executed as expected. Use the Windows Event Viewer to check for a message describing that the operation was completed by operator request. 1-4 Endurance FTvirtual Server Commands

13 MTCCONS Command Summary In this manual, the MTCCONS commands are grouped in chapters by components on which the commands act, as listed in Table 1-2: Table 1-2 Endurance MTCCONS Commands To Operate on Component... Refer to Chapter... Endurance Configuration Chapter 2 FTvirtual Server Chapter 3 Virtual Server Chapter 4 CoServer Chapter 5 CoServer Link Chapter 6 CoServer Datagram Chapter 7 CoServer Disk Chapter 8 CoServer Ethernet Chapter 9 CoServer Providers Chapter 10 CoServer SCP Chapter 11 Management Chapter 12 Quorum Manager Chapter 13 Introduction to Endurance Commands 1-5

14 1-6 Endurance FTvirtual Server Commands

15 Endurance_Configuration Commands 2 This chapter lists and describes the MTCCONS commands that perform operations in the Endurance Configuration environment. Table 2-1 lists the Endurance_Configuration commands. Table 2-1 Endurance_Configuration Commands Command Page Endurance_Configuration Set Preferred CoServer 2-2 Endurance_Configuration Show Preferred CoServer 2-2 Endurance_Configuration Shutdown Operation 2-3 Endurance_Configuration Shutdown Operation without CoServer Reboot 2-3 Endurance_Configuration Commands 2-1

16 Endurance_Configuration Set Preferred CoServer This command specifies the CoServer that should be preserved, if possible, when the Endurance software must choose a CoServer to remove when a system fault occurs. For example, if the CoServer Link becomes unusable and one CoServer must be removed, the Endurance software uses this setting to determine which CoServer to preserve. The preferred CoServer may still be removed if any attached devices are not functional, or if the non-preferred CoServer has more Active physical network adapters. By default, there is no preferred CoServer. Variables MTCCONS Endurance_Configuration Set Preferred CoServer n from CoServerm n The ID of the CoServer (1 or 2) that is to be preserved during a system failure, if possible, or zero to indicate no preference. m the ID of the CoServer (1 or 2) to which you are directing the command The preferred CoServer ID is set. The setting is preserved when the CoServer and Endurance Configuration reboot. Endurance_Configuration Show Preferred CoServer Endurance_Configuration Show Preferred CoServer This command shows the setting of the CoServer that should be preserved, if possible, when the Endurance software must choose a CoServer to remove when a system fault occurs. By default, there is no preferred CoServer. Variables MTCCONS Endurance_Configuration Show Preferred CoServer from CoServerm m the ID of the CoServer (1 or 2) to which you are directing the command The preferred CoServer ID is displayed. Possible values are 1 (CoServer1), 2 (CoServer2) or 0 (neither CoServer). Endurance_Configuration Set Preferred CoServer 2-2 Endurance FTvirtual Server Commands

17 Endurance_Configuration Shutdown Operation This command initiates a shutdown of the FTvirtual Server operating system, and then a shutdown of each active CoServer. After the CoServers shut down, they immediately begin to reboot, and then the FTvirtual Server operating system also reboots. Variables MTCCONS Endurance_Configuration Shutdown Operation from CoServern n the ID of the CoServer (1 or 2) to which you are directing the command If the FTvirtual Server operating system is active, this command begins the shutdown process. First it shuts down the FTvirtual Server operating system, followed by a shutdown of each active CoServer. After all components shut down, they immediately begin the reboot process. If you do not want the Endurance Configuration to reboot automatically, invoke the command Endurance_Configuration Shutdown Operation from CoServern without CoServer Reboot instead of this command. Endurance_Configuration Shutdown Operation without CoServer Reboot Endurance_Configuration Shutdown Operation without CoServer Reboot This command initiates a shutdown of the FTvirtual Server operating system, and then a shutdown of each active CoServer. After the CoServers shut down, they do not reboot. Variables MTCCONS Endurance_Configuration Shutdown Operation without CoServer Reboot from CoServern n the ID of the CoServer to which you are directing the command. If the FTvirtual Server operating system is active, this command begins the shutdown process. First it shuts down the FTvirtual Server operating system, followed by a shutdown of each active CoServer. After all components shut down, they do not reboot. If you want the Endurance Configuration to reboot automatically, invoke the command Endurance_Configuration Shutdown Operation from CoServern instead of this command. Endurance_Configuration Shutdown Operation Endurance_Configuration Commands 2-3

18 2-4 Endurance FTvirtual Server Commands

19 FTvirtual_Server Commands 3 The FTvirtual_Server commands perform operations that act on the FTvirtual Server operating system or that permit the FTvirtual Server operating system to have or display particular characteristics and settings. Table 3-1 lists the FTvirtual_Server commands. Table 3-1 FTvirtual_Server Commands Command Page FTvirtual_Server Disable Auto Boot 3-3 FTvirtual_Server Disable Auto Resynch 3-3 FTvirtual_Server Disable Background Synchronization 3-4 FTvirtual_Server Disable Foreground-only Synchronization 3-4 FTvirtual_Server Enable Application Mode 3-5 FTvirtual_Server Enable Auto Boot 3-5 FTvirtual_Server Enable Auto Resynch 3-6 FTvirtual_Server Enable Background Mode 3-6 FTvirtual_Server Enable Background Synchronization 3-7 FTvirtual_Server Enable Foreground-only Synchronization 3-7 FTvirtual_Server Set Background Synchronization Timeout 3-8 FTvirtual_Server Show Auto Boot 3-8 FTvirtual_Server Show Auto Resynch 3-9 FTvirtual_Server Show Background Synchronization Parameters 3-10 FTvirtual_Server Show Parameters 3-11 FTvirtual_Server Commands 3-1

20 Table 3-1 FTvirtual_Server Commands Command Page FTvirtual_Server Show Settings 3-12 FTvirtual_Server Shutdown Operation 3-12 FTvirtual_Server Shutdown Operation Without Reboot 3-13 FTvirtual_Server Start Boot 3-13 FTvirtual_Server Start Boot on Preferred Virtual Server 3-14 FTvirtual_Server Start Boot on Specified Virtual Server 3-14 FTvirtual_Server Start Resynch Endurance FTvirtual Server Commands

21 FTvirtual_Server Disable Auto Boot This command disables the FTvirtual Server operating system from booting automatically when the CoServers start. By default, Auto Boot is true (enabled). Variables MTCCONS FTvirtual_Server Disable Auto Boot From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command To verify that Auto Boot has been disabled for the FTvirtual Server operating system, issue a FTvirtual_Server Show Auto Boot or FTvirtual_Server Show Parameters command from either CoServer. FTvirtual_Server Enable Auto Boot FTvirtual_Server Show Auto Boot FTvirtual_Server Show Parameters FTvirtual_Server Disable Auto Resynch This command disables the FTvirtual_Server operating system from resynchronizing automatically after a Virtual Server is removed. By default, Auto Synch is true (enabled). Variables MTCCONS FTvirtual_Server Disable Auto Resynch From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command To verify that Auto Resynch has been disabled for the FTvirtual Server operating system, issue a FTvirtual_Server Show Auto Resynch or FTvirtual_Server Show Parameters command from either CoServer. FTvirtual_Server Disable Auto Boot FTvirtual_Server Enable Auto Resynch FTvirtual_Server Show Auto Boot FTvirtual_Server Show Parameters FTvirtual_Server Commands 3-3

22 FTvirtual_Server Disable Background Synchronization This command disables background synchronization for the FTvirtual Server. When background synchronization is disabled, FTvirtual Server operations pause during the entire synchronization process. By default, background synchronization is true (enabled). Variables MTCCONS FTvirtual_Server Disable Background Synchronization From CoServern n the ID number of the CoServer (1 or 2) from which you are directing the command To verify that background synchronization has been disabled for the FTvirtual Server, issue a FTvirtual_Server Show Background Synchronization command from either CoServer. FTvirtual_Server Enable Background Synchronization FTvirtual_Server Show Background Synchronization Parameters FTvirtual_Server Disable Foreground-only Synchronization When background synchronization times out repeatedly, this command determines that synchronization is retried repeatedly but much less frequently. Variables MTCCONS FTvirtual_Server Disable Foreground-only Synchronization From CoServern n the ID number of the CoServer (1 or 2) from which you are directing the command After background synchronization has timed out multiple times, synchronization is tried much less frequently until it succeeds. FTvirtual_Server Enable Foreground-only Synchronization FTvirtual_Server Show Background Synchronization Parameters 3-4 Endurance FTvirtual Server Commands

23 FTvirtual_Server Enable Application Mode This command sets the FTvirtual Server operating system to operate to the benefit of applications that are installed on the FTvirtual Server operating system. Variables MTCCONS Virtual_FTsever Enable Application Mode From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command After this command takes effect, the FTvirtual Server operating system operates most efficiently for applications installed and running in the FTvirtual Server operating system space. FTvirtual_Server Enable Background Mode FTvirtual_Server Enable Auto Boot This command enables the FTvirtual Server operating system to boot automatically when the CoServers start. By default, Auto Boot is true (enabled). Variables MTCCONS FTvirtual_Server Enable Auto Boot From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command To verify that Auto Boot has been enabled for the FTvirtual Server operating system, issue a FTvirtual_Server Show Auto Boot or FTvirtual_Server Show Parameters command from either CoServer. FTvirtual_Server Disable Auto Boot FTvirtual_Server Show Auto Boot FTvirtual_Server Show Parameters FTvirtual_Server Commands 3-5

24 FTvirtual_Server Enable Auto Resynch This command enables automatic resynchronization (Auto Resynch) after a Virtual Server has been removed. Auto Resynch allows the Virtual Server to automatically attempt to resynchronize with the running Virtual Server. By default, Auto Synch is true (enabled). Variables MTCCONS FTvirtual_Server Enable Auto Resynch From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command To verify that Auto Resynch has been enabled for the Virtual Server, issue a FTvirtual_Server Show Auto Resynch or FTvirtual_Server Show Parameters command from either CoServer. FTvirtual_Server Disable Auto Resynch FTvirtual_Server Show Auto Resynch FTvirtual_Server Show Parameters FTvirtual_Server Enable Background Mode This command sets the FTvirtual Server operating system to operate to the benefit of client/ server I/O processing. Variables MTCCONS FTvirtual_Server Enable Background Mode From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command After this command takes effect, the FTvirtual Server operating system on the specified CoServer operates most efficiently for client/server I/O processing. FTvirtual_Server Enable Application Mode FTvirtual_Server Shutdown Operation 3-6 Endurance FTvirtual Server Commands

25 FTvirtual_Server Enable Background Synchronization This command enables background synchronization for the FTvirtual Server. Background synchronization allows FTvirtual Server operations to continue with only a minimal pause for memory mirroring during the synchronization process. By default, background synchronization is true (enabled). Variables MTCCONS FTvirtual_Server Enable Background Synchronization From CoServern n the ID number of the CoServer (1 or 2) from which you are directing the command To verify that background synchronization has been enabled for the FTvirtual Server, issue a FTvirtual_Server Show Background Synchronization command from either CoServer. FTvirtual_Server Disable Background Synchronization FTvirtual_Server Show Background Synchronization Parameters FTvirtual_Server Enable Foreground-only Synchronization When background synchronization times out repeatedly, this command determines that synchronization is performed entirely in the foreground. Variables MTCCONS FTvirtual_Server Enable Foreground-only Synchronization From CoServern n the ID number of the CoServer (1 or 2) from which you are directing the command After background synchronization has timed out multiple times, FTvirtual Server operations are paused for the entire synchronization process. FTvirtual_Server Disable Foreground-only Synchronization FTvirtual_Server Show Background Synchronization Parameters FTvirtual_Server Commands 3-7

26 FTvirtual_Server Set Background Synchronization Timeout This command sets a time limit for background synchronization to occur for the FTvirtual Server. At the end of the specified time, attempts at background synchronization stop and are retried later. The timeout value (interval) is 300 to 3600 seconds. Variables MTCCONS FTvirtual_Server Set Background Synchronization Timeout Interval From CoServern n the ID number of the CoServer (1 or 2) from which you are directing the command FTvirtual_Server Show Background Synchronization Parameters FTvirtual_Server Show Auto Boot This command displays the state of the Auto Boot parameter for the FTvirtual Server from the specified CoServer. Auto Boot allows the FTvirtual Server to boot its Windows operating system automatically after a reboot or a power cycle. By default, Auto Boot is true (enabled). Variables MTCCONS FTvirtual_Server Show Auto Boot From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command The value for Auto Boot is displayed as either true (enabled) or false (disabled). FTvirtual_Server Disable Auto Boot FTvirtual_Server Disable Auto Resynch FTvirtual_Server Enable Auto Boot FTvirtual_Server Enable Auto Resynch FTvirtual_Server Show Auto Boot FTvirtual_Server Show Auto Resynch FTvirtual_Server Show Parameters 3-8 Endurance FTvirtual Server Commands

27 FTvirtual_Server Show Auto Resynch This command displays the current Auto Resynch settings for the FTvirtual Server from the specified CoServer. Auto Resynch allows the Virtual Servers to automatically resynchronize with each other after a Virtual Server has been removed. By default, Auto Resynch is set to true (enabled). Variables MTCCONS FTvirtual_Server Show Auto Resynch From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command The value for Auto Resynch is displayed as either true (enabled) or false (disabled). FTvirtual_Server Disable Auto Boot FTvirtual_Server Disable Auto Resynch FTvirtual_Server Enable Auto Boot FTvirtual_Server Enable Auto Resynch FTvirtual_Server Show Auto Boot FTvirtual_Server Show Auto Resynch FTvirtual_Server Show Parameters FTvirtual_Server Commands 3-9

28 FTvirtual_Server Show Background Synchronization Parameters This command displays the current background synchronization settings for the FTvirtual Server. The background synchronization settings determine whether and how long FTvirtual Server operations are paused for synchronization. By default, background synchronization is set to true (enabled). Variables MTCCONS FTvirtual_Server Show Background Synchronization Parameters From CoServern n the ID number of the CoServer (1 or 2) from which you are directing the command Table 3-2 Background Synchronization Parameters Value Meaning Default Interval The default time in seconds before FTvirtual Server background synchronization is timed out. The default is 600 seconds. Maximum Interval Minimum Interval Current Interval enabled disable Foreground Synchronization FTv is capable of background synchronization The maximum time in seconds allowed for the interval. The maximum time is 3600 seconds. The minimum time in seconds allowed for the interval. The minimum time is 300 seconds. The amount of time in seconds before FTvirtual Server background synchronization is timed out. Specifies that background synchronization is enabled. Specifies that background synchronization is disabled. When background synchronization times out repeatedly, this parameter determines the action taken. If foreground synchronization is enabled, synchronization is performed entirely in the foreground. If it is disabled, synchronization is retried repeatedly but much less frequency. If this value is FALSE, the Windows operating system on the FTvirtual Server is not capable of performing background synchronization. If this value is TRUE, the Windows operating system on the FTvirtual Server is capable of performing background synchronization Endurance FTvirtual Server Commands

29 FTvirtual_Server Disable Background Synchronization FTvirtual_Server Enable Background Synchronization FTvirtual_Server Disable Foreground-only Synchronization FTvirtual_Server Enable Foreground-only Synchronization FTvirtual_Server Show Parameters This command displays the current parameter settings for the FTvirtual Server from the specified CoServer. After a Virtual Server has been removed, Auto Resynch allows the FTvirtual Server to automatically resynchronize. Auto Boot allows the FTvirtual Server to automatically boot its Windows operating system after a reboot or power cycle. By default, Auto Boot and Auto Resynch are set to true (enabled). Variables MTCCONS FTvirtual_Server Show Parameters From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command The FTvirtual Server will resynchronize automatically after a power cycle, or after a Virtual Server is removed, or will boot after a reboot or power cycle. Table 3-3 Virtual Server Parameters Value Meaning Auto Boot Auto Resynch Displays the state of the Auto Boot parameter as either true (enabled) or false (disabled). This value determines whether the FTvirtual Server operating system will be booted automatically when the CoServers start. Displays the state of the Auto Resynch parameter as either true (enabled) or false (disabled). This value determines whether the FTvirtual Server operating system will be resynchronized automatically after a Virtual Server is removed. FTvirtual_Server Disable Auto Boot FTvirtual_Server Disable Auto Resynch FTvirtual_Server Enable Auto Boot FTvirtual_Server Enable Auto Resynch FTvirtual_Server Show Auto Boot FTvirtual_Server Show Auto Resynch FTvirtual_Server Commands 3-11

30 FTvirtual_Server Show Settings This command displays the application and background interval settings of the FTvirtual Server operating system. Variables MTCCONS FTvirtual_Server Show Settings From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command The FTvirtual Server operating system s settings for application and background intervals are displayed. FTvirtual_Server Enable Application Mode FTvirtual_Server Enable Background Mode FTvirtual_Server Shutdown Operation This command performs a shutdown on the FTvirtual Server operating system if it is active. Variables MTCCONS FTvirtual_Server Shutdown Operation From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command The SCP (System Control Provider) on the specified CoServer issues a request to the Endurance Manager to shut down the FTvirtual Server operating system, which initiates the system shutdown. The operating system reboots when the Virtual Server(s) becomes available, as defined by the Virtual Server Auto Boot and Auto Synch parameters. To verify that the FTvirtual Server operating system completes shutdown, from either CoServer: Check the status of the Endurance Configuration in the Endurance Manager s main window, and verify the FTvirtual Server operating system is offline. Invoke the Endurance Manager s Component Status window to verify that the FTvirtual Server operating system is offline. Check the Windows Event Viewer for a message that indicates that the FTvirtual Server operating system has been shut down by operator request. FTvirtual_Server Shutdown Operation Without Reboot 3-12 Endurance FTvirtual Server Commands

31 FTvirtual_Server Shutdown Operation Without Reboot This command shuts down the Endurance Configuration and prevents it from restarting immediately. This command shuts down the FTvirtual Server s operating system. After the shutdown completes, if you want to bring the FTvirtual Server s operating system back, issue the FTvirtual Server Start Boot command. Variables MTCCONS FTvirtual_Server Shutdown Operation Without Reboot From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command Once shut down, the FTvirtual Server operating system does not reboot. If you want the FTvirtual Server operating system to reboot, issue the FTvirtual Server Start Boot command. FTvirtual_Server Shutdown Operation FTvirtual_Server Start Boot FTvirtual_Server Start Boot This command boots the FTvirtual Server operating system. Variables MTCCONS FTvirtual_Server Start Boot From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command The Virtual Server operating system begins the boot process for the FTvirtual Server. FTvirtual_Server Commands 3-13

32 FTvirtual_Server Start Boot on Preferred Virtual Server This command boots the FTvirtual Server on the preferred Virtual Server. Variables MTCCONS FTvirtual_Server Start Boot on Preferred Virtual Serverm From CoServern m the ID number of the Virtual Server (1 or 2) to which you are directing the command n the ID number of the CoServer (1 or 2) from which you are directing the command The Virtual Server you specified begins the boot process for the FTvirtual Server, if possible. Otherwise, the other Virtual Server begins the boot process for the FTvirtual Server. FTvirtual_Server Start Boot on Specified Virtual Server FTvirtual_Server Start Boot on Specified Virtual Server This command boots the FTvirtual Server on the specified Virtual Server. Variables MTCCONS FTvirtual_Server Start Boot on Specified Virtual Serverm From CoServern m the ID number of the Virtual Server (1 or 2) to which you are directing the command n the ID number of the CoServer (1 or 2) from which you are directing the command The specified Virtual Server begins the boot process for the FTvirtual Server. FTvirtual_Server Start Boot on Preferred Virtual Server 3-14 Endurance FTvirtual Server Commands

33 FTvirtual_Server Start Resynch This command starts the process to resynchronize the FTvirtual Server operating system. Variables MTCCONS FTvirtual_Server Start Resynch From CoServern n the ID number of the CoServer (1 or 2) to which you are directing the command The Virtual Server operating system begins the resynchronization process for the FTvirtual Server. FTvirtual_Server Commands 3-15

34 3-16 Endurance FTvirtual Server Commands

35 Virtual_Server Commands 4 The Virtual_Server commands perform operations in the Virtual Server environment. Table 4-1 lists the Virtual_Server commands. Table 4-1 Virtual_Server Commands Command Page Virtual_Server Disable Auto Boot 4-2 Virtual_Server Disable Auto Synch 4-3 Virtual_Server Disable Operation 4-4 Virtual_Server Enable Auto Boot 4-5 Virtual_Server Enable Auto Synch 4-5 Virtual_Server Enable Operation 4-6 Virtual_Server Remove From Configuration 4-7 Virtual_Server Show Auto Boot 4-8 Virtual_Server Show Auto Synch 4-8 Virtual_Server Show Parameters 4-9 Virtual_Server Commands 4-1

36 Virtual_Server Disable Auto Boot This command disables Auto Boot for the specified Virtual Server. Auto Boot allows the Virtual Server to boot its Windows operating system automatically after a reboot or power cycle. If you disable Auto Boot, the Virtual Server s operating system cannot be booted until you issue a Virtual Server Enable Auto Boot command. If you are setting this option to prevent a Virtual Server from joining the Endurance Configuration, make sure that you disable both Auto Boot and Auto Synch for the specified Virtual Server. Otherwise, in certain scenarios, the Virtual Servers can synchronize. By default, Auto Boot is true (enabled). MTCCONS Virtual_Servern Disable Auto Boot From CoServerx Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command To verify that Auto Boot is disabled for the specified Virtual Server, issue a Virtual_Servern Show Auto Boot or Virtual_Servern Show Parameters command from either CoServer. Virtual_Server Disable Auto Synch Virtual_Server Enable Auto Boot Virtual_Server Enable Auto Synch Virtual_Server Show Auto Boot Virtual_Server Show Parameters 4-2 Endurance FTvirtual Server Commands

37 Virtual_Server Disable Auto Synch This command disables automatic synchronization (Auto Synch) for the specified Virtual Server. Auto Synch allows the second Virtual Server to automatically attempt to synchronize with the running Virtual Server. If you disable Auto Synch, you cannot synchronize the specified Virtual Server into the Endurance Configuration until you issue a Virtual_Server Enable Auto Synch command. By default, Auto Synch is true (enabled). MTCCONS Virtual_Servern Disable Auto Synch From CoServerx Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command To verify that Auto Synch is disabled for the specified Virtual Server, issue a Virtual_Servern Show Auto Synch or Virtual_Servern Show Parameters command from either CoServer. Virtual_Server Disable Auto Boot Virtual_Server Enable Auto Boot Virtual_Server Enable Auto Synch Virtual_Server Show Auto Synch Virtual_Server Show Parameters Virtual_Server Commands 4-3

38 Virtual_Server Disable Operation This command disables the specified Virtual Server from the active Endurance Configuration. For the Virtual Server to rejoin the Endurance Configuration, you must enable it using the command Virtual_Server Enable Operation. MTCCONS Virtual_Servern Disable Operation From CoServerx -disable_safeguard Note: The -disable_safeguard argument is needed only if the specified Virtual Server is the only active Virtual Server. Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command The Virtual Server cannot boot or synchronize with the Endurance Configuration until you issue a Virtual_Server Enable Operation command. To verify that the specified Virtual Server is disabled, on either CoServer, you can: Check the status of the Endurance Configuration in the Endurance Manager s main window. If the command was successful, the specified Virtual Server is disabled. Check the Windows Event Viewer for a message that indicates that the specified Virtual Server has been disabled. Virtual_Server Enable Operation Virtual_Server Remove From Configuration 4-4 Endurance FTvirtual Server Commands

39 Virtual_Server Enable Auto Boot This command enables Auto Boot for the specified Virtual Server. Auto Boot allows the Virtual Server to automatically boot its operating system after a reboot. By default, Auto Boot is true (enabled). MTCCONS Virtual_Servern Enable Auto Boot From CoServerx Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command To verify that Auto Boot has been enabled for the specified Virtual Server, issue a Virtual_Servern Show Auto Boot or Virtual_Servern Show Parameters command from either CoServer. Virtual_Server Disable Auto Boot Virtual_Server Show Auto Boot Virtual_Server Show Parameters Virtual_Server Enable Auto Synch This command enables automatic synchronization (Auto Synch) for the specified Virtual Server. Auto Synch allows the specified Virtual Server to automatically attempt to synchronize with the running Virtual Server. By default, Auto Synch is true (enabled). MTCCONS Virtual_Servern Enable Auto Synch From CoServerx Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command To verify that Auto Synch has been enabled for the specified Virtual Server, issue a Virtual_Servern Show Auto Synch or Virtual_Servern Show Parameters command from either CoServer. Virtual_Server Disable Auto Synch Virtual_Server Show Auto Synch Virtual_Server Show Parameters Virtual_Server Commands 4-5

40 Virtual_Server Enable Operation This command enables the specified Virtual Server, allowing it to join the active Endurance Configuration. MTCCONS Virtual_Servern Enable Operation From CoServerx Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command To verify that the specified Virtual Server is enabled, on either CoServer, you can: Check the status of the Endurance Configuration in the Endurance Manager s main window. If the command was successful, the specified Virtual Server is good. Check the Windows Event Viewer for a message that indicates that the specified Virtual Server was enabled by operator request. Virtual_Server Disable Operation Virtual_Server Remove From Configuration 4-6 Endurance FTvirtual Server Commands

41 Virtual_Server Remove From Configuration This command removes the specified Virtual Server from the Endurance Configuration, reinitializes it, and then reboots it. When the specified Virtual Server reboots, it tries to rejoin the Endurance Configuration. If you do not want the specified Virtual Server to rejoin the Endurance Configuration, use the command Virtual_Servern Disable Operation instead. Warning: If the Virtual Server in just one CoServer is in operation, use a Windows Shutdown command instead. This Endurance command does not perform a normal Windows operating system shutdown. As a result, you can lose any data in the Windows disk cache that has not been written to disk. MTCCONS Virtual_Servern Remove From Configuration From CoServerx -disable_safeguard Note: The -disable_safeguard argument is needed only for the last Virtual Server online. Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command To verify that the specified Virtual Server was removed from the Endurance Configuration, on either CoServer, you can: Check the status of the Endurance Configuration in the Endurance Manager s main window. If the command was successful, the specified Virtual Server is disabled. Check the Windows Event Viewer for a message that indicates that the specified Virtual Server has been removed from service. Virtual_Server Disable Auto Boot Virtual_Server Disable Auto Synch Virtual_Server Disable Operation Virtual_Server Enable Auto Boot Virtual_Server Enable Auto Synch Virtual_Server Enable Operation Virtual_Server Commands 4-7

42 Virtual_Server Show Auto Boot This command shows the state of the Auto Boot parameter for the specified Virtual Server. Auto Boot allows the Virtual Server to boot its Windows operating system automatically after a reboot. By default, Auto Boot is true (enabled). MTCCONS Virtual_Servern Show Auto Boot From CoServerx Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command The value for Auto Boot is either true (enabled) or false (disabled). Virtual_Server Disable Auto Boot Virtual_Server Enable Auto Boot Virtual_Server Show Parameters Virtual_Server Show Auto Synch This command shows the state of the Auto Synch parameter for the specified Virtual Server. Auto Synch allows the Virtual Server to synchronize automatically with the other Virtual Server. If you disable Auto Synch, you cannot synchronize that Virtual Server until you issue a Virtual_Server Enable Auto Synch command. By default, Auto Synch is true (enabled). MTCCONS Virtual_Servern Show Auto Synch From CoServerx Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command The value for Auto Synch is either true (enabled) or false (disabled). Virtual_Server Disable Auto Synch Virtual_Server Enable Auto Synch Virtual_Server Show Parameters 4-8 Endurance FTvirtual Server Commands

43 Virtual_Server Show Parameters This command displays the current parameter settings for the specified Virtual Server. MTCCONS Virtual_Servern Show Parameters From CoServerx Variables n the ID number of the Virtual Server (1 or 2) x the ID number of the CoServer (1 or 2) to which you are directing the command Table 4-2 Virtual Server Parameters Value Auto Boot Auto Resynch Meaning Displays the state of the Auto Boot parameter as either true (enabled) or false (disabled). This value determines whether the Virtual Server operating system will be booted automatically when the CoServers start. Displays the state of the Auto Synch parameter as either true (enabled) or false (disabled). This value determines whether the Virtual Server operating system will be synchronized automatically. Virtual_Server Disable Auto Boot Virtual_Server Disable Auto Synch Virtual_Server Enable Auto Boot Virtual_Server Enable Auto Synch Virtual_Server Show Auto Boot Virtual_Server Show Auto Synch Virtual_Server Commands 4-9

44 4-10 Endurance FTvirtual Server Commands

45 CoServer Commands 5 The CoServer commands perform operations on the CoServers. Table 5-1 lists the CoServer commands. Table 5-1 CoServer Commands Command Page CoServer Disable Operation 5-2 CoServer Enable Operation 5-3 CoServer Shutdown Operation 5-4 CoServer Shutdown Operation Without CoServer Reboot 5-5 CoServer Commands 5-1

46 CoServer Disable Operation This command disables (removes) the specified CoServer from the active Endurance Configuration. You can use this command if you want to perform a maintenance procedure. You can also use this command to remove a CoServer that is not operating properly so that you can verify whether the Endurance FTvirtual Server operates correctly without it. For a disabled CoServer to rejoin the Endurance Configuration, you must issue a CoServer Enable Operation command. Warning: When you issue this command, all I/O devices on the specified CoServer are unavailable to the FTvirtual Server. MTCCONS CoServern Disable Operation From CoServerx -disable_safeguard Note: The -disable_safeguard argument is needed only for the last CoServer online or for the Virtual Server boot disk if the Virtual Server is running. Variables n the ID number of the CoServer (1 or 2) that you want to disable x the ID number of the CoServer (1 or 2) to which you are directing the command To verify that the specified CoServer has been disabled, either: Check the Windows Event Viewer for a message that indicates that the CoServer has been disabled by operator request. Check the Component Status window in the Endurance Manager to verify that the specified CoServer is disabled. CoServer Enable Operation CoServer Shutdown Operation 5-2 Endurance FTvirtual Server Commands

47 CoServer Enable Operation This command enables the specified CoServer that was disabled or failed. The CoServer attempts to rejoin the Endurance Configuration immediately or when it reboots the Windows operating system. Variables MTCCONS CoServern Enable Operation From CoServerx n the ID number of the CoServer (1 or 2) you want to enable x the ID number of the CoServer (1 or 2) to which you are directing the command To verify that the specified CoServer has been enabled, either: Check the Component Status Window in the Endurance Manager to verify that the CoServer is enabled. Check the Windows Event Viewer on the CoServer that you enabled for a message indicating that the CoServer is enabled. CoServer Disable Operation CoServer Shutdown Operation CoServer Commands 5-3

48 CoServer Shutdown Operation This command removes the specified CoServer from the Endurance Configuration, shuts down its operating system, and allow it to reboot. When it reboots, the CoServer rejoins the Endurance Configuration. If you do not want the CoServer to reboot and rejoin the Endurance Configuration, use the CoServer Disable Operation command. MTCCONS CoServern Shutdown Operation From CoServerx -disable_safeguard Note: The -disable_safeguard argument is needed only for the last CoServer online, or for the Virtual Server boot disk if the Virtual Server is running. Variables n the ID number of the CoServer (1 or 2) to shut down x the ID number of the CoServer (1 or 2) to which you are directing the command After the CoServer shuts down, it reboots and is reconfigured back into the Endurance Configuration. If you do not want the CoServer to automatically reboot and rejoin the Configuration, issue the CoServer Shutdown Operation Without CoServer Reboot instead of this command. CoServer Disable Operation CoServer Enable Operation CoServer Shutdown Operation Without CoServer Reboot 5-4 Endurance FTvirtual Server Commands

49 CoServer Shutdown Operation Without CoServer Reboot This command removes the specified CoServer from the Endurance Configuration, shuts down its operating system, and does not reboot the CoServer. MTCCONS CoServern Shutdown Operation Without CoServer Reboot From CoServerx -disable_safeguard Note: The -disable_safeguard argument is needed only for the last CoServer online or for the Virtual Server boot disk if the Virtual Server is running. Variables n the ID number of the CoServer (1 or 2) to shut down x the ID number of the CoServer (1 or 2) to which you are directing the command After the CoServer shuts down, it does not reboot and is not reconfigured back into the Endurance Configuration when it is available again. If you want the CoServer to automatically reboot and rejoin the CoServer, use the CoServer Shutdown Operation command. If you want to permanently remove the CoServer from the Endurance Configuration, use the CoServer Disable command. Check the Windows Event Viewer for a message indicating that the CoServer has been shut down by operator request. CoServer Disable Operation CoServer Enable Operation CoServer Shutdown Operation CoServer Commands 5-5