Adding unsupported disk arrays to the DISKS category


Adding unsupported disk arrays to the DISKS category
Prev	How to administer the Device Discovery Layer	Next

Disk arrays should be added as JBOD devices if no Array Support Library (ASL) is available for the array.

JBODs are assumed to be Active/Active (A/A) unless otherwise specified. If a suitable ASL is not available, an A/A-A, A/P or A/PF array must be claimed as an Active/Passive (A/P) JBOD to prevent path delays and I/O failures. If a JBOD is ALUA-compliant, it is added as an ALUA array.

Warning:

The procedure in this section ensures that Dynamic Multi-Pathing (DMP) is set up correctly on an array that is not supported by Veritas Volume Manager.

If DMP is not set up correctly, Veritas Volume Manager treats the independent paths to the disks as separate devices, which can result in data corruption.

To add an unsupported disk array to the DISKS category

Use the following command to identify the vendor ID and product ID of the disks in the array:
```
# /etc/vx/diag.d/vxscsiinq device_name
```
where device_name is the device name of one of the disks in the array. Note the values of the vendor ID (VID) and product ID (PID) in the output from this command. For Fujitsu disks, also note the number of characters in the serial number that is displayed.

The following example output shows that the vendor ID is SEAGATE and the product ID is ST318404LSUN18G.
```
Vendor id (VID)     : SEAGATE
Product id (PID)    : ST318404LSUN18G
Revision            : 8507
Serial Number       : 0025T0LA3H
```
Stop all applications, such as databases, from accessing VxVM volumes that are configured on the array, and unmount all file systems and Storage Checkpoints that are configured on the array.
If the array is of type A/A-A, A/P or A/PF, configure it in autotrespass mode.
Enter the following command to add a new JBOD category:
```
# vxddladm addjbod vid=vendorid [pid=productid] \
[serialnum=opcode/pagecode/offset/length] \
[cabinetnum=opcode/pagecode/offset/length] policy={aa|ap}]
```
where vendorid and productid are the VID and PID values that you found from the previous step. For example, vendorid might be FUJITSU, IBM, or SEAGATE. For Fujitsu devices, you must also specify the number of characters in the serial number as the argument to the length argument (for example, 10). If the array is of type A/A-A, A/P or A/PF, you must also specify the policy=ap attribute.

Continuing the previous example, the command to define an array of disks of this type as a JBOD would be:
```
# vxddladm addjbod vid=SEAGATE pid=ST318404LSUN18G
```
Use the vxdctl enable command to bring the array under VxVM control.
```
# vxdctl enable
```

To verify that the array is now supported, enter the following command:

# vxddladm listjbod

The following is sample output from this command for the example array:

VID     PID          SerialNum            CabinetNum   Policy
                 (Cmd/PageCode/off/len) (Cmd/PageCode/off/len)
==============================================================
SEAGATE ALL PIDs  18/-1/36/12           18/-1/10/11    Disk
SUN     SESS01    18/-1/36/12           18/-1/12/11    Disk

To verify that the array is recognized, use the vxdmpadm listenclosure command as shown in the following sample output for the example array:

# vxdmpadm listenclosure
ENCLR_NAME ENCLR_TYPE ENCLR_SNO STATUS    ARRAY_TYPE LUN_COUNT
==============================================================
Disk       Disk       DISKS     CONNECTED Disk       2

The enclosure name and type for the array are both shown as being set to Disk. You can use the vxdisk list command to display the disks in the array:

# vxdisk list
DEVICE   TYPE       DISK     GROUP      STATUS
Disk_0   auto:none  -        -          online invalid
Disk_1   auto:none  -        -          online invalid
...

To verify that the DMP paths are recognized, use the vxdmpadm getdmpnode command as shown in the following sample output for the example array:
```
# vxdmpadm getdmpnode enclosure=Disk
NAME   STATE   ENCLR-TYPE PATHS ENBL DSBL ENCLR-NAME
=====================================================
Disk_0 ENABLED Disk       2     2    0    Disk
Disk_1 ENABLED Disk       2     2    0    Disk
...
```
The output in this example shows that there are two paths to the disks in the array.

For more information, enter the command vxddladm help addjbod.

See the vxddladm(1M) manual page.

See the vxdmpadm(1M) manual page.

Prev	Up	Next
Listing supported disks in the DISKS category	Home	Removing disks from the DISKS category