Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

metasync(1m) [opensolaris man page]

metasync(1M)						  System Administration Commands					      metasync(1M)

NAME
metasync - handle metadevice resync during reboot SYNOPSIS
/usr/sbin/metasync -h /usr/sbin/metasync [-s setname] [buffer_size] metadevice /usr/sbin/metasync [-s setname] -r [buffer_size] /usr/sbin/metasync -p metadevice /usr/sbin/metasync -c metadevice DESCRIPTION
The metasync command starts a resync operation on the specified metadevice. All components that need to be resynced are resynced. If the system crashes during a RAID5 initialization, or during a RAID5 resync, either an initialization or resync restarts when the system reboots. Applications are free to access a metadevice at the same time that it is being resynced by metasync. Also, metasync performs the copy oper- ations from inside the kernel, which makes the utility more efficient. Use the -r option in boot scripts to resync all possible submirrors. OPTIONS
The following options are supported: -c metadevice Cancels the resync that is in progress on the specified metadevice. The resync will be stopped at its current point and can be resumed by running the "metasync metadevice" command. This option only applies to RAID1 volumes. -h Displays usage message. -p metadevice Regenerates parity information for RAID5 metadevices. -s setname Specifies the name of the diskset on which metasync will work. Using the -s option will cause the command to perform its administrative function within the specified diskset. Without this option, the command will perform its function on local metadevices. -r Specifies that the metasync command handle special resync requirements during a system reboot. metasync -r should only be invoked from the svc:/system/mdmonitor service. The metasync command only resyncs those metadevices that need to be resynced. metasync schedules all the mirror resyncs according to their pass numbers. To override the default buffer_size value used by the svc:/system/mdmonitor service, you can edit /etc/system to specify: set md_mirror:md_resync_bufsz = 2048 so that resyncs occur as quickly as possible. OPERANDS
buffer_size Specifies the size (number of 512-byte disk blocks) of the internal copy buffer for the mirror resync. The size defaults to 1024 512-byte disk blocks. It can be no more than 2048 blocks. For best performance (quickest completion of the resync), 2048 blocks is the recommended size. EXIT STATUS
The following exit values are returned: 0 Successful completion. >0 An error occurred. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWmdu | +-----------------------------+-----------------------------+ SEE ALSO
mdmonitord(1M), metaclear(1M), metadb(1M), metadetach(1M), metahs(1M), metainit(1M), metaoffline(1M), metaonline(1M), metaparam(1M), metarecover(1M), metarename(1M), metareplace(1M), metaroot(1M), metaset(1M), metassist(1M), metastat(1M), metattach(1M), md.tab(4), md.cf(4), mddb.cf(4), md.tab(4), attributes(5), md(7D) NOTES
The metasync service is managed by the service management facility, smf(5), under the service identifier: svc:/system/mdmonitor Administrative actions on this service, such as enabling, disabling, or requesting restart, can be performed using svcadm(1M). The ser- vice's status can be queried using the svcs(1) command. SunOS 5.11 27 Mar 2006 metasync(1M)

Check Out this Related Man Page

metaparam(1M)						  System Administration Commands					     metaparam(1M)

NAME
metaparam - modify parameters of metadevices SYNOPSIS
/usr/sbin/metaparam -h /usr/sbin/metaparam [-s setname] [ concat/stripe or RAID5 options] concat/stripe RAID /usr/sbin/metaparam [-s setname] [ mirror options] mirror DESCRIPTION
The metaparam command is used to display or modify current parameters of metadevices. If just the metadevice is specified as an argument to the metaparam command, the current settings are displayed. The metaparam command enables most metadevice (volume) parameters to be changed. Only the interlace value cannot be changed by metaparam, because it is established when the metadevice is created and cannot be changed thereafter. OPTIONS
Root privileges are required for all of the options. The following options are supported: -h Displays usage message. -s setname Specify the name of the diskset on which metaparam works. Using the -s option causes the command to perform its administra- tive function within the specified diskset. Without this option, the command performs its function on local metadevices. CONCAT
/STRIPE OR RAID5 OPTIONS -h hot_spare_pool | none Specifies the hot spare pool to be used by a metadevice. If none is specified, the metadevice is disassoci- ated with the hot spare pool assigned to it. If the metadevice is currently using a hot spare, then meta- param cannot replace the hot spare pool. concat/stripe | RAID Specifies the metadevice name of the concatenation, stripe, or concatenation of stripes, or of the RAID5 metadevice. MIRROR OPTIONS
-r roundrobin | geometric | first Modifies the read option for a mirror. The -r option must be followed by either roundrobin, geomet- ric, or first. roundrobin, which is the default action under the metainit command, specifies read- ing the disks in a round-robin (load balancing) method. geometric allows for faster performance on sequential reads. first specifies reading only from the first submirror. -w parallel | serial Modifies the write option for a mirror. The -w option must be followed by either parallel or serial. parallel, the default action under the metainit command, specifies that all writes are par- allel. serial specifies that all writes are serial. -p pass_number A number from 0-to-9 that specifies the order in which a mirror is resynced during reboot. The default is 1. Smaller pass numbers are resynced first. Equal pass numbers are run concurrently. If 0 is used, the mirror resync is skipped. 0 should only be used for mirrors mounted as read-only, or as swap. mirror Specifies the metadevice name of the mirror. EXAMPLES
Example 1: Associating Hot Spare Pool with RAID5 Metadevice This example associates a hot spare pool, hsp005, with a RAID5 metadevice, d80. # metaparam -h hsp005 d80 Example 2: Changing Read Option to Geometric This example changes the read option on a mirror d50 from the default of roundrobin to geometric. # metaparam -r geometric d50 EXIT STATUS
The following exit values are returned: 0 Successful completion. >0 An error occurred. ATTRIBUTES
See attributes(5) for descriptions of the following attributes: +-----------------------------+-----------------------------+ | ATTRIBUTE TYPE | ATTRIBUTE VALUE | +-----------------------------+-----------------------------+ |Availability |SUNWmdu | +-----------------------------+-----------------------------+ SEE ALSO
mdmonitord(1M), metaclear(1M), metadb(1M), metadetach(1M), metahs(1M), metainit(1M), metaoffline(1M), metaonline(1M), metarecover(1M), metarename(1M), metareplace(1M), metaroot(1M), metaset(1M), metassist(1M), metastat(1M), metasync(1M), metattach(1M), md.tab(4), md.cf(4), mddb.cf(4), md.tab(4), attributes(5), md(7D) Solaris Volume Manager Administration Guide SunOS 5.10 2 Jun 1004 metaparam(1M)
Man Page