Dell EqualLogic PS6210XV EqualLogic Host Integration Tools for Linux Version 1 - Page 110

Using the ehcmcli Diagnostic Tool, ehcmcli Command Syntax

Get Dell EqualLogic PS6210XV PDF manuals and user guides View all Dell EqualLogic PS6210XV manuals
Add to My Manuals
Save this manual to your list of manuals

Page 110 highlights

• 11-eqlenv.rules This udev rule file sets up important environment variables and symlinks used by ehcmd and in other udev rule files. • 38-equallogic.rules These udev rules should serve as a guide for setting up systemwide udev rules for EqualLogic storage devices, and 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. This rule file applies only to the individual SD devices. Any other block-layer tuning done here will be bypassed by the top-level DM devices built by ehcmd. To tune those devices, see the information for the 38-equallogic.rules file. A number of distribution-specific files might be required to work with other distribution-specific udev rules, such as 64-eqllvm.rules or 89-eqlfinal.rules. These files are identified by a -eql prefix ( ??-eql*.rules), and contain internal comments that explain their function and purpose. Using the ehcmcli Diagnostic Tool The ehcmcli diagnostic tool reports the diagnostic state of the EqualLogic Host Connection Manager (ehcmd) and multipath device information. When entering ehcmcli commands, Bash command completion lets you type part of a command followed by a single horizontal tab, which completes the command. For more information, see Appendix C Bash Command Completion. ehcmcli Command Syntax The command syntax is as follows: ehcmcli [subcommand-1] [subcommand-2] [options] [argument] help [subcommand] dm create dm cleanup dm unload switch login --target target | -T [--portal IP-address-or-name | -p] [--hidden] [--login-at-boot | --no-login-at-boot] logout --target target | -T] [--no-login-at-boot] pr init --key key-name pr remove --key key-name pr status [--verbose] status [--verbose] The following table describes the commands and options for the ehcmcli tool. Table 43. ehcmcli Commands and Options Subcommands Required Options login --target | -T --portal | -p --hidden --login-at-boot --no-login-at-boot Argument Description target IP address or name Specifies --target to log in to one session to the specified PS Series group. Optional. Use --portal to provide the iSCSI portal IP address or name to log in if target is not already discovered on the system. Optional. Use --hidden to treat the login as a hidden ASM device. Optional. Use either --login-at-boot to set the node.startup values for the target to perform the login at the next reboot, or --no-login-at-boot to set the values to not perform the login at the next reboot. 110 Troubleshooting

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69
  • 70
  • 71
  • 72
  • 73
  • 74
  • 75
  • 76
  • 77
  • 78
  • 79
  • 80
  • 81
  • 82
  • 83
  • 84
  • 85
  • 86
  • 87
  • 88
  • 89
  • 90
  • 91
  • 92
  • 93
  • 94
  • 95
  • 96
  • 97
  • 98
  • 99
  • 100
  • 101
  • 102
  • 103
  • 104
  • 105
  • 106
  • 107
  • 108
  • 109
  • 110
  • 111
  • 112
  • 113
  • 114
  • 115
  • 116
  • 117
  • 118
  • 119
  • 120
  • 121
  • 122
  • 123
  • 124
  • 125
  • 126
  • 127
•
11-eqlenv.rules
This udev rule file sets up important environment variables and symlinks used by ehcmd and in other udev rule files.
•
38-equallogic.rules
These udev rules should serve as a guide for setting up systemwide udev rules for EqualLogic storage devices, and 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. This rule file applies only to the
individual SD devices. Any other block-layer tuning done here will be bypassed by the top-level DM devices built by ehcmd. To tune
those devices, see the information for the
38-equallogic.rules
file.
A number of distribution-specific files might be required to work with other distribution-specific udev rules, such as
64-eqllvm.rules
or
89-eqlfinal.rules
. These files are identified by a
-eql
prefix (
??-eql*.rules
), and contain internal comments that explain
their function and purpose.
Using the ehcmcli Diagnostic Tool
The ehcmcli diagnostic tool reports the diagnostic state of the EqualLogic Host Connection Manager (ehcmd) and multipath device
information. When entering ehcmcli commands, Bash command completion lets you type part of a command followed by a single
horizontal tab, which completes the command. For more information, see
Appendix C Bash Command Completion
.
ehcmcli Command Syntax
The command syntax is as follows:
ehcmcli [subcommand-1] [subcommand-2] [options] [argument]
help [subcommand]
dm create
dm cleanup
dm unload switch
login --target
target
| -T
[--portal
IP-address-or-name
| -p]
[--hidden]
[--login-at-boot | --no-login-at-boot]
logout --target
target
| -T]
[--no-login-at-boot]
pr init --key
key-name
pr remove --key
key-name
pr status [--verbose]
status [--verbose]
The following table describes the commands and options for the ehcmcli tool.
Table 43. ehcmcli Commands and Options
Subcommands
Options
Argument
Description
Required
login
--target | -T
--portal | -p
--hidden
--login-at-boot
--no-login-at-boot
target IP address
or
name
Specifies
--target
to log in to one session to the
specified PS Series group.
Optional.
Use
--portal
to provide the iSCSI portal IP
address or name to log in if
target
is not already
discovered on the system.
Optional.
Use
--hidden
to treat the login as a hidden
ASM device.
Optional.
Use either
--login-at-boot
to set the
node.startup
values for the target to perform the login
at the next reboot, or
--no-login-at-boot
to set the
values to not perform the login at the next reboot.
110
Troubleshooting