Skip Navigation Links
Exit Print View
| Oracle Solaris Cluster Reference Manual Oracle Solaris Cluster 4.1

Search Scope:

- This Document
- Entire Library

### dcs_config

- query DCS

### Synopsis

    /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

## Description

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.

## Options

The following options are supported:

`-c` command

  Specifies the command to run:

  `info`

    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.

  `status`

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

  `remove`

    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.

## Examples

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)
    Properties:
       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

## Attributes

See `attributes`(5) for descriptions of the following attributes.

ATTRIBUTE TYPE | ATTRIBUTE VALUE
--- | ---
Availability | ha-cluster/system/core
Interface Stability | Evolving

## See Also

`cldevicegroup`(1CL), `metaset`(1M)

Copyright © 2000, 2012, Oracle and/or its affiliates. All rights reserved. Legal Notices |