virtual grind thoughts from the virtual world


Reset Equallogic Member To Default Settings

In our lab environments, we are constantly using Equallogic members for various purposes. Sometimes, it is easier to simply reset an array and initialize it for quick use.

To reset an array to factory defaults, simply ssh in to the IP address of one of the network interfaces on your array and enter the reset command.

Reset this array to factory defaults? [n/DeleteAllMyDataNow] DeleteAllMyDataNow

Note that the array makes sure you want to reset the configuration by making you type in "DeleteAllMyDataNow".


Quickly Reset Equallogic Group Membership Password

I have run in to situations where I need to add new Equallogic members to groups that did not have the password documented. On an initial group configuration, settings such as group IP, grpadmin password, and membership password are chosen. Unfortunately, there is not an easy way to recover or see the membership password via the Group Manager.

Anyway, you can safely change the password to something new and NOT affect any existing settings to get a new member in.

To do this, simply ssh in to your group IP, and issue the grpparams and passwd commands:

Password for adding members: 1234
Retype password: 1234
Password change succeeded.


Clearing Equallogic Lost Raid Blocks

When there are issues with a lost block condition on a RAID volume on an Equallogic member, you may receive a "RAIDset lost blocks error" via the Group Manager or via an email/smtp message.

To get more info on the lost block(s), simply ssh in to an IP address of the member with the error and issue the following commands:

su exec 'raidtool'

Look for an error similar to *!! RAID LUN contains 8 lost blocks. !!* in the output:

*!! RAID LUN contains 8 lost blocks. !!*
(raidtool -W 1) clears blocks.
(raidtool -w 1) lists blocks.
14 Drives (14,15,16,46,18,19,20,21,22,23,24,25,26,27)
RAID 50 (64KB sectPerSU)
Capacity 23,489,351,516,160 bytes

In this example, we see that LUN 1 contains 8 bad blocks. To list the the bad blocks, we will use a -w (followed by LUN number) switch in the raidtool utility and to clear the lost blocks, we will use the -W (followed by LUN number).

List bad blocks:

su exec 'raidtool -w 1'

Clear bad blocks:

su exec 'raidtool -W 1'


Restarting the Equallogic Group Manager Interface

I have run in to a few occasions over the last couple of years where the Equallogic Group Manager interface stops responding. Usually, the statistics will start to fail or the login page is simply inaccessible.

To remedy this, you can restart the UI, with the following command via the CLI:

eqlinit restart-snap netmgtd

Please note that this does not restart your array, just the management interface.


Accessing the bash shell in Equallogic

Sometimes I need tools such as traceroute when troubleshooting connectivity between Equallogic arrays. This is especially useful when configuring features like replication.

From the main Equallogic shell, only certain Equallogic specific commands are available. To access the OS level shell, you can simply ssh in to your array and issue the command:

su exec bash

From the bash shell, you can issue OS level commands such as ifconifg and traceroute.


Quickly Determine An Equallogic Group Lead

When updating firmware (amongst other things) if you quickly need to check which member in a group is the lead, you can do so with the command:

su exec pm member

Simply ssh in to your group IP address or one of the specific member IP addresses and issue the command. Note that this command will also show you some useful statistics as well.

An example of the output from this command is below:

MEMBER-NAME-HERE [1.1447322343] 0-888888-999999-000000 pssId(4) Talisker(10)
total space : 1476818 pages 21633.08GB RAID-5
free space : 39861 pages 583.90GB (3%)
snap space : 0 pages 0.00MB (0%)
repl space : 9490 pages 139.01GB (1%)
status: (Online GL)

GL-group lead, RV-raid verification, BC-battery charging, RR-raid reconstruction

As you can see, some basic stats on the space is presented. In the "status" line, you also see that the member is online and that it contains "GL", which means it is currently the group lead. Via the legend at the bottom, you can also see that there is a possible GL, RV, BC, and RR status on the member as well.