H.3 Registration procedure

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

Contents

Appendix H Register shared disk units

H.3 Registration procedure

Take the following steps to register shared disk units in the resource database.

[Chart: Flow of Shared Disk Unit Registration]

This procedure should be done on an arbitrary node that consists of a cluster system.
Do not execute the clautoconfig(8) command on the node where the command is running, or on any other nodes. If it occurs, registration is not properly done. You need to proceed with the following on all nodes consisting of a cluster system, and then take the above steps:
1. Reset the resource database
  Execute the clinitreset(8) command to reset. See the manual for details.
2. Restart a node
First, you need to check the following:
1. Setup of CF, CIP, and resource database are done on all nodes. See "PRIMECLUSTER Cluster Foundation (CF) (Linux) Configuration and Administration Guide" for details.
2. All nodes are physically connected to the shared disk units.
3. All nodes start in a multi-user mode.
4. Setup of multi-path is done when using the shared disk units.
Do not execute the setup command of GDS during the clautoconfig(8) command's running. If it occurs, the setup command might detect an error.

Register shared disk units

Take the following steps on an arbitrary node that consists of a cluster system.

1. Log in using system administrator access privileges

2. Create a definition file for a shared disk

It is a file to define setup information of shared disk units connected to all nodes consisting of a cluster system.

The definition file is created in the following format:

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

"Resource key name, Device name, and Node identification name" is defined in one string by shared disk unit connected to each node.
"Resource key name, Device name, and Node identification name" are space-deliminated.

Each name requires the following setup:

Resource key name

Specify a resource key name that has a sharing relation with each shared disk unit. The name should be the same by device shared between nodes. The name is also specified in the "shd number" format. This "shd" is a fixed string. Specify arbitrary 4 digits for number. If multiple devices are shared between multiple nodes, specify a different number.

Example

When sharing "/dev/sdb" and "/dev/sdc" between nodes

    /dev/sdb resource key name: shd0001
    /dev/sdc resource key name: shd0002

Device name: Specify a device name of a shared disk unit. The device name should be in the "/dev/device" format.; Example; When the device is "/dev/sdb", the device name should be "/dev/sdb".

Node identification name

Specify an identification name of the node connected to a device. Confirm the name by executing the clgettree(1) command. See the manual for details.

Example

node1 and node2 are 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

When "/dev/sdb" and "/dev/sdc" are shared between node1 and node2, the definition file of a shared disk is as follows:

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

3. Execute the clautoconfig(8) command

Execute the clautoconfig(8) command to register the definition file that is created at (2) in the resource database. Specify the command in the following format:

Format: /etc/opt/FJSVcluster/bin/clautoconfig -f Full path of the definition file
Example: # /etc/opt/FJSVcluster/bin/clautoconfig -f /var/tmp/diskfile

When the clautoconfig(8) command is abnormally terminated, follow the displayed corrective action. See "PRIMECLUSTER Cluster Foundation (CF) (Linux) Configuration and Administration Guide" for the clautoconfig(8) command messages.
The clautoconfig(8) command is not aware that the shared disk unit is physically connected. If you found a mistake of setting the definition file after executing the clautoconfig(8) command, you need to proceed with the following on all nodes consisting of a cluster system, and then take the above steps:
1. Reset the resource database
  Execute the clinitreset(8) command to reset. See the manual for details.
2. Restart a node

4. Confirm registration

Confirm information of the shared disk unit registered in the resource database using the clgettree(1) command.

Example

The following example shows that the shared disk unit "/dev/sdb" and "/dev/sdc" are shared between node1 and node2.

The resource of the "DISK" class is a device of the shared disk unit. The resource of the "SHD_DISK" class indicates a sharing relation.

# /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

Contents