IBM DS System Storage common commands examples

root's picture

In these examples, we will use dscli command without connecting to the storage device by using a profile. If you want to configure yours, check the following tutorial on iBM website. However, if you are connected directly to the storage device, you can use them without it, just stick with bold green from the examples below.

How to list the physical disks attached to the storage with lsddm command:

The unassigned ones from our example below are newly added - after a minute they will be automatically initialised and seen differently, depending of RAID level: spare required or unconfigured.

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]lsddm IBM.1750-6969696[/color][/b]
Date/Time: November 12, 2010 10:47:18 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
ID                             DA Pair dkcap (10^9B) dkuse          arsite State
=================================================================================
IBM.1750-522-6969696/R0-P1-D1  0                73.0 spare required S3     Normal
IBM.1750-522-6969696/R0-P1-D2  0                73.0 array member   S1     Normal
IBM.1750-522-6969696/R0-P1-D3  0                73.0 array member   S3     Normal
IBM.1750-522-6969696/R0-P1-D4  0                73.0 array member   S3     Normal
IBM.1750-522-6969696/R0-P1-D5  0                73.0 array member   S3     Normal
IBM.1750-522-6969696/R0-P1-D6  0                73.0 array member   S4     Normal
IBM.1750-522-6969696/R0-P1-D7  0                73.0 array member   S4     Normal
IBM.1750-522-6969696/R0-P1-D8  0                73.0 array member   S4     Normal
IBM.1750-522-6969696/R0-P1-D9  0                73.0 array member   S4     Normal
IBM.1750-522-6969696/R0-P1-D10 0                73.0 array member   S1     Normal
IBM.1750-522-6969696/R0-P1-D11 0                73.0 array member   S1     Normal
IBM.1750-522-6969696/R0-P1-D12 0                73.0 array member   S1     Normal
IBM.1750-522-6969696/R0-P1-D13 0                73.0 spare required S2     Normal
IBM.1750-522-6969696/R0-P1-D14 0                73.0 array member   S2     Normal
IBM.1750-522-6969696/R0-P1-D15 0                73.0 array member   S2     Normal
IBM.1750-522-6969696/R0-P1-D16 0                73.0 array member   S2     Normal
IBM.1750-EX2-6839366/R0-P1-D1  0               300.0 unassigned     -      New
IBM.1750-EX2-6839366/R0-P1-D2  0               300.0 unassigned     -      New
IBM.1750-EX2-6839366/R0-P1-D3  0               300.0 unassigned     -      New
IBM.1750-EX2-6839366/R0-P1-D4  0               300.0 unassigned     -      New
IBM.1750-EX2-6839366/R0-P1-D5  0               300.0 unassigned     -      New
IBM.1750-EX2-6839366/R0-P1-D6  0               300.0 unassigned     -      New
IBM.1750-EX2-6839366/R0-P1-D7  0               300.0 unassigned     -      New
IBM.1750-EX2-6839366/R0-P1-D8  0               300.0 unassigned     -      New
IBM.1750-EX2-6854765/R0-P1-D1  0                73.0 array member   S13    Normal
IBM.1750-EX2-6854765/R0-P1-D2  0                73.0 array member   S15    Normal
IBM.1750-EX2-6854765/R0-P1-D3  0                73.0 array member   S15    Normal
IBM.1750-EX2-6854765/R0-P1-D4  0                73.0 array member   S15    Normal
IBM.1750-EX2-6854765/R0-P1-D5  0                73.0 array member   S15    Normal
IBM.1750-EX2-6854765/R0-P1-D6  0                73.0 array member   S16    Normal
IBM.1750-EX2-6854765/R0-P1-D7  0                73.0 array member   S16    Normal
IBM.1750-EX2-6854765/R0-P1-D8  0                73.0 array member   S16    Normal
IBM.1750-EX2-6854765/R0-P1-D9  0                73.0 array member   S16    Normal
IBM.1750-EX2-6854765/R0-P1-D10 0                73.0 array member   S13    Normal
IBM.1750-EX2-6854765/R0-P1-D11 0                73.0 array member   S13    Normal
IBM.1750-EX2-6854765/R0-P1-D12 0                73.0 array member   S13    Normal
IBM.1750-EX2-6854765/R0-P1-D13 0                73.0 array member   S14    Normal
IBM.1750-EX2-6854765/R0-P1-D14 0                73.0 array member   S14    Normal
IBM.1750-EX2-6854765/R0-P1-D15 0                73.0 array member   S14    Normal
IBM.1750-EX2-6854765/R0-P1-D16 0                73.0 array member   S14    Normal
IBM.1750-EX2-6864352/R0-P1-D1  0                73.0 spare required S7     Normal
IBM.1750-EX2-6864352/R0-P1-D2  0                73.0 array member   S5     Normal
IBM.1750-EX2-6864352/R0-P1-D3  0                73.0 array member   S7     Normal
IBM.1750-EX2-6864352/R0-P1-D4  0                73.0 array member   S7     Normal
IBM.1750-EX2-6864352/R0-P1-D5  0                73.0 array member   S7     Normal
IBM.1750-EX2-6864352/R0-P1-D6  0                73.0 array member   S8     Normal
IBM.1750-EX2-6864352/R0-P1-D7  0                73.0 array member   S8     Normal
IBM.1750-EX2-6864352/R0-P1-D8  0                73.0 array member   S8     Normal
IBM.1750-EX2-6864352/R0-P1-D9  0                73.0 array member   S8     Normal
IBM.1750-EX2-6864352/R0-P1-D10 0                73.0 array member   S5     Normal
IBM.1750-EX2-6864352/R0-P1-D11 0                73.0 array member   S5     Normal
IBM.1750-EX2-6864352/R0-P1-D12 0                73.0 array member   S5     Normal
IBM.1750-EX2-6864352/R0-P1-D13 0                73.0 spare required S6     Normal
IBM.1750-EX2-6864352/R0-P1-D14 0                73.0 array member   S6     Normal
IBM.1750-EX2-6864352/R0-P1-D15 0                73.0 array member   S6     Normal
IBM.1750-EX2-6864352/R0-P1-D16 0                73.0 array member   S6     Normal
IBM.1750-EX2-6875242/R0-P1-D1  0                73.0 array member   S9     Normal
IBM.1750-EX2-6875242/R0-P1-D2  0                73.0 array member   S9     Normal
IBM.1750-EX2-6875242/R0-P1-D3  0                73.0 array member   S9     Normal
IBM.1750-EX2-6875242/R0-P1-D4  0                73.0 array member   S9     Normal
IBM.1750-EX2-6875242/R0-P1-D5  0                73.0 array member   S10    Normal
IBM.1750-EX2-6875242/R0-P1-D6  0                73.0 array member   S10    Normal
IBM.1750-EX2-6875242/R0-P1-D7  0                73.0 array member   S10    Normal
IBM.1750-EX2-6875242/R0-P1-D8  0                73.0 array member   S10    Normal
IBM.1750-EX2-6875242/R0-P1-D9  0                73.0 array member   S11    Normal
IBM.1750-EX2-6875242/R0-P1-D10 0                73.0 array member   S11    Normal
IBM.1750-EX2-6875242/R0-P1-D11 0                73.0 array member   S11    Normal
IBM.1750-EX2-6875242/R0-P1-D12 0                73.0 array member   S11    Normal
IBM.1750-EX2-6875242/R0-P1-D13 0                73.0 array member   S12    Normal
IBM.1750-EX2-6875242/R0-P1-D14 0                73.0 array member   S12    Normal
IBM.1750-EX2-6875242/R0-P1-D15 0                73.0 array member   S12    Normal
IBM.1750-EX2-6875242/R0-P1-D16 0                73.0 array member   S12    Normal

How to list the arrays with lsarraysite command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]lsarraysite[/color][/b]
Date/Time: November 12, 2010 1:09:41 PM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
arsite DA Pair dkcap (10^9B) State      Array
=============================================
S1     0                73.0 Assigned   A0
S2     0                73.0 Assigned   A0
S3     0                73.0 Assigned   A1
S4     0                73.0 Assigned   A1
S5     0                73.0 Assigned   A2
S6     0                73.0 Assigned   A2
S7     0                73.0 Assigned   A3
S8     0                73.0 Assigned   A3
S9     0                73.0 Assigned   A4
S10    0                73.0 Assigned   A4
S11    0                73.0 Assigned   A5
S12    0                73.0 Assigned   A5
S13    0                73.0 Assigned   A6
S14    0                73.0 Assigned   A6
S15    0                73.0 Assigned   A7
S16    0                73.0 Assigned   A7
S17    0               300.0 Unassigned -
S18    0               300.0 Unassigned -

How to create an array with mkarray command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]mkarray -dev IBM.1750-6969696 -raidtype 5 -arsite S17,S18[/color][/b]
Date/Time: November 12, 2010 2:06:00 PM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
CMUC00004I mkarray: Array A8 successfully created.

How to list the arrays with lsarray command:

A8 Array does not have rank yet so that is why it is unassigned

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]lsarray[/color][/b]
Date/Time: November 12, 2010 4:12:59 PM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
Array State      Data   RAIDtype  arsite  Rank DA Pair DDMcap (10^9B)
=====================================================================
A0    Assigned   Normal 5 (6+P+S) S1,S2   R0   0                 73.0
A1    Assigned   Normal 5 (6+P+S) S3,S4   R1   0                 73.0
A2    Assigned   Normal 5 (6+P+S) S5,S6   R2   0                 73.0
A3    Assigned   Normal 5 (6+P+S) S7,S8   R3   0                 73.0
A4    Assigned   Normal 5 (7+P)   S9,S10  R4   0                 73.0
A5    Assigned   Normal 5 (7+P)   S11,S12 R5   0                 73.0
A6    Assigned   Normal 5 (7+P)   S13,S14 R6   0                 73.0
A7    Assigned   Normal 5 (7+P)   S15,S16 R7   0                 73.0
A8    Unassigned Normal 5 (6+P+S) S17,S18 -    0                300.0

How to create a rank with the command mkrank:

We have several examples here, one of them is giving error because the licenced capacity was over exceeded.

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]mkrank -dev IBM.1750-6969696 -array A8 -stgtype fb -wait[/color][/b]
Date/Time: November 12, 2010 4:17:33 PM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
[color=red]CMUN02403E mkrank: Unable to create rank: licensed capacity has been exceeded.[/color]
if you try again without extending the license, you will have the surprise seeing the disks as being formatted.
root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]mkrank -dev IBM.1750-6969696 -array A8 -stgtype fb -wait[/color][/b]
Date/Time: November 12, 2010 2:46:54 PM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
[color=yellow]CMUN02428E mkrank: Unable to create rank. Disks are being formatted.[/color]
root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]mkrank -dev IBM.1750-6969696 -array A8 -stgtype fb -wait[/color][/b]
Date/Time: November 23, 2010 9:19:17 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
[color=green]CMUC00007I mkrank: Rank R8 successfully created.[/color]

How to list (lskey) and apply (applykey) a new license key to your storage device:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]lskey IBM.1750-6969696[/color][/b]
Date/Time: November 23, 2010 9:09:07 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
Activation Key              Authorization Level (TB) Scope
==========================================================
Operating environment (OEL) 5                        FB
root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]applykey -key XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX-XXXX IBM.1750-6969696[/color][/b]
Date/Time: November 23, 2010 9:10:04 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
CMUC00199I applykey: License Machine Code successfully applied to storage image IBM.1750-6969696.
root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]lskey IBM.1750-6969696[/color][/b]
Date/Time: November 23, 2010 9:10:52 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
Activation Key              Authorization Level (TB) Scope
==========================================================
Operating environment (OEL) 8                        All

How to list ranks with lsrank command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]lsrank[/color][/b]
Date/Time: November 23, 2010 9:33:27 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
ID Group State      datastate Array RAIDtype extpoolID stgtype
==============================================================
R0     0 Normal     Normal    A0           5 P0        fb
R1     1 Normal     Normal    A1           5 P1        fb
R2     0 Normal     Normal    A2           5 P2        fb
R3     1 Normal     Normal    A3           5 P3        fb
R4     0 Normal     Normal    A4           5 P4        fb
R5     1 Normal     Normal    A5           5 P5        fb
R6     0 Normal     Normal    A6           5 P6        fb
R7     1 Normal     Normal    A7           5 P7        fb
R8     - Unassigned Normal    A8           5 -         fb

How to list the pools with lsextpool command (use -l to see extra information):

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]lsextpool[/color][/b]                 
Date/Time: November 23, 2010 9:27:26 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
Name   ID stgtype rankgrp status availstor (2^30B) %allocated available reserved numvols
========================================================================================
Pool_0 P0 fb            0   full                 0        100         0        0       5
Pool_1 P1 fb            1   full                 0        100         0        0       5
Pool_2 P2 fb            0   full                 0        100         0        0       7
Pool_3 P3 fb            1   full                 0        100         0        0       7
Pool_4 P4 fb            0   full                 0        100         0        0       6
Pool_5 P5 fb            1   full                 0        100         0        0       6
Pool_6 P6 fb            0   full                 0        100         0        0       9
Pool_7 P7 fb            1  below                45         89        45        0       8

How to create a new pool with mkextpool command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]mkextpool -dev IBM.1750-6969696 -rankgrp 0 -stgtype fb Pool_8[/color][/b]
Date/Time: November 23, 2010 9:38:35 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
CMUC00000I mkextpool: Extent pool P8 successfully created.

How to attach the rank to the newly created pool with chrank command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]chrank -dev IBM.1750-6969696 -extpool P8 R8[/color][/b]
Date/Time: November 23, 2010 9:45:31 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
CMUC00008I chrank: Rank R8 successfully modified.

How to list ranks with lsrank command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.6969696 [color=green][b]lsrank[/color][/b]
Date/Time: November 23, 2010 9:47:21 AM CET IBM DSCLI Version: 5.2.422.20 DS: IBM.1750-6969696
ID Group State  datastate Array RAIDtype extpoolID stgtype
==========================================================
R0     0 Normal Normal    A0           5 P0        fb
R1     1 Normal Normal    A1           5 P1        fb
R2     0 Normal Normal    A2           5 P2        fb
R3     1 Normal Normal    A3           5 P3        fb
R4     0 Normal Normal    A4           5 P4        fb
R5     1 Normal Normal    A5           5 P5        fb
R6     0 Normal Normal    A6           5 P6        fb
R7     1 Normal Normal    A7           5 P7        fb
R8     0 Normal Normal    A8           5 P8        fb

How to list Volume Groups and which server is using them with lsvolgrp command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.69ABAY0 [color=green][b]lsvolgrp[/color][/b]
Date/Time: June 9, 2010 12:48:00 PM CEST IBM DSCLI Version: 5.2.422.20 DS: IBM.2107-69ABAY0
Name                ID  Type
=======================================
jupiter             V0  SCSI Mask
oesix               V1  SCSI Mask
venus               V2  SCSI Mask
egg                 V3  SCSI Mask
vbox		    V4  SCSI Mask
All Fixed Block-520 V30 OS400 All

How to list luns with lsfbvol command. In our example we grep for V0 volume group.

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.69ABAY0 [color=green][b]lsfbvol -l | grep -w V0[/color][/b]
jupiter_data1 1010 Online   Normal    Normal      2107-900  FB 512   P2      Standard      DS        36.0           -     75497472 V0
jupiter_data3 1057 Online   Normal    Normal      2107-900  FB 512   P20     Standard      DS        11.0           -     23068672 V0
jupiter_data2 1136 Online   Normal    Normal      2107-900  FB 512   P3      Standard      DS        36.0           -     75497472 V0
jupiter_data4 114A Online   Normal    Normal      2107-900  FB 512   P21     Standard      DS        11.0           -     23068672 V0

How to create a 11G lun with mkfbvol command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.69ABAY0 [color=green][b]mkfbvol -extpool P27 -name jupiter_data5 -cap 11 2704[/color][/b]
Date/Time: June 9, 2010 12:45:38 PM CEST IBM DSCLI Version: 5.2.422.20 DS: IBM.2107-69ABAY0
CMUC00025I mkfbvol: FB volume 2704 successfully created.

How to attach the newly created lun to a volume group with chvolgrp command:

root@gznim:/opt/ibm/dscli/profile # dscli -cfg dscli.profile.69ABAY0 [color=green][b]chvolgrp -action add -volume 2704 V0[/color][/b]
Date/Time: June 9, 2010 12:51:53 PM CEST IBM DSCLI Version: 5.2.422.20 DS: IBM.2107-69ABAY0
CMUC00031I chvolgrp: Volume group V0 successfully modified.

Thou shalt not steal!

If you want to use this information on your own website, please remember: by doing copy/paste entirely it is always stealing and you should be ashamed of yourself! Have at least the decency to create your own text and comments and run the commands on your own servers and provide your output, not what I did!

Or at least link back to this website.

Recent content