Go to main content

Reference for Oracle Solaris Cluster 4.4

Exit Print View

Updated: August 2018

dcs_config (8)


dcs_config - query DCS


/usr/cluster/lib/sc/dcs_config -c info [-s service-name | -C 
     service-class | -d device-path]
/usr/cluster/dtk/bin/dcs_config -c status [-s service-name]
/usr/cluster/lib/sc/dcs_config -c remove -s service-name


The dcs_config command is an emergency command line interface designed to update the Device Configuration System (DCS) directly. The update options to dcs_config should only be used when directed by authorized Oracle support personnel. Perform all normal changes to the DCS by using the cldevicegroup command.

To query device services, use the info or status forms of the command. The info form gives general configuration information about the service. The status form gives information about the service's current state. info and status commands without additional qualifying options shows all service classes and services in use.

You can use this command only in the global zone.


The following options are supported:

–c command

Specifies the command to run:


displays information about the specified service name or all services if one is not specified. Output varies depending on the type of service and can include service class, secondaries, switchback, replicas, incarnations, or devices.


Displays the service state for the specified service or all states if no service name is specified


Removes the specified service name from DCS. This only removes the service name from the cluster. It does not remove it from Oracle Solaris. For instance, if you use dcs_config to remove a metaset, Solaris Volume Manager does not remove the disk set.

–C service-class

Specifies the service class. Valid service classes are SUNWmd, DISK, TAPE, and SUNWlocal.

–d device-path

Specifies the device path.

–s service-name

Specifies the service name. Valid service names include metasets and disks.


Example 1 Displaying Information About a Disk

This example displays information about the disk dsk/d5:

# dcs_config -c info -s dsk/d5
Service name: dsk/d5
Service class: DISK
Switchback Enabled: False
Number of secondaries: All
Replicas: (Node id --> 1, Preference --> 0)(Node id --> 2, Preference --> 0)
Devices: (239, 160-167) 
   gdev --> d5
   autogenerated --> 1
Example 2 Removing an Unrecognized Solaris Volume Manager metaset

In this example, the cluster software recognizes the metaset nfs-set but Solaris Volume Manager does not. The cldevicegroup status command shows the metaset:

=== Cluster Device Groups ===

--- Device Group Status ---       
Device Group Name     Primary     Secondary     Status      
-----------------     -------     ---------     ------      
nfs-set                -           -             Offline

The metaset command does not know about the set:

# metaset -s nfs-set
metaset: setname "nfs-set": no such set

Run from one node, the following dcs_config command removes nfs-set from the cluster:

# dcs_config -c remove -s nfs-set
Example 3 Displaying the Status of a metaset

This example displays the status of the nfs-set metaset.

# dcs_config -c status -s nfs-set
Service Name: nfs-set
Active replicas: (1. State - Primary)(2. State - Secondary)
Service state: SC_STATE_ONLINE


See attributes(7) for descriptions of the following attributes.

Interface Stability

See Also

cldevicegroup(8CL), metaset(8)