How to recreate the missing symbolic links for a Veritas Array Support Library (ASL) not listed by 'vxddladm listversion'

Article: 100038082
Last Published: 2014-01-02
Ratings: 0 0
Product(s): InfoScale & Storage Foundation

Description

This document attempts to explain the steps required to recreate the missing symbolic links for Veritas Array Support Library (ASL) related files that are not listed by the CLI command "vxddladm listversion".

What is an Array Support Library?
 
An ASL is a small library written either by VERITAS or by an array vendor that does the work of identifying an array and telling DMP how to use the devices that are present in the array.  By splitting the discovery and path fail over routines into a separate library we can add support for new arrays without changing the base VxVM package.

The ASL libraries are installed in /etc/vx/lib/discovery.d.
There is a corresponding ASL related key file installed in /etc/vx/aslkey.d .

Note: Without the applicable ASL related files, the specific disks will be claimed under the generic DMP enclosure category.


Steps

1.] cd /etc/vx/aslkey.d

2.] Confirm if the symbolic link is present for the required ASL key file.

3.] If the symbolic link is missing, recreate it as follows:

Sample syntax

# ln -s /etc/vx/aslkey.d/libvxemc.key.1 libvxemc.key

4.] cd /etc/v/lib/discovery.d

 

5.] If the symbolic link is missing for the ASL library, recreate it as follows:

Sample syntax

# ln -s /etc/vx/lib/discovery.d/libvxemc.so.1 libvxemc.so

6.] Following the above changes to the aslkey.d and discovery.d directories, restart the Veritas Volume Manager "vxconfigd" daemon for the ASL updates to be detected.

# vxconfigd -k

 

Example

The EMC ASL "libvxemc.so" is not listed with the CLI command "vxddladm listversion". As a result the EMC Symmetrix luns will not be claimed by the required ASL.


# vxddladm listversion output
LIB_NAME                        ASL_VERSION      Min. VXVM version  
===================================================================
libvx3par.so                    vm-5.0-rev-1            5.0
libvxCLARiiON.so                vm-5.0-rev-3            5.0
libvxhds9980.so                 vm-5.0-rev-1            5.0
libvxhdsalua.so                 vm-5.0-rev-2            5.0
libvxhdsusp.so                  vm-5.0-rev-2            5.0
libvxhpalua.so                  vm-5.0-rev-1            5.0
libvxhpmsa.so                   vm-5.0-rev-2            5.0
libvxibmds4k.so                 vm-5.0-rev-2            5.0
libvxibmds6k.so                 vm-5.0-rev-2            5.0
libvxibmds8k.so                 vm-5.0-rev-1            5.0
libvxpp.so                      vm-5.0-rev-1            5.0
libvxxp1281024.so               vm-5.0-rev-1            5.0
libvxxp12k.so                   vm-5.0-rev-2            5.0


In the above instance  the symbolic link for the "libvxemc.key" file does not exist in the directory /etc/vx/aslkey.d.


Output prior to recreating the missing symbolic link



# ll

total 84
lrwxrwxrwx 1 root root  32 Jul 26  2011 libvx3par.key -> /etc/vx/aslkey.d/libvx3par.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvx3par.key.1
lrwxrwxrwx 1 root root  36 Jul 26  2011 libvxCLARiiON.key -> /etc/vx/aslkey.d/libvxCLARiiON.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxCLARiiON.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxcscovrts.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxemc.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxhds.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxhds9980.key -> /etc/vx/aslkey.d/libvxhds9980.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhds9980.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxhdsalua.key -> /etc/vx/aslkey.d/libvxhdsalua.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhdsalua.key.1
lrwxrwxrwx 1 root root  34 Jul 26  2011 libvxhdsusp.key -> /etc/vx/aslkey.d/libvxhdsusp.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhdsusp.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhitachi.key.1
lrwxrwxrwx 1 root root  34 Jul 26  2011 libvxhpalua.key -> /etc/vx/aslkey.d/libvxhpalua.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhpalua.key.1
lrwxrwxrwx 1 root root  33 Jul 26  2011 libvxhpmsa.key -> /etc/vx/aslkey.d/libvxhpmsa.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxhpmsa.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxibmds4k.key -> /etc/vx/aslkey.d/libvxibmds4k.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxibmds4k.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxibmds6k.key -> /etc/vx/aslkey.d/libvxibmds6k.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxibmds6k.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxibmds8k.key -> /etc/vx/aslkey.d/libvxibmds8k.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxibmds8k.key.1
lrwxrwxrwx 1 root root  30 Jul 26  2011 libvxpp.key -> /etc/vx/aslkey.d/libvxpp.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxpp.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxpurple.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxshark.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxveritas.key.1
lrwxrwxrwx 1 root root  37 Jul 26  2011 libvxxp1281024.key -> /etc/vx/aslkey.d/libvxxp1281024.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxxp1281024.key.1
lrwxrwxrwx 1 root root  33 Jul 26  2011 libvxxp12k.key -> /etc/vx/aslkey.d/libvxxp12k.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxxp12k.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxxp256.key.1

 
How to create the symbolic link for the "libvxemc.key.1" file


# ln -s /etc/vx/aslkey.d/libvxemc.key.1
libvxemc.key

Output post recreating the missing symbolic link


# ll
total 84
lrwxrwxrwx 1 root root  32 Jul 26  2011 libvx3par.key -> /etc/vx/aslkey.d/libvx3par.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvx3par.key.1
lrwxrwxrwx 1 root root  36 Jul 26  2011 libvxCLARiiON.key -> /etc/vx/aslkey.d/libvxCLARiiON.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxCLARiiON.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxcscovrts.key.1
lrwxrwxrwx 1 root root  31 May 24 14:24 libvxemc.key -> /etc/vx/aslkey.d/libvxemc.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxemc.key.1

-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxhds.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxhds9980.key -> /etc/vx/aslkey.d/libvxhds9980.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhds9980.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxhdsalua.key -> /etc/vx/aslkey.d/libvxhdsalua.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhdsalua.key.1
lrwxrwxrwx 1 root root  34 Jul 26  2011 libvxhdsusp.key -> /etc/vx/aslkey.d/libvxhdsusp.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhdsusp.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhitachi.key.1
lrwxrwxrwx 1 root root  34 Jul 26  2011 libvxhpalua.key -> /etc/vx/aslkey.d/libvxhpalua.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxhpalua.key.1
lrwxrwxrwx 1 root root  33 Jul 26  2011 libvxhpmsa.key -> /etc/vx/aslkey.d/libvxhpmsa.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxhpmsa.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxibmds4k.key -> /etc/vx/aslkey.d/libvxibmds4k.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxibmds4k.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxibmds6k.key -> /etc/vx/aslkey.d/libvxibmds6k.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxibmds6k.key.1
lrwxrwxrwx 1 root root  35 Jul 26  2011 libvxibmds8k.key -> /etc/vx/aslkey.d/libvxibmds8k.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxibmds8k.key.1
lrwxrwxrwx 1 root root  30 Jul 26  2011 libvxpp.key -> /etc/vx/aslkey.d/libvxpp.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxpp.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxpurple.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxshark.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxveritas.key.1
lrwxrwxrwx 1 root root  37 Jul 26  2011 libvxxp1281024.key -> /etc/vx/aslkey.d/libvxxp1281024.key.1
-r-xr-xr-x 1 root sys  112 Feb 26  2010 libvxxp1281024.key.1
lrwxrwxrwx 1 root root  33 Jul 26  2011 libvxxp12k.key -> /etc/vx/aslkey.d/libvxxp12k.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxxp12k.key.1
-r-xr-xr-x 1 root sys   96 Feb 26  2010 libvxxp256.key.1


ASL linkage

# cd /etc/vx/lib/discovery.d


Output prior to recreating the missing symbolic link


# ll
total 264
lrwxrwxrwx 1 root root    38 2011-07-26 14:35 libvx3par.so -> /etc/vx/lib/discovery.d/libvx3par.so.1
-r-xr-xr-x 1 root sys  10017 2010-02-26 05:22 libvx3par.so.1
lrwxrwxrwx 1 root root    42 2011-07-26 14:35 libvxCLARiiON.so -> /etc/vx/lib/discovery.d/libvxCLARiiON.so.1
-r-xr-xr-x 1 root sys  10951 2010-02-26 05:22 libvxCLARiiON.so.1
-r-xr-xr-x 1 root sys   7729 2010-02-26 05:22 libvxcscovrts.so.1
-r-xr-xr-x 1 root sys   9944 2010-02-26 05:22 libvxemc.so.1
lrwxrwxrwx 1 root root    41 2011-07-26 14:35 libvxhds9980.so -> /etc/vx/lib/discovery.d/libvxhds9980.so.1
-r-xr-xr-x 1 root sys  10198 2010-02-26 05:22 libvxhds9980.so.1
lrwxrwxrwx 1 root root    41 2011-07-26 14:35 libvxhdsalua.so -> /etc/vx/lib/discovery.d/libvxhdsalua.so.1
-r-xr-xr-x 1 root sys  14619 2010-02-26 05:22 libvxhdsalua.so.1
-r-xr-xr-x 1 root sys  12665 2010-02-26 05:22 libvxhds.so.1
lrwxrwxrwx 1 root root    40 2011-07-26 14:35 libvxhdsusp.so -> /etc/vx/lib/discovery.d/libvxhdsusp.so.1
-r-xr-xr-x 1 root sys  15755 2010-02-26 05:22 libvxhdsusp.so.1
-r-xr-xr-x 1 root sys  11258 2010-02-26 05:22 libvxhitachi.so.1
lrwxrwxrwx 1 root root    40 2011-07-26 14:35 libvxhpalua.so -> /etc/vx/lib/discovery.d/libvxhpalua.so.1
-r-xr-xr-x 1 root sys  10078 2010-02-26 05:22 libvxhpalua.so.1
lrwxrwxrwx 1 root root    39 2011-07-26 14:35 libvxhpmsa.so -> /etc/vx/lib/discovery.d/libvxhpmsa.so.1
-r-xr-xr-x 1 root sys  10495 2010-02-26 05:22 libvxhpmsa.so.1
lrwxrwxrwx 1 root root    41 2011-07-26 14:35 libvxibmds4k.so -> /etc/vx/lib/discovery.d/libvxibmds4k.so.1
-r-xr-xr-x 1 root sys  12080 2010-02-26 05:22 libvxibmds4k.so.1
lrwxrwxrwx 1 root root    41 2011-07-26 14:35 libvxibmds6k.so -> /etc/vx/lib/discovery.d/libvxibmds6k.so.1
-r-xr-xr-x 1 root sys   8717 2010-02-26 05:22 libvxibmds6k.so.1
lrwxrwxrwx 1 root root    41 2011-07-26 14:35 libvxibmds8k.so -> /etc/vx/lib/discovery.d/libvxibmds8k.so.1
-r-xr-xr-x 1 root sys   8870 2010-02-26 05:22 libvxibmds8k.so.1
lrwxrwxrwx 1 root root    36 2011-07-26 14:35 libvxpp.so -> /etc/vx/lib/discovery.d/libvxpp.so.1
-r-xr-xr-x 1 root sys  19075 2010-02-26 05:22 libvxpp.so.1
-r-xr-xr-x 1 root sys   8944 2010-02-26 05:22 libvxpurple.so.1
-r-xr-xr-x 1 root sys   7971 2010-02-26 05:22 libvxshark.so.1
-r-xr-xr-x 1 root sys   7750 2010-02-26 05:22 libvxveritas.so.1
lrwxrwxrwx 1 root root    43 2011-07-26 14:35 libvxxp1281024.so -> /etc/vx/lib/discovery.d/libvxxp1281024.so.1
-r-xr-xr-x 1 root sys   8712 2010-02-26 05:22 libvxxp1281024.so.1
lrwxrwxrwx 1 root root    39 2011-07-26 14:35 libvxxp12k.so -> /etc/vx/lib/discovery.d/libvxxp12k.so.1
-r-xr-xr-x 1 root sys  12673 2010-02-26 05:22 libvxxp12k.so.1
-r-xr-xr-x 1 root sys   9074 2010-02-26 05:22 libvxxp256.so.1
 

How to create the symbolic link for the "libvxemc.so.1" file
 

# ln -s /etc/vx/lib/discovery.d/libvxemc.so.1 libvxemc.so

 

Following the above changes to the aslkey.d and discovery.d directories, restart the Veritas Volume Manager "vxconfigd" daemon for the ASL updates to be detected.

# vxconfigd -k


The missing ASL should now be listed by the CLI command "vxddladm listversion":
 

# vxddladm listversion
LIB_NAME                        ASL_VERSION      Min. VXVM version
===================================================================
libvx3par.so                    vm-5.0-rev-1            5.0
libvxCLARiiON.so                vm-5.0-rev-3            5.0
libvxemc.so                     vm-5.0-rev-3            5.0              <<< ASL now listed following the recreation of the required symbolic links
libvxhds9980.so                 vm-5.0-rev-1            5.0
libvxhdsalua.so                 vm-5.0-rev-2            5.0
libvxhdsusp.so                  vm-5.0-rev-2            5.0
libvxhpalua.so                  vm-5.0-rev-1            5.0
libvxhpmsa.so                   vm-5.0-rev-2            5.0
libvxibmds4k.so                 vm-5.0-rev-2            5.0
libvxibmds6k.so                 vm-5.0-rev-2            5.0
libvxibmds8k.so                 vm-5.0-rev-1            5.0
libvxpp.so                      vm-5.0-rev-1            5.0
libvxxp1281024.so               vm-5.0-rev-1            5.0
libvxxp12k.so                   vm-5.0-rev-2            5.0
 

 

Was this content helpful?