The scgdevs utility manages the global devices namespace. The global devices namespace is mounted under /global and consists of a set of logical links to physical devices. As /dev/global is visible to each node of the cluster, each physical device is visible across the cluster. This fact means that any disk, tape, or CD-ROM that is added to the global devices namespace can be accessed from any node in the cluster.

The scgdevs command allows the administrator to attach new global devices (for example, tape drives, CD-ROM drives, and disk drives) to the global devices namespace without requiring a system reboot. The drvconfig(1m) and devlinks(1m) commands must be executed prior to running the scgdevs script.

Alternatively, a reconfiguration reboot can be used to rebuild the global namespace and attach new global devices. See boot(1m).

This script must be run from a node that is a current cluster member. If this script is run from a node that is not a cluster member, the script exits with an error code and leaves the system state unchanged.

You need solaris.cluster.system.modify RBAC authorization to use this command. See rbac(5).

You must also be able to assume a role to which the Sun Cluster Commands rights profile has been assigned to use this command. Authorized users can issue privileged Sun Cluster commands on the command line from the pfsh(1), pfcsh(1), or pfksh(1) profile shell. A profile shell is a special kind of shell that enables you to access privileged Sun Cluster commands that are assigned to the Sun Cluster Commands rights profile. A profile shell is launched when you run su(1m) to assume a role. You can also use pfexec(1) to issue privileged Sun Cluster commands.

The following exit values are returned:

0

The command completed successfully.

nonzero

An error occurred. Error messages are displayed on the standard output.

/devices

Device nodes directory

/global/.devices

Global devices nodes directory

/dev/md/shared

SDS/Solaris Volume Manager metaset directory

See attributes(5) for descriptions of the following attributes:

boot(1m), devfsadm(1m), devlinks(1m), drvconfig(1m), scdidadm(1M), attributes(5), did(7)

Sun Cluster System Administration Guide

The scgdevs command, called from the local node, will perform its work on remote nodes asynchronously. Therefore, command completion on the local node does not necessarily mean it has completed its work clusterwide.

This document does not constitute an API. /global/.devices and /devices might not exist or might have different contents or interpretations in a future release. The existence of this notice does not imply that any other documentation that lacks this notice constitutes an API. This interface should be considered an unstable interface.