Dell EqualLogic PS6610E EqualLogic Host Integration Tools for Linux Version 1.
Dell EqualLogic PS6610E Manual
View all Dell EqualLogic PS6610E manuals
Add to My Manuals
Save this manual to your list of manuals |
Dell EqualLogic PS6610E manual content summary:
- Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 1
Dell EqualLogic Host Integration Tools for Linux Version 1.7 Installation and User's Guide - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 2
of data and tells you how to avoid the problem. WARNING: A WARNING indicates a potential for property damage, personal injury, or death. © 2020 Dell Inc. or its subsidiaries. All rights reserved. Dell, EMC, and other trademarks are trademarks of Dell Inc. or its subsidiaries. Other trademarks may be - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 3
Guide...8 Revision History...8 Audience...8 Related Documentation...8 Dell Online Services...8 Technical Support and Customer Service...8 Contacting Dell Configuration...16 Configuring HIT/Linux ...17 EqualLogic Configuration Utility (eqlconfig)...17 EqualLogic Host Performance and Tuning Suite ( - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 4
Example: Initializing a PS Series Array...26 Managing Access to a PS Series Group...26 Adding Access to a Group...26 Listing Accessible Groups...27 rswcli --list-group Command Syntax...27 Example: Listing Information for Groups...28 Modifying Access to a Group...28 rswcli --modify-group-access - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 5
Select a Smart Copy...45 Requirements for Creating Smart Copies...46 About Snapshot Space Borrowing...46 Methods of Creating Smart Copies...46 About Group Access Files...47 About Collections...47 About Smart Copy Schedules...48 Advantages of Smart Copy Schedules...48 Constraints of Smart Copy - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 6
...101 Thin-Provisioning a Volume...102 eqlvolume rethin Command Syntax...103 Examples: Analyzing Thin-Provisioning Recommendations 103 8 Troubleshooting...105 General Troubleshooting Guidelines...105 Ensuring Correct Operation of the dm-switch Kernel Module 105 Establishing iSCSI Sessions...105 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 7
Step 4: Complete the Installation...116 Disabling Active Management...117 Enabling Storage Cluster Support ...117 B Enabling iSCSI Offload on HIT/Linux 118 Step 1: Set Up and Verify Your Configuration...118 Step 2: Configure the Network Interfaces...118 Step 3: Configure ehcmd - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 8
into the Documentation page at the customer support site: https://eqlsupport.dell.com/support/resources.aspx?id=2495 NOTE: You must log in to the Dell customer support site to access these pages. Dell Online Services To learn more about Dell EqualLogic products and new releases being planned, visit - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 9
state of your configuration • Dell EqualLogic Volume Rethinning Facility (eqlvolume)-Manages the available storage on thin-provisioned volumes • Capability to import EqualLogic storage to PowerStore. For more information see Importing External Storage to PowerStore Guide. Terminology The following - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 10
additional terminology specific to Dell EqualLogic storage products, see the Dell EqualLogic Master Glossary. PS Series manual. Table 1. PS Series Group Network Recommendations Recommendation Switched Gigabit Ethernet network Description Connect arrays and computers to a switched network. Dell - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 11
instructions. Topics: • Obtain the Installation Kit • Installation Prerequisites • Installation Procedure • Configuration • Verification Obtain the Installation Kit Obtain the installation kit from the Dell EqualLogic customer support solutions provided in the Troubleshooting section. Verify that the - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 12
Dell EqualLogic devices so multipathd does not attempt to manage them. For more information, see Migrating to HIT/Linux Multipath I/O. However, the multipathd daemon is required to manage PowerStore devices. Therefore, to import EqualLogic storage to PowerStore, make sure that the multipathd service - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 13
manually install the required Linux packages. Installation Procedure This section describes installing HIT/Linux from the ISO image (equallogic-host-tools-version.iso) you downloaded from the Dell support kit from the EqualLogic customer support site, per the instructions in Obtain the Installation - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 14
Mount the ISO image in the /media/iso directory: # mount -o loop equallogic-host-tools-version.iso /media/iso After mounting, you should see the mix of supported and unsupported kernels. • The --nogpgcheck option specifies not to check the integrity of packages using GPG. Dell recommends not - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 15
/usr/sbin/asmcli Dell EqualLogic Auto-Snapshot Manager CLI (ASMCLI) /usr/sbin/ehcmd EqualLogic Host Connection Manager daemon /usr/sbin/ehcmcli EqualLogic Host Connection Manager CLI /usr/sbin/eqlconfig EqualLogic Configuration Utility /usr/sbin/eqllog EqualLogic Log Gathering Facility - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 16
Dell EqualLogic tools Location of the End-Users License Agreement (EULA) and license Uninstalling HIT/Linux You are not required to manually a supported version, and reboot if prompted by the operating system update. See Supported Linux Distributions for information on supported operating - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 17
I/O. You can instruct the eqlconfig utility to begin the procedure by running: # eqlconfig --mpio --migrate For more information about eqlconfig, see EqualLogic Configuration Utility (eqlconfig). Step 5: Discover iSCSI Targets and Create Sessions to Volumes After the iSCSI service is running, run - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 18
EqualLogic Host Performance and Configuration Tuning Suite (eqltune) verifies a Linux system for optimal iSCSI performance configuration. The suite analyzes a large number of system settings for compliance with Dell choose individual NICs, and then starts the services. In the process, it merges the - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 19
load on the volume. The critical block device verification is the SCSI device timeout value. HIT/Linux configures the timeout value, based on the EqualLogic udev rules installed with HIT/Linux. Example rules are also provided in the installed udev file that demonstrate how to set other block device - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 20
Logical Volume Management (LVM) The LVM device filter expressions must be set up to exclude hidden Dell EqualLogic DM devices. All LVM configuration settings are in /etc/lvm/lvm.conf. EqualLogic Host Tools This category summarizes whether the running ehcmd process has detected warnings or errors on - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 21
EqualLogic Host Tools Running system checks 0 0 0 2 eqlvolume checks 0 0 0 3 Run in verbose mode (eqltune -v) for more details and instructions boot. If by default this is 'manual', you can designate only those nodes you • Ensure that your network supports PS Series group, discover your - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 22
• Users must have credentials for access rights to volumes in PS Series groups. • Volumes must have snapshot space reserved to create snapshots. See the Dell EqualLogic PS Series Group Administrator's Guide. • The group and volume must be configured for replication to create volume replicas. See the - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 23
3 Remote Setup Wizard Command Line Interface The Remote Setup Wizard Command Line Interface (RSWCLI) provides setup commands that you can execute at the Linux command prompt and a command line interface where you can perform all required setup actions. Topics: • General Command Syntax for the RSWCLI - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 24
could take up to a minute) 1 uninitialized PS Series array found. Service Tag: JJRKWP1 Serial Number: SHU0935411YBF04 Array MAC Address for eth0: 00:09 :30 Host Adapter MAC Address: 00:26:B9:3A:2C:35 Firmware Version: X.Y.Z Supported RAID Levels: 6, 10, 50 Disk Info: 15 931.52GB 7200rpm SATA(HDD) - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 25
access to the PS Series array to be initialized. Only IPv4 addresses are supported. Designates the service tag or serial number of the PS Series array to be initialized. The --service-tag parameter is not supported on all versions of the PS Series array firmware. Optional Parameters --admin none - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 26
Dell EqualLogic arrays, but it can be configured using the Group Manager CLI. For more information about RAID policies on PS Series systems, see the Dell group IP from the list of discovered portals. If a group has been manually discovered with iscsiadm, you do not need to add group access with the - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 27
The following table describes the required and optional command parameters. Table 7. Add Group Access Command Parameters Parameter Abbr. Required Parameters Argument Description --group-name --gn group-name Designates the name of the PS Series group to which access is being configured. -- - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 28
Example: Listing Information for Groups In the following example, the list command produces a list of names and IP addresses for a PS Series group to which access is configured. # rswcli --list-group --gn farm31-grp Processing list-group command... Groups accessible from this computer: Group Name: - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 29
-group-access command... The remove-group-access command succeeded. Configuring Multipath I/O Several configuration parameters control the behavior of the EqualLogic Host Connection Manager daemon (ehcmd). The rswcli -mpio-parameters command lets you view and modify the most commonly used multipath - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 30
least one iSCSI session to the volume. By default, the EqualLogic Host Connection Manager (ehcmd) uses the software iSCSI initiator to -m discoverydb -p group-IP-address -t st -o new delete -D NOTE: Support of the iscsiadm -m discoverydb command syntax applies to systems with version 2.0-872 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 31
example: # ehcmcli login --target iqn.2001-05.com.equallogic:0-290c06-52f7c99c61a2000001aa4f479-myvolume Login succeeded. Device to mount: For example: # mkfs.ext4 /dev/eql/VolA For a list of supported file systems, see Supported File systems. 3. Specify a directory and create a mount point for the - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 32
• EqualLogic storage supports partitions (for example, using fdisk), but recommends using file systems on To connect the volumes, set the node.startup property to automatic for individual iSCSI targets. Dell recommends that you not set the default node.startup property to automatic in the iscsid. - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 33
group member, reducing the amount of I/O forwarding that is necessary between members. HIT/Linux includes two components that use this configuration: • The EqualLogic Host Connection Manager daemon (ehcmd) monitors the iSCSI session state and the configuration of the Linux server and PS Series group - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 34
Figure 1. Dell EqualLogic Multipath Device Configuration - Logical View Table 11. Callouts in Figure 1 Callout Number Description of Feature 1 Host file system or application using a block device 2 Device Mapper - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 35
are used for I/O. For information on the supported path selection policies, see Conditions for Configuring four iSCSI sessions to a single EqualLogic volume located on two group members /eql/vol5 To avoid volume name symlink collisions, Dell recommends that every volume to which you connect have - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 36
Dell EqualLogic devices so multipathd does not attempt to manage them. For more information, see Migrating to HIT/Linux Multipath I/O. However, the multipathd daemon is required to manage PowerStore devices. Therefore, to import EqualLogic storage to PowerStore, make sure that the multipathd service - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 37
For additional information troubleshooting problems with the dm-switch kernel module, see Assuring Correct the hosts using HIT multipathing to connect to volumes on the group. See the Dell EqualLogic PS Series Storage Arrays Release Notes for the current configuration limits. Setting MPIO Parameters - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 38
Table 12. MPIO Optional Parameters Parameter Abbr. --max-sessions-per-volume-slice maxvols --max-sessions-per-entire-volume maxvole --default-load-balancing dlb --io-per-path ios --min-adapter-speed --use-mpio-snapshots --useip or --useip6 minsp msnap ip or ip6 Argument 1-4 1-12 LQD or RR - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 39
to include for MPIO. You can specify a subnet, an adapter identified by a user-defined string, an IP address, or a MAC address. Dell recommends using a subnet or adapter name based on inclusion/exclusion rules. rswcli --mpio-include Command Syntax rswcli --mpio-include | -I [--network ip-address - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 40
Parameter --mask --adapter --mac Abbr. none none none --ip-address --force none none --default none Argument subnet-mask adapter-name mac-address ip-address none include|exclude Description Specifies a subnet mask to include. Used with the -network parameter. Specifies a user-defined string - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 41
adapter identified by a user-defined string, an IP address, or a MAC address. Dell recommends using a subnet or adapter name based on inclusion/exclusion rules. Including or Excluding settings applied to all volumes. The ehcmd command supports volume-specific settings for the following parameters: • - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 42
file: [MPIO Volume Params LogVol*] IOPerPath = 100 By default, SuppressPartitions is set to False, which enables you to use partitions on an EqualLogic device. Some software solutions, such as the XEN server, might not detect volumes correctly if a partitioned device is present. To suppress creating - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 43
Auto-Snapshot Manager/Linux Edition (ASM/LE) is a component of Dell EqualLogic Host Integration Tools for Linux. ASM/LE is installed as part of the HIT/Linux installation and presented as a configuration option. Topics: • About ASM/LE • - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 44
accessible from Linux systems. It is also accessible as a CLI.) For troubleshooting, it might be necessary to access and manage a Smart Copy from the PS Series group using the Group Manager GUI. However, Dell recommends that you manage Smart Copies from ASM/LE and not the Group - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 45
replication partner and is accessible only on the local host. Replica clones support the same functions as clones (for example, list, mount, unmount, through the Dell EqualLogic Group Manager GUI. For more information, see the Dell EqualLogic PS Series Group Manager Administratorʼs Guide. HIT/Linux - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 46
Copy was created • By the source target volume name ASM/LE supports the following glob syntax: • Asterisk (*) matches zero or more configuring a replication partnership with the Group Manager, see the Dell EqualLogic Group Manager Administrator's Guide. • To create a clone Smart Copy, there must - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 47
be safely frozen and thawed, so the Smart Copy operation fails. NOTE: Make sure the elements of a collection support your intended backup and restore plans. Dell recommends creating collections only for objects that are logically related to restore as a group. Avoid creating collections that contain - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 48
of Smart Copy Schedules Using Smart Copy schedules provides several advantages over manual Smart Copy creation: • You can name commonly used commands for on the PS Series group. See the Dell EqualLogic Group Manager Administrator's Guide for details. For information about commands for schedule - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 49
did at the time you created the Smart Copy, unless you manually change the restored mount points to reference different volumes, such in a Smart Copy, you must mount it first. Mounting a Smart Copy supports mount points, physical locations in the partition that server uses as an access point - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 50
creates a new snapshot that represents the current state of the volume.) 6. Sets the EqualLogic volumes online 7. Logs in sessions to the EqualLogic volumes 8. Rebuilds the DM devices to support the EqualLogic volumes 9. Mounts the file systems About Restoring a Soft-Deleted Smart Copy When a Smart - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 51
When a clone is purged from the volume recovery bin, either manually or automatically, no confirmation message is given. Use the asmcli list -copy --source /mnt/vol2 --type clone Dell EqualLogic Auto-Snapshot Manager CLI Version 1.7.0 Copyright (c) 2010-2020 Dell Inc. The mount point has been frozen. - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 52
-copy --type clone --check-status Dell EqualLogic Auto-Snapshot Manager CLI Version 1.7.0 Copyright (c) 2010-2020 Dell Inc. Smart Copies Source: rhel69x.mycompany is visible and you can mount the Smart Copy. You can also manually purge the volume from the Group Manager, which deletes it from the - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 53
status --group-access-file \ voladmin-sles Dell EqualLogic Auto-Snapshot Manager CLI Version 1.7.0 Copyright (c) 2010-2020 Dell Inc. Smart Copies Source: rhel69x.mycompany used by other, unrelated applications. Make sure your collections support your intended backup and restore plans. • Do not - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 54
about these features, see Introduction to ASM/LE. Entering ASMCLI Commands Commands are executed from the Linux command prompt in one of two ways: • Manually typing the command, using command help to see options that complete a command (see General Command Syntax for ASMCLI and Access Help on ASMCLI - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 55
• Use of the equal sign (=) to specify a value to parameters is optional. For example, --name=eqlgroup1 and --name eqlgroup1 are equivalent. • Not shown in the syntax for an ASMCLI command is the --verbose option, which you can use to display more detailed information. For more verbose output - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 56
[--schedule schedule-name | -S] [--source mount-point1 [mount-point2...] -s] [--type volume-type | -t] [--volume volume-name] Table 16. ASMCLI Search Options Search Option Parameter --collection Abbr. -c Argument collection-name --comment -C comment-string --copy-group --copy-volume --group - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 57
are used by ASM/LE to connect to PS Series groups when needed to support ASM/LE functions, such as Smart Copy creation. When you create a group access establishing pool or volume administrators. See the Dell EqualLogic Group Manager Administrators Guide for information on setting up pool and - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 58
Parameter --name --user-name Optional Parameters --file --ip-address --management-ip --no-password --password Abbr. -n -u -f -i -I none -p Argument group-name user-name Description Specifies the name of the PS Series group. Specifies the user name on the PS Series group. file-location IP-address - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 59
volumes are administered by volume administrator accnt-admin. The system administrator creates a group access record in the default group access file, /etc/equallogic/asm-group-access for user-admin to manage Smart Copies for the user volumes. The system administrator uses the default group access - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 60
Successfully created credentials record in file /etc/equallogic/asm-group-access. # asmcli list group-access Group Access Group name: Group1 IP address: 192.x.x.xx User names: user-voladmin Group name: Group2 IP address: - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 61
Group name: IP address: User names: eqlgroup2 192.x.x.xy j_smith Group name: IP address: User names: eqlgroup8 192.x.x.zz John_Smith 3 Groups defined. Example 2: Listing Group Access Records for a Specific Group To list group access information for the group eqlgroup1, specify a group name: # - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 62
Parameter --user-name Abbr. -u Argument user-name Description Specifies the user name on the PS Series group. Examples: Updating Group Access Information This section includes examples of replacing a group access file, changing a group name, updating a group access file for a management IP, and - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 63
--no-password Successfully updated credentials for user "user-voladmin" in group "Group2" in file /etc/equallogic/asm-group-access. # asmcli list group-access Group Access Group name: Group1 IP address: 192.x.x.xx User names: user-voladmin Group name: Group2 IP address: - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 64
recommends that you restrict unauthorized access by setting up pool or volume administration accounts. See the Dell EqualLogic PS Series Group Manager Administrator's Guide. 2. Save one or more administrator user names and passwords in a group access file. If you do not specify the password as an - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 65
[--force | -F] [--freeze-time n] [--group-access file-location | -g] [--object object-id | -o] [--output error | always] [--read-only | -R] [--retry-count n | -r] [--retry-wait n | -w] [--type volume-type | -t] [--username user-name | -u] The following table describes the required and optional - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 66
Parameter --retry-wait --type Abbr. -w -t --user-name -u Argument n volume-type clone|replica| snapshot| thinclone user-name Description Specifies the number of seconds to wait before retrying a failed operation. Specifies the Smart Copy type to create. If omitted, creates snapshot. ASMCLI - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 67
Created snapshot volb-2017-01-05-14:39:14.221.1 on glengrp Created snapshot volc-2017-01-05-14:39:14.222.1 on glengrp Created snapshot vola-2017-01-05-14:39:14.223.1 on glengrp All mount points (3) have been thawed. Successfully created a Smart Copy from 3 targets. Example 4: Retrying Creation of - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 68
Smart Copies Source: myhost.mycompany.com : /mnt/asm-acl Replica: 02-Feb-2017 14:58:37.692088 ObjectId: b-6d91c1-b5427dfda-ccfc656a321b56aa asm-acl on windev33-grp --> asm-acl.1-2017-02-02-01:50:58.533.1 on HitStore4 1 Smart Copy found. # asmcli create smart-copy --object b-6d91c1-b5427dfda- - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 69
# asmcli delete group-access --name Group3 --user-name grpadmin Successfully deleted credentials for user "grpadmin" in group "Group3" in file /etc/equallogic/asm-group-access. # asmcli list group-access Group Access Group name: Group2 IP address: 192.x.x.xx User names: grpadmin Group name: Group3 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 70
Suggestion: Please increase snapshot reserve or delete unnecessary snapshots. For scheduled operations, consider using "keep count" (see "asmcli help schedule"). The mount point has been frozen. Created snapshot myvol-user1-2017-08-16-09:49:20.465.1 on group9 The mount point has been thawed. - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 71
Snapshot: 05-Jan-2017 16:24:29.074310 Status: Mounted as /snapshots/VolB ObjectId: c-01e943-574012772-74bc9cfd88221283 Directory: /var/lib/equallogic/asm/smart-copies/asm-le-hosta.com/source-121a09d-9ce520990-c75a20bb9b1eb86f/ File: 20120104-212429.074310-c-01e943-574012772-74bc9cfd88221283.bcd volb - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 72
/mnt/mnt4 Replica: 28-Feb-2017 10:42:54.077954 ObjectId: f-ceea53-2f409c86e-6b29668578db1cac Directory: /mnt/asm/asm-le-node202.equallogic.com/source-e-794700- 706f6e2b2-c25ce4ca6fda4f46/ File: 20120222-154254.077954-f-ceea53-2f409c86e-6b29668578db1cac.bcd vol1 on group1 --> vol1.3-2017-02-22-11 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 73
Search option parameters also apply to this command. For information, see ASMCLI Search Options. The following table describes the optional command parameters. Table 23. Delete Smart Copy Optional Command Parameters Parameter Abbr. Argument Description --broken -B none Deletes broken Smart - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 74
Example 2: Deleting a Smart Copy Identified By Object ID To ensure you are deleting the correct Smart Copy, list Smart Copies in very verbose mode to display full information for the Smart Copies. # asmcli list smart-copy --source /source/VolB -verbose Smart Copies Source: hostname.mycompany.com : - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 75
: Restoring Smart Copies The following example restores a Smart Copy from a source mount point. # asmcli restore smart-copy --source /mnt/eql/std-vol-06 Dell EqualLogic Auto-Snapshot Manager CLI Version 1.7.0 Copyright (c) 2010-2020 Inc. Unmounted /mnt/eql/std-vol-06 Logged out iqn.2001-05.com - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 76
ns-gl1 /mnt/ns-gl2 Clone: 18-May-2017 18:47:38.101719 ObjectId: d-ae90fe-d14693ed0-4b94835698ac308b Directory: /tmp/asm3/asm-le-ns.equallogic.com/source-e-86ca5b- e4f2bf9ea-3660dd7d9ae03f4b/ File: 20170518-224738.101719-d-ae90fe-d14693ed0-4b94835698ac308b.bcd ns-gl1 --> ns-gl1-clone-2017:05:18-18:47 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 77
-gl1 /mnt/ns-gl2 Clone: 18-May-2017 18:47:38.101719 ObjectId: d-ae90fe-d14693ed0-4b94835698ac308b Directory: /tmp/asm3/asm-le-ns.equallogic.com/source-e-86ca5be4f2bf9ea-3660dd7d9ae03f4b/ File: .20170518-224738.101719-d-ae90fe-d14693ed0-4b94835698ac308b.bcd ns-gl1 --> ns-gl1-clone-2017:05:18-18:47:38 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 78
Description Creates a Smart Copy of a synchronous replication volume. Supports snapshots and clones only. --mount Mounts a synchronous replication volume is in the SyncAlternate pool. >> vol1 on system1 {system1.equallogic.com} Suggestion: Switch to SyncAlternate using the group manager UI. - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 79
• Change the schedule without modifying any scripts or cron tables. When the scheduled operation is included in a script or cron table, you can use ASMCLI to change the options to the create smart-copy command without making other changes (see Creating a Smart Copy). • Locate Smart Copies created by - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 80
Option Abbr. --group-access-file -g --keep -K --output none --retry-count -r --retry-wait -w --type -t --user-name -u Argument Description the operation times out and a consistent Smart Copy is not created. For most configurations, the default time is sufficient. When creating Smart - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 81
Table 27. List Schedule Optional Command Parameter Parameter Argument Description --name schedule-name Specifies the name of the scheduled operation. Examples: Listing Schedules This section includes examples of listing schedules with verbose output and listing schedules that are enabled in - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 82
# Run this scheduled operation every 15 minutes */15 * * * * asmcli do schedule --name 15min >/dev/null # Run this scheduled operation every hour 0 * * * * asmcli do schedule --name hourly >/dev/null # asmcli list smart-copy Smart Copies Source: hostname.mycompany.com : /vol1 Snapshot: 10- - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 83
vola01 --> vola01-2017-01-10-10:59:07.16866 on windev11-grp Snapshot: 10-Jan-2017 11:00:01.853586 Description: Test schedule cron: 15 minutes Schedule: 15min Collection: test1 vola01 --> vola01-2017-01-10-10:59:07.16867 on windev11-grp Snapshot: 10-Jan-2017 11:15:01.881889 Description: - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 84
Example 2: Running a Schedule in a Cron Job In this example, the scheduled operation is included in a cron table. You can modify the schedule with ASMCLI (see Updating a Schedule) without modifying any scripts or cron tables. That is, you can change the options on the create smart-copy command at - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 85
The following table describes the required and optional command syntax. Table 29. Update Schedule Command Options Parameter Abbr. Required Parameter Argument Description --name -n schedule-name Specifies the name of the schedule. Optional Parameters --collection -c collection-name - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 86
Parameter --user-name Abbr. -u Argument user-name Description Specifies a particular user identity, when multiple user names have been stored in the group access file. Examples: Updating Schedules This section includes examples of updating a schedule to change the Smart Copy type, to change a - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 87
1 schedule found. # asmcli update schedule --name user-hourly --delete comment Successfully updated schedule "user-hourly". # asmcli list schedule Schedules Name: user-hourly Command: asmcli create schedule --keep 24 --type snapshot --source /user1 /user2 /user3 1 schedule found. Example 4: - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 88
access, the journals are replayed and the changes are made to on-disk structures, but no further changes can be made to the file system. A problem might occur if a file system journal contains critical updates but the media is read-only. For example, if a journal needs to be replayed but the - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 89
3. Unmount the file system. asmcli mount smart-copy Command Syntax The command syntax is as follows: # asmcli mount smart-copy --destination directory-name | -d [--group-access-file file-location | -g] [--output always | error] [--read-only | -R] [--retry-count n | -r] [--retry-wait n | -w] [-- - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 90
: 14-Dec-2016 10:46:44.839798 Status: Mounted as /snapshots/VolA ObjectId:5-392e06-8244f99a7-88d5834731b41690 Directory: /var/lib/equallogic/asm/smart-copies/asm-le-hosta./sourcea-5d5e2d-874d8ac30-0d2df1dc89f8932c/ File: 20161214-154644.839798-5-392e06-8244f99a7-88d5834731b41690.bcd vola --> vola - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 91
2. Specify the object ID in the unmount command: # asmcli unmount smart-copy --object 5-392e06-8244f99a7-88d5834731b41690 If you know the Smart Copy is the latest created, you can bypass using the Object ID and unmount using the --latest option. Similarly, you can unmount the earliest-created Smart - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 92
: Logged-in Description: Hourly snapshot of user space Schedule: user-hourly ObjectId: 8-b8b03d-7444e1f3e-626856b008bde08e Directory: /var/lib/equallogic/asm/smart-copies/asm-le-dk-test2.com /source-1-21a09d-9ce520990-c75a20bb9b1eb86f/ File: 20170105-220557.846661-8-b8b03d-7444e1f3e-626856b008bde08e - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 93
: Logged-in Description: Hourly snapshot of user space Schedule: user-hourly ObjectId: 8-b8b03d-7444e1f3e-626856b008bde08e Directory: /var/lib/equallogic/asm/smart-copies/asm-le-dk-test2.com /source-1-21a09d-9ce520990-c75a20bb9b1eb86f/ File: 20170105-220557.846661-8-b8b03d-7444e1f3e-626856b008bde08e - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 94
asmcli create collection Command Syntax The command syntax is as follows: # asmcli create collection --name collection-name --source mount-point1 [mount-point2...] The following table describes the required command parameters. Table 35. Create Collection Required Command Options Parameter --name - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 95
Example: Listing Collections This example specifies the name daily-user-vols and displays a collection containing three volumes. # asmcli list collection --name daily-user-vols Collections Name: Mount point: Mount point: Mount point: daily-user-vols /source/VolA /source/VolB /source/VolC 1 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 96
Example 2: Deleting from a Collection This example deletes the volume VolC from the collection. # asmcli list collection --name daily-user-vols Collections Name: Mount point: Mount point: Mount point: daily-user-vols /source/VolA /source/VolB /source/VolC 1 collection found. #asmcli update - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 97
that support them. You can also display a list of volumes recommended for thin-provisioning (also called rethinning) or that are mounted with the -o discard option, and specify which volumes are to be thin-provisioned. NOTE: See the Dell EqualLogic PS Series Group Manager Administratorʼs Guide for - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 98
thin-provisioning and to run volume thin-provisioning either manually or as a scheduled maintenance activity. On-demand volume list of mount points to thin-provision instead of all mount points supported by EqualLogic volumes. Similarly, the eqlvolume rethin --exclude command specifies mount points - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 99
to recover any significant free space on the volume. EqualLogic volume characteristics that prevent eqlvolume from recommending thin-provisioning include was originally part of which file system. If a target volume supports multiple file systems through logical volumes or partitions, and one or - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 100
place, increase this parameter and/or ReThinHeadroom. Show Mount Point Information Use the eqlvolume show command to locate the file systems, or mount points, supported by EqualLogic volumes and to display characteristics of those mount points and volumes. 100 Managing Thin-Provisioned Volumes - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 101
by Auto Snapshot Manager (ASM). • Each mount point is represented in a single line above the volume name and group name of the EqualLogic volume used to support it. • Relationships are shown by grouping the mount points above the volume on the PS Series group. In this example, the LVM Logical - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 102
vg11 on eqlgroup1 1.71 GB 100.00 GB 1.7% thin /lv12a /lv12b /lv12c vg12 on eqlgroup1 150 MB 150 MB 150 MB 5.07 GB 9.84 GB 9.84 GB 9.84 GB 100.00 GB 1.5% 1.5% 1.5% 5.1% ext4 ext4 ext4 thin /VolA 5.18 GB 98.43 GB 0.2% vola on eqlgroup2 2.65 GB 100.00 GB 2.7% ext3 thin /mnt/temp/lv11a 662 MB - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 103
information on these parameters, see Volume Thin-Provisioning Configuration Parameters. # eqlvolume rethin --recommend --verbose Locating all mount points supported by EqualLogic targets. Logged into PS Series group 192.x.x.xy (eqlgroup2) as username grpadmin There is 1 mount point recommended for - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 104
for thin-provisioning, and the reasons those volumes are not recommended. # eqlvolume rethin --verbose --recommend Locating all mount points supported by EqualLogic targets. Logged into PS Series group 192.x.x.xy (eqlgroup2) as username linux-server (VolumeAdmin) Logged into PS Series group 192 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 105
the scope of the problem, use iscsiadm to manually attempt to log in to a volume from each Ethernet port. In addition, you can run eqltune and look at diagnostic information to configure an optimal Linux multipath I/O environment. For information on using eqltune, see EqualLogic Host Performance and - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 106
daemon. If restarting the daemon does not correct the problem, look at the iscsiadm error diagnostics. Logical Volume Manager EqualLogic devices. See EqualLogic Host Performance and Tuning Suite (eqltune) for additional details. LVM Filtering Rules for EqualLogic Devices The EqualLogic Troubleshooting - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 107
When you configure LVM on EqualLogic volumes, enable replication, and then promote a replica volume, Dell recommends that you retain the original target volume name for the promoted replica volume because LVM only recognizes the original volume name and not a new volume name. Troubleshooting 107 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 108
Using the eqllog Facility To gather information for EqualLogic support, you can run the EqualLogic Log Gathering Facility (eqllog) to collect system logs and information of the eqllog command without any options. # eqllog Capturing EqualLogic configuration, logs, and state 108 Troubleshooting - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 109
Copy directory /var/log/equallogic as logs Copy directory /etc/equallogic as etc Capture 'ehcmcli -dv' to 'ehcmcli appropriate rules for the given device (if any), and then returns with instructions to the kernel concerning the device. For more information, enter man udev on : Troubleshooting 109 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 110
• 38-equallogic.rules These udev rules should serve as a guide for setting up systemwide udev rules for EqualLogic storage devices rules Set the SCSI subsystem device timeout to 60 seconds for every Dell EqualLogic iSCSI session. This rule file applies only to the individual SD Troubleshooting - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 111
ehcmcli help pr). Builds the initial DM devices for all current EqualLogic devices. Removes any unmanaged DM devices (/dev/mapper devices created target to not perform the login at the next reboot. Instructs ehcmcli to gather diagnostic data and report the current multipathing Troubleshooting 111 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 112
the volume has a problem, an explanatory message services are running; otherwise, start the service: # service iscsid start # service ehcmd start • The required services are set to auto-start: # chkconfig --list iscsid # chkconfig --list ehcmd Running the ehcmd Daemon The EqualLogic Troubleshooting - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 113
device characteristics are incompatible with that operation. After changing the partition table on an EqualLogic storage volume device, log out and log in to that volume to refresh the partition partition devices on a volume, see Setting Volume-Specific Configuration Parameters. Troubleshooting 113 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 114
Linux system connected to Dell EqualLogic PS Series storage to use service interruption is inevitable. Be aware of limitations associated with SAN Boot Volumes. If you have questions about migrating these volumes, contact Dell Support for assistance. During the migration procedure, do not manually - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 115
manual block device migration. In another shell, check the output of 'ehcmcli status' for the device names that have been created, and migrate all services and applications to use the new devices before proceeding. Consult the user guide for further instructions on your EqualLogic volumes, ensure - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 116
multipathd), you must manually unmount the file system and run ehcmcli login --target target to recreate the EqualLogic DM devices after service is running. For more information about importing to PowerStore, see the Importing External Storage to PowerStore Guide. You must blacklist all EqualLogic - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 117
EqualLogic no changes. Consult the user guide for further instructions. Choose action (Enable/Abort/Quit Storage Add-On, is supported. If you followed all LVM setup instructions, you do not need instructions for LVM in Logical Volume Manager Considerations. NOTE: Although not strictly required, Dell - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 118
=eth3 Jan 14 17:38:03 rh6-910 kernel: bnx2i: iSCSI not supported, dev=eth2 Jan 14 17:38:05 rh6-910 kernel: bnx2i: iSCSI not supported, dev=eth1 Jan 14 17:38:07 rh6-910 kernel: bnx2i: iSCSI not supported, dev=eth0 When enabled, messages similar to the following will display: Jan - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 119
specify using the Broadcom iSCSI offload initiator, edit the /etc/equallogic/eql.conf file and set the IscsiInitiator parameter: IscsiInitiator = tcp even if they are properly configured with an IP address. To manually start the iscsid service, you can either log in to at least one iSCSI session - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 120
After rediscovering the targets, you will see that the isciadm interface records have been updated by ehcmd. For example: # iscsiadm -m iface default tcp,,,, iser iser,,,, bnx2i.a4:ba:db:38:8b:40 bnx2i,a4:ba:db:38:8b:40,1.2.3.4,, - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 121
in HIT/Linux are integrated with a Bash programmable command completion facility. The Bash commandcompletion script, installed as /etc/bash_completion.d/equallogic, integrates with the following CLIs: • Remote Setup Wizard Command Line Interface (rswcli) • Auto-Snapshot ManagerCommand Line Interface - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 122
If you enter s followed by a tab, Bash completes the command with the source parameter: # asmcli create smart-copy --s # asmcli create smart-copy --source As a general rule, type as much as you think will enable Bash to complete the command. If you are unsure of the options, enter a command, - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 123
Support DKMS manually, download the package from https://github.com/dell/dkms. Dell recommends using version 2.2.0.1 or later. • To verify if your system is using the correct DKMS version or the prebuilt binary version, enter the following command: # rpm -q equallogic - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 124
Index A add-group-access command parameters 27 ASM Command Line Interface, See ASMCLI ASM/LE about authentication files 47 about data restoration 50 accessing volumes and snapshots 22 automatic authentication 47, 57 best practices 53 collections 47, 93 configuration 16 configure 21 description 9 - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 125
recommend for thin-provisioning 99 show 100 thin-provisioning 102 EqualLogic Log Gathering Facility See eqllog 108 Ethernet interface 9 EULA accepting iSCSI sessions 32 K kernel module dm-switch 33 L Linux filesystems supported 12 list collection command options 94 list group-access command options - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 126
thin-provisioned volumes 97 thin-provisioning as scheduled maintenance 98 considerations for 99 multiple file systems 99 on-demand 97 realtime 97 troubleshooting general guidelines 105 LVM and replica volumes 107 running ehcmd as a foreground task 112 using ehcmcli 110 using eqllog 108 using eqltune - Dell EqualLogic PS6610E | EqualLogic Host Integration Tools for Linux Version 1. - Page 127
volume (continued) ASM/LE access to 22 displaying connections to 32 increasing size of 105 layout 48 managing 100 mount points referenced 49 partitioning 42, 113 recovery bin 76 setting configuration parameters 41 synchronous replication 77 thin-provisioning 102 thin-provisioning parameters 100
Dell EqualLogic Host Integration Tools for
Linux
Version 1.7
Installation and User’s Guide