Dell EqualLogic PS6210XS EqualLogic Host Integration Tools for Linux Version 1
Dell EqualLogic PS6210XS Manual
View all Dell EqualLogic PS6210XS manuals
Add to My Manuals
Save this manual to your list of manuals |
Dell EqualLogic PS6210XS manual content summary:
- Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 3
This Guide...8 Revision History...8 Audience...8 Related Documentation...8 Dell Online Services...8 Technical Support and Customer Service...8 Contacting Dell...8 1 Introduction to HIT/Linux...9 Overview...9 Terminology...9 PS Series Group Network Recommendations...10 2 Installing and Configuring - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 4
Host Access to a Group...29 rswcli --remove-group-access Command Syntax...29 Example: Removing Host Access to Group...29 Configuring Multipath I/O...29 4 Configuring Multipath I/O Devices 30 Accessing Volumes Using Multipath I/O...30 Discovering Targets...30 Log In to an MPIO Volume...31 Logging - Dell EqualLogic PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 6
Systems...99 Volume Thin-Provisioning Configuration Parameters 100 Show Mount Point Information Provisioning Recommendations 103 8 Troubleshooting...105 General Troubleshooting Guidelines...105 Ensuring Correct 114 Before You Begin ...114 Step 1: Install HIT Linux in Migration Mode ...114 Step 2: - Dell EqualLogic PS6210XS | 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 to Use the Offload - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 8
to configure and manage Dell EqualLogic PS Series groups from a Linux host. Revision History Document Number 110-6312-EN Revision R1 Date April 2020 Description Version 1.7 initial release Audience The information in this document is intended for administrators responsible for installing and - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 9
setup utility to: • Discover and initialize PS Series arrays • Configure and manage access to a PS Series group • Set configuration parameters for Multipath I/O (MPIO) • Manage which subnets are used for MPIO • Dell EqualLogic installation process. • Dell EqualLogic Host Performance and Configuration - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 10
, see the Dell EqualLogic Master Glossary. PS Series Group Network Recommendations The following table describes the network recommendations for PS Series group operation and for computer access to the group. All the normal networking rules apply; however, network configuration is beyond the - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 11
was successful, follow the Verification 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 web site. To download HIT - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 12
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 is running. For more information see Importing External Storage to PowerStore Guide. 12 Installing and Configuring HIT/Linux - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 13
package manager to verify and install the Dell EqualLogic host tools and packages and to resolve any dependencies. As the installation script executes, it installs the HIT/Linux software and guides you through the initial system configuration. The installation script accomplishes the following - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 14
are installed only in certain situations or for certain Linux distributions. For a full listing of all files that were installed, run the following commands after a successful installation. • For user package contents: # rpm -q equallogic-host-tools --filesbypkg 14 Installing and Configuring HIT - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 15
components. Table 2. Installation Components Path Configuration Files Description /etc/equallogic/eql.conf Configuration file location for HIT/Linux /etc/equallogic/eqltune.d/ Eqltune-specific configuration scriptlets Binary Applications /usr/sbin/asmcli Dell EqualLogic Auto-Snapshot - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 16
man/man8/ /usr/share/docs/equallogichost-tools-version/ Description Location of manpages for Dell EqualLogic tools Location of the End-Users License Agreement (EULA) and license Uninstalling HIT/Linux You are not required to manually uninstall the HIT/Linux kit when performing an update. HIT/Linux - Dell EqualLogic PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 18
errors and completes the installation. • Runs through the configuration process for Multipath I/O and ASM/LE. For MPIO configurations, eqlconfig reviews the network protocol and subnets, and presents available subnets or lets you choose individual NICs, and then starts the services. In the process - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 19
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 settings - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 20
up to exclude hidden Dell EqualLogic DM devices. All LVM configuration settings are in /etc/lvm/lvm.conf. EqualLogic Host Tools This category 1 0 Ethernet Devices eth8 0 0 2 1 eth5 0 0 2 1 eth7 0 0 2 1 eth6 0 0 2 1 eth9 0 0 2 1 20 Installing and Configuring HIT/Linux - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 21
environment as follows: • Ensure that your network supports PS Series group, discover your PS Series group, and set MPIO configuration parameters, if required. • Ensure that your PS Series groups meet requirements. See PS Series Group Network Recommendations Installing and Configuring HIT/Linux 21 - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 22
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 PS Series Group Administrator's Guide. Access to Volumes and Snapshots To log in - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 23
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 • Configuration - Discovering a PS Series Array • Initializing a PS Series Array • Managing Access to a PS Series Group • Listing - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 24
4F: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) -subnet subnet_mask | --msub --member-gateway IPv4_address | --mgwy --service-tag service-tag | --st 24 Remote Setup Wizard Command Line Interface - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 25
addresses are supported. --group- are supported. controlling access to the PS Series array to be initialized. Designates the IP Address of the gateway to use for access to the PS Series array to be initialized. Only IPv4 addresses are supported. Designates the service is not supported on all versions - Dell EqualLogic PS6210XS | 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 the list of discovered portals. If a group has been manually discovered with iscsiadm, you do not need to add Setup Wizard Command Line Interface - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 27
a list of the names and IP addresses of all PS Series groups to which access is configured for this host. rswcli --list-group Command Syntax The command syntax is as follows: rswcli --list- Series groups to which access is configured for this host. Remote Setup Wizard Command Line Interface 27 - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 28
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 --ngn new31-grp Processing modify-group-access command... 28 Remote Setup Wizard Command Line Interface - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 29
command succeeded. Configuring Multipath I/O Several configuration parameters control the behavior of the EqualLogic Host Connection Manager information on configuring multipath I/O using the rswcli --mpio-parameters command parameters, see Configuring Multipath I/O Devices. Remote Setup Wizard - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 30
EqualLogic Host Connection Manager (ehcmd) uses the software iSCSI initiator to connect to volumes. For information on enabling and configuring 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 31
a single session, the EqualLogic Host Connection Manager (ehcmd) will analyze the configuration and create additional iSCSI system. 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 new - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 32
EqualLogic storage supports partitions (for example, using fdisk), but recommends using file systems on the full volume instead of partitions on that volume. • If you want to suppress creating partition devices on a volume, see Setting Volume-Specific Configuration Dell recommends it to control the - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 33
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. Running in the background, ehcmd uses - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 34
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 layer-The Device Mapper allows layering block devices to set up a multipath configuration - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 35
I/O. For information on the supported path selection policies, see Conditions for Configuring Multipath Devices. 5 SD block Configuration The following example output from the dmsetup table illustrates a typical configuration that results from creating four iSCSI sessions to a single EqualLogic - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 36
Multipath Devices Certain conditions should be met to successfully configure multipath devices using HIT/Linux. Use of the multipathd Daemon The multipathd daemon is not required for EqualLogic devices. Blacklist Dell EqualLogic devices so multipathd does not attempt to manage them. For more - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 37
troubleshooting problems with the dm-switch kernel module, see Assuring Correct Operation of the dmswitch Kernel Module. Configuring Settings for Multipath I/O HIT/Linux lets you configure . See the Dell EqualLogic PS Series Storage Arrays Release Notes for the current configuration limits. Setting - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 38
... MPIO Parameters: Max sessions per volume slice: 3 Max sessions per entire volume: 12 Minimum adapter speed: 1000 Default load balancing policy configuration: Round Robin (RR) IOs Per Path: 16 Use MPIO for snapshots: Yes Internet Protocol: IPv6 The mpio-parameters command succeeded. Example - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 39
, 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 Specifies a subnet to include. Used with the --mask parameter. Configuring Multipath I/O Devices 39 - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 40
list Adapter Rules: Included: eth0 Excluded: All Other All other subnets, adapters or ip addresses are excluded by default. The mpio-include command succeeded. 40 Configuring Multipath I/O Devices - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 41
a user-defined string, an IP address, or a MAC address. Dell recommends using a subnet or adapter name based on inclusion/exclusion rules. Configuration Parameters The configuration parameters in the MPIO Parameters section are global settings applied to all volumes. The ehcmd command supports - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 42
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 file: [MPIO Volume Params LogVol03] SuppressPartitions = True 42 Configuring Multipath I/O Devices - Dell EqualLogic PS6210XS | 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 • About Smart Copies • About Collections • About Smart Copy - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 44
It is also accessible as a CLI.) For troubleshooting, it might be necessary to access and manage a Smart Series group using the Group Manager GUI. However, Dell recommends that you manage Smart Copies from ASM/LE groups and the volume must be configured for replication. When replication begins, - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 45
host. Replica clones support the same functions as Configuring synchronous replication volumes and switching the roles of the two storage pools must be performed through the Dell EqualLogic Group Manager GUI. For more information, see the Dell EqualLogic PS Series Group Manager Administratorʼs Guide - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 46
the source target volume name ASM/LE supports the following glob syntax: • Asterisk (*) configuring a replication partnership with the Group Manager, see the Dell EqualLogic Group Manager Administrator's Guide Smart Copy creation and allow you to control the timing, frequency, and number of retained - Dell EqualLogic PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 48
you create once and use repeatedly. You can also control how many Smart Copies ASM/LE preserves. To Using Smart Copy schedules provides several advantages over manual Smart Copy creation: • You can name configured on the PS Series group. See the Dell EqualLogic Group Manager Administrator's Guide - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 51
bin, either manually or automatically, no confirmation message is given. Use the asmcli list smart-copy --check-status command to review the current state 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 - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 58
IP Address In this example, the --management-ip option is used to create a group access file for PS Series groups that are configured with separate IP addresses for management: asmcli create group-access --name eqlgroup1 --ip-address 192.x.x.xx --management-ip eqlmgmt1.mycompany.com --user - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 62
"sample" to "eqlgroup8" in file "/etc/ mycompany/asm-group-access". Example 3: Updating the Group Access File for a Management IP This example configures a PS Series group with a separate IP address for management. Use the --management option to specify the management IP address: # asmcli update - Dell EqualLogic PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 64
or volume administration accounts. See the Dell EqualLogic PS Series Group Manager Administrator's Guide. 2. Save one or more administrator create smart-copy --source mount-point --username user-name NOTE: The interactive installation script asks if you want to enter and save passwords for each PS - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 65
file systems when creating a Smart Copy. If this value is exceeded, the operation times out and a consistent Smart Copy is not created. For most configurations, the default time is sufficient. When creating Smart Copies with a large number of mount points or a heavy I/O load, ASM/LE might not have - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 77
: d-ae90fe-d14693ed0-4b94835698ac308b Directory: /tmp/asm3/asm-le-ns.equallogic.com/source-e-86ca5be4f2bf9ea-3660dd7d9ae03f4b/ File: .20170518-224738.101719-d-ae90fe-d14693ed0 available from the Group Manager interface. NOTE: To configure synchronous replication volumes or to switch from the active - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 80
-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 Copies with a large number of mount points or a heavy I/O load, ASM/LE might not - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 85
systems when updating a Smart Copy. If this value is exceeded, the operation times out and a consistent Smart Copy is not updated. For most configurations, the default time is sufficient. If you are updating Smart Copies with a significant number of mount points or a heavy I/O load, ASM/LE might - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 97
Dell EqualLogic PS Series Group Manager Administratorʼs Guide for considerations and limitations regarding thin-provisioned volumes. Topics: • About Thin-Provisioning • Considerations for Thin-Provisioning • Volume Thin-Provisioning Configuration systems might not support the realtime discard - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 98
supported by ASM/LE. Select ext4 or xfswhen installing SLES 12. On-Demand Thin-Provisioning On-demand thin-provisioning enables you to disable realtime volume thin-provisioning and to run volume thin-provisioning either manually of all mount points supported by EqualLogic volumes. Similarly, the - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 99
Series groups by eqlvolume is controlled by entries in the group the file system and the EqualLogic volume, as well as defined configuration parameters to determine if a part of which file system. If a target volume supports multiple file systems through logical volumes or partitions, and - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 100
Configuration Parameters Configuration parameters in /etc/equallogic/eql.conf control the behavior of the eqlvolume rethin command. The eqlvolume tool uses these parameters, with file system and EqualLogic FITRIM ioctl is supported. On systems where FITRIM ioctl is not supported, this parameter and - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 103
new parameter value. For more 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 - Dell EqualLogic PS6210XS | 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 PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 106
problem, look at the iscsiadm error diagnostics. Logical Volume Manager (LVM) Considerations If you are using Logical Volume Manager (LVM) to manage the disk space on your EqualLogic volumes, the following considerations can apply. eqltune will automatically configure which will review the filters - Dell EqualLogic PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 108
Displays the installed version of eqllog review the contents of the tar file to ensure it is free of such information. Example: eqllog Output The following shows the output of the eqllog command without any options. # eqllog Capturing EqualLogic configuration, logs, and state 108 Troubleshooting - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 109
equallogic as logs Copy directory /etc/equallogic Capturing iSCSI configuration and state instructions to the kernel concerning the device. For more information, enter man udev on a Linux system. HIT/Linux automatically installs a set of udev rule files on your system.These files are installed - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 110
demonstrate how this setup can be done by setting the readahead value for all EqualLogic devices to 1024kb. You can copy this file to /etc/udev/ rules.d/39-eql_user.rules for customization. • 99-eqlsd.rules Set the SCSI subsystem device timeout to 60 seconds for every Dell EqualLogic iSCSI session - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 111
the initial DM devices for all current EqualLogic devices. Removes any unmanaged DM devices (/ the login at the next reboot. Instructs ehcmcli to gather diagnostic data and report a list of all volumes for which multipathing is configured by ehcmd. If the list does not contain all Troubleshooting 111 - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 112
is unable to create the desired number of iSCSI sessions due to iSCSI login errors. If this problem occurs, verify that all Ethernet ports are properly configured on the host and that the access control record on the volume allows iSCSI logins from all Ethernet ports. • The daemon cannot communicate - Dell EqualLogic PS6210XS | 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 creating partition devices on a volume, see Setting Volume-Specific Configuration Parameters. Troubleshooting 113 - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 114
an existing Linux system connected to Dell EqualLogic PS Series storage to use HIT/Linux multipath I/O (MPIO). If you are installing HIT/Linux in an environment without previously configured storage, follow the basic installation steps in Installing and Configuring HIT/Linux. NOTE: This migration is - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 115
steps: 1. As part of the installation, eqltune added filtering rules to your LVM configuration file (/etc/lvm/lvm.conf) to exclude all EqualLogic lower-tier devices on most simple setups. If your system uses a more complicated filtering setup, you might need to manually ensure that all devices under - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 116
sure that the multipathd service is running. For more information about importing to PowerStore, see the Importing External Storage to PowerStore Guide. You must blacklist all EqualLogic devices in the multipath configuration file (multipath.conf). As part of the installation, eqltune fix introduces - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 117
an EqualLogic top-tier eqlconfig immediately, making no changes. Consult the user guide for further instructions. Choose action (Enable/Abort/Quit) [Enable]: • is supported. If you followed all LVM setup instructions, you do not need to take special action when performing a fresh installation or - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 118
that HIT/Linux is installed on your system and that ehcmd is running and using the (default) TCP initiator. Follow the steps in this chapter to enable Broadcom iSCSI offload functionality for HIT/Linux. Topics: • Step 1: Set Up and Verify Your Configuration • Step 2: Configure the Network Interfaces - Dell EqualLogic PS6210XS | 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 any bnx2i adapters, even if they are properly configured with an IP address. To manually start the iscsid service, you can either log in to at least - Dell EqualLogic PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 121
, installed as /etc/bash_completion.d/equallogic, integrates with the following CLIs: • Remote Setup Wizard Command Line Interface (rswcli) • Auto-Snapshot ManagerCommand Line Interface (asmcli) • EqualLogic Host Connection Manager Command Line Interface (ehcmcli) • EqualLogic Configuration Utility - Dell EqualLogic PS6210XS | 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 PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 123
system is configured to use the Extra Packages for Enterprise Linux (epel) repository. DKMS is automatically installed by the HIT/Linux installation script. No further action is needed. • To install DKMS manually, download the package from https://github.com/dell/dkms. Dell recommends using version - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 124
authentication 47, 57 best practices 53 collections 47, 93 configuration 16 configure 21 description 9 environment prerequisites 22 group requirements 22 introduction ehcmd daemon command syntax 112 configuring for offload iSCSI initiator 119 controlling behavior of 29 creating interface records 32 - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 125
EqualLogic Log Gathering Facility See eqllog 108 Ethernet interface 9 EULA accepting from command line 14 F FITRIM volume thin-provisioning 99 G group access adding 26 listing 27 Smart Copy login 64 group management 26 H HIT/Linux configuration 16, 17 installation Linux filesystems supported 12 list - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 126
to 26 modifying access to 28 removing host access to 29 R Remote Setup Wizard Command Line Interface, See RSWCLI restore smart-copy command options 75 for 99 multiple file systems 99 on-demand 97 realtime 97 troubleshooting general guidelines 105 LVM and replica volumes 107 running ehcmd as - Dell EqualLogic PS6210XS | EqualLogic Host Integration Tools for Linux Version 1 - Page 127
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 volume rethinning, See thin-provisioning volume slice 10 volume
Dell EqualLogic Host Integration Tools for
Linux
Version 1.7
Installation and User’s Guide