5.1.3.2 Registering Hardware Devices

PRIMECLUSTER Installation and Administration Guide 4.2 (Linux)

Contents Index

Part 2 Installation

> Chapter 5 Building a Cluster

> 5.1 Initial Cluster Setup

> 5.1.3 Initial Setup of the Cluster Resource Management Facility

5.1.3.2 Registering Hardware Devices

The automatic configure process registers the connected hardware devices (shared disks and network interface cards) to the resource database.

Operation Procedure:

Registering the network interface card
1. Confirm that all nodes have been started in multi-user mode.
2. Log in to any of nodes using system administrator access privileges and execute the "clautoconfig" command. Then, the network interface is automatically recognized and registered in the resource database.
```
  #/etc/opt/FJSVcluster/bin/clautoconfig -r -n [RETURN]
```
  For details on this command, see the manual pages of "clautoconfig".
- Do not execute the "clautoconfig" command on the node in which the "clautoconfig" command is being executed or on any other node while the "clautoconfig" command is being executed. If you execute it, a shared disk device cannot be registered correctly. If you have executed it, execute the following operation on all the nodes that constitute the cluster system to re-execute "Initial Setup of the Cluster Resource Management" described in this chapter:
  1. Reset the resource database using the "clinitreset" command. For details on this command, see the manual pages of "clinitreset".
  2. Reboot the node.
- Only an active network interface card is automatically detected. Confirm the state of the network interface card using the "ifconfig(8)" command.
  Execute the following command to activate the network interface:
```
  # ifconfig network interface card up
```
  (Example) Enable the network interface card eth1
```
  # ifconfig eth1 up
```
Registering a shared disk

When you use GDS, register a shared disk in the resource database using the following steps on any one of the nodes of the cluster system. For details on the procedure, see "Appendix H" in the "PRIMECLUSTER Global Disk Services Configuration and Administration Guide ."
1. Log in any one of the nodes of the cluster system using system administrator access privileges.
2. Create a shared disk configuration file in the following format. The configuration file defines settings of a shared disk connected to all the nodes of the cluster system. Create a shared disk definition file with an arbitrary name.
```
<Resource key name> <device name> <node identifier>
<Resource key name> <device name> <node identifier>
                     :                 
```
  - Define "resource key name device name node identifier" for each shared disk in one row.
  - "resource key name", "device name", and "node identifier" are delimited by a single space.
  Set up resource key name, device name and node identifier as follows;
  
  Resource key name
  Specify a resource key name that indicates the sharing relationship for each shared disk. You need to specify the same name for each disk shared between nodes. The resource key name should be specified in the "shd number" format. "shd" is a fixed string. For "number", you can specify any four-digit numbers. If multiple shared disks are used, specify unique numbers for each shared disk.
```
   (Example) When /dev/sdb and /dev/sdc are shared between nodes
```
```
     Resource key name of /dev/sdb: shd0001
```
```
     Resource key name of /dev/sdc: shd0002
```
  Device name
  Specify a device name of the shared disk in the "/dev/device" format.
```
   (Example) In the case of /dev/sdb
```
```
     /dev/sdb
```
  Node identifier
  Specify a node identifier for which a shared disk device is available. Confirm the node identifier by executing the "clgettree" command. For details on this command, see the manual pages of "clgettree".
```
   (Example) node1 and node2 are node identifiers in the following case:
```
```
     # /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 the configuration file of the shared disk when shared disks /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. Execute the "clautoconfig" command to register the settings of the shared disk device that is stored in the configuration file in the resource database.
  
  Specify the "clautoconfig" command in 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" command ends abnormally, take corrective action according to the error message. For details on the messages of this command, see the "PRIMECLUSTER Cluster Foundation (CF) Configuration and Administration Guide." This command does not check whether the shared disk defined in the configuration file is physically connected. If you found an error in the shared disk configuration file after executing the "clautoconfig" command, reset the resource database by executing the "clinitreset" command and reboot the node.
4. When the initial setup and automatic configure are completed, the following screen appears.
5. When automatic configuration is completed, go to the CRM main window and confirm that the resource registration is completed by checking the following.
  - Whether the disk configuration is different among the nodes.
  - Whether the number of disks in each node differs from the number of shared disk units.
  - Whether the number of shared disk unit resources is less than the actual device configuration.
  - Whether any disks other than shared disk unit are registered as shared disk unit.
  - Whether the number of public LAN resources is less than the actual device configuration.
  If the actual device configuration and the resources do not match each other as described above, automatic detection may have been disabled because of one of the following causes:
  - There is a connection path failure between a host device and a disk array unit.
  - A disk array unit is not ready.
  - A network adapter failed.
  - A network adapter driver failed.
  If the resources are not registered correctly, first review the above causes.

If a message is displayed in the CRM main window during operation or a message is displayed in the message dialog box entitled "Cluster resource management facility," see the following manuals for details:
- "PRIMECLUSTER Cluster Foundation (CF) Configuration and Administration Guide"
  - "10.10 Resource Database messages"
- Appendix D in this manual
  - "Failed Resource and Operator Intervention Messages (GUI)"
If you want to add, delete, or rename a disk class from the Global Disk Services screen after executing automatic configuration from the CRM main window, close the Cluster Admin screen.

Contents Index