PRIMECLUSTER Global Disk Services Configuration and Administration Guide 4.2 (Linux)

H.4 Shared Disk Unit Resource Registration Procedure

Perform the following procedure on a node that composes the cluster system.

1. Logging in with system administrator access privileges

   Log in to a node that composes the cluster system using system administrator access privileges.
   
   

2. Creating a shared disk definition file

   A shared disk definition file is a file to declare physical connection configuration of nodes in a cluster system and shared disk units. Use the following format.

   Resource key name Device name Node identification name
   Resource key name Device name Node identification name
                               :

   
   

   • Describe "Resource key name, Device name, and Node identification name" in one line for every shared disk unit connected to each node.

   • "Resource key name", "Device name", and "Node identification name" are space delimited.

   Specify values as follows for "Resource name", "Device name", and "Node identification name".

   Resource key name

   For a resource key name, specify a resource name that indicates a shared relationship for every shared disk unit. The name should be the same by device shared between nodes. The resource key name is specified in "shd number" format. "shd" is a fixed text string. "number" can contain any 4-digit figure. When multiple shared disks exist, specify different "number"s.
   

   [Example] When /dev/sdb and /dev/sdc are connected to and shared between multiple nodes

   Resource key name of /dev/sdb: shd0001
   Resource key name of /dev/sdc: shd0002

   Device name

   For a device name, specify the device name of a shared disk unit. The device name is specified in "/dev/device" format.
   

   [Example] When the device is /dev/sdb.

   /dev/sdb

   Node identification name

   For a node identification name, specify the ID number of a node where the shared disk unit resides. The node identification names can be checked with the clgettree(1) command.
   
   
   For details on the clgettree(1) command, see the clgettree(1) command manual.
   
   [Example] In the following example, node1 and node2 are node identification names.

   # /etc/opt/FJSVcluster/bin/clgettree
      Cluster 1 cluster
              Domain 2 PRIME
                      Shared 7 SHD_PRIME
                      Node 3 node1 ON
                      Node 5 node2 ON

   
   

   The following example shows a shared disk definition file created when "/dev/sdb" and "dev/sdc" are shared between node1 and node2.

   shd0001 /dev/sdb node1
   shd0001 /dev/sdb node2
   shd0002 /dev/sdc node1
   shd0002 /dev/sdc node2

   
   

3. Resource registration with the clautoconfig(8) command

   Execute the clautoconfig(8) command to register information in the shared disk definition file created in step 2 with the resource database using the following format:

   [Format]

   /etc/opt/FJSVcluster/bin/clautoconfig -f Full path of the shared disk definition file

   [Example]

   # /etc/opt/FJSVcluster/bin/clautoconfig -f /var/tmp/diskfile

   
   
   If the clautoconfig(8) command terminates abnormally, take corrective actions as indicated in a displayed message. For clautoconfig(8) command messages, see "PRIMECLUSTER Cluster Foundation (CF) Configuration and Administration Guide."

   
   

4. Confirming resource registration

   Check information of the shared disk units registered with the resource database using the clgettree(1) command.

   [Example]

   The following example shows clgettree(1) command output generated when resource registration is performed using the shared disk definition file shown as an example in step 2.
   
   The resources in the "DISK" class are shared disk unit resources. The resources in the "SHD_DISK" class are resources that indicate shared disk unit shared relationships.
   

   # /etc/opt/FJSVcluster/bin/clgettree
       Cluster 1 cluster
         Domain 2 PRIME
            Shared 7 SHD_PRIME
                   SHD_DISK 14 SHD_Disk14 UNKNOWN
                           DISK 15 sdb UNKNOWN node1
                           DISK 16 sdb UNKNOWN node2
                   SHD_DISK 17 SHD_Disk17 UNKNOWN
                           DISK 18 sdc UNKNOWN node1
                           DISK 19 sdc UNKNOWN node2
            Node 3 node1 ON
                   DISK 15 sdb UNKNOWN
                   DISK 18 sdc UNKNOWN
            Node 5 node2 ON
                   DISK 16 sdb UNKNOWN
                   DISK 19 sdc UNKNOWN

   
   

   
   The clautoconfig(8) command does not check shared disk units in a specified shared disk definition file whether they are physically connected to nodes. If any error is found in the shared disk definition file after clautoconfig(8) command execution, it is necessary to perform the recovery procedure as follows on all nodes that compose the cluster system and then perform resource registration again. In a situation where hardware unit resources other than shared disk units are registered, it is also necessary to register those resources again.

   [Recovery procedure]

   1. Resetting the resource database

      Reset the resource database using the clinitreset(8) command.
      
      
      For details, see the clinitreset(8) command manual.
      
      

   2. Rebooting the node

      Reboot the node.