dscfg(1m) - osol9

1dscfg(1M)               System Administration Commands               dscfg(1M)
2
3
4

NAME

6       dscfg  - configuration tool for Sun StorageTek Availability Suite soft‐
7       ware
8

SYNOPSIS

10       dscfg
11
12
13       dscfg -L
14
15
16       dscfg -h
17
18
19       dscfg [-C group]
20
21
22       dscfg [-C group] -i [-p parser_config_file]
23
24
25       dscfg [-C group] -a config_file
26
27
28       dscfg [-C group] [-l]
29
30
31       dscfg [-C group] [-l] -s config_location
32
33
34       dscfg -D dgname
35
36

DESCRIPTION

38       The dscfg command controls the Availability Suite configuration by pro‐
39       viding  facilities  to initialize, list, format, restore the configura‐
40       tion database.
41

OPTIONS

43       If no options are specified, dscfg displays the current local  configu‐
44       ration location. The dscfg command supports the following options:
45
46       -L
47
48           Displays  the status of the lock controlling access to the configu‐
49           ration database. If the configuration database is locked, the  type
50           of  lock  (read or write) is displayed along with the process id of
51           the process that holds the lock.
52
53
54       -h
55
56           Displays the usage message for the dscfg command.
57
58
59       -i
60
61           Initializes the configuration database. As it deletes  previous  or
62           current  configuration information, this option prompts you to con‐
63           firm the deletion before proceeding.
64
65
66       -p parser_config_file
67
68           When used with the -i option, dscfg loads the parser  configuration
69           file into the persistent configuration, it reformats the configura‐
70           tion database.
71
72
73       -a config_file
74
75           Restore the specified  config_file  into  the  configuration.  This
76           option  does  not  do  any  error checking of the file. Use of this
77           option invalidates the configuration file.
78
79
80       -l
81
82           Lists the contents of current configuration database  in  a  format
83           that  is  suitable for the -a option. When used in combination with
84           the -s option, it displays the  contents  stored  in  the  location
85           passed  to  the -s option, but does not set the configuration loca‐
86           tion.
87
88
89
90       The options below are for Sun Cluster-configured  systems  only.  group
91       can be either Sun Cluster device group or as '-' as local devices.
92
93       -C group
94
95           Display the location of cluster configuration database.
96
97
98       -C group -i
99
100           Initializes the configuration database entries that only associated
101           with group specified. As it deletes previous or current  configura‐
102           tion  information, this options prompts you to confirm the deletion
103           before proceeding.
104
105
106       -C group -p parser_config_file
107
108           When used with the -i option, dscfg loads the parser  configuration
109           file into the persistent configuration, it reformats the configura‐
110           tion database entries that only associated with group specified.
111
112
113       -C  group -a config_file
114
115           Restore the specified config_file into the  configuration  database
116           entries  that  only  associated  with group specified.  This option
117           does not do any error checking of the  file.  Use  of  this  option
118           invalidates the configuration file.
119
120
121       -C group -l
122
123           Lists  the contents of current configuration database that is asso‐
124           ciated with resource group specified.
125
126
127       -C  group -s config_file_location
128
129           Specifies where the Sun Cluster configuration database resides, the
130           location has to be DID device.
131
132
133       -D device_group
134
135           Checks  whether  the specified device_group is known by Sun Cluster
136           and whether it is available on this node. It displays a information
137           that  indicates  the device group's status and return values are as
138           follows,
139
140           (use echo $? to retrieve the return value):
141
142           1            Device group is in Sun Cluster and is active  on  this
143                        node;
144
145
146           0            Device  group  is in Sun Cluster but active on another
147                        node;
148
149
150           -1           Device group is not in Sun Cluster.
151
152
153

USAGE

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

FILES

161       /etc/dscfg_format
162
163           parser configuration file
164
165
166       /etc/dscfg_local
167
168           configuration location for all entries with no cluster tags
169
170
171       /etc/dscfg_cluster
172
173           reference  file specifying the location of the Sun Cluster configu‐
174           ration database.
175
176

ATTRIBUTES

178       See attributes(5) for descriptions of the following attributes:
179
180
181
182
183       ┌─────────────────────────────┬─────────────────────────────┐
184       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
185       ├─────────────────────────────┼─────────────────────────────┤
186       │Availability                 │SUNWscmr, SUNWscmu           │
187       ├─────────────────────────────┼─────────────────────────────┤
188       │Interface Stability          │Evolving                     │
189       └─────────────────────────────┴─────────────────────────────┘
190