SnapDrive® 5.2.2 for UNIX®
Installation and Administration Guide
For IBM AIX®
SnapDrive for UNIX overview
What SnapDrive for UNIX does
Features supported in SnapDrive for UNIX
Clustered Data ONTAP features available in SnapDrive for UNIX
Operations performed on stand-alone UNIX systems
Support for Vserver
Considerations for supporting vFiler units
Considerations for using SnapDrive for UNIX
Management of an LVM and raw entities
SnapDrive for UNIX provisioning in an LVM environment
SnapDrive for UNIX and raw entities
How to manage Snapshot copies of LVM, raw devices, and NFS entities
Security considerations
Access permissions on a storage system
Requirements for storage systems
Stack requirements
Supported FC, iSCSI, or NFS configurations
Limitations
Limitations of LUNs managed by SnapDrive
SnapDrive limitations for clustered Data ONTAP
Support for NetApp DataMotion for vFiler
Support for volume migration
Managing volume migration in SnapDrive for UNIX
SnapDrive for UNIX configuration checker
Limitations for NFS files or directory trees
Multipathing in SnapDrive for UNIX
Thin provisioning in SnapDrive for UNIX
Volume managers on SnapDrive for UNIX
New in this release
Preparing to install SnapDrive for UNIX
Hardware and software configuration
FC or iSCSI configuration checks
NFS configuration checks
Preparing your storage system
Verification of storage system readiness and licenses
Storage system partner IP address or interface name confirmation
Considerations for NFS configurations
Storage system volume preparation
Volume optimization in an FC or iSCSI environment
Reset the snap reserve option
Resetting the snap reserve option on the storage system
Resetting the snap reserve option by using FilerView
Host preparation for installing SnapDrive for UNIX
Installing Linux Solaris AIX HPUX Host Utilities
Verify that the hosts are ready
Installing or upgrading SnapDrive of UNIX
Decompressing the downloaded software
Installing SnapDrive for UNIX on an AIX host
Uninstalling SnapDrive for UNIX from an AIX host
Postinstallation checks
Files installed by SnapDrive for UNIX
Executables installed by SnapDrive for UNIX
Configuration files installed by SnapDrive for UNIX
Diagnostic files installed by SnapDrive for UNIX
Manual pages installed by SnapDrive for UNIX
Upgrade SnapDrive for UNIX to current version
The SnapDrive for UNIX daemon
What the Web service and daemon are
Checking the status of the daemon
Starting the SnapDrive for UNIX daemon
Changing the default daemon password
Stopping the daemon
Nonforcibly stopping the daemon
Forcibly stopping the daemon
Restarting the daemon
Forcing daemon restart
Secure daemon communication using HTTPS
Generating self-signed certificates
SnapDrive for UNIX configuration checker
Configuration checker components for SnapDrive for UNIX
Checking the SnapDrive configuration checker version
Identifying the installed components
Verifying the supported configuration
Importing data files
Configuration specification
Support for storage system rename
Configuring the new storage system name in a host system
Viewing the list of storage systems
Migrating from old storage system to new storage system
Viewing the migrated new storage system
Deleting the storage system mapping information from the host system
Using port set in SnapDrive for UNIX
Adding a port set in SnapDrive
Viewing the list of port set
Removing a port set from SnapDrive
Migrating to new Vserver name
Configuring igroups
Adding an igroup
Deleting an igroup
Viewing the list of igroups
Using Selective LUN Map in SnapDrive for UNIX
Configuring SnapDrive for UNIX
Configuration information in SnapDrive for UNIX
What the snapdrive.conf file is
Configuration options and their default values
What SnapDrive configuration wizard does
SnapDrive configuration wizard
Some configuration commands
Setting up the configuration wizard
Setting values in the snapdrive.conf file
Checking the version of SnapDrive for UNIX
Configuration information for Vserver environment
Login information for Vserver
Specifying login information for Vserver
Verifying login information for Vserver
Deleting a user for a Vserver
Audit, recovery, and trace logging in SnapDrive for UNIX
Types of logs
Enabling and disabling log files
Log file rotation settings
Contents of an audit log file
Changing the defaults for the audit logs
Contents of the recovery log
Default values for the recovery logs
What the trace log file is
Default values for the trace log files
What AutoSupport is
How SnapDrive for UNIX uses AutoSupport
Contents of AutoSupport message
Example of an AutoSupport message
Multipath access in SnapDrive for UNIX
Enabling multipathing
Reason to refresh the DMP paths
Thin provisioning in SnapDrive for UNIX
Enabling thin provisioning for LUNs
Enabling thin provisioning for NFS entities
Multiple subnet configuration
Configuring management and data interfaces for a storage system
Viewing all the data interfaces for a management interface
Deleting a data interface entry for a management interface
LUN names in SAN environment
Pure NFS environment
Mixed SAN and NFS environments
Automatic detection of host entities
Wizards in SnapDrive for UNIX
Commands executed using a wizard
Storage management operations using a wizard
Snapshot copy management operations using a wizard
Delete storage using a wizard
Security features in SnapDrive for UNIX
What the Security features are
Access control in SnapDrive for UNIX
What access control settings are
Available access control levels
Setting up access control permission
Viewing the access control permission
Login information for storage systems
Specifying login information
Verifying storage system user names associated with SnapDrive for UNIX
Deleting a user login for a storage system
Setting up HTTP
Role-based access control in SnapDrive for UNIX
What role-based access control (RBAC) in SnapDrive for UNIX is
SnapDrive for UNIX and Operations Manager console interaction
Configuration of role-based access control in SnapDrive for UNIX
Configuring sd-admin in Operations Manager console
Configuring sd-admin using command-line interface
Adding sd-hostname to the storage system
Adding sd- hostname to storage system using CLI
Configuring user credentials on SnapDrive for UNIX
User name formats for performing access checks with Operations Manager console
Configuration variables for role-based access control
SnapDrive commands and capabilities
Preconfigured roles for ease of user role configuration
Automatic storage system update on Operations Manager console
Multiple Operations Manager console servers
Operations Manager console unavailable
RBAC and storage operation examples
Operation with a single filespec on a single storage object
Operation with a single filespec on multiple storage objects
Operation with multiple filespec and storage objects
Operation with multiple storage objects
Operation with multiple Operations Manager console servers managing storage systems
FlexClone volumes in SnapDrive for UNIX
What FlexClone volumes are
Benefits of FlexClone volumes
Types of FlexClone volumes
SnapDrive for UNIX operations on FlexClone volumes
Role-based access control for FlexClone volume operations
Snap connect procedure
Snap disconnect procedure
Connecting to a single filespec in a LUN
Connecting to multiple filespecs
Disconnecting a file specification
Splitting the FlexClone volume
Space reservation with a FlexClone volume
Storage Provisioning in SnapDrive for UNIX
Storage operations in SnapDrive for UNIX
Storage operations across multiple storage system volumes
Considerations for storage operations
Storage creation with SnapDrive for UNIX
Methods for creating storage
Guidelines for the storage create operation
Information required for the storage create operation
Storage creation for LVM VxVM entities
Storage creation for a file system that resides on a LUN
Creating LUNs without host entities
Creating a file system on a LUN and setting up the LUN automatically
Creating a file system on a LUN and specifying the LUN
Creating an LVM a VxVM entity and setting up the LUN automatically
Creating an LVM a VxVM entity and specifying the LUN
Command to use to display available storage
Methods for displaying storage information
Increase the storage size using SnapDrive for UNIX
Guidelines for the storage resize command
Information required for using the snapdrive storage resize command
Command syntax to increase the size of the storage
Host volumes and file system resize operation
The storage connect command
Guidelines for the storage connect command
Information required for using the snapdrive storage connect command
Connecting LUNs with disk groups, host volumes, and file systems
Connecting existing LUNs with shared resources
The storage disconnect command
Methods for disconnecting storage
Guidelines for the snapdrive storage disconnect command
Tips for using the storage disconnect command
Information required for using the snapdrive storage disconnect command
Command syntax for disconnecting LUNs from the host
Command syntax for disconnecting a file system created on a LUN from the host
Command syntax for disconnecting LUNs and storage entities from the host
The storage delete command
Guidelines for using the storage delete command
Information required for using the snapdrive storage delete command
Creating and using Snapshot copies in SnapDrive for UNIX
What Snapshot operations are in SnapDrive for UNIX
Considerations when working with Snapshot copies
Snapshot copy operations
Crash-consistent Snapshot copies
Crash consistency with Data ONTAP 7.2 and later
Using Consistency Group Snapshots in SnapDrive for Unix
Capturing a consistency group snapshot
Disabling consistency group snapshots
Application-consistent Snapshot copies
Snapshot copies that span storage systems or volumes
Creating Snapshot copies of unrelated entities
Guidelines for Snapshot copy creation
Information required for using the snapdrive snap create command
Creating a Snapshot copy
Snapshot copies information display
Command to use to display Snapshot copy information
Guidelines for displaying Snapshot copies
Information required for using the snapdrive snap show or list commands
Displaying Snapshot copies residing on a storage system
Displaying Snapshot copies of a storage system volume
Displaying a Snapshot copy
Other ways to get Snapshot copy names
Snapshot copy rename
Command to use to rename a Snapshot copy
Renaming a Snapshot copy that spans storage systems or volumes
Guidelines for renaming Snapshot copies
Changing a Snapshot copy name
Restoring a Snapshot copy
Command to use to restore Snapshot copies
Restoring Snapshot copies on a destination storage system
Restoring multiple storage entities
Considerations for restoring a Snapshot copy
Information required for using the snapdrive snap restore command
Restoring a Snapshot copy
Restoring a Snapshot copy from a different host
Volume-based SnapRestore
What volume-based SnapRestore is
Considerations for using volume-based SnapRestore
Mandatory checks for volume-based SnapRestore
Checks that can be overridden by the user
Volume-based SnapRestore command
Information about LUNs mapped to local or remote hosts
Host filespec information for a particular volume
Volume-based SnapRestore for space reservation
Connecting to a Snapshot copy
How the snapdrive snap connect command works
Connecting Snapshot copies on mirrored storage systems
Connecting multiple storage entities
Snapshot connect and Snapshot restore operations
Guidelines for connecting Snapshot copies
Information required for using the snapdrive snap connect command
Connecting to a Snapshot copy that contains LUNs
Connecting to a Snapshot copy of storage entities other than LUNs
Connecting to Snapshot copies of shared storage entities other than LUNs
Splitting a volume clone or LUN clone
Estimating the storage space to split a volume clone
Estimating the storage space to split a LUN clone
Estimating the storage space using a Snapshot copy
Starting the volume clone or LUN clone split
Viewing the status of a volume clone or LUN clone split
Stopping the volume clone or LUN clone split operation
Viewing the result of clone split using job id or file specification
Deleting a Snapshot copy
Command to use to delete Snapshot copies
Reasons to delete Snapshot copies
Guidelines for deleting Snapshot copies
Information required for using the snapdrive snap delete command
Deleting a Snapshot copy
Disconnecting a Snapshot copy
Using the Snapshot disconnect operation
Guidelines for disconnecting Snapshot copies
Guidelines for disconnecting Snapshot copies for NFS entities
Information required for using the snapdrive snap disconnect command
Disconnecting Snapshot copy with LUNs and no storage entities
Disconnecting Snapshot copy with storage entities
Disconnecting Snapshot copies with shared storage entities
Data collection utility
About the data collection utility
Tasks performed by snapdrive.dc
Executing the data collection utility
Examples of using snapdrive.dc
Troubleshooting
Understanding error messages
Error message locations
Error message format
Sample error message
Common error messages
Operating system limits on open files
Deleting LUNs and clones leave stale devices in UNIX
Error message values
If a volume is deleted on the Vserver without unmounting the volume on the host system, the snapdrive storage show command displays the incorrect actual path
Snap restore operation fails when you have nfsv3 and nfsv4 versions enabled in the host and storage system
Snap disconnect operation fails to delete cloned volume
SnapDrive for UNIX reports an error if iSCSI is not running
Discrepancy in the error code message
Commands appear blocked
Clustering message appears during SnapRestore
Standard exit status values
Understanding exit status values of error messages
Using exit status values
Script example
Exit status values
Volume-based SnapRestore check fails
Snapshot create and delete operation fails
Unable to create a Snapshot copy
Unable to restore a Snapshot copy
Unable to restart the daemon-host cannot communicate to the storage system
(AIX) MPIO cfmode support limited
Unable to start the daemon- due to port issues
Ghost device handle in AIX
snapdrived start command fails
SnapDrive commands sometimes result in mounting or unmounting file systems and modify system files
Unable to select a storage stack
snapdrived stop or snapdrived start command hangs
SnapDrive for UNIX command displays could not check access error
Mounting a FlexVol volume fails in NFS environment
SnapDrive for UNIX incorrectly interprets the dollar sign
SnapDrive for UNIX storage create command fails while discovering some mapped devices
SnapDrive for UNIX commands fail with customized LD_LIBRARY_PATH
SnapDrive operations fail in multiple subnet configuration
SnapDrive for UNIX commands fail when environment variables are set using a command shell
Cannot install SnapDrive for UNIX patches on AIX by default
SnapDrive for UNIX does not automatically delete stale devices in UNIX
Command reference
Collecting information needed by SnapDrive for UNIX commands
Collecting information needed by commands
General notes about the commands
Summary of the SnapDrive for UNIX commands
Command summary
Configuration command lines
Storage provisioning command lines
Host-side command lines
Snapshot operation command lines
SnapDrive for UNIX options, keywords, and arguments
Command-line options
Rules for keywords
Command-line keywords
Command-line arguments
Copyright information
Trademark information
How to send your comments