How to Update the Global Device Namespace

When adding a new global device, manually update the global device namespace by running the cldevice populate command.

The cldevice populate command does not have any effect if the node that is running the command is not currently a cluster member. The command also has no effect if the /global/.devices/node@ nodeID file system is not mounted.

This procedure provides the long forms of the Sun Cluster commands. Most commands also have short forms. Except for the long and short forms of the command names, the commands are identical. For a list of the commands and their short forms, see Appendix A, Sun Cluster Object-Oriented Commands.

1. Become superuser or assume a role that provides solaris.cluster.modify RBAC authorization on any node of the cluster.

2. On each node in the cluster, run the devfsadm(1M) command.

   You can run this command on all nodes in the cluster at the same time.

3. Reconfigure the namespace.

   # cldevice populate

4. On each node, verify that the cldevice populate command has been completed before you attempt to create any disk sets.

   The cldevice command calls itself remotely on all nodes, even when the command is run from just one node. To determine whether the cldevice populate command has completed processing, run the following command on each node of the cluster.

   # ps -ef | grep scgdevs

Example 5–20 Updating the Global Device Namespace

The following example shows the output generated by successfully running the cldevice populate command.

# devfsadm
cldevice populate 
Configuring the /dev/global directory (global devices)...
obtaining access to all attached disks
reservation program successfully exiting
# ps -ef | grep scgdevs