System Administration Commands                          dscfg(1M)



NAME
     dscfg - configuration tool for Sun  StorageTek  Availability
     Suite software

SYNOPSIS
     dscfg


     dscfg -L


     dscfg -h


     dscfg [-C group]


     dscfg [-C group] -i [-p parserconfigfile]


     dscfg [-C group] -a configfile


     dscfg [-C group] [-l]


     dscfg [-C group] [-l] -s configlocation


     dscfg -D dgname


DESCRIPTION
     The dscfg command controls the Availability Suite configura-
     tion  by  providing  facilities to initialize, list, format,
     restore the configuration database.

OPTIONS
     If no options are  specified,  dscfg  displays  the  current
     local configuration location. The dscfg command supports the
     following options:

     -L

         Displays the status of the lock  controlling  access  to
         the  configuration  database. If the configuration data-
         base is locked, the type of  lock  (read  or  write)  is
         displayed  along with the process id of the process that
         holds the lock.






SunOS 5.11           Last change: 2 Oct 2007                    1






System Administration Commands                          dscfg(1M)



     -h

         Displays the usage message for the dscfg command.


     -i

         Initializes the configuration database.  As  it  deletes
         previous  or  current  configuration  information,  this
         option  prompts  you  to  confirm  the  deletion  before
         proceeding.


     -p parserconfigfile

         When used with the -i option,  dscfg  loads  the  parser
         configuration file into the persistent configuration, it
         reformats the configuration database.


     -a configfile

         Restore the specified configfile  into  the  configura-
         tion.  This option does not do any error checking of the
         file. Use of this option invalidates  the  configuration
         file.


     -l

         Lists the contents of current configuration database  in
         a  format  that is suitable for the -a option. When used
         in combination with the -s option, it displays the  con-
         tents  stored  in  the location passed to the -s option,
         but does not set the configuration location.



     The options below are  for  Sun  Cluster-configured  systems
     only. group can be either Sun Cluster device group or as '-'
     as local devices.

     -C group

         Display the location of cluster configuration database.


     -C group -i

         Initializes the configuration database entries that only
         associated  with group specified. As it deletes previous
         or  current  configuration  information,  this   options



SunOS 5.11           Last change: 2 Oct 2007                    2






System Administration Commands                          dscfg(1M)



         prompts you to confirm the deletion before proceeding.


     -C group -p parserconfigfile

         When used with the -i option,  dscfg  loads  the  parser
         configuration file into the persistent configuration, it
         reformats the configuration database entries  that  only
         associated with group specified.


     -C  group -a configfile

         Restore the specified configfile into the configuration
         database  entries that only associated with group speci-
         fied.  This option does not do any error checking of the
         file.  Use  of this option invalidates the configuration
         file.


     -C group -l

         Lists the contents  of  current  configuration  database
         that is associated with resource group specified.


     -C  group -s configfilelocation

         Specifies where the Sun Cluster  configuration  database
         resides, the location has to be DID device.


     -D devicegroup

         Checks whether the specified devicegroup  is  known  by
         Sun Cluster and whether it is available on this node. It
         displays a information that indicates the device group's
         status and return values are as follows,

         (use echo $? to retrieve the return value):

         1            Device group  is  in  Sun  Cluster  and  is
                      active on this node;


         0            Device group is in Sun Cluster  but  active
                      on another node;


         -1           Device group is not in Sun Cluster.





SunOS 5.11           Last change: 2 Oct 2007                    3






System Administration Commands                          dscfg(1M)



USAGE
     The dscfg command is typically run from other scripts,  such
     as  package  installation scripts, and from dscfgadm(1M). It
     is not intended for general  use.  For  uses  of  dscfg  not
     covered  by dscfgadm, please refer to the Availability Suite
     Troubleshooting Guide.

FILES
     /etc/dscfgformat

         parser configuration file


     /etc/dscfglocal

         configuration location for all entries with  no  cluster
         tags


     /etc/dscfgcluster

         reference file specifying the location of the Sun  Clus-
         ter configuration database.


ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWscmr, SUNWscmu          
    
     Interface Stability          Evolving                    
    


SEE ALSO
     dscfgadm(1M), iiadm(1M), scmadm(1M), sndradm(1M), svadm(1M),
     ds.log(4), attributes(5)












SunOS 5.11           Last change: 2 Oct 2007                    4