Users Guide
Table Of Contents
- About This Guide
- Dell EqualLogic Auto-Snapshot Manager/Microsoft Edition Version 5.4 User's Guide
- Introduction to ASM/ME
- Functions Provided By ASM/ME
- Supported Applications
- HIT Groups and Multiple Machine Management
- ASM/ME Smart Copies
- Smart Copy Types
- Smart Copy Operations for Template and Thin Clone Volumes
- Robust Data Recovery
- Thin-Provisioning a Volume
- SAN Data Copy Offload
- Scripts and Command Generation
- Alerts and Event Notification
- Remote Installations
- Failover Cluster Support
- ASM/ME and the Virtual Snapshot Service
- Functions Provided By ASM/ME
- Configure ASM/ME
- PS Series Group Requirements
- Windows Computer Requirements
- Required Access Controls
- VSS/VDS Service Access to the Group
- Access to Volumes and Snapshots
- iSCSI Target Connections
- Volume Mount Point and Drive Letter Assignments
- Mount Point Constraints in Cluster Environments
- ASM/ME Settings
- ASM/ME Graphical User Interface
- Start the ASM/ME GUI
- Tree Panel
- Tree Panel Behavior in Failover Cluster Environments
- Tree Panel Nodes
- Tree Panel Icons
- Group SharePoint Farm Nodes, Clusters, or Host Nodes
- About Aliases
- Customize Color Themes
- HIT Groups
- General ASM/ME Operations
- About Volumes
- Operations on Failover Clusters
- About Collections
- About Schedules
- About Smart Copies
- Restoring Data
- View Multipath Information
- View I/O Details
- Using ASM/ME with Exchange
- View Exchange Applications in ASM/ME
- Exchange Operations
- Overview of Exchange Smart Copies
- Exchange eseutil.exe Utility
- Recovery Considerations for Exchange
- Checksum Verification and Soft Recovery
- Run Checksum Verification and Soft Recovery Immediately
- Run Checksum Verification and Soft Recovery After Smart Copy Creation
- Schedule a Global Verification Task for Checksum Verification and Soft Recovery
- Run Checksum Verification and Soft Recovery on a Remote Host
- View Checksum Verification and Soft Recovery Status
- Checksum Verification and Soft Recovery Logging and Notification
- Create Exchange Smart Copies
- Schedule Smart Copies for Exchange Components
- Recover Exchange Data
- Using ASM/ME with SQL Server
- Using ASM/ME with Hyper-V
- Using ASM/ME with SharePoint
- SharePoint Installation Considerations
- Plan to Install on a SharePoint Farm
- Example of ASM/ME Installed on a SharePoint Farm
- Example of a SharePoint Farm with a SQL Cluster
- Install ASM/ME on a SharePoint Farm
- About Changes to an Existing SharePoint Farm
- Remove a HIT Group Host From a SharePoint Farm
- Add a Writer Host to a SharePoint Farm
- Change a Writer Host in a SharePoint Farm
- Change the Writer Host and Disable the VSS Writer in a SharePoint Farm
- Respond to Changes in a SharePoint Farm
- View SharePoint Farm Components in ASM/ME
- SharePoint Smart Copies
- Restore Options for SharePoint Smart Copies
- Availability of SharePoint Data Restoration Operations
- Mount a SharePoint Smart Copy
- Restore Selected Databases from a SharePoint Smart Copy
- Restore a Database In-Place From a SharePoint Smart Copy
- Restore a Database From a SharePoint Smart Copy as a New Database
- Restore an SSA From a SharePoint Smart Copy
- Using the Command Line Interface
- Introduction to ASMCLI
- How to Use ASMCLI Commands
- General Command Syntax
- ASMCLI Command Summary
- Command Parameters
- ASMCLI Commands and Their Syntax
- ASMCLI -alert
- ASMCLI -breaksmartcopy
- ASMCLI -cloneReplica
- ASMCLI -configureASM
- ASMCLI -configureCHAP
- ASMCLI -createCollection
- ASMCLI -delete
- ASMCLI -deleteCollection
- ASMCLI -enumerateiSCSIPortals
- ASMCLI -enumerateSmartCopies
- ASMCLI -help
- ASMCLI -list
- ASMCLI -modifyCollection
- ASMCLI -mount
- ASMCLI -Properties
- ASMCLI -restore
- ASMCLI -selectiveRestore
- ASMCLI -shutdownsystray
- ASMCLI -shutdownverifier
- ASMCLI -smart
- ASMCLI -unmount
- ASMCLI -verify
- ASMCLI -version
- Use a Script to Create Smart Copies
- Recover a Clustered Volume From a Clone
- Index
Using the Command Line Interface
This chapter describes the command line and scripting options provided by the ASM/ME command line interface (ASMCLI).
Topics:
• Introduction to ASMCLI
• How to Use ASMCLI Commands
• General Command Syntax
• ASMCLI Command Summary
• Command Parameters
• ASMCLI Commands and Their Syntax
• Use a Script to Create Smart Copies
Introduction to ASMCLI
ASM/ME provides a set of commands (ASMCLI) you execute at the Windows command prompt for Smart Copy operations, or
to create site‑specific scripts for Smart Copy operations.
NOTE:
To perform the functions discussed in this section, Dell recommends that you use the ASM PowerShell cmdlets,
which are more comprehensive. For reference information information about PowerShell cmdlets, see the Dell EqualLogic
PowerShell Tools Reference Guide.
You can generate complex commands automatically by using menu options in the ASM/ME GUI as described in Scripts and
Command Generation. The auto‑generate option automatically copies the long text strings that identify objects such as volumes
and schedules and builds them into syntactically‑correct commands. This feature aids you in using the command line or
scripting. You do not need to manually type long commands and you can aggregate the auto‑generated commands into scripts
by copying and pasting the commands into a text editor.
On a cluster, if the action for which you want to generate a command is disabled, the action to automatically generate the
command is also disabled. If you manually create the commands for these actions, you must add Cluster Management actions to
your scripts. This action resolves any cluster related issues and allows the command to execute successfully.
Use the ASMCLI commands for the following operations:
● Create Smart Copies
● Run Checksum Verification and Soft Recovery—for Exchange only
● Delete Smart Copies
● Mount a Smart Copy
● Unmount a Smart Copy
● Restore a Smart Copy—Perform a full restore or a selective restore of certain files
● Selective Restore—Not available for Exchange.
● List supported volumes, collections, and components
● Configure ASM/ME properties
● Create, modify, and delete collections
● Clone a replica Smart Copy
● Configure CHAP credentials
● Retrieve ASMCLI version information
● Enumerate Smart Copies for specific volumes, components, or collections
● Enumerate iSCSI target portals
● Safely shut down the current instance of the Global Verification Task
● Close all instances of verifier notification pop‑up dialog boxes that appear in the Windows taskbar notification area
10
104 Using the Command Line Interface