diff options
Diffstat (limited to 'usr/src/man')
| -rw-r--r-- | usr/src/man/man1m/Makefile | 14 | ||||
| -rw-r--r-- | usr/src/man/man1m/dsbitmap.1m | 178 | ||||
| -rw-r--r-- | usr/src/man/man1m/dscfg.1m | 310 | ||||
| -rw-r--r-- | usr/src/man/man1m/dscfgadm.1m | 159 | ||||
| -rw-r--r-- | usr/src/man/man1m/dscfglockd.1m | 100 | ||||
| -rw-r--r-- | usr/src/man/man1m/dsstat.1m | 1127 | ||||
| -rw-r--r-- | usr/src/man/man1m/iiadm.1m | 1016 | ||||
| -rw-r--r-- | usr/src/man/man1m/iicpbmp.1m | 77 | ||||
| -rw-r--r-- | usr/src/man/man1m/iicpshd.1m | 85 | ||||
| -rw-r--r-- | usr/src/man/man1m/nscadm.1m | 143 | ||||
| -rw-r--r-- | usr/src/man/man1m/scmadm.1m | 203 | ||||
| -rw-r--r-- | usr/src/man/man1m/sndradm.1m | 1043 | ||||
| -rw-r--r-- | usr/src/man/man1m/sndrd.1m | 150 | ||||
| -rw-r--r-- | usr/src/man/man1m/sndrsyncd.1m | 132 | ||||
| -rw-r--r-- | usr/src/man/man1m/svadm.1m | 181 | ||||
| -rw-r--r-- | usr/src/man/man4/Makefile | 5 | ||||
| -rw-r--r-- | usr/src/man/man4/ds.log.4 | 112 | ||||
| -rw-r--r-- | usr/src/man/man4/rdc.cf.4 | 166 | ||||
| -rw-r--r-- | usr/src/man/man4/sndr.4 | 89 | ||||
| -rw-r--r-- | usr/src/man/man7d/Makefile | 4 | ||||
| -rw-r--r-- | usr/src/man/man7d/ii.7d | 104 | ||||
| -rw-r--r-- | usr/src/man/man7d/sv.7d | 47 |
22 files changed, 2 insertions, 5443 deletions
diff --git a/usr/src/man/man1m/Makefile b/usr/src/man/man1m/Makefile index f83b395683..625ae224d4 100644 --- a/usr/src/man/man1m/Makefile +++ b/usr/src/man/man1m/Makefile @@ -112,11 +112,6 @@ _MANFILES= 6to4relay.1m \ dns-sd.1m \ domainname.1m \ drvconfig.1m \ - dsbitmap.1m \ - dscfg.1m \ - dscfgadm.1m \ - dscfglockd.1m \ - dsstat.1m \ dtrace.1m \ dumpadm.1m \ editmap.1m \ @@ -180,9 +175,6 @@ _MANFILES= 6to4relay.1m \ if_mpadm.1m \ ifconfig.1m \ ifparse.1m \ - iiadm.1m \ - iicpbmp.1m \ - iicpshd.1m \ ikeadm.1m \ ikecert.1m \ in.chargend.1m \ @@ -336,7 +328,6 @@ _MANFILES= 6to4relay.1m \ nfsmapid.1m \ nfsstat.1m \ nlsadmin.1m \ - nscadm.1m \ nscd.1m \ nwamd.1m \ passmgmt.1m \ @@ -434,7 +425,6 @@ _MANFILES= 6to4relay.1m \ savecore.1m \ sbdadm.1m \ scadm.1m \ - scmadm.1m \ sdpadm.1m \ sendmail.1m \ setuname.1m \ @@ -452,9 +442,6 @@ _MANFILES= 6to4relay.1m \ smbios.1m \ smbstat.1m \ smrsh.1m \ - sndradm.1m \ - sndrd.1m \ - sndrsyncd.1m \ snoop.1m \ soconfig.1m \ sppptun.1m \ @@ -468,7 +455,6 @@ _MANFILES= 6to4relay.1m \ sttydefs.1m \ su.1m \ sulogin.1m \ - svadm.1m \ svc.configd.1m \ svc.ipfd.1m \ svc.startd.1m \ diff --git a/usr/src/man/man1m/dsbitmap.1m b/usr/src/man/man1m/dsbitmap.1m deleted file mode 100644 index eac1e0d6a7..0000000000 --- a/usr/src/man/man1m/dsbitmap.1m +++ /dev/null @@ -1,178 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DSBITMAP 1M "Oct 2, 2007" -.SH NAME -dsbitmap \- size Availability Suite bitmap volumes -.SH SYNOPSIS -.LP -.nf -\fBdsbitmap\fR \fB-h\fR -.fi - -.LP -.nf -\fBdsbitmap\fR \fB-p\fR \fIdata_volume\fR [\fIbitmap_volume\fR] -.fi - -.LP -.nf -\fBdsbitmap\fR \fB-r\fR \fIdata_volume\fR [\fIbitmap_volume\fR] -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBdsbitmap\fR command calculates the size of the Availability Suite bitmap -volume required for use with the specified data volume. -.SH OPTIONS -.sp -.LP -The following options are supported: -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.sp .6 -.RS 4n -Prints the usage message for the \fBdsbitmap\fR command -.RE - -.sp -.ne 2 -.na -\fB\fB-p\fR \fB\fIdata_volume\fR\fR \fB[\fIbitmap_volume\fR]\fR\fR -.ad -.sp .6 -.RS 4n -For the given \fIdata_volume\fR, \fBdsbitmap\fR calculates and display the -required size for the associated Availability Suite Point in Time bitmap -volume. The bitmap volume sizes for all possible Availability Suite Point in -Time set configurations are displayed. These configurations include Independent -shadow, Full size dependent shadow, and Compact dependent shadow. If the -optional \fIbitmap_volume\fR argument is supplied, \fBdsbitmap\fR determines if -this volume is large enough to be used as the bitmap volume for -\fIdata_volume\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR \fB\fIdata_volume\fR\fR \fB[\fIbitmap_volume\fR]\fR\fR -.ad -.sp .6 -.RS 4n -For the given \fIdata_volume\fR, \fBdsbitmap\fR calculates and displays the -required size for the associated Availability Suite Remote Mirror bitmap -volume. The bitmap volume sizes for all possible Availability Suite Remote -Mirror set configurations are displayed. These configurations include Sync -replication, Async replication with memory queue, disk queue and 32 bit -refcount. If the optional \fIbitmap_volume\fR argument is supplied, -\fBdsbitmap\fR determines if this volume is large enough to be used as the -bitmap volume for \fIdata_volume\fR. -.RE - -.SH USAGE -.sp -.LP -\fBdsbitmap\fR is typically used by the system administrator during the initial -stages of configuring Sun StorageTek Availability Suite software in order to -determine the required bitmap volume sizes, and then to check if the bitmap -volumes that have been created are suitable. -.SH EXIT STATUS -.sp -.LP -The following exit values are returned: -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Successful completion. If the name of a bitmap volume was specified, that -volume is sufficiently large for all potential uses. -.RE - -.sp -.ne 2 -.na -\fB\fB1\fR\fR -.ad -.RS 13n -An error occurred. -.RE - -.sp -.ne 2 -.na -\fB\fB2\fR\fR -.ad -.RS 13n -An invalid option was supplied on the command line. -.RE - -.sp -.ne 2 -.na -\fB\fB3\fR\fR -.ad -.RS 13n -The specified bitmap volume is not large enough to be used as an Availability -Suite Remote Mirror bitmap for an asynchronous set with a disk queue, but is -large enough to be used for all other Remote Mirror set configurations. -.RE - -.sp -.ne 2 -.na -\fB\fB4\fR\fR -.ad -.RS 13n -The specified bitmap volume is not large enough to be used as an Availability -Suite Remote Mirror bitmap for any Remote Mirror set configuration. -.RE - -.sp -.ne 2 -.na -\fB\fB5\fR\fR -.ad -.RS 13n -The specified bitmap volume is not large enough to be used as an Availability -Suite Remote Mirror bitmap for any Remote Mirror set configuration. -.RE - -.sp -.ne 2 -.na -\fB\fB6\fR\fR -.ad -.RS 13n -The specified bitmap volume is not large enough to be used as an Availability -Suite Point in Time bitmap for a compact dependent shadow, but is large enough -to be used for all other Point in Time set configurations. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBiiadm\fR(1M), \fBsndradm\fR(1M), \fBattributes\fR(5) diff --git a/usr/src/man/man1m/dscfg.1m b/usr/src/man/man1m/dscfg.1m deleted file mode 100644 index 1b7bc165d9..0000000000 --- a/usr/src/man/man1m/dscfg.1m +++ /dev/null @@ -1,310 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DSCFG 1M "Oct 2, 2007" -.SH NAME -dscfg \- configuration tool for Sun StorageTek Availability Suite software -.SH SYNOPSIS -.LP -.nf -\fBdscfg\fR -.fi - -.LP -.nf -\fBdscfg\fR \fB-L\fR -.fi - -.LP -.nf -\fBdscfg\fR \fB-h\fR -.fi - -.LP -.nf -\fBdscfg\fR [\fB-C\fR \fIgroup\fR] -.fi - -.LP -.nf -\fBdscfg\fR [\fB-C\fR \fIgroup\fR] \fB-i\fR [\fB-p\fR \fIparser_config_file\fR] -.fi - -.LP -.nf -\fBdscfg\fR [\fB-C\fR \fIgroup\fR] \fB-a\fR \fIconfig_file\fR -.fi - -.LP -.nf -\fBdscfg\fR [\fB-C\fR \fIgroup\fR] [\fB-l\fR] -.fi - -.LP -.nf -\fBdscfg\fR [\fB-C\fR \fIgroup\fR] [\fB-l\fR] \fB-s\fR \fIconfig_location\fR -.fi - -.LP -.nf -\fBdscfg\fR \fB-D\fR \fIdgname\fR -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBdscfg\fR command controls the Availability Suite configuration by -providing facilities to initialize, list, format, restore the configuration -database. -.SH OPTIONS -.sp -.LP -If no options are specified, \fBdscfg\fR displays the current local -configuration location. The \fBdscfg\fR command supports the following options: -.sp -.ne 2 -.na -\fB\fB-L\fR\fR -.ad -.sp .6 -.RS 4n -Displays the status of the lock controlling access to the configuration -database. If the configuration database is locked, the type of lock (read or -write) is displayed along with the process id of the process that holds the -lock. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.sp .6 -.RS 4n -Displays the usage message for the \fBdscfg\fR command. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR\fR -.ad -.sp .6 -.RS 4n -Initializes the configuration database. As it deletes previous or current -configuration information, this option prompts you to confirm the deletion -before proceeding. -.RE - -.sp -.ne 2 -.na -\fB\fB-p\fR \fIparser_config_file\fR\fR -.ad -.sp .6 -.RS 4n -When used with the \fB-i\fR option, \fBdscfg\fR loads the parser configuration -file into the persistent configuration, it reformats the configuration -database. -.RE - -.sp -.ne 2 -.na -\fB\fB-a\fR \fIconfig_file\fR\fR -.ad -.sp .6 -.RS 4n -Restore the specified \fIconfig_file\fR into the configuration. This option -does not do any error checking of the file. Use of this option invalidates the -configuration file. -.RE - -.sp -.ne 2 -.na -\fB\fB-l\fR\fR -.ad -.sp .6 -.RS 4n -Lists the contents of current configuration database in a format that is -suitable for the \fB-a\fR option. When used in combination with the \fB-s\fR -option, it displays the contents stored in the location passed to the \fB-s\fR -option, but does not set the configuration location. -.RE - -.sp -.LP -The options below are for Sun Cluster-configured systems only. \fIgroup\fR can -be either Sun Cluster device group or as '-' as local devices. -.sp -.ne 2 -.na -\fB\fB-C\fR \fIgroup\fR\fR -.ad -.sp .6 -.RS 4n -Display the location of cluster configuration database. -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR\ \fIgroup\fR\ \fB-i\fR\fR -.ad -.sp .6 -.RS 4n -Initializes the configuration database entries that only associated with group -specified. As it deletes previous or current configuration information, this -options prompts you to confirm the deletion before proceeding. -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR\ \fIgroup\fR\ \fB-p\fR\ \fIparser_config_file\fR\fR -.ad -.sp .6 -.RS 4n -When used with the \fB-i\fR option, \fBdscfg\fR loads the parser configuration -file into the persistent configuration, it reformats the configuration database -entries that only associated with group specified. -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR \ \fIgroup\fR\ \fB-a\fR\ \fIconfig_file\fR\fR -.ad -.sp .6 -.RS 4n -Restore the specified \fIconfig_file\fR into the configuration database entries -that only associated with group specified. This option does not do any error -checking of the file. Use of this option invalidates the configuration file. -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR\ \fIgroup\fR\ \fB-l\fR\fR -.ad -.sp .6 -.RS 4n -Lists the contents of current configuration database that is associated with -resource group specified. -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR \ \fIgroup\fR\ \fB-s\fR\ \fIconfig_file_location\fR\fR -.ad -.sp .6 -.RS 4n -Specifies where the Sun Cluster configuration database resides, the location -has to be DID device. -.RE - -.sp -.ne 2 -.na -\fB\fB-D\fR \fIdevice_group\fR\fR -.ad -.sp .6 -.RS 4n -Checks whether the specified \fIdevice_group\fR 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, -.sp -(use echo $? to retrieve the return value): -.sp -.ne 2 -.na -\fB\fB1\fR\fR -.ad -.RS 13n -Device group is in Sun Cluster and is active on this node; -.RE - -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Device group is in Sun Cluster but active on another node; -.RE - -.sp -.ne 2 -.na -\fB\fB-1\fR\fR -.ad -.RS 13n -Device group is not in Sun Cluster. -.RE - -.RE - -.SH USAGE -.sp -.LP -The \fBdscfg\fR command is typically run from other scripts, such as package -installation scripts, and from \fBdscfgadm\fR(1M). It is not intended for -general use. For uses of \fBdscfg\fR not covered by \fBdscfgadm\fR, please -refer to the \fIAvailability Suite Troubleshooting Guide\fR. -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/dscfg_format\fR\fR -.ad -.sp .6 -.RS 4n -parser configuration file -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/dscfg_local\fR\fR -.ad -.sp .6 -.RS 4n -configuration location for all entries with no cluster tags -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/dscfg_cluster\fR\fR -.ad -.sp .6 -.RS 4n -reference file specifying the location of the Sun Cluster configuration -database. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdscfgadm\fR(1M), \fBiiadm\fR(1M), \fBscmadm\fR(1M), \fBsndradm\fR(1M), -\fBsvadm\fR(1M), \fBds.log\fR(4), \fBattributes\fR(5) diff --git a/usr/src/man/man1m/dscfgadm.1m b/usr/src/man/man1m/dscfgadm.1m deleted file mode 100644 index 92b6df73a5..0000000000 --- a/usr/src/man/man1m/dscfgadm.1m +++ /dev/null @@ -1,159 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DSCFGADM 1M "Oct 2, 2007" -.SH NAME -dscfgadm \- administration command for the Availability Suite configuration -location and services -.SH SYNOPSIS -.LP -.nf -\fBdscfgadm\fR \fB-i\fR -.fi - -.LP -.nf -\fBdscfgadm\fR \fB-e\fR [\fB-r\fR] [\fB-p\fR] -.fi - -.LP -.nf -\fBdscfgadm\fR \fB-d\fR [\fB-r\fR] -.fi - -.LP -.nf -\fBdscfgadm\fR \fB-s\fR -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBdscfgadm\fR command controls the Availability Suite configuration -location and services by providing facilities to set the configuration -location, and to enable and disable the Availability Suite services. -.SH OPTIONS -.sp -.LP -If you do not specify any arguments to a \fBdscfgadm\fR command, the utility -interactively steps you through setting the configuration location and starting -the services. The configuration location is validated to ensure it meets -criteria such as size and file type before it is initialized for use. -.sp -.LP -The \fBdscfgadm\fR command supports the following options. -.sp -.ne 2 -.na -\fB\fB-d\fR [\fB-r\fR ]\fR -.ad -.sp .6 -.RS 4n -Disables the Availability Suite SMF services. This includes stopping daemons -and suspending any Point-in-Time Copy or Remote Mirror sets that are currently -enabled under the Availability Suite software. When executed with no additional -options, the \fB-d\fR option disables all Availability Suite services. This -setting is persistent across system boots. -.sp -.ne 2 -.na -\fB\fB-r\fR\fR -.ad -.sp .6 -.RS 4n -When passed to the \fB-d\fR or \fB-e\fR option, acts only on the Remote Mirror -services. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-e\fR [\fB-r\fR ] [\fB-p\fR]\fR -.ad -.sp .6 -.RS 4n -Enables the Availability Suite SMF services. This includes starting daemons and -resuming any Point-in-Time Copy or Remote Mirror sets that have been previously -configured under the Availability Suite software. When executed with no -additional options, the \fB-e\fR option enables all Availability Suite -services. This setting is persistent across system boots. -.sp -.ne 2 -.na -\fB\fB-r\fR\fR -.ad -.sp .6 -.RS 4n -When passed to the \fB-d\fR or \fB-e\fR option, acts only on the Remote Mirror -services. -.RE - -.sp -.ne 2 -.na -\fB\fB-p\fR\fR -.ad -.sp .6 -.RS 4n -When passed to the \fB-e\fR option, enables only the Point-in-Time Copy -service. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR\fR -.ad -.sp .6 -.RS 4n -Displays information on the Availability Suite SMF services. -.RE - -.sp -.ne 2 -.na -\fB\fB-s\fR\fR -.ad -.sp .6 -.RS 4n -Allows you to set the location of the configuration database containing -information specific to Sun Cluster configurations. -.RE - -.sp -.ne 2 -.na -\fB\fB-x\fR\fR -.ad -.sp .6 -.RS 4n -Displays verbose debugging information as the program is executing. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdscfg\fR(1M), \fBiiadm\fR(1M), \fBscmadm\fR(1M), \fBsndradm\fR(1M), -\fBsvadm\fR(1M), \fBattributes\fR(5) diff --git a/usr/src/man/man1m/dscfglockd.1m b/usr/src/man/man1m/dscfglockd.1m deleted file mode 100644 index e7830789aa..0000000000 --- a/usr/src/man/man1m/dscfglockd.1m +++ /dev/null @@ -1,100 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DSCFGLOCKD 1M "Oct 2, 2007" -.SH NAME -dscfglockd \- Availability Suite Services lock daemon -.SH SYNOPSIS -.LP -.nf -\fB/usr/lib/dscfglockd\fR [\fB-e\fR \fIprogram\fR | \fB-f\fR \fIfile\fR] -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBdscfglockd\fR daemon coordinates StorageTek configuration database lock -requests between nodes within a cluster. -.SH OPTIONS -.sp -.LP -The \fBdscfglockd\fR supports the following options: -.sp -.ne 2 -.na -\fB\fB-e\fR \fIprogram\fR\fR -.ad -.sp .6 -.RS 4n -Executes the script and arguments in \fIprogram\fR. The executable and any -arguments it needs must be supplied with suitable quoting as a single argument -to this option. This argument is processed by \fBsh\fR(1). -.RE - -.sp -.ne 2 -.na -\fB\fB-f\fR \fIfile\fR\fR -.ad -.sp .6 -.RS 4n -Reads the list of names for peer hosts from \fIfile\fR. -.RE - -.sp -.LP -If no arguments are specified, \fBdscfglockd\fR acts as a local lock daemon, -but coordinates lock requests with any other daemons that might contact the -local host as part of their own configuration process. -.SH EXIT STATUS -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Daemon started successfully. -.RE - -.sp -.ne 2 -.na -\fB\fB>0\fR\fR -.ad -.RS 13n -Daemon failed to start. -.RE - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/lib/svc/method/svc-scm\fR\fR -.ad -.sp .6 -.RS 4n -Shell script for starting and stopping \fBdscfglockd\fR. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBsh\fR(1), \fBattributes\fR(5) diff --git a/usr/src/man/man1m/dsstat.1m b/usr/src/man/man1m/dsstat.1m deleted file mode 100644 index 16a8ba8ca9..0000000000 --- a/usr/src/man/man1m/dsstat.1m +++ /dev/null @@ -1,1127 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DSSTAT 1M "Oct 2, 2007" -.SH NAME -dsstat \- report Sun StorageTek Availability Suite I/O statistics -.SH SYNOPSIS -.LP -.nf -\fBdsstat\fR \fB-m\fR \fImode\fR [\fB-r\fR \fIreport-options\fR] [\fB-d\fR \fIdisplay-options\fR] - [\fB-s\fR \fIvolume-sets\fR] [\fB-f\fR | \fB-F\fR] [\fB-z\fR] [\fIinterval\fR [\fIcount\fR]] -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBdsstat\fR command collects and reports I/O statistics for the Sun -StorageTek Availability Suite products. -.SH OPTIONS -.sp -.LP -The \fBdsstat\fR supports the following options: -.sp -.ne 2 -.na -\fB\fB-m\fR \fB\fImode\fR\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the mode(s) of operation. Valid modes are: -.sp -.ne 2 -.na -\fB\fBcache\fR\fR -.ad -.sp .6 -.RS 4n -Cache statistics -.RE - -.sp -.ne 2 -.na -\fB\fBii\fR\fR -.ad -.sp .6 -.RS 4n -Point-in-Time Copy statistics -.RE - -.sp -.ne 2 -.na -\fB\fBsndr\fR\fR -.ad -.sp .6 -.RS 4n -Remote Mirror statistics -.RE - -To display statistics for multiple services simultaneously, use the \fB-m\fR -switch to specify each of the modes required. For example: -.sp -.in +2 -.nf -% \fBdsstat -m ii -m sndr\fR -% \fBdsstat -m ii -m sndr -m cache\fR -.fi -.in -2 -.sp - -To determine which statistics are being reported from which service, use the -\fIrole\fR field, described below. When cache statistics are requested as one -of the multiple services, the \fBrkps\fR and \fBwkps\fR statistics is further -divided into \fBcrkps\fR, \fBdrkps\fR, \fBcwkps\fR, and \fBdwkps\fR. If no -\fB-m\fR switch is specified, then \fBdsstat\fR displays default statistics for -all of the valid modes as described above. See "Field Descriptions," below for -descriptions of these fields. -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR \fB\fIreport-options\fR\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the volume components to be displayed. Each item is represented by a -single character, and multiple items can be selected. The \fIreport-options\fR -vary based on the mode(s) specified above. This option is not used for -\fBcache\fR mode. -.sp -Valid \fIreport-options\fR for \fBii\fR mode are: -.sp -.ne 2 -.na -\fB\fBm\fR\fR -.ad -.RS 13n -Master volume statistics. -.RS +4 -.TP -.ie t \(bu -.el o -For the "report-options for ii mode": \fBm\fR, \fBs\fR, \fBb\fR, \fBo\fR -.RE -.RS +4 -.TP -.ie t \(bu -.el o -For the "report-options for sndr mode": \fBb\fR, \fBn\fR -.RE -.RS +4 -.TP -.ie t \(bu -.el o -For the "display-options for cache mode": \fBr\fR, \fBw\fR, \fBd\fR, \fBc\fR, -\fBs\fR, \fBf\fR -.RE -.RS +4 -.TP -.ie t \(bu -.el o -For the "display-options for ii mode": \fBr\fR, \fBw\fR, \fBt\fR, \fBs\fR, -\fBp\fR, \fBf\fR -.RE -.RE - -.sp -.ne 2 -.na -\fB\fBs\fR\fR -.ad -.RS 13n -Shadow volume statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBb\fR\fR -.ad -.RS 13n -Bitmap volume statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBo\fR\fR -.ad -.RS 13n -Overflow volume statistics, if attached. -.RE - -Valid \fIreport-options\fR for \fBsndr\fR mode are: -.sp -.ne 2 -.na -\fB\fBb\fR\fR -.ad -.RS 13n -Bitmap volume statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBn\fR\fR -.ad -.RS 13n -Network volume statistics. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-d\fR \fIdisplay-options\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the statistics to be displayed. The types of statistics are -represented by a single character; multiple types can be specified. -.sp -For \fBcache\fR mode, the valid \fIdisplay-options\fR are: -.sp -.ne 2 -.na -\fB\fBr\fR\fR -.ad -.RS 13n -Detailed read statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBw\fR\fR -.ad -.RS 13n -Detailed write statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBs\fR\fR -.ad -.RS 13n -Summary statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBf\fR\fR -.ad -.RS 13n -Cache behavior flags. -.RE - -The following \fIdisplay-options\fR are available only for cache mode, they -need to be combined with the mode options (\fB-m\fR) -.sp -.ne 2 -.na -\fB\fBd\fR\fR -.ad -.RS 13n -Destaged data statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBc\fR\fR -.ad -.RS 13n -Write cancellation statistics. -.RE - -The default \fIdisplay-options\fR for \fBcache\fR are \fBsf\fR. -.sp -For \fBii\fR mode, the valid \fIdisplay-options\fR are: -.sp -.ne 2 -.na -\fB\fBr\fR\fR -.ad -.sp .6 -.RS 4n -Detailed read statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBw\fR\fR -.ad -.sp .6 -.RS 4n -Detailed write statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBt\fR\fR -.ad -.sp .6 -.RS 4n -Timing statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBs\fR\fR -.ad -.sp .6 -.RS 4n -Summary statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBp\fR\fR -.ad -.sp .6 -.RS 4n -Percentage of volume requiring sync. -.RE - -.sp -.ne 2 -.na -\fB\fBf\fR\fR -.ad -.sp .6 -.RS 4n -Volume type/status flags. -.RE - -The default \fIdisplay-options\fR for \fBii\fR are \fBspf\fR. For \fBsndr\fR -mode, the valid \fIdisplay-options\fR are: -.sp -.ne 2 -.na -\fB\fBr\fR\fR -.ad -.RS 13n -Detailed read statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBw\fR\fR -.ad -.RS 13n -Detailed write statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBt\fR\fR -.ad -.RS 13n -Timing statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBs\fR\fR -.ad -.RS 13n -Summary statistics. -.RE - -.sp -.ne 2 -.na -\fB\fBp\fR\fR -.ad -.RS 13n -Percentage of volume requiring sync. -.RE - -.sp -.ne 2 -.na -\fB\fBf\fR\fR -.ad -.RS 13n -Volume type/status flags. -.RE - -.sp -.ne 2 -.na -\fB\fBq\fR\fR -.ad -.RS 13n -Asynchronous queue statistics. -.RE - -The following \fIdisplay-option\fR is only available for \fBsndr\fR mode, and -needs to be combined with the mode options (\fB-m\fR). -.sp -.ne 2 -.na -\fB\fBq\fR\fR -.ad -.RS 13n -Asynchronous queue statistics. -.RE - -The default \fIdisplay-options\fR for \fBsndr\fR are \fBspf\fR. -.sp -Specifying the summary \fIdisplay-option\fR causes \fBr\fR \fBw\fR \fBt\fR -\fIdisplay-options\fR to be ignored. -.RE - -.sp -.ne 2 -.na -\fB\fB-s\fR \fB\fIvolume-sets\fR\fR\fR -.ad -.RS 20n -Filters the output to include only the specified \fIvolume-sets\fR, where -\fIvolume-sets\fR is a comma-delimited list of volume names. When displaying -Remote Mirror statistics, the name specified is compared to the Remote Mirror -primary volume to determine if they match. Additionally, an Remote Mirror -volume should be specified as \fI<host>\fR:\fI<volume>\fR where \fI<host>\fR is -the primary or secondary host and \fI<volume>\fR is the volume name by which -that host recognizes the volume set. When specifying multiple Remote Mirror -volumes sets, be aware that each volume set specified is evaluated -individually, using the rules above. When displaying Point-in-Time Copy -statistics, the volume name specified is compared to the Point-in-Time Copy -shadow volume to determine if they match. -.RE - -.sp -.ne 2 -.na -\fB\fB-f\fR\fR -.ad -.RS 20n -Output field headers at every reporting cycle. -.RE - -.sp -.ne 2 -.na -\fB\fB-F\fR\fR -.ad -.RS 20n -Output field headers once, when reporting begins. -.RE - -.sp -.ne 2 -.na -\fB\fB-z\fR\fR -.ad -.RS 20n -Suppress report lines that have zero values or no activity. -.RE - -.SH OPERANDS -.sp -.LP -The \fBdsstat\fR command line supports the following operands: -.sp -.ne 2 -.na -\fB\fIinterval\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the \fIinterval\fR for each report, in seconds. If no \fIinterval\fR -is specified, a single report with a one second \fIinterval\fR is output. -.sp -Due to the varying number of entries in a given set and the varying number of -sets, header information might appear in the middle of a set being reported. To -avoid this, use the \fB-f\fR or \fB-F\fR options to display the header -information at the desired time. -.RE - -.sp -.ne 2 -.na -\fB\fIcount\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the number of reports to generate. If no \fIcount\fR is specified, -output continues until interrupted. -.RE - -.SS "Field Descriptions" -.sp -.LP -Unless otherwise specified, all fields are per-second averages based on the -data collected during the specified \fIinterval\fR. -.sp -.ne 2 -.na -\fB\fBname\fR\fR -.ad -.RS 13n -Name of the entity being reported -.RE - -.sp -.ne 2 -.na -\fB\fBt\fR\fR -.ad -.RS 13n -Volume type -.RE - -.sp -.ne 2 -.na -\fB\fBs\fR\fR -.ad -.RS 13n -Volume status -.RE - -.sp -.ne 2 -.na -\fB\fBr\fR\fR -.ad -.RS 13n -Cache read behavior -.RE - -.sp -.ne 2 -.na -\fB\fBw\fR\fR -.ad -.RS 13n -Cache write behavior -.RE - -.sp -.ne 2 -.na -\fB\fBpct\fR\fR -.ad -.RS 13n -Percentage of volume requiring sync -.RE - -.sp -.ne 2 -.na -\fB\fBrole\fR\fR -.ad -.RS 13n -Role of the item being reported -.RE - -.sp -.ne 2 -.na -\fB\fBtps\fR\fR -.ad -.RS 13n -Total number of reads + writes -.RE - -.sp -.ne 2 -.na -\fB\fBrtps\fR\fR -.ad -.RS 13n -Number of reads -.RE - -.sp -.ne 2 -.na -\fB\fBwtps\fR\fR -.ad -.RS 13n -Number of writes -.RE - -.sp -.ne 2 -.na -\fB\fBkps\fR\fR -.ad -.RS 13n -Total kilobytes read + written -.RE - -.sp -.ne 2 -.na -\fB\fBrkps\fR\fR -.ad -.RS 13n -Kilobytes read -.RE - -.sp -.ne 2 -.na -\fB\fBwkps\fR\fR -.ad -.RS 13n -Kilobytes written -.RE - -.sp -.ne 2 -.na -\fB\fBcrkps\fR\fR -.ad -.RS 13n -Kilobytes read from cache -.RE - -.sp -.ne 2 -.na -\fB\fBdrkps\fR\fR -.ad -.RS 13n -Kilobytes read from disk -.RE - -.sp -.ne 2 -.na -\fB\fBcwkps\fR\fR -.ad -.RS 13n -Kilobytes written to cache -.RE - -.sp -.ne 2 -.na -\fB\fBdwkps\fR\fR -.ad -.RS 13n -Kilobytes written to disk -.RE - -.sp -.ne 2 -.na -\fB\fBckps\fR\fR -.ad -.RS 13n -Kilobytes transferred to or from cache -.RE - -.sp -.ne 2 -.na -\fB\fBdkps\fR\fR -.ad -.RS 13n -Kilobytes transferred to or from disk -.RE - -.sp -.ne 2 -.na -\fB\fBsvt\fR\fR -.ad -.RS 13n -Service time per operation -.RE - -.sp -.ne 2 -.na -\fB\fBhit\fR\fR -.ad -.RS 13n -Read hits during \fIinterval\fR -.RE - -.sp -.ne 2 -.na -\fB\fBds/s\fR\fR -.ad -.RS 13n -Kilobytes destaged from cache -.RE - -.sp -.ne 2 -.na -\fB\fBcn/s\fR\fR -.ad -.RS 13n -Number of write cancellations -.RE - -.sp -.ne 2 -.na -\fB\fBq\fR\fR -.ad -.RS 13n -Type of asynchronous queuing being used -.RE - -.sp -.ne 2 -.na -\fB\fBqi\fR\fR -.ad -.RS 13n -Number of items currently queued -.RE - -.sp -.ne 2 -.na -\fB\fBqk\fR\fR -.ad -.RS 13n -Kilobytes currently queued -.RE - -.sp -.ne 2 -.na -\fB\fBqhwi\fR\fR -.ad -.RS 13n -High water mark of queued items -.RE - -.sp -.ne 2 -.na -\fB\fBqhwk\fR\fR -.ad -.RS 13n -High water mark of queued kilobytes -.RE - -.sp -.LP -The \fBname\fR field displays only the last 16 characters of the name. -.sp -.LP -Valid cache behaviors for \fBcache\fR are: -.sp -.ne 2 -.na -\fB\fBC\fR\fR -.ad -.RS 13n -Cache reads/writes -.RE - -.sp -.ne 2 -.na -\fB\fBD\fR\fR -.ad -.RS 13n -Disk reads/writes -.RE - -.sp -.LP -Valid volume types for \fBii\fR are: -.sp -.ne 2 -.na -\fB\fBI\fR\fR -.ad -.RS 13n -Independent shadow volume -.RE - -.sp -.ne 2 -.na -\fB\fBD\fR\fR -.ad -.RS 13n -Dependent shadow volume -.RE - -.sp -.LP -Valid volume status for \fBii\fR is: -.sp -.ne 2 -.na -\fB\fBC\fR\fR -.ad -.RS 13n -Copy in progress -.RE - -.sp -.ne 2 -.na -\fB\fB-\fR\fR -.ad -.RS 13n -No copy in progress -.RE - -.sp -.LP -Valid volume types for \fBsndr\fR are: -.sp -.ne 2 -.na -\fB\fBP\fR\fR -.ad -.RS 13n -This is the primary host of this volume set -.RE - -.sp -.ne 2 -.na -\fB\fBS\fR\fR -.ad -.RS 13n -This is the secondary host of this volume set -.RE - -.sp -.LP -Valid volume status for \fBsndr\fR is: -.sp -.ne 2 -.na -\fB\fBL\fR\fR -.ad -.RS 13n -Changes to this volume are being logged -.RE - -.sp -.ne 2 -.na -\fB\fBQ\fR\fR -.ad -.RS 13n -Volume are in queuing mode -.RE - -.sp -.ne 2 -.na -\fB\fBR\fR\fR -.ad -.RS 13n -Replicating changes to secondary -.RE - -.sp -.ne 2 -.na -\fB\fBSY\fR\fR -.ad -.RS 13n -Synchronization in progress. Sending data. -.RE - -.sp -.ne 2 -.na -\fB\fBRS\fR\fR -.ad -.RS 13n -Reverse synchronization in progress. Receiving data. -.RE - -.sp -.ne 2 -.na -\fB\fBSN\fR\fR -.ad -.RS 13n -Synchronization needed -.RE - -.sp -.ne 2 -.na -\fB\fBRN\fR\fR -.ad -.RS 13n -Reverse synchronization needed -.RE - -.sp -.ne 2 -.na -\fB\fBVF\fR\fR -.ad -.RS 13n -Volume failed -.RE - -.sp -.ne 2 -.na -\fB\fBBF\fR\fR -.ad -.RS 13n -Bitmap failed -.RE - -.sp -.ne 2 -.na -\fB\fBQF\fR\fR -.ad -.RS 13n -Queue failed -.RE - -.sp -.LP -Valid queue types for \fBsndr\fR are: -.sp -.ne 2 -.na -\fB\fBD\fR\fR -.ad -.RS 13n -Disk-based queuing enabled -.RE - -.sp -.ne 2 -.na -\fB\fBM\fR\fR -.ad -.RS 13n -Memory-based queuing enabled -.RE - -.sp -.LP -Volume roles for \fBsndr\fR are: -.sp -.ne 2 -.na -\fB\fBnet\fR\fR -.ad -.RS 13n -Network volume statistics -.RE - -.sp -.ne 2 -.na -\fB\fBbmp\fR\fR -.ad -.RS 13n -Bitmap volume statistics -.RE - -.sp -.LP -Volume roles for \fBii\fR are: -.sp -.ne 2 -.na -\fB\fBmst\fR\fR -.ad -.RS 13n -Master volume statistics -.RE - -.sp -.ne 2 -.na -\fB\fBshd\fR\fR -.ad -.RS 13n -Shadow volume statistics -.RE - -.sp -.ne 2 -.na -\fB\fBbmp\fR\fR -.ad -.RS 13n -Bitmap volume statistics -.RE - -.sp -.ne 2 -.na -\fB\fBovr\fR\fR -.ad -.RS 13n -Overflow volume statistics -.RE - -.SH EXAMPLES -.LP -\fBExample 1 \fRReport Cache Statistics -.sp -.LP -The following example shows the display of Report Cache statistics, with -detailed breakdowns of read and writes to cache/disk. Reports are generated at -five second intervals. Reporting is limited to the set -\fB/dev/rdsk/c1t1d0s0\fR. - -.sp -.in +2 -.nf - # dsstat -m cache -d rw -s /dev/rdsk/c1t1d0s0 5 -- read - - write - -name ckps dkps hit ckps dkps hit -dev/rdsk/c1t1d0s0 0 0 0.00 0 0 0.00 -dev/rdsk/c1t1d0s0 3 2396 0.13 983 763 100.00 -dev/rdsk/c1t1d0s0 2399 799 75.00 2815 2686 100.00 -dev/rdsk/c1t1d0s0 3200 800 80.00 2755 2908 100.00 -dev/rdsk/c1t1d0s0 3999 799 83.33 2809 2868 100.00 -dev/rdsk/c1t1d0s0 4800 800 85.71 2867 2931 100.00 -.fi -.in -2 - -.LP -\fBExample 2 \fRReport Master, Shadow and Bitmap Statistics -.sp -.LP -Report master, shadow and bitmap statistics for Point-in-Time Copy, using -default output. Generate reports at two second intervals. - -.sp -.in +2 -.nf -# dsstat -m ii -r msb 2 -name t s pct role kps tps svt -dev/rdsk/c0t1d0s5 I C 96.15 mst 19921 38 22 -dev/rdsk/c0t1d0s6 shd 9960 19 20 -dev/rdsk/c0t1d0s7 bmp 39 77 2 -dev/rdsk/c0t1d0s5 I C 94.24 mst 19623 38 22 -dev/rdsk/c0t1d0s6 shd 9939 19 20 -dev/rdsk/c0t1d0s7 bmp 39 77 2 -dev/rdsk/c0t1d0s5 I C 92.34 mst 19969 39 22 -dev/rdsk/c0t1d0s6 shd 9984 19 20 -dev/rdsk/c0t1d0s7 bmp 39 78 2 -.fi -.in -2 - -.LP -\fBExample 3 \fRReport Network Statistics for Remote Mirror -.sp -.LP -Report network statistics for Remote Mirror, using detailed read, write -statistics. Report includes volume type/status flags and percentages. Generate -reports at two second intervals. Limit reporting to the set -\fB/dev/rdsk/c0t1d0s0\fR. - -.sp -.in +2 -.nf -# dsstat -m sndr -r n -d rwpf -s /dev/rdsk/c0t1d0s0 2 -name t s pct role rkps rtps wkps wtps -dev/rdsk/c0t1d0s0 P L 100.00 sec 0 0 0 0 -dev/rdsk/c0t1d0s0 P SY 99.90 sec 0 0 288 9 -dev/rdsk/c0t1d0s0 P SY 97.90 sec 0 0 5296 165 -dev/rdsk/c0t1d0s0 P SY 95.81 sec 0 0 5184 161 -dev/rdsk/c0t1d0s0 P SY 93.81 sec 0 0 5280 164 -dev/rdsk/c0t1d0s0 P SY 91.71 sec 0 0 5198 162 -.fi -.in -2 - -.SH EXIT STATUS -.sp -.LP -The following exit values are returned: -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Successful completion. -.RE - -.sp -.ne 2 -.na -\fB\fB1\fR\fR -.ad -.RS 13n -Successful completion, no statistics to report. -.RE - -.sp -.ne 2 -.na -\fB\fB2\fR\fR -.ad -.RS 13n -An invalid argument has been encountered. -.RE - -.sp -.ne 2 -.na -\fB\fB3\fR\fR -.ad -.RS 13n -No memory is available to create \fBkstat\fR statistics. -.RE - -.sp -.ne 2 -.na -\fB\fB4\fR\fR -.ad -.RS 13n -An unknown error has occurred. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdscfg\fR(1M), \fBsvadm\fR(1M), \fBds.log\fR(4), \fBrdc.cf\fR(4), -\fBattributes\fR(5) diff --git a/usr/src/man/man1m/iiadm.1m b/usr/src/man/man1m/iiadm.1m deleted file mode 100644 index 5f2fa3c015..0000000000 --- a/usr/src/man/man1m/iiadm.1m +++ /dev/null @@ -1,1016 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH IIADM 1M "Nov 26, 2017" -.SH NAME -iiadm \- command-line interface to control Sun StorageTek Availability Suite -Point-in-Time Copy operations -.SH SYNOPSIS -.LP -.nf -\fBiiadm\fR \fB-e\fR {ind | shd} \fImaster_vol\fR \fIshadow_vol\fR \fIbitmap_vol\fR -.fi - -.LP -.nf -\fBiiadm\fR \fB-ne\fR ind \fImaster_vol\fR \fIshadow_vol\fR \fIbitmap_vol\fR -.fi - -.LP -.nf -\fBiiadm\fR [\fB-p\fR] [\fB-n\fR] {\fB-c\fR | \fB-u\fR} {s | m} \fIvolume_set\fR -.fi - -.LP -.nf -\fBiiadm\fR [\fB-adDilR\fR] \fIvolume_set\fR -.fi - -.LP -.nf -\fBiiadm\fR [\fB-p\fR] [\fB-n\fR] \fB-w\fR \fIvolume_set\fR -.fi - -.LP -.nf -\fBiiadm\fR [\fB-hilLv\fR] -.fi - -.LP -.nf -\fBiiadm\fR \fB-P\fR \fIdelay\fR \fIunits\fR \fIvolume_set\fR -.fi - -.LP -.nf -\fBiiadm\fR \fB-P\fR \fIvolume_set\fR -.fi - -.LP -.nf -\fBiiadm\fR \fB-A\fR \fIoverflow_vol\fR \fIvolume_set\fR -.fi - -.LP -.nf -\fBiiadm\fR [\fB-OQ\fR] \fIoverflow_vol\fR -.fi - -.LP -.nf -\fBiiadm\fR \fB-E\fR \fIvolume_set\fR -.fi - -.LP -.nf -\fBiiadm\fR [\fB-IJ\fR] \fIvolume_set\fR \fIbitmap\fR -.fi - -.LP -.nf -\fBiiadm\fR \fB-g\fR \fIgroup_name\fR [\fB-aAcdDeEilLmPRuw\fR] -.fi - -.LP -.nf -\fBiiadm\fR [\fB-C\fR] \fIcluster_tag\fR [\fIoptions\fR] -.fi - -.SH DESCRIPTION -.LP -Point-in-Time Copy software is a point-in-time snapshot feature of the Solaris -operating system. -.sp -.LP -A Point-in-Time Copy snapshot is an instantly-available, time-fixed, replicated -view of a momentarily quiesced volume. Once a snapshot is taken, Point-in-Time -Copy software allows immediate read/write access to both the master and shadow -volume data. -.sp -.LP -Point-in-Time Copy software tracks the differences between the master and -shadow volumes (caused by writes) from the moment that the snapshot was -established. This capability allows applications accessing the master volume's -data to move forward in time independently of applications accessing the shadow -volume's data, and vice-versa. -.sp -.LP -The Point-in-Time Copy software's tracking of differences between the master -and shadow volumes facilitates a fast resynchronization or a full copy at a -later time. The volume resynchronization can occur from either shadow to master -or master to shadow. -.sp -.LP -Instantly after the point-in-time is (re-)established (either when the CLI -prompt returns or the next shell script command is read), the master volume can -be remounted or the applications using them can be resumed. Also, the shadow -volume can be mounted and immediately accessed. -.sp -.LP -The \fBiiadm\fR command line utility performs only one action per command -invocation. Because of this, you cannot combine multiple options, except in -combination with the following overall command modifiers: -.RS +4 -.TP -.ie t \(bu -.el o -If no action item is entered, \fBiiadm\fR displays the list of Point-in-Time -Copy sets (non-suspended) currently configured. If more than one action item, -or an incorrectly specified action item is entered, \fBiiadm\fR displays the -specific error message to stderr, followed by a brief usage summary. -.RE -.RS +4 -.TP -.ie t \(bu -.el o -For the Point-in-Time Copy options ENABLE (\fB-e\fR), COPY (\fB-c\fR) and -UPDATE (\fB-u\fR), there are two associated shadow volume selection qualifiers, -\fB{ind|dep}\fR, that are used to specify the type of Point-in-Time Copy volume -set to create. -.RE -.sp -.LP -An independent (\fBind\fR) snapshot causes Point-in-Time Copy software to -perform a full volume copy operation from the master to the shadow. When the -copy completes, the shadow volume data is identical to the master volume data -at the moment that it was established. Create an independent shadow if you -require two physical copies of the data. An independent shadow volume must be -the same size or greater than the size of the master volume. Sun recommends -that the master and shadow volumes be the same size for environments where -resynchronization from shadow to master is a consideration. -.sp -.LP -A dependent (\fBdep\fR) snapshot causes Point-in-Time Copy software not to -perform a full volume copy. The resulting shadow volume relies on the master -volume for all unmodified data blocks, which are not copied until requested. -Create a dependent shadow when you do not require two physical copies of the -data. A dependent shadow volume can be either the same size or smaller than the -master volume. A smaller shadow volume is called a \fBCompact Dependent Shadow -Volume\fR, and is typically used when the amount of change that occurs to a -Point-in-Time Copy volume set is small compared to the entire size of the -master volume. -.sp -.LP -The following syntax allows you to create an exportable independent shadow -volume in a Sun Cluster environment: -.sp -.in +2 -.nf -# iiadm -ne ind master shadow bitmap -.fi -.in -2 -.sp - -.sp -.LP -An issue arises when using a Compact Dependent Shadow Volume in that its size -is established at the time that the Point-in-Time Copy volume set is enabled. -If the amount of change to the entire volume set over the duration of its usage -exceeds the space allocated for the shadow volume, the shadow volume is marked -as out of space. It is possible to read from the shadow volume even after it is -out of space, until a portion of the data for which there was no room is -requested. Once that happens, the read fails and the shadow volume is marked -offline. -.sp -.LP -To address this issue, Point-in-Time Copy supports the ability to associate an -\fBoverflow\fR volume to an existing Point-in-Time Copy dependent volume set. -Thus, if the size of the Compact Dependent Shadow Volume is too small, or an -unscheduled amount of change occurs to the volume set, changed data can be -redirected to the associated overflow volume. To facilitate efficient usage of -this overflow volume, it can be associated with multiple Point-in-Time Copy -volume sets on an as-needed basis. -.SS "Considerations" -.LP -Prior to invoking an Point-in-Time Copy \fBenable\fR, \fBcopy\fR or -\fBupdate\fR operation, Point-in-Time Copy assures that the shadow volume is -not mounted, to prevent a file system panic from occurring. Also, it is -suggested that you either unmount or suspend (quiesce) all applications using -the master volume, for only the instant when the point-in-time snapshot is -taken. This assures that an atomically consistent point-in-time snapshot is -taken. -.sp -.LP -It is suggested that, if the master volume was suspended rather than unmounted, -the new point-in-time shadow volume's integrity be validated using volume -validation utilities, such as \fBfsck\fR(1M). The reason is that Point-in-Time -Copy has made a point-in-time copy of a \fBmounted\fR master volume to an -\fBunmounted\fR shadow volume. During the mounting of the shadow volume, the -file system detects that it is in the \fBmounted\fR state. Typically this state -occurs only when a system crashes, so the file system attempts to validate the -integrity of the volume assuming a system failure occurred, not an -Point-in-Time Copy. -.SS "ENVIRONMENT OPTIONS" -.LP -The \fBii_bitmap\fR variable in the \fB/usr/kernel/drv/ii.conf\fR configuration -file determines the bitmap volume operational semantics as follows: -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Indicates that the bitmap is maintained in memory only or resume operation. -.RE - -.sp -.ne 2 -.na -\fB\fB1\fR\fR -.ad -.RS 13n -Indicates that the bitmap is maintained in memory and on disk. This is the -default value. -.RE - -.sp -.LP -If a system failure occurs while using \fBii_bitmap=0\fR, the shadow volume -might be inconsistent and fast resynchronization would not be possible. -.sp -.LP -If Point-in-Time Copy is used in conjunction with the Network Storage component -Remote Mirror or in a Sun Cluster, set \fBii_bitmap=1\fR. -.sp -.LP -The \fBii_debug\fR variable in the \fB/usr/kernel/drv/ii.conf\fR configuration -file determines the amount of information logging that is output to the system -console \fB/dev/console\fR during Point-in-Time Copy processing. -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Indicates that no logging is sent to the system console. -.RE - -.sp -.ne 2 -.na -\fB\fB1\fR\fR -.ad -.RS 13n -Indicates that informational logging is sent to the system console. -.RE - -.sp -.ne 2 -.na -\fB\fB2\fR\fR -.ad -.RS 13n -Indicates that developmental logging is sent to the system console. -.RE - -.SH OPTIONS -.LP -The \fBiiadm\fR utility supports the following options. -.sp -.ne 2 -.na -\fB\fB-e\fR\fB{ind|dep}\fR \fImaster_vol shadow_vol bitmap_vol\fR\fR -.ad -.sp .6 -.RS 4n -Enable Point-in-Time Copy for the specified master, shadow, and bitmap volumes. -.sp -The enable shadow set processing assures that the specified volumes are -accessible, that the \fIshadow_vol\fR is not mounted, and that the -\fIbitmap_vol\fR is correctly sized for the type of shadow set being created. -Additionally, it assures that the volumes are under control of the SV driver ( -if they are not, it puts them there), initializes the bitmap volume, and, if -the volume set is an independent shadow set, a full copy operation is -initiated. -.sp -On a successful enable, Point-in-Time Copy stores the specified -\fImaster_vol\fR, \fIshadow_vol\fR and \fIbitmap_vol\fR names, plus the -enabling type (\fBind\fR or \fBdep\fR), into the Point-in-Time Copy -configuration store. The configuration store contains all currently configured -Point-in-Time Copy Volume Sets and their associated configuration attributes. -(See discussion above on independent and dependent shadow volume semantics.) -.sp -\fImaster_vol\fR is the volume from which a point-in-time snapshot is made. -.sp -\fIshadow_vol\fR is the volume that contains the point-in-time snapshot. -.sp -\fIbitmap_vol\fR is used for tracking differences between the shadow and master -volumes. When Point-in-Time Copy shadow operations are suspended or resumed, -the bitmap volume (maintained in kernel memory) can be stored in or retrieved -from permanent storage. The storage associated with the bitmap volume should be -as redundant as that of the shadow volume storage. -.sp -The \fIshadow_vol\fR name is the name that the Point-in-Time Copy Shadow Set is -known by for all \fBiiadm\fR options requiring specification of a -\fIvolume_set\fR name. -.RE - -.sp -.ne 2 -.na -\fB\fB-d\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Disable the Point-in-Time Copy volume set associated with the specified -\fIvolume_set\fR. -.sp -If Point-in-Time Copy was running in \fBindependent\fR mode as specified in the -\fB-e\fR \fBind\fR options, above, the shadow volume data contains the same -data as it did before it was disabled (assuming no writes have occurred). Users -can access the master and shadow volumes, as they are now standalone -point-in-time copies. -.sp -During the time that the full copy is active, an \fBindependent\fR volume -operates as though it is a \fBdependent\fR volume. To assure that the volume is -no longer in full copy mode, issue the following command to wait for the full -copy to complete: -.sp -.in +2 -.nf -# iiadm -w \fIvolume_set\fR -.fi -.in -2 -.sp - -.RE - -.sp -.ne 2 -.na -\fB[\fB-p\fR] \fB-u\fR \fBs\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Update the shadow volume from the master. -.sp -Updates a point-in-time copy of the master volume to the shadow volume. -\fIvolume_set\fR is the Point-in-Time Copy shadow set containing the master and -shadow volumes. This option provides a fast resynchronization of the shadow -volume, creating an incremental copy of the master. This update copies all 32KB -segments flagged as different between the master and shadow volumes. It does -not copy all master volume data, only changed data. While the data is being -copied, the shadow is dependent upon the master volume. -.sp -Before using this option, momentarily quiesce the workload to the volumes; stop -the host application from writing to the volumes. This ensures that the -point-in-time data is consistent. You can visually check the status of this -copy or update operation with \fBiiadm\fR \fB-i\fR \fIvolume_set\fR, or -interactively (by means of a shell or script) with \fBiiadm\fR \fB-w\fR -\fIvolume_set\fR, before using the target volume for any other operations. -.sp -This command supports PID (Process IDentifier) locking, by using the option -\fB-p\fR, \fBiiadm\fR \fB-p\fR \fB-u\fR \fBs\fR. Enabling this option prevents -other processes from taking a new point-in-time snapshot, thus invalidating -prior point-in-time data. -.RE - -.sp -.ne 2 -.na -\fB[\fB-p\fR] [\fB-n\fR] \fB-u\fR \fBm\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Updates a point-in-time copy of the master volume from the shadow. -\fIvolume_set\fR is the Point-in-Time Copy volume set containing the master and -shadow. This option provides a fast resynchronization of the master volume, -creating an incremental copy of the shadow. This update copies all 32KB -segments flagged as different between the master and shadow volumes. It does -not copy all shadow volume data, only changed data. While the data is being -copied, the master is dependent upon the shadow volume. -.sp -Before using this option, momentarily quiesce the workload to the volumes; stop -the host application from writing to the volumes. This ensures that the -point-in-time data is consistent. You can visually check the status of this -copy or update operation with \fBiiadm\fR \fB-i\fR \fIvolume_set\fR, or -interactively (by means of a shell or script) with \fBiiadm\fR \fB-w\fR -\fIvolume_set\fR, before using the target volume for any other operations. -.sp -This command is query enabled to prevent accidentally overwriting the data on a -master volume. When this command option is used in scripts, add the \fB-n\fR -option to prevent the query from occurring. -.sp -This command supports PID (Process IDentifier) locking, by using the option -\fB-p\fR, \fBiiadm\fR \fB-p\fR \fB-u\fR \fBm\fR. Enabling this option prevents -other processes from taking a new point-in-time snapshot, thus invalidating -prior point-in-time data. -.RE - -.sp -.ne 2 -.na -\fB[\fB-p\fR] \fB-c\fR s \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Copy the master volume to the shadow. -.sp -Creates a point-in-time copy of the master volume to the shadow volume. -\fIvolume_set\fR is the Point-in-Time Copy volume set containing the master and -shadow. This option writes all data in the point-in-time copy of the master -volume to the shadow volume. While the data is being copied from master to -shadow, the shadow is dependent on the master volume. -.sp -This option performs a full volume copy. Use \fBiiadm\fR \fB-u\fR \fBs\fR -unless the integrity of the data on the independent shadow volume is in doubt. -Otherwise, use this option to synchronize the master and shadow volumes; that -is, make the data on each volume match. -.sp -Before using this option, momentarily quiesce the workload to the volumes; stop -the host application from writing to the volumes. This ensures that the -point-in-time data is consistent. You can visually check the status of this -copy or update operation with \fBiiadm\fR \fB-i\fR \fIvolume_set\fR, or -interactively (by means of a shell or script) with \fBiiadm\fR \fB-w\fR -\fIvolume_set\fR, before using the target volume for any other operations. -.sp -This command supports PID (Process IDentifier) locking, by using the \fB-p\fR -option, \fBiiadm\fR \fB-p\fR \fB-c\fR \fBs\fR. Enabling this option prevents -other processes from taking a new point-in-time snapshot, thus invalidating -prior point-in-time data. -.RE - -.sp -.ne 2 -.na -\fB\fB-c\fR \fBm\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Copy the shadow volume to the master. -.sp -Creates a point-in-time copy of the shadow volume to the master volume. -\fIvolume_set\fR is the Point-in-Time Copy volume set containing the master and -shadow volumes. This option writes all data in the point-in-time copy of the -shadow volume to the master volume. While the data is being copied from the -shadow to the master, the master is dependent upon the shadow volume. -.sp -This option performs a full volume copy. Use \fBiiadm\fR \fB-u\fR \fBm\fR -unless the integrity of the data on the independent master is in doubt. -Otherwise, use this option to synchronize the master and shadow volumes; that -is, make the data on each volume match. -.sp -Before using this option, momentarily quiesce the workload to the volumes; stop -the host application from writing to the volumes. This ensures that the -point-in-time data is consistent. You can visually check the status of this -copy or update operation with \fBiiadm\fR \fB-i\fR \fIvolume_set\fR, or -interactively (by means of a shell or script) with \fBiiadm\fR \fB-w\fR -\fIvolume_set\fR, before using the target volume for any other operations. -.sp -This command is query-enabled to prevent accidentally overwriting the data on a -master volume. When this command option is used in scripts, add the \fB-n\fR -option to prevent the query from occurring. -.sp -This command supports PID (Process IDentifier) locking, by using the \fB-p\fR -option, \fBiiadm\fR \fB-p\fR \fB-c\fR \fBm\fR. Enabling this option prevents -other processes from taking a new point-in-time snapshot, thus invalidating -prior point-in-time data. -.RE - -.sp -.ne 2 -.na -\fB\fB-a\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Abort any current copy operation that might be active between the master and -shadow volumes. \fIvolume_set\fR is the Point-in-Time Copy volume set -containing the master and shadow volumes. After executing \fBiiadm\fR \fB-a\fR, -the update or copy to the target (master or shadow) volume is incomplete. The -target volume is now a dependent copy of the source volume. Reissue the update -or copy command option to resynchronize the volumes. -.RE - -.sp -.ne 2 -.na -\fB\fB[\fR\fB-p\fR\fB] [\fR\fB-n\fR\fB] \fR\fB-w\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Wait until any in-progress copy or update operation completes or is aborted. -\fIvolume_set\fR is the Point-in-Time Copy volume set containing the master and -shadow volumes. -.sp -This option waits until the current Point-in-Time Copy operation is complete, -thus preventing a subsequent \fBiiadm\fR command (from a shell or script) from -executing. Use this command option when you need to be sure the copy or update -operation has completed. -.sp -This command supports PID (Process IDentifier) unlocking. If a prior copy or -update, using a command \fBiiadm\fR \fB-p\fR \fB{\fR\fB-c\fR\fB|\fR\fB-u\fR\fB} -{m|s}\fR, was invoked with the \fB-p\fR option, upon completion of the wait -processing, if the current PID was the PID that locked the point-in-time data, -this option unlocks the data. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Display status for the Point-in-Time Copy currently-enabled or -suspended -volume set. \fIvolume_set\fR is the Point-in-Time Copy volume set containing -the master and shadow volumes. If no \fIvolume_set\fR is specified, status is -displayed for all Point-in-Time Copy volume sets that are configured. -.RE - -.sp -.ne 2 -.na -\fB\fB-l\fR\fR -.ad -.sp .6 -.RS 4n -List all currently configured Point-in-Time Copy volumes. -.RE - -.sp -.ne 2 -.na -\fB\fB-O\fR \fIoverflow_vol\fR\fR -.ad -.sp .6 -.RS 4n -This option causes Point-in-Time Copy to initialize the specified -\fIoverflow_vol\fR for subsequent use as an overflow volume in conjunction with -Compact Dependent Shadow Volumes. To facilitate efficient, shared usage of this -overflow volume, it can be associated with multiple Point-in-Time Copy volume -sets on an as-needed basis. -.sp -During initialization of the \fIoverflow_vol\fR, the initiator of this option, -must answer the following question: "Initialize this overflow volume? yes/no" A -response of either "yes/no" is required before proceeding. -.sp -This option supports the \fB-n\fR option, so that the requested action is -performed without prompting. This option is useful for inclusion in a script. -The \fB-n\fR option must be specified first. For example, "\fBiiadm\fR -\fB-nO\fR \fBvol\fR" is valid; "\fBiiadm\fR \fB-On\fR \fBvol\fR" is not. -.sp -Make sure you want to initialize the data on the specified \fIoverflow_vol\fR, -especially when using the \fB-n\fR option. -.RE - -.sp -.ne 2 -.na -\fB\fB-A\fR \fIoverflow_vol\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -This option enables the specified \fIoverflow_vol\fR, for subsequent use as an -overflow volume in a situation where the size of the Compact Dependent Shadow -Volume is too small, or an unscheduled amount of change occurs to the volume -set. Overflow changed data would be redirected to the associated overflow -volume. \fIvolume_set\fR is the Point-in-Time Copy volume set containing the -master and shadow volumes. -.sp -If the \fIoverflow_vol\fR has not been initialized, this option initializes the -\fIoverflow_vol\fR (see \fB-O\fR option), then attaches the \fIoverflow_vol\fR -to the \fIvolume_set\fR. -.sp -If \fIoverflow_vol\fR was previously initialized, this option attaches the -\fIoverflow_vol\fR to the \fIvolume_set\fR. -.sp -This option supports the \fB-n\fR option, so that the requested action is -performed without prompting. This option is useful for inclusion in a script. -The \fB-n\fR option must be specified first. For example, "\fBiiadm\fR -\fB-nA\fR \fBvol\fR" is valid; "\fBiiadm\fR \fB-An\fR \fBvol\fR" is not. -.sp -Make sure you want to initialize the data on the specified \fIoverflow_vol\fR, -especially when using the \fB-n\fR option. -.RE - -.sp -.ne 2 -.na -\fB\fB-D\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -This option removes the overflow volume currently associated with the specified -\fIvolume_set\fR. If the overflow volume is currently in use by the -\fIvolume_set\fR, this operation fails with an "Overflow volume still in use" -error message. To resolve this situation, perform one of the operations -described below on the \fIvolume_set\fR. These operations momentarily clear out -all overflow writes that are associated with this volume set. -.sp -.ne 2 -.na -\fB\fBabort\fR(\fB-a\fR)\fR -.ad -.sp .6 -.RS 4n -Abort copy operation. -.RE - -.sp -.ne 2 -.na -\fB\fBdisable\fR(\fB-d\fR)\fR -.ad -.sp .6 -.RS 4n -Dissolve the volume set. -.RE - -.sp -.ne 2 -.na -\fB\fBupdate\fR(\fB-u\fR)\fR -.ad -.sp .6 -.RS 4n -Update the volume set. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-L\fR\fR -.ad -.sp .6 -.RS 4n -This option lists all overflow volumes which are associated with one or more -volume sets. -.RE - -.sp -.ne 2 -.na -\fB\fB-Q\fR \fIoverflow_vol\fR\fR -.ad -.sp .6 -.RS 4n -This option displays the current status of the \fIoverflow_vol\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-E\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Export the independent shadow volume of the Point-in-Time Copy volume set -specified by \fIvolume_set\fR. The shadow volume is to be made available to -another host for read/write access, by means of an enabling technology, such as -multi-ported devices. This other host is responsible for maintaining a bitmap -of differences that is used to merge with locally recorded differences to the -master when the shadow volume is rejoined to its master volume. While a shadow -volume is exported it must not be subject to an update or copy operation. -Perform an \fBiiadm\fR \fB-w\fR \fIvolume_set\fR command prior to invoking an -export command. -.RE - -.sp -.ne 2 -.na -\fB\fB-I\fR \fIvolume_set\fR \fIbitmap_vol\fR\fR -.ad -.sp .6 -.RS 4n -Import the independent shadow volume of the Point-in-Time Copy volume set -specified by \fIvolume_set\fR. The shadow volume must have been previously -exported from a host by means of an enabling technology, such as multi-ported -devices. The import operation causes this host to start maintaining a bitmap of -differences as the volume is modified. The \fIbitmap_vol\fR should not be the -same as that used when the shadow volume was originally formed into a shadow -group. -.sp -After the exported/imported independent shadow volume is no longer needed by -the other node, you must enter a disable command so that the \fIbitmap_vol\fR -and its associated \fIshadow_vol\fR are consistent, prior to performing a join -operation. For example, -.sp -.in +2 -.nf -# iiadm -d \fIvolume_set\fR -.fi -.in -2 -.sp - -.RE - -.sp -.ne 2 -.na -\fB\fB-J\fR \fIvolume_set\fR \fIbitmap_vol\fR\fR -.ad -.sp .6 -.RS 4n -Join the \fIvolume_set\fR, using the \fIbitmap_vol\fR, with the master volume -set of the Point-in-Time Copy volume set. The bitmap volume supplied is read -and merged with the original volume to reconstruct the original volume set -consisting of the master, shadow, and bitmap volumes. The \fIbitmap_vol\fR to -be merged is the one obtained on the node that had imported the independent -shadow volume. There must be no write activity to the shadow volume on the -importing machine from the time the bitmap is copied over until the shadow is -once again imported. -.RE - -.sp -.ne 2 -.na -\fB\fB-g\fR \fIgroup_name\fR \fB-m\fR \fIvolume_set [volume_set2 ...]\fR\fR -.ad -.sp .6 -.RS 4n -Add one or more existing Point-in-Time Copy \fIvolume_set(s)\fR into a user -specified \fIgroup_name\fR. This association of one or more Point-in-Time Copy -volume sets in a group allows the list of \fBiiadm\fR options shown below to be -performed on all volume sets within the \fIgroup_name\fR as a whole. -.sp -Only the commands \fBCOPY\fR (\fB-c\fR) and \fBUPDATE\fR (\fB-u\fR) are -performed atomically across all Point-in-Time Copy sets within the group. All -other grouped, \fBiiadm\fR commands are performed sequentially on each member -of the group. -.sp -The syntax of an \fBiiadm\fR group command is as follows: -.sp -.in +2 -.nf -iiadm -g \fIgroup_name\fR [\fIoptions\fR] -.fi -.in -2 -.sp - -The \fIoptions\fR are as follows: -.sp -.ne 2 -.na -\fB\fB-a\fR\fR -.ad -.sp .6 -.RS 4n -Abort copy operation on all sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-A\fR\fR -.ad -.sp .6 -.RS 4n -Attach \fIoverflow_vol\fR to all sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-c\fR \fB{s | m}\fR\fR -.ad -.sp .6 -.RS 4n -Copy shadow/master for all sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-D\fR\fR -.ad -.sp .6 -.RS 4n -Detach \fIoverflow_vol\fR from all sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-d\fR\fR -.ad -.sp .6 -.RS 4n -Disable all sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-E\fR\fR -.ad -.sp .6 -.RS 4n -Export all volume sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR\fR -.ad -.sp .6 -.RS 4n -Status of all volume sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-l\fR\fR -.ad -.sp .6 -.RS 4n -List all volume sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-L\fR\fR -.ad -.sp .6 -.RS 4n -List all groups. -.RE - -.sp -.ne 2 -.na -\fB\fB-n\fR\fR -.ad -.sp .6 -.RS 4n -Do not ask if an update of the master volume is what the user really intended. -.RE - -.sp -.ne 2 -.na -\fB\fB-P\fR\fR -.ad -.sp .6 -.RS 4n -Set parameters on all volume sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR\fR -.ad -.sp .6 -.RS 4n -Reset all volume sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-u\fR \fB{s | m}\fR\fR -.ad -.sp .6 -.RS 4n -Update shadow/master for all sets within \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-w\fR\fR -.ad -.sp .6 -.RS 4n -Wait for all volume sets within \fIgroup_name\fR. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-g\fR \fB""\fR \fB-m\fR \fIvolume_set\fR [\fIvolume_set2 ...\fR]\fR -.ad -.sp .6 -.RS 4n -Remove one or more existing Point-in-Time Copy \fIvolume_set(s)\fR from their -currently associated \fIgroup_name\fR. By default, or until moved into a user -specified \fIgroup_name\fR, all Point-in-Time Copy \fIvolume_set(s)\fR are in -the blank (\fB" "\fR) group. This association allows all the previously -documented \fBiiadm\fR group commands to be performed against the blank (\fB" -"\fR) \fBiiadm\fR \fIgroup_name\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR \fIcluster_tag\fR\fR -.ad -.sp .6 -.RS 4n -This Point-in-Time Copy option is a modifier that limits configuration -operations to only those volumes belonging to a Sun Cluster Resource Group, or -Disk Group. -.sp -In a Sun Cluster where the volume manager is Sun Cluster-aware, \fBiiadm\fR -automatically obtains the correct Disk Group information, therefore this option -is typically not required unless the volumes are part of an encompassing -Resource Group. -.sp -In a Sun Cluster where the volumes are accessible on the local node only, the -special \fIcluster_tag\fR of \fBlocal\fR is used to indicate volumes that are -not part of a Sun Cluster Resource Group or Disk Group. -.sp -If "\fB-L\fR" is given as a the \fIcluster_tag\fR argument, then \fBiiadm\fR -lists all cluster tags associated with Point-in-Time Copy. -.sp -This option is invalid when used on a Solaris system on which the Sun Cluster -package has not been installed or configured. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.sp .6 -.RS 4n -Prints the \fBiiadm\fR usage summary. -.RE - -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.sp .6 -.RS 4n -Display the current version of the Point-in-Time Copy software components. -.RE - -.sp -.LP -Contact Sun Enterprise Services for assistance in using the remaining commands -in this section. -.sp -.ne 2 -.na -\fB\fB-P\fR \fIdelay\fR \fIunit\fR \fIvolume_set\fR\fR -.ad -.sp .6 -.RS 4n -Alter the Point-in-Time Copy volume set tuning parameters for the specified -\fIvolume_set\fR to \fIdelay\fR ticks, every \fIunit\fR I/O's. Delay ranges -from 2 to 10000 inclusive; unit ranges from 100 to 60000 inclusive. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR \fIvolume\fR\fR -.ad -.sp .6 -.RS 4n -After a volume has failed, Point-in-Time Copy places it offline. After -replacing the volume, place it back online using this option. Associated -dependent volumes in the Point-in-Time Copy volume set are also placed online. -After the volume is placed online, this command also starts any necessary -point-in-time volume updates. -.RE - -.SH EXIT STATUS -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Command completed successfully. -.RE - -.sp -.ne 2 -.na -\fB\fB>0\fR\fR -.ad -.RS 13n -An error occurred. -.RE - -.SH ATTRIBUTES -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.LP -\fBdscfg\fR(1M), \fBsvadm\fR(1M), \fBds.log\fR(4), \fBrdc.cf\fR(4), -\fBattributes\fR(5), \fBii\fR(7D), \fBsv\fR(7D) diff --git a/usr/src/man/man1m/iicpbmp.1m b/usr/src/man/man1m/iicpbmp.1m deleted file mode 100644 index bd867af67c..0000000000 --- a/usr/src/man/man1m/iicpbmp.1m +++ /dev/null @@ -1,77 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH IICPBMP 1M "Oct 2, 2007" -.SH NAME -iicpbmp \- copy Availability Suite Point-In-Time bitmap volumes -.SH SYNOPSIS -.LP -.nf -\fBiicpbmp\fR [\fB-c\fR] \fIold_bitmap\fR \fInew_bitmap\fR... -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBiicpbmp\fR command copies an Availability Suite Point-in-Time bitmap -volume, rewriting the bitmap header so that it is consistent with the new -bitmap volume name. The configuration entry for the shadow set is rewritten to -reflect the location of the new bitmap. -.sp -.LP -No checks on the current use of either the old or new bitmap volumes are made. -The \fBiicpbmp\fR command should only be run when the Point-In-Time Copy shadow -set using the old bitmap is suspended. -.SH OPTIONS -.sp -.ne 2 -.na -\fB\fB-c\fR\fR -.ad -.RS 13n -Do not attempt to update the Availability Suite configuration for the -Point-in-Time shadow set that uses the bitmap. This option produces a duplicate -of the bitmap but does not affect the shadow set using the old bitmap volume. -.RE - -.SH OPERANDS -.sp -.ne 2 -.na -\fB\fIold_bitmap\fR \fInew_bitmap\fR\fR -.ad -.sp .6 -.RS 4n -The old and new Point-In-Time bitmap volumes. -.RE - -.SH WARNINGS -.sp -.LP -The \fBiicpbmp\fR should be run only when a system is in single-user mode. -\fBiicpbmp\fR makes no attempt to check if an Point-In-Time Copy set is in use -at the time the copy is made. Running \fBiicpbmp\fR without the \fB-c\fR flag -while Point-In-Time Copy is using the shadow set results in inconsistencies in -the shadow set the next time Point-In-Time Copy is started. -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBiiadm\fR(1M), \fBiicpshd\fR(1M), \fBattributes\fR(5) diff --git a/usr/src/man/man1m/iicpshd.1m b/usr/src/man/man1m/iicpshd.1m deleted file mode 100644 index ebf853db1d..0000000000 --- a/usr/src/man/man1m/iicpshd.1m +++ /dev/null @@ -1,85 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH IICPSHD 1M "Oct 2, 2007" -.SH NAME -iicpshd \- copy Availability Suite Point-in-Time shadow volume -.SH SYNOPSIS -.LP -.nf -\fBiicpshd\fR [\fB-s\fR] \fIold_shadow\fR \fInew_shadow\fR... -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBiicpshd\fR command copies an Availability Suite Instant Image shadow -volume, updating the bit map header and Availability Suite configuration to -reflect the new shadow volume. -.sp -.LP -No checks on the current use of either the old or new shadow volumes are made. -The \fBiicpshd\fR command should only be run when the Instant Image shadow set -using the old shadow volume is suspended. -.SH OPTIONS -.sp -.LP -The \fBiicpshd\fR command supports the following option: -.sp -.ne 2 -.na -\fB\fB-s\fR\fR -.ad -.RS 13n -Update the StorageTek configuration information for the Point-in-Time shadow -set, but do \fBnot\fR copy data from the old shadow volume to the new shadow -volume. -.RE - -.SH OPERANDS -.sp -.LP -A \fBiicpshd\fR command line has the following operands: -.sp -.ne 2 -.na -\fB\fIold_shadow\fR \fInew_shadow\fR\fR -.ad -.sp .6 -.RS 4n -\fBiicpshd\fR copies the data of the old Availability Suite Instant Image -shadow volume to the new shadow volume and updates the bit map header and -configuration data. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBiiadm\fR(1M), \fBiicpbmp\fR(1M), \fBattributes\fR(5) -.SH WARNINGS -.sp -.LP -\fBiicpshd\fR should be run only when the system is in single-user mode. When -you run \fBiicpshd\fR, the command makes no attempt to check if a Point-in-Time -set is in use. Running \fBiicpshd\fR with the \fB-s\fR flag while Point-in-Time -is using the old shadow volume can result in shadow volume data loss. If you -use the \fB-s\fR option, you must manually copy the data on the old shadow -volume to the new shadow volume. diff --git a/usr/src/man/man1m/nscadm.1m b/usr/src/man/man1m/nscadm.1m deleted file mode 100644 index ab7b28f59a..0000000000 --- a/usr/src/man/man1m/nscadm.1m +++ /dev/null @@ -1,143 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH NSCADM 1M "Oct 2, 2007" -.SH NAME -nscadm \- network storage control utility -.SH SYNOPSIS -.LP -.nf -\fBnscadm\fR freeze \fIdevice\fR -.fi - -.LP -.nf -\fBnscadm\fR unfreeze \fIdevice\fR -.fi - -.LP -.nf -\fBnscadm\fR isfrozen \fIdevice\fR -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBnscadm\fR command performs several network storage control functions. -.sp -.LP -The \fBnscadm\fR \fBfreeze\fR command closes existing references to the -specified device, and blocks future accesses. This allows maintenance of -virtual volume device drivers (for example, RAID 0, RAID 1, RAID 5) to be -performed without shutting down the system. -.sp -.LP -The \fBnscadm\fR \fBunfreeze\fR command reverses the effects of \fBnscadm\fR -\fBfreeze\fR for the specified device. -.sp -.LP -The \fBnscadm\fR \fBisfrozen\fR command returns the current status of the -specified device. -.SH OPTIONS -.sp -.LP -The \fBnscadm\fR command supports the following option. -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.RS 13n -Display the usage menu. -.RE - -.SH OPERANDS -.sp -.LP -The \fBnscadm\fR command line supports the following operand. -.sp -.ne 2 -.na -\fB\fIdevice\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the storage device to be acted upon by \fBnscadm\fR. -.RE - -.SH EXIT STATUS -.sp -.LP -For the \fBfreeze\fR and \fBunfreeze\fR, subcommands \fBnscadm\fR returns the -following exit values: -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Success -.RE - -.sp -.ne 2 -.na -\fB\fB255\fR\fR -.ad -.RS 13n -Error -.RE - -.sp -.LP -For the \fBisfrozen\fR subcommand, \fBnscadm\fR returns the following exit -values: -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Device is currently frozen. -.RE - -.sp -.ne 2 -.na -\fB\fB1\fR\fR -.ad -.RS 13n -Device is not currently frozen. -.RE - -.sp -.ne 2 -.na -\fB\fB255\fR\fR -.ad -.RS 13n -Error -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBscmadm\fR(1M), \fBattributes\fR(5) diff --git a/usr/src/man/man1m/scmadm.1m b/usr/src/man/man1m/scmadm.1m deleted file mode 100644 index 82e49af38b..0000000000 --- a/usr/src/man/man1m/scmadm.1m +++ /dev/null @@ -1,203 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SCMADM 1M "Aug 3, 2006" -.SH NAME -scmadm \- storage cache manager administration utility -.SH SYNOPSIS -.LP -.nf -\fBscmadm\fR -.fi - -.LP -.nf -\fBscmadm\fR \fB-h\fR -.fi - -.LP -.nf -\fBscmadm\fR \fB-e\fR -.fi - -.LP -.nf -\fBscmadm\fR \fB-d\fR -.fi - -.LP -.nf -\fBscmadm\fR \fB-v\fR -.fi - -.LP -.nf -\fBscmadm\fR \fB-C\fR [\fIparameter\fR [= [\fIvalue\fR]]...] -.fi - -.LP -.nf -\fBscmadm\fR \fB-o\fR {system | \fIcd\fR | \fIdevice\fR} [\fIoption\fR] -.fi - -.LP -.nf -\fBscmadm\fR \fB-m\fR {\fIcd\fR | \fIdiskname\fR | all} -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBscmadm\fR command provides various options for controlling and gathering -information about a storage device cache. -.SH OPTIONS -.sp -.LP -If no options are specified, \fBscmadm\fR displays a list of configured cache -descriptors with disknames, options, and global options. The \fBscmadm\fR -command supports the following options: -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.sp .6 -.RS 4n -Displays usage information for the \fBscmadm\fR command. -.RE - -.sp -.ne 2 -.na -\fB\fB-e\fR\fR -.ad -.sp .6 -.RS 4n -Reads the configuration and enables the storage device cache with those -parameters. See \fBdscfg\fR(1M). -.RE - -.sp -.ne 2 -.na -\fB\fB-d\fR\fR -.ad -.sp .6 -.RS 4n -Shuts down the storage device cache. -.RE - -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.sp .6 -.RS 4n -Displays the cache version number. -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR [\fIparameter\fR[=[\fIvalue\fR]] ...]\fR -.ad -.sp .6 -.RS 4n -Sets or displays the configuration parameters. If the \fB-C\fR option is -specified with no arguments the current cache configuration parameters are -displayed. If \fIparameter\fR is specified, the current value of -\fIparameter\fR is displayed. If \fIparameter=value\fR is specified, the -current value of \fIparameter\fR is displayed and the parameter is changed to -\fIvalue\fR. If \fIvalue\fR is omitted, or if \fIvalue\fR is specified as the -null string, " ", or as "-", the parameter is deleted from the configuration -and the system uses the default value. Multiple parameters can be specified in -a single invocation of the \fBscmadm\fR command. A change in a configuration -parameter takes effect only when the cache is next restarted. -.RE - -.sp -.ne 2 -.na -\fB\fB-o\fR { \fBsystem\fR | \fBcd\fR | \fIdiskname\fR } [\fIoption\fR]\fR -.ad -.sp .6 -.RS 4n -Sets or displays the options for the system or for the cache device specified -by \fBcd\fR or \fIdiskname\fR. If the \fIoption\fR \fBrdcache\fR or -\fBnordcache\fR is specified, the system or specified cache device is set to -that option. The option is saved as part of the configuration so that the -option persists. See \fBdscfg\fR(1M). To notify the system to "forget" about a -saved option, use the \fBforget\fR option. This does not change the option; it -just removes the option from the saved configuration. If no option is -specified, current options are displayed. The \fBrdcache\fR option is set as -the default. The \fIoption\fRs are defined as follows: -.sp -.ne 2 -.na -\fB\fBrdcache\fR\fR -.ad -.sp .6 -.RS 4n -Data blocks are likely to be referenced again and should remain in cache. -.RE - -.sp -.ne 2 -.na -\fB\fBnordcache\fR\fR -.ad -.sp .6 -.RS 4n -Data blocks are unlikely to be referenced again and should be treated as least -recently used, so that other blocks can remain in the cache longer. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-m\fR { \fBcd\fR | \fIdiskname\fR | \fBall\fR }\fR -.ad -.sp .6 -.RS 4n -Displays the cache descriptor and diskname map for the device specified by -\fBcd\fR or \fIdiskname\fR or, if you specify \fBall\fR, displays the cache -descriptors and diskname map for all storage devices on the system. -.RE - -.SH EXIT STATUS -.sp -.LP -The \fBscmadm\fR command returns 0 for success, non-zero for error. -.SH FILES -.sp -.LP -\fB/dev/sdbc\fR -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdscfg\fR(1M), \fBattributes\fR(5) -.SH DIAGNOSTICS -.sp -.LP -\fBscmadm\fR fails if there is insufficient contiguous memory. diff --git a/usr/src/man/man1m/sndradm.1m b/usr/src/man/man1m/sndradm.1m deleted file mode 100644 index eddd56c052..0000000000 --- a/usr/src/man/man1m/sndradm.1m +++ /dev/null @@ -1,1043 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SNDRADM 1M "Oct 2, 2007" -.SH NAME -sndradm \- control Sun StorageTek Availability Suite Remote Mirror operations -.SH SYNOPSIS -.LP -.nf -\fBsndradm\fR \fB-I\fR a \fImaster\fR \fIshadow\fR \fIbitmap\fR -.fi - -.LP -.nf -\fBsndradm\fR \fB-I\fR d \fImaster\fR \fIshadow\fR \fIbitmap\fR -.fi - -.LP -.nf -\fBsndradm\fR \fB-h\fR \fIusage message\fR -.fi - -.LP -.nf -\fBsndradm\fR \fB-v\fR \fIversion information\fR -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-e\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-E\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-d\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-D\fR block [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-D\fR noblock [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-l\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-m\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-m\fR \fB-r\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-u\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-u\fR \fB-r\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-w\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-H\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-p\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-P\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-q\fR a \fIvolume\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-q\fR d [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-q\fR r \fIvolume\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-i\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-a\fR \fIvalue\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-A\fR \fIvalue\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-F\fR \fIvalue\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-W\fR \fIvalue\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR b p \fIbitmap\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR b s \fIbitmap\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR C \fItag\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR g \fIio_groupname\fR [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR m sync [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR m async [\fIsndr_set\fR] -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR \fB-f\fR \fIvolset-file\fR -.fi - -.LP -.nf -\fBsndradm\fR [\fIoptions\fR] \fB-R\fR r [\fIsndr_set\fR] * -.fi - -.SH DESCRIPTION -.sp -.LP -The \fB/usr/sbin/sndradm\fR command is the administrative command line -interface for the Sun StorageTek Availability Suite Remote Mirror software. -Remote Mirror enables you to replicate disks between different -physically-separate Sun servers in real time. Remote Mirror is conceptually -similar to the local disk mirroring scheme of RAID 1 but it performs its -replication operations over longer distances. -.sp -.LP -If you do not specify a Remote Mirror set (\fIsndr_set\fR) on the command line, -\fBsndradm\fR operates on all configured Remote Mirror sets. -.sp -.LP -The \fBsndradm\fR command generates an entry in the Availability Suite log -file, \fB/var/adm/ds.log\fR (see \fBds.log\fR(4)), for all operations except -print (\fB-p\fR, \fB-P\fR and \fB-i\fR), help (\fB-h\fR), and version -(\fB-v\fR). -.SH OPTIONS -.sp -.LP -The \fBsndradm\fR utility supports the following options: -.sp -.ne 2 -.na -\fB\fB-f\fR \fIvolset-file\fR\fR -.ad -.sp .6 -.RS 4n -Specifies a file containing the \fIsndr_set\fR information for one or more -Remote Mirror sets in the same format as the fully specified command line -\fIsndr_set\fR documented below. -.RE - -.sp -.ne 2 -.na -\fB\fB-g\fR \fIio_groupname\fR\fR -.ad -.sp .6 -.RS 4n -Limits operations to only those Remote Mirror sets belonging to -\fIio_groupname\fR. -.sp -The \fIio_groupname\fR for a given set must be consistent across both the -primary and the secondary hosts. -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR \fItag\fR\fR -.ad -.sp .6 -.RS 4n -On a clustered node, limits operations to only those Remote Mirror sets -belonging to the cluster resource group or disk group name specified by -\fItag\fR. This option is not valid on a system that is not clustered. -.RE - -.sp -.ne 2 -.na -\fB\fB-n\fR\fR -.ad -.sp .6 -.RS 4n -Does not prompt the user after starting a Remote Mirror operation using -\fBsndradm\fR. For all but the printing, help, and version options, the default -behavior is to prompt for a response. For example, after starting a full -synchronization from the primary to the secondary volume, Remote Mirror -prompts: \fB"Overwrite secondary with primary? (Y/N) [N]"\fR. -.RE - -.sp -.ne 2 -.na -\fB\fIsndr_set\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the Remote Mirror set. For a set that has already been enabled, this -can be a \fBset_name\fR in the format \fIshost\fR:\fIsdev\fR. You can supply a -fully specified Remote Mirror set in the same format as a configuration file: -.sp -.in +2 -.nf -\fIphost pdev pbitmap shost sdev sbitmap\fR \fBip\fR {\fBsync | async\fR} \e -[g \fIio_groupname\fR] [C \fItag\fR] -.fi -.in -2 - -These parameters are described as follows: -.sp -.ne 2 -.na -\fB\fIphost\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the server on which the primary volume resides. -.RE - -.sp -.ne 2 -.na -\fB\fIpdev\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the primary volume partition to be replicated. Specify full pathnames -only (for example, \fB/dev/rdsk/c0t1d0s2\fR). -.RE - -.sp -.ne 2 -.na -\fB\fIpbitmap\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the volume partition on which the bitmap (scoreboard log) of the -primary partition is stored. Specify full pathnames only (for example, -\fB/dev/rdsk/c0t1d0s3\fR). -.RE - -.sp -.ne 2 -.na -\fB\fIshost\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the server on which the secondary volume resides. -.RE - -.sp -.ne 2 -.na -\fB\fIsdev\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the secondary volume partition. Specify full path names only (for -example, \fB/dev/rdsk/c0t1d0s4\fR). -.RE - -.sp -.ne 2 -.na -\fB\fIsbitmap\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the volume partition on which the bitmap (scoreboard log) of the -secondary partition is stored. Specify full path names only (for example, -\fB/dev/rdsk/c0t1d0s5\fR). -.RE - -.sp -.ne 2 -.na -\fB\fBip\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the network transfer protocol. -.RE - -.sp -.ne 2 -.na -\fB\fBsync | async\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the Remote Mirror operating mode. \fBsync\fR is the Remote Mirror -mode where the I/O operation is not confirmed as complete until the remote -volume has been updated. \fBasync\fR is the Remote Mirror mode where the -primary host I/O operation is confirmed as complete before updating the remote -volume. -.RE - -.sp -.ne 2 -.na -\fB\fIio_groupname\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the name of the Remote Mirror consistency group to which the Remote -Mirror set belongs. In asynchronous mode, write ordering must be preserved -across all replicating volumes in a Remote Mirror consistency group. This -ensures that the secondary volumes belonging to the group contains a valid -point-in-time copy of the corresponding primary volumes. -.sp -When adding an existing set to a consistency group or when enabling a set to be -in a group, the set must be configured with the same group name on both the -primary and the secondary hosts. -.RE - -.sp -.ne 2 -.na -\fB\fItag\fR\fR -.ad -.sp .6 -.RS 4n -For operation within a cluster, this specifies the disk group name or resource -tag of the local data and bitmap volumes in cases where this is not implied by -the name of the volume (for example, \fB/dev/rdsk/md/dg/vol\fR and -\fB/dev/vx/rdsk/dg/vol\fR both indicate a disk group name of \fBdg\fR). It is -the responsibility of the user to ensure that the cluster tag specified to the -Remote Mirror matches the appropriate cluster resource group tag, and to keep -all the Availability Suite services up to date in the event of cluster resource -group reconfigurations. It is illegal to specify the cluster resource tag on a -system that is not clustered. -.RE - -.RE - -.SH PARAMETERS -.sp -.LP -A valid \fBsndradm\fR command must specify one of the parameters listed below. -.sp -.ne 2 -.na -\fB\fB-I\fR \fBa\fR \fImaster\fR \fIshadow\fR \fIbitmap\fR\fR -.ad -.sp .6 -.RS 4n -Add an \fBndr_ii\fR entry with the specified master, shadow, and bitmap to the -Availability Suite configuration file. See \fBsndrsyncd\fR(1M). If the -corresponding Point-in-Time Copy set does not exist, it is enabled when the -next \fBsync\fR command is issued on the related volume(s). When no longer -required, this Point-in-Time Copy set can be disabled by \fBiiadm\fR \fB-d\fR. -See \fBiiadm\fR(1M) -.RE - -.sp -.ne 2 -.na -\fB\fB-I\fR \fBd\fR \fImaster\fR \fB\fIshadow\fR\fR \fB\fIbitmap\fR\fR\fR -.ad -.sp .6 -.RS 4n -Delete the \fBndr_ii\fR entry with the specified master, shadow, and bitmap -from the Availability Suite configuration file. Use the \fBdscfg\fR command to -list \fBndr_ii\fR configuration entries. -.RE - -.sp -.ne 2 -.na -\fB\fB-a\fR \fIvalue\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the value, on or off, of the automatic sync variable for the set. -Once \fBautosync\fR has been requested for a set, the functionality is active -from the time a sync operation is requested until the set is manually put into -logging mode. Once the set is manually put into logging mode, the -\fBautosync\fR functionality is not active and remains inactive until the next -time a \fBsync\fR request is made. To check whether \fBautosync\fR is active, -use \fBsndradm\fR \fB-P\fR. To check whether autosync has been requested for a -set, look for the"\fBauto=on;\fR" tag for the set in the output of \fBdscfg\fR -\fB-l\fR. See \fBsndrsyncd\fR(1M). -.RE - -.sp -.ne 2 -.na -\fB\fB-A\fR \fIvalue\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the maximum number of threads that can be created to process the -asynchronous queue when a set is replicating in asynchronous mode. The default -is \fB2\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-W\fR \fIvalue\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the maximum number of writes that can be queued to a set replicating -in asynchronous mode. The default is \fB4096\fR. For example, set this value to -1 to ensure that the secondary volume is never more than one write operation -behind the primary volume. -.sp -Tuning the maximum number of writes is only valid for sets using memory-based -async I/O queues. This value is ignored when disk based I/O queues are used. -.RE - -.sp -.ne 2 -.na -\fB\fB-D\fR \fB{block\fR \fB|\fR \fBnoblock}\fR\fR -.ad -.sp .6 -.RS 4n -Toggles the \fBblock\fR|\fBnoblock\fR attribute of a disk-based queue. The -default setting is \fBblock\fR. If the I/O fill rate is larger than the drain -rate for enough time for the queue to fill, incoming I/O is blocked until there -is adequate space on the queue for it. This is to preserve write ordering -whether it is one volume or across many volumes in the same consistency group. -If \fBnoblock\fR is set, and incoming I/O fills the queue, the I/O is not -blocked. Instead, the set is put into logging and the disk queue contents are -disregarded. An ensuing update sync synchronizes the latest data to the -secondary site. -.RE - -.sp -.ne 2 -.na -\fB\fB-F\fR \fIvalue\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the maximum number of 512-byte FBAs that can be queued in kernel -memory to a set replicating in asynchronous mode. The default is \fB16384\fR. -.sp -Tuning the maximum number of FBAs is valid only for sets using memory-based -async I/O queues. This value isignored when disk-based I/O queues are used. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.sp .6 -.RS 4n -Prints the \fBsndradm\fR usage summary. -.RE - -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.sp .6 -.RS 4n -Prints the Remote Mirror version number. -.RE - -.sp -.ne 2 -.na -\fB\fB-e\fR\fR -.ad -.sp .6 -.RS 4n -Enables Remote Mirror for the set and enables scoreboard logging. The -scoreboard is set to indicate that a full synchronization is required. Details -of the set are saved in the current configuration. See \fBdscfg\fR(1M). The -local volume and the bitmap volume are enabled for the Storage Volume driver -(see \fBsv\fR(7D)). -.RE - -.sp -.ne 2 -.na -\fB\fB-E\fR\fR -.ad -.sp .6 -.RS 4n -Enables Remote Mirror for the set and enables scoreboard logging. The -scoreboard is cleared to indicate that the primary and secondary volumes are -already guaranteed to be fully synchronized. Details of the set are saved in -the current configuration. See \fBdscfg\fR(1M). The local volume and the bitmap -volume are enabled for the Storage Volume driver (see \fBsv\fR(7D)). -.RE - -.sp -.ne 2 -.na -\fB\fB-d\fR\fR -.ad -.sp .6 -.RS 4n -Disables Remote Mirror for the set and halts any current synchronization -operations. \fBsndradm\fR \fB-d\fR also discards any active scoreboards that -track temporary differences between primary and secondary volumes. -.RE - -.sp -.ne 2 -.na -\fB\fB-l\fR\fR -.ad -.sp .6 -.RS 4n -Stops Remote Mirror replication and copy operations between primary and -secondary volumes and starts independent Remote Mirror scoreboard logging on -these volumes. When all the sets in a consistency group are replicating, it -means that the secondary volumes contain a valid point-in-time copy of the -corresponding primary volumes. Under this condition, as soon as one Remote -Mirror set drops into logging mode, the \fBrdc\fR kernel module drops all the -other sets in the group into logging mode automatically. This ensures that the -secondary volumes still contains a valid point-in-time copy. To resume the -Remote Mirror after using the \fB-l\fR parameter, use the \fB-m\fR parameter to -perform a full resynchronization or the \fB-u\fR parameter to perform an update -resynchronization (based on the scoreboard). -.sp -This option does not work on the secondary for any volumes that are currently -synchronizing. -.RE - -.sp -.ne 2 -.na -\fB\fB-w\fR\fR -.ad -.sp .6 -.RS 4n -Waits for a synchronization copy to complete or abort, or returns immediately -if invoked on the secondary system. -.RE - -.sp -.ne 2 -.na -\fB\fB-H\fR\fR -.ad -.sp .6 -.RS 4n -Reports on the health of the network link used by the specified volume set. The -health of the link is reported as active or inactive. Active means that the -network link is actively being used for replicating or resynchronizing data, -and is therefore in good health. Inactive means that the network link is not -actively being used for replicating or resynchronizing data, which might -indicate a problem with the link. -.RE - -.sp -.ne 2 -.na -\fB\fB-p\fR\fR -.ad -.sp .6 -.RS 4n -Displays a list of configured Remote Mirror volumes or sets. -.RE - -.sp -.ne 2 -.na -\fB\fB-P\fR\fR -.ad -.sp .6 -.RS 4n -Displays a list of configured Remote Mirror volumes or sets with extra details. -(See state descriptions, below.) -.RE - -.sp -.ne 2 -.na -\fB\fB-q\fR \fBa\fR \fIvolume\fR\fR -.ad -.sp .6 -.RS 4n -Add a disk queue to a set or group. This operation is valid when the set or -group is in logging mode. -.RE - -.sp -.ne 2 -.na -\fB\fB-q\fR \fBd\fR\fR -.ad -.sp .6 -.RS 4n -Remove a disk queue from a set or group. This operation is valid when the set -or group is in logging mode. -.RE - -.sp -.ne 2 -.na -\fB\fB-q\fR \fBr\fR \fIvolume\fR\fR -.ad -.sp .6 -.RS 4n -Replace a disk queue for a group or set. The queue is removed from the set or -group as in the queue-disable operation and the new disk queue is added as in -the queue-add operation. This operation is valid when the set or group is in -logging mode. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR\fR -.ad -.sp .6 -.RS 4n -Displays a list of configured Remote Mirror volumes or sets in the same format -as the \fIvolset-file\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR\fR -.ad -.sp .6 -.RS 4n -Attempt to reset a Remote Mirror set's error condition such as failed bitmaps. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR \fBb\fR \fBp\fR \fIbitmap\fR\fR -.ad -.sp .6 -.RS 4n -Reconfigure a Remote Mirror set's primary bitmap. This command should be -entered on both primary and secondary servers. It is only possible to -reconfigure the primary bitmap for one set at a time. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR \fBb\fR \fBs\fR \fIbitmap\fR\fR -.ad -.sp .6 -.RS 4n -Reconfigure a Remote Mirror set's secondary bitmap. This command should be -entered on both primary and secondary servers. It is only possible to -reconfigure the secondary bitmap for one set at a time. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR \fBC\fR \fItag\fR\fR -.ad -.sp .6 -.RS 4n -Reconfigure the cluster tag, or disk group name, of a Remote Mirror set's local -volumes, in those cases where this is not indicated by the pathname. This does -not affect the remote volumes. This parameter cannot be used on a system that -is not clustered. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR \fBm\fR \fB{sync\fR \fB|\fR \fBasync}\fR\fR -.ad -.sp .6 -.RS 4n -Reconfigure the replication mode of a Remote Mirror set. The sets belonging to -a consistency group must be either all synchronous or all asynchronous. It is -not possible to mix modes within a group. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR \fBg\fR \fIgroup\fR\fR -.ad -.sp .6 -.RS 4n -Reconfigure the consistency group of a Remote Mirror set. This command should -be entered with the same group name on both primary and secondary servers. -.sp -To remove a set from a consistency group, specify the null string (" ") when -reconfiguring the consistency group. -.RE - -.sp -.LP -The following parameters can be issued only from the primary server: -.sp -.ne 2 -.na -\fB\fB-m\fR\fR -.ad -.sp .6 -.RS 4n -Starts a full volume copy from the primary volume to the secondary volume, and -concurrently enables Remote Mirror replication of new updates from the primary -volume to the secondary volume. Use this parameter when the primary and -secondary volumes might be different and no logging information exists to -incrementally resynchronize the volumes. See EXIT STATUS. -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR\fR -.ad -.sp .6 -.RS 4n -Reverses the direction of the synchronization so the primary volume is -synchronized from the secondary volume. Use this parameter with the \fB-m\fR or -\fB-u\fR parameter. \fB-m\fR \fB-r\fR starts a full volume copy from the -secondary (source) volume to the primary (target) volume but concurrently -enables Remote Mirror replication of new updates from the primary (source) -volume to the secondary (target) volume, ensuring the volume sets remain -synchronized. Use \fB-m\fR \fB-r\fR when the primary and secondary volume -content might differ and the secondary has the desired contents, yet no logging -information exists to incrementally resynchronize the volumes (using \fB-u\fR). -\fB-u\fR \fB-r\fR resynchronizes the primary (target) volume from the secondary -(source) volume, using the Remote Mirror scoreboard logs maintained while -replication was suspended. It then resumes Remote Mirror replication of new -updates from the primary volume to the secondary volume so that the volume sets -remain synchronized. Quiesce the workload to the volume sets during the -restore/refresh operation. This action ensures that the primary and secondary -volumes match before replication of new updates resumes. -.RE - -.sp -.ne 2 -.na -\fB\fB-u\fR\fR -.ad -.sp .6 -.RS 4n -Updates a Remote Mirror volume set. This parameter resynchronizes a Remote -Mirror volume set. Only the blocks logged as changed in the Remote Mirror -scoreboards are updated. Enables Remote Mirror replication for the primary -volume and also uses the Remote Mirror scoreboard logs to start the -resynchronization process so that the corresponding secondary volume matches -the primary volume. -.RE - -.SS "States Returned from \fBsndradm\fR \fB-P\fR" -.sp -.LP -The following are the states that can be returned from \fBsndradm\fR \fB-P\fR. -.sp -.ne 2 -.na -\fB\fBvolume\fR \fBfailed\fR\fR -.ad -.sp .6 -.RS 4n -An I/O operation to the local data volume has failed -.RE - -.sp -.ne 2 -.na -\fB\fBbitmap\fR \fBfailed\fR\fR -.ad -.sp .6 -.RS 4n -An I/O operation to the local bitmap volume has failed -.RE - -.sp -.ne 2 -.na -\fB\fBdisk\fR \fBqueue\fR \fBfailed\fR\fR -.ad -.sp .6 -.RS 4n -An I/O operation to disk queue volume has failed -.RE - -.sp -.ne 2 -.na -\fB\fBneed\fR \fBsync\fR\fR -.ad -.sp .6 -.RS 4n -A sync to this volume has been interrupted. It needs to be completed (or -restored via Point-in-Time Copy). The direction of the data flow must not be -changed until one or the other is done. -.RE - -.sp -.ne 2 -.na -\fB\fBneed\fR \fBreverse\fR \fBsync\fR\fR -.ad -.sp .6 -.RS 4n -A reverse sync to this volume has been interrupted. It needs to be completed -(or restored via Point-in-Time Copy). The direction of the data flow must not -be changed until one or the other is done. -.RE - -.sp -.ne 2 -.na -\fB\fBlogging\fR\fR -.ad -.sp .6 -.RS 4n -Incoming writes are logged in the bitmap only. Data is not replicated to the -remote site. \fBneed sync\fR, \fBneed reverse sync\fR, and \fBqueuing\fR are -all substates of logging such that writes are logged in the bitmap, but not -replicated. Queuing mode (described below) logs the writes to the bitmap, and -queues the request for later replication by the async flushers. -.RE - -.sp -.ne 2 -.na -\fB\fBreverse\fR \fBsyncing\fR\fR -.ad -.sp .6 -.RS 4n -A secondary to primary copy is in progress. -.RE - -.sp -.ne 2 -.na -\fB\fBsyncing\fR\fR -.ad -.sp .6 -.RS 4n -A primary to secondary copy is in progress. -.RE - -.sp -.ne 2 -.na -\fB\fBqueuing\fR\fR -.ad -.sp .6 -.RS 4n -During normal async replication using disk queues, i/o is placed on the disk -queue to be replicated by the async flusher threads. In the event of a -temporary link failure, the set transitions to queuing mode. The queue is not -discarded, as it would be with memory based queues. Instead, data is logged in -the bitmap and placed on the queue. When the link comes up, and \fBsndradm\fR -\fB-u\fR is issued, (automated by turning autosync on for the set) the flushers -restarts. This preserves write ordering through a temporary link outage. If -write ordering is not necessary, and only the latest data is needed, the set -can be put into logging manually (\fBsndradm\fR \fB-l\fR) and an update sync -issued (\fBsndradm\fR \fB-u\fR). This action discards the data on the queue, -and fast resyncs using the bitmap. If the queue fills before the link comes -back and the update sync is issued, the queue is discarded and the set put into -logging mode to avoid application hangs. -.RE - -.SH EXAMPLES -.LP -\fBExample 1 \fREnabling a Remote Mirror Set -.sp -.LP -The following command enables a Remote Mirror asynchronous set on host -\fBexample\fR, where \fBexample\fR is the primary host and \fBexample-remote\fR -is the secondary host. - -.sp -.in +2 -.nf -example% \fBsndradm -e example /dev/rdsk/c1t0d0s1 /dev/rdsk/c1t1d0s3 \e -example-remote /dev/rdsk/c2t3d0s5 /dev/rdsk/c2t4d0s5 ip async\fR -.fi -.in -2 -.sp - -.LP -\fBExample 2 \fRAdding a Disk Queue to an Asynchronous Set -.sp -.LP -The following command adds a disk queue volume to an asynchronous set. - -.sp -.in +2 -.nf -example% \fBsndradm -q a /dev/rdsk/c1t2d0s3 \e -example-remote:/dev/rdsk/c2t3d0s5\fR -.fi -.in -2 -.sp - -.LP -\fBExample 3 \fRRemoving a Disk Queue from an Asynchronous Set -.sp -.LP -The following command removes the disk queue volume from a set with a disk -queue volume attatched to it. - -.sp -.in +2 -.nf -example% \fBsndradm -q d example-remote:/dev/rdsk/c2t3d0s5\fR -.fi -.in -2 -.sp - -.LP -\fBExample 4 \fRDisabling a Remote Mirror Set -.sp -.LP -The following command disables a Remote Mirror set enabled on host -\fBexample\fR. - -.sp -.in +2 -.nf -example% \fBsndradm -d example-remote:/dev/rdsk/c2t3d0s5\fR -.fi -.in -2 -.sp - -.SH EXIT STATUS -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Command completed successfully. -.RE - -.sp -.ne 2 -.na -\fB\fB>0\fR\fR -.ad -.RS 13n -An error occurred. -.RE - -.sp -.LP -When the \fB-m\fR or \fB-u\fR option is executed in a script, the exit status -following one of these options always returns success, regardless of the -current status of the Remote Mirror set. -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdscfg\fR(1M), \fBsndrd\fR(1M), \fBsndrsyncd\fR(1M), \fBds.log\fR(4), -\fBrdc.cf\fR(4), \fBattributes\fR(5), \fBsv\fR(7D) diff --git a/usr/src/man/man1m/sndrd.1m b/usr/src/man/man1m/sndrd.1m deleted file mode 100644 index 0a44a95e97..0000000000 --- a/usr/src/man/man1m/sndrd.1m +++ /dev/null @@ -1,150 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SNDRD 1M "Dec 11, 2015" -.SH NAME -sndrd \- Remote Mirror daemon -.SH SYNOPSIS -.LP -.nf -\fB/usr/lib/sndrd\fR [\fB-c\fR \fImax_connections\fR] [\fB-l\fR \fIlisten_backlog\fR] -.fi - -.SH DESCRIPTION -.LP -The \fBsndrd\fR daemon processes client Remote Mirror requests. Only the root -user or a user with equivalent privileges can run this daemon. The daemon is -automatically invoked in run level 2. \fBsndrd\fR restarts the TCP transport -layers. -.sp -.LP -Administrators wanting to change startup parameters for \fBsndrd\fR should, as -root or equivalent, make changes in the \fB/etc/default/sndr\fR file rather -than editing the \fB/lib/svc/method/svc-rdcsyncd\fR file. See \fBsndr\fR(4). -.SH OPTIONS -.LP -The \fBsndrd\fR daemon supports the following options: -.sp -.ne 2 -.na -\fB\fB-c\fR \fImax_connections\fR\fR -.ad -.sp .6 -.RS 4n -Sets the maximum number of connections allowed to the server over -connection-oriented transports. By default, the number of connections is 16. -.RE - -.sp -.ne 2 -.na -\fB\fB-l\fR \fIlisten_backlog\fR\fR -.ad -.sp .6 -.RS 4n -Sets connection queue length for the RDC TCP over a connection-oriented -transport. The default value is 10 entries. -.RE - -.SH EXIT STATUS -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Daemon started successfully. -.RE - -.sp -.ne 2 -.na -\fB\fB>0\fR\fR -.ad -.RS 13n -Daemon failed to start. -.RE - -.sp -.LP -Error information is reported to \fBsyslog\fR at level \fBLOG_ERR\fR. -.SH FILES -.ne 2 -.na -\fB\fB/lib/svc/method/svc-rdcsyncd\fR\fR -.ad -.sp .6 -.RS 4n -Shell script for starting \fBsndrd\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB/lib/svc/method/svc-rdc\fR\fR -.ad -.sp .6 -.RS 4n -Shell script for stopping \fBsndrd\fR. -.RE - -.SH ATTRIBUTES -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.LP -\fBsvcadm\fR(1M), \fBsyslogd\fR(1M), \fBds.log\fR(4), \fBattributes\fR(5) -.SH NOTES -.LP -Do not manually stop the sndrd daemon. If you need to manually stop sndrd -perform these steps. This stops both the \fBsndrd\fR and \fBsndrsyncd\fR -daemons. -.sp -.in +2 -.nf -# svcadm disable svc:/system/nws_rdc -.fi -.in -2 - -.sp -.in +2 -.nf -# svcadm disable svc:/system/nws_rdcsyncd -.fi -.in -2 - -.sp -.LP -Do not manually start or restart the sndrd daemon. If you need to manually -start sndrd perform these steps. This starts both the sndrd and sndrsyncd -daemons. -.sp -.in +2 -.nf -# svcadm enable svc:/system/nws_rdc -.fi -.in -2 - -.sp -.in +2 -.nf -# svcadm enable svc:/system/nws_rdcsyncd -.fi -.in -2 - -.sp -.LP -See \fBsvcadm\fR(1M) for additional information. diff --git a/usr/src/man/man1m/sndrsyncd.1m b/usr/src/man/man1m/sndrsyncd.1m deleted file mode 100644 index ea7b081933..0000000000 --- a/usr/src/man/man1m/sndrsyncd.1m +++ /dev/null @@ -1,132 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SNDRSYNCD 1M "Dec 11, 2015" -.SH NAME -sndrsyncd \- Availability Suite Remote Mirror update resynchronization daemon -.SH SYNOPSIS -.LP -.nf -\fB/usr/lib/sndrsyncd\fR -.fi - -.SH DESCRIPTION -.LP -The \fBsndrsyncd\fR daemon automates update resynchronization after a network -or machine failure and invokes Point-in-Time Copy copies when needed to protect -the data volumes being updated during a resynchronization. -.sp -.LP -The daemon is notified by the kernel when a network link being used by Remote -Mirror goes down and invokes the \fBsndradm\fR(1M) command with the \fB-u\fR -option to resynchronize all Remote Mirror sets which have autosync switched on -and are using the network link. See \fBsndradm\fR(1M) for details on how to -configure autosync for a Remote Mirror set. -.sp -.LP -The daemon is also notified when any Remote Mirror resynchronization starts or -completes. The daemon takes Point-in-Time Copy snapshots, if configured in the -Availability Suite configuration file. On a secondary server, the daemon checks -if a file system is currently mounted on the secondary volume and informs the -kernel not to allow the synchronization to start if the file system is -currently mounted. -.SH EXIT STATUS -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 13n -Daemon started successfully. -.RE - -.sp -.ne 2 -.na -\fB\fB>0\fR\fR -.ad -.RS 13n -Daemon failed to start. -.RE - -.SH FILES -.ne 2 -.na -\fB\fB/lib/svc/method/svc-rdcsyncd\fR\fR -.ad -.sp .6 -.RS 4n -Shell script for starting \fBsndrsyncd\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB/lib/svc/method/svc-rdc\fR\fR -.ad -.sp .6 -.RS 4n -Shell script for stopping \fBsndrsyncd\fR. -.RE - -.SH ATTRIBUTES -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.LP -\fBiiadm\fR(1M), \fBsndradm\fR(1M), \fBsndrd\fR(1M), \fBsvcadm\fR(1M), -\fBds.log\fR(4), \fBrdc.cf\fR(4), \fBattributes\fR(5) -.SH NOTES -.LP -Do not manually stop the sndrsyncd daemon. If you need to manually stop -sndrsyncd perform these steps. This stops both the \fBsndrd\fR and -\fBsndrsyncd\fR daemons. -.sp -.in +2 -.nf -# svcadm disable svc:/system/nws_rdc -.fi -.in -2 - -.sp -.in +2 -.nf -# svcadm disable svc:/system/nws_rdcsyncd -.fi -.in -2 - -.sp -.LP -Do not manually start or restart the \fBsndrsyncd\fR daemon. If you need to -manually start \fBsndrsyncd\fR perform these steps. This starts both the -\fBsndrd\fR and \fBsndrsyncd\fR daemons. -.sp -.in +2 -.nf -# svcadm enable svc:/system/nws_rdc -.fi -.in -2 - -.sp -.in +2 -.nf -# svcadm enable svc:/system/nws_rdcsyncd -.fi -.in -2 - -.sp -.LP -See \fBsvcadm\fR(1M) for additional information. diff --git a/usr/src/man/man1m/svadm.1m b/usr/src/man/man1m/svadm.1m deleted file mode 100644 index 82ba35ba94..0000000000 --- a/usr/src/man/man1m/svadm.1m +++ /dev/null @@ -1,181 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All rights reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SVADM 1M "Oct 2, 2007" -.SH NAME -svadm \- command line interface to control Availability Suite Storage Volume -operations -.SH SYNOPSIS -.LP -.nf -\fBsvadm\fR \fB-h\fR -.fi - -.LP -.nf -\fBsvadm\fR \fB-v\fR -.fi - -.LP -.nf -\fBsvadm\fR [\fB-C\fR \fItag\fR] -.fi - -.LP -.nf -\fBsvadm\fR [\fB-C\fR \fItag\fR] \fB-i\fR -.fi - -.LP -.nf -\fBsvadm\fR [\fB-C\fR \fItag\fR] \fB-e\fR {\fB-f\fR \fIconfig_file\fR | volume} -.fi - -.LP -.nf -\fBsvadm\fR [\fB-C\fR \fItag\fR] \fB-d\fR {\fB-f\fR \fIconfig_file\fR | volume} -.fi - -.LP -.nf -\fBsvadm\fR [\fB-C\fR \fItag\fR] \fB-r\fR {\fB-f\fR \fIconfig_file\fR | volume} -.fi - -.SH DESCRIPTION -.LP -The \fBsvadm\fR command controls the Storage Volume (SV) driver by providing -facilities to enable and disable the SV driver for specified volumes, and to -dynamically reconfigure the system. -.SH OPTIONS -.LP -If you specify no arguments to an \fBsvadm\fR command, the utility displays the -list of volumes currently under SV control. \fBsvadm\fR supports the following -options: -.sp -.ne 2 -.na -\fB\fB-C\fR \fItag\fR\fR -.ad -.sp .6 -.RS 4n -On a clustered node, limits operations to only those volumes belonging to the -cluster resource group, or disk group name, specified by tag. This option is -illegal on a system that is not clustered. The special \fItag\fR, \fBlocal\fR, -can be used to limit operations to only those volumes that cannot switch over -to other nodes in the cluster. -.RE - -.sp -.ne 2 -.na -\fB\fB-d\fR\fR -.ad -.sp .6 -.RS 4n -Disables the SV devices specified on the command line or in the configuration -file. If \fB-C\fR tag is specified with this option, then the volume should be -in this cluster disk group. -.RE - -.sp -.ne 2 -.na -\fB\fB-e\fR\fR -.ad -.sp .6 -.RS 4n -Enables the SV devices specified on the command line or in the configuration -file. Details of the volume are saved in the current configuration. See -\fBdscfg\fR(1M). If \fB-C\fR tag is specified with this option, then the volume -should be in this cluster disk group. -.RE - -.sp -.ne 2 -.na -\fB\fB-f\fR \fIconfig_file\fR\fR -.ad -.sp .6 -.RS 4n -Specifies a configuration file that contains a list of volumes. A command reads -this volume list and then perform the operation. The format of the -\fIconfig_file\fR is a simple list of volume pathnames, one per line. Blank -lines and lines starting with the comment character (#) are ignored. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.sp .6 -.RS 4n -Displays the \fBsvadm\fR usage summary. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR\fR -.ad -.sp .6 -.RS 4n -Displays extended status for the volumes currently under SV control. -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR\fR -.ad -.sp .6 -.RS 4n -When a \fIconfig_file\fR is specified, reconfigure the running system to match -the configuration specified in the \fIconfig_file\fR. When the \fB-C\fR option -is specified, compare the cluster tag for each volume and change it to -\fIcluster_tag\fR. If a volume is specified with this option, it is valid only -to reconfigure the cluster tag associated with the volume. The \fB-e\fR or -\fB-d\fR options should be used to enable or disable single volumes. -.RE - -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.sp .6 -.RS 4n -Displays the SV version number. -.RE - -.SH USAGE -.LP -When an SV volume is enabled, normal system call access to the device (see -\fBIntro\fR(2)) is redirected into the StoreEdge architecture software. This -allows standard applications to use StorageTek features such as Sun StorageTek -Point-in-Time Copy and Remote Mirror Software. -.sp -.LP -The \fBsvadm\fR command generates an entry in the Availability Suite log file, -\fB/var/adm/ds.log\fR (see \fBds.log\fR(4)), when performing enable (\fB-e\fR) -and disable (\fB-d\fR) operations. -.SH ATTRIBUTES -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.LP -\fBdscfg\fR(1M), \fBds.log\fR(4), \fBattributes\fR(5), \fBsv\fR(7D) diff --git a/usr/src/man/man4/Makefile b/usr/src/man/man4/Makefile index fd60281537..2008cfee3b 100644 --- a/usr/src/man/man4/Makefile +++ b/usr/src/man/man4/Makefile @@ -12,7 +12,7 @@ # # Copyright 2011, Richard Lowe # Copyright 2015, Joyent, Inc. -# Copyright 2016 Nexenta Systems, Inc. +# Copyright 2018 Nexenta Systems, Inc. # Copyright 2018 Gary Mills # @@ -60,7 +60,6 @@ _MANFILES= Intro.4 \ dialups.4 \ dir_ufs.4 \ driver.conf.4 \ - ds.log.4 \ ethers.4 \ exec_attr.4 \ fdi.4 \ @@ -157,7 +156,6 @@ _MANFILES= Intro.4 \ publickey.4 \ queuedefs.4 \ rcmscript.4 \ - rdc.cf.4 \ remote.4 \ resolv.conf.4 \ rmtab.4 \ @@ -178,7 +176,6 @@ _MANFILES= Intro.4 \ smb.4 \ smbautohome.4 \ smhba.conf.4 \ - sndr.4 \ sock2path.d.4 \ space.4 \ sulog.4 \ diff --git a/usr/src/man/man4/ds.log.4 b/usr/src/man/man4/ds.log.4 deleted file mode 100644 index 41d85fe865..0000000000 --- a/usr/src/man/man4/ds.log.4 +++ /dev/null @@ -1,112 +0,0 @@ -'\" te -.\" Copyright (C) 2007 Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DS.LOG 4 "Jun 08, 2007" -.SH NAME -ds.log \- Availability Suite data services log file -.SH DESCRIPTION -.sp -.LP -The \fB/var/adm/ds.log\fR file contains the Availability Suite data services -command log. The administration commands log activities to the file in the -format: -.sp -.in +2 -.nf -date time product: message -.fi -.in -2 - -.sp -.LP -Note that when the size of the log file exceeds 10 Mbytes, ds.log is renamed -\fB/var/adm/ds.log.bak\fR and a new \fB/var/adm/ds.log\fR file is created. -.sp -.LP -The \fBds.log\fR fields are: -.sp -.ne 2 -.na -\fBdate\fR -.ad -.sp .6 -.RS 4n -The date format is \fImmm nn\fR, where \fImmm\fR is the local three-character -abbreviation for the month and \fInn\fR is the day of the month on which the -event occurred. -.RE - -.sp -.ne 2 -.na -\fBtime\fR -.ad -.sp .6 -.RS 4n -The time of the event, in \fIhh:mm:ss\fR format. -.RE - -.sp -.ne 2 -.na -\fBproduct\fR -.ad -.sp .6 -.RS 4n -A product code that identifies which component of the data services produced -the event. The code is separated from the message that follows by a colon (:) -and a space. -.RE - -.sp -.ne 2 -.na -\fBmessage\fR -.ad -.sp .6 -.RS 4n -A message that can extend over more than one line describing the event that -occurred. The second or following lines are not prefixed by the date, time, -and product code strings. -.RE - -.SH EXAMPLES -.sp -.LP -The example below shows sample \fBds.log\fR file content: -.sp -.in +2 -.nf -Jan 25 05:26:17 ii: iiboot suspend cluster tag <none> -Jan 25 05:32:02 ii: iiboot resume cluster tag <none> -Jan 25 05:32:04 sv: svboot: resume /dev/vx/rdsk/bigmaster -Jan 25 05:32:04 sv: svboot: resume /dev/vx/rdsk/bigshadow -Jan 25 05:32:04 sv: svboot: resume /dev/vx/rdsk/mstvxfs -Jan 25 05:32:04 sv: svboot: resume /dev/vx/rdsk/master01 -.fi -.in -2 - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Architecture x86 -_ -Interface Stability Committed -.TE - -.SH SEE ALSO -.sp -.LP -\fBiiadm\fR(1M), \fBsndradm\fR(1M), \fBsvadm\fR(1M), \fBattributes\fR(5) diff --git a/usr/src/man/man4/rdc.cf.4 b/usr/src/man/man4/rdc.cf.4 deleted file mode 100644 index 10c8e4be8a..0000000000 --- a/usr/src/man/man4/rdc.cf.4 +++ /dev/null @@ -1,166 +0,0 @@ -'\" te -.\" Copyright (C) 2007 Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH RDC.CF 4 "Jun 08, 2007" -.SH NAME -rdc.cf \- Availability Suite Remote Mirror software configuration file -.SH DESCRIPTION -.sp -.LP -The \fBrdc.cf\fR is an optional configuration file that supplies the -\fBsndradm\fR(1M) command with details of the volume sets to be operated on. -Inrdc.cf, the volume sets and their host locations are defined in the -following format: -.sp -.in +2 -.nf -post pdevice pbitmap shost sdevice sbitmap protocol mode options -.fi -.in -2 - -.sp -.LP -The \fBrdc.cf\fR fields are: -.sp -.ne 2 -.na -\fBphost (primary host)\fR -.ad -.sp .6 -.RS 4n -Server on which the primary volume resides. -.RE - -.sp -.ne 2 -.na -\fBpdevice (primary device)\fR -.ad -.sp .6 -.RS 4n -Primary volume partition to be copied. Specify only full path names (for -example, /dev/rdsk/c0t1d0s2). -.RE - -.sp -.ne 2 -.na -\fBpbitmap (primary bitmap)\fR -.ad -.sp .6 -.RS 4n -Volume partition in which the bitmap (scoreboard logs) of the primary -partition is stored. Specify only full path names (for example, -/dev/rdsk/c0t1d0s3). -.RE - -.sp -.ne 2 -.na -\fBshost (secondary host)\fR -.ad -.sp .6 -.RS 4n -Server on which the secondary volume resides. -.RE - -.sp -.ne 2 -.na -\fBsdevice (secondary device)\fR -.ad -.sp .6 -.RS 4n -Secondary volume partition. Specify only full path names (for -example,\fB/dev/rdsk/c0t1d0s4\fR). -.RE - -.sp -.ne 2 -.na -\fBsbitmap (secondary bitmap)\fR -.ad -.sp .6 -.RS 4n -Volume partition in which the bitmap (scoreboard logs) of the secondary file -is stored. Specify only full path names (for example, -\fB/dev/rdsk/c0t1d0s5\fR). -.RE - -.sp -.ne 2 -.na -\fBprotocol\fR -.ad -.sp .6 -.RS 4n -Network transfer protocol. Specify IP. -.RE - -.sp -.ne 2 -.na -\fBmode\fR -.ad -.sp .6 -.RS 4n -Remote Mirror operating mode. Sync is the Remote Mirror mode where the I/O -operation is not confirmed as complete until the remote volume has been -updated. Async is the other Remote Mirror mode, in which the primary host I/O -operation is confirmed as complete before updating the remote volume. -.RE - -.sp -.ne 2 -.na -\fBoptions\fR -.ad -.sp .6 -.RS 4n -A consistency group name can be specified using the g character. A disk queue -volume partition can be specified using the q character, using full path name -only (/dev/rdsk/c0t1d0s5). Without the q character set will default to memory -base queue. When running on a clustered system, a cluster resource group tag -can be specified using the C character. -.sp -These options have the following syntax: -.sp -.in +2 -.nf -[g io_groupname] [q queue_volume][C ctag] -.fi -.in -2 - -.LP -Note - -.sp -.RS 2 -When running on a cluster configuration, the cluster resource group tag is -appended to the Remote Mirror set by default. -.RE -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for a description of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Architecture x86 -_ -Interface Stability Committed -.TE - -.SH SEE ALSO -.sp -.LP -\fBsndradm\fR(1M), \fBsndrd\fR(1M), \fBattributes\fR(5) diff --git a/usr/src/man/man4/sndr.4 b/usr/src/man/man4/sndr.4 deleted file mode 100644 index df709d12d0..0000000000 --- a/usr/src/man/man4/sndr.4 +++ /dev/null @@ -1,89 +0,0 @@ -'\" te -.\" Copyright (C) 2007 Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SNDR 4 "Jun 08, 2007" -.SH NAME -sndr \- SNDR parameter values -.SH SYNOPSIS -.LP -.nf -\fB/etc/default/sndr\fR -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBsndr\fR file resides in \fB/etc/default\fR and provides startup -parameters for the \fBsndrd\fR(1M) and \fBsndrsyncd\fR(1M) daemons. -.sp -.LP -The \fBsndr\fR file format is ASCII and comment lines begin with the crosshatch -(#) character. Parameters consist of a keyword followed by an equal (=) sign -followed by the parameter value of the form: -.sp -.in +2 -.nf -keyword=value -.fi -.in -2 - -.sp -.LP -The following parameters are currently supported in the \fBsndr\fR file: -.sp -.ne 2 -.na -\fBSNDR_THREADS=num\fR -.ad -.sp .6 -.RS 4n -Sets the maximum number of connections allowed to the server over -connection-oriented transports. By default, the number of connections is 16. -.RE - -.sp -.ne 2 -.na -\fBSNDR_LISTEN_BACKLOG=num\fR -.ad -.sp .6 -.RS 4n -Sets connection queue length for the RDC TCP over a connection-oriented -transport. The default value is 10 entries. -.RE - -.sp -.ne 2 -.na -\fBSNDR_TRANSPORT=string\fR -.ad -.sp .6 -.RS 4n -Sets the transport used for the RDC connection. If IPv6 is installed, the -default value is "\fB/dev/tcp\fR" or "\fB/dev/tcp6\fR." -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for a description of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Architecture x86 -_ -Interface Stability Committed -.TE - -.SH SEE ALSO -.sp -.LP -\fBsndrd\fR(1M), \fBsndrsyncd\fR(1M) diff --git a/usr/src/man/man7d/Makefile b/usr/src/man/man7d/Makefile index e74632b315..f27ddf6131 100644 --- a/usr/src/man/man7d/Makefile +++ b/usr/src/man/man7d/Makefile @@ -14,7 +14,7 @@ # Copyright 2016 Garrett D'Amore <garrett@damore.org> # Copyright (c) 2017, Joyent, Inc. # Copyright 2016 Hans Rosenfeld <rosenfeld@grumpf.hope-2000.org> -# Copyright 2017 Nexenta Systems, Inc. +# Copyright 2018 Nexenta Systems, Inc. # include $(SRC)/Makefile.master @@ -70,7 +70,6 @@ _MANFILES= aac.7d \ ibtl.7d \ ieee1394.7d \ igb.7d \ - ii.7d \ ipnet.7d \ iscsi.7d \ iser.7d \ @@ -121,7 +120,6 @@ _MANFILES= aac.7d \ sgen.7d \ srpt.7d \ st.7d \ - sv.7d \ sysmsg.7d \ systrace.7d \ ticlts.7d \ diff --git a/usr/src/man/man7d/ii.7d b/usr/src/man/man7d/ii.7d deleted file mode 100644 index cb6ad9dfed..0000000000 --- a/usr/src/man/man7d/ii.7d +++ /dev/null @@ -1,104 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH II 7D "Jun 8, 2007" -.SH NAME -ii \- Instant Image control device -.SH DESCRIPTION -.sp -.LP -The \fBii\fR device is a control interface for Instant Image devices and -controls the Instant Image module through the \fBioctl\fR(2) interface. -.sp -.LP -Instant Image is a point-in-time volume copy facility for the Solaris operating -environment that is administered through the \fBiiadm\fR(1M) command. With -Instant Image, you can create an independent point-in-time copy of a volume or -a master volume-dependent point-in-time view. You can also independently -access the master and shadow volume for read and write operations. Instant -Image also lets you update the shadow volume from the master volume or restore -the master volume from the shadow. (Restore operations to volumes can be full -or incremental). Instant Image supports fast volume re-synchronization, letting -you create a new point-in-time volume copy by updating the specified volume -with only changed data. -.sp -.LP -To create a shadow volume you need a: -.RS +4 -.TP -1. -Master volume to be shadowed. -.RE -.RS +4 -.TP -2. -Shadow volume where the copy will reside. This volume must be equal to or -larger than the master volume. -.RE -.RS +4 -.TP -3. -Administrative bitmap volume or file for tracking differences between the -shadow and master volumes. The administrative bitmap volume or file must be at -least 24Kbytes in size and requires 8KBytes for each GByte (or part thereof) of -master volume size, plus an additional 8KBytes overhead. For example, to shadow -a 3GByte master volume, the administration volume must be 8KBytes + (3 * -8KBytes) =32KBytes in size. -.RE -.sp -.LP -The Instant Image module uses services provided by the SDBC and SD_GEN modules. -The SV module is required to present a conventional block device interface to -the storage product interface of the Instant Image, SDBC and SD_GEN modules. -.sp -.LP -When a shadow operation is suspended or resumed, the administration volumes may -be stored in permanent SDBC storage or loaded and saved to and from kernel -memory. The ii_bitmap variable in the \fB/kernel/drv/ii.conf\fR configuration -file determines the administration volume storage type. A value of 0 indicates -kernel memory, while a value of 1 indicates permanent SDBC storage. If the -system is part of a storage products cluster, use the 1 value (permanent -storage), otherwise use kernel memory (0 value). -.SH FILES -.sp -.ne 2 -.na -\fB\fBkernel/drv/ii\fR\fR -.ad -.RS 23n -32- bit ELF kernel module (x86). -.RE - -.sp -.ne 2 -.na -\fB\fB/kernel/drv/ii.conf\fR\fR -.ad -.RS 23n -Configuration file. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for a description of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Architecture x86 -_ -Interface Stability Committed -.TE - -.SH SEE ALSO -.sp -.LP -\fBiiadm\fR(1M), \fBioctl\fR(2), \fBattributes\fR(5), \fBsv\fR(7D) diff --git a/usr/src/man/man7d/sv.7d b/usr/src/man/man7d/sv.7d deleted file mode 100644 index 9872538986..0000000000 --- a/usr/src/man/man7d/sv.7d +++ /dev/null @@ -1,47 +0,0 @@ -'\" te -.\" Copyright (c) 2007, Sun Microsystems, Inc. All Rights Reserved -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH SV 7D "Jun 8, 2007" -.SH NAME -sv \- Storage Volume system call device -.SH DESCRIPTION -.sp -.LP -The \fBsv\fR driver allows standard system call access (see \fBIntro\fR(2)) to -a disk device to be redirected into the StorageTek architecture software. This -enables standard applications to use Sun StorageTek Availability Suite -components such as Point-in-Time Copy and Remote Mirror software. -.SH FILES -.sp -.ne 2 -.na -\fB\fBkernel/drv/sv\fR\fR -.ad -.RS 17n -SV control and administration driver. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for a description of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Architecture x86 -_ -Interface Stability Committed -.TE - -.SH SEE ALSO -.sp -.LP -\fBiiadm\fR(1M) |