vxtune(1M)																vxtune(1M)

NAME

       vxtune - adjust Veritas Volume Replicator and Veritas Volume Manager tunables

SYNOPSIS

       vxtune [-r]

       vxtune [-r] tunable

       vxtune [-r] tunable value

DESCRIPTION

       The vxtune utility manages the various memory tunables that are used by Veritas Volume Replicator (VVR).  It can also be used to change the
       value of the volpagemod_max_memsz tunable that is used by the instant snapshots feature of Veritas Volume Manager  (VxVM).  No  other  VxVM
       tunables are currently tunable using vxtune.

       You  can use vxtune to display, set or change the memory tunables that are used by VVR. To maximize VVR performance, you can use this util-
       ity to experiment with different values before deciding on the optimal tunable values.

       The main advantage of using vxtune to change tunable values is that the new values are available immediately without needing to reboot  the
       system.

       When invoked with no arguments, vxtune displays a list of the tunables whose values may be displayed or set.

       When invoked with the name of a supported tunable as the argument, vxtune displays the value of that tunable.

       When invoked with the name of a supported tunable and a value as arguments, vxtune  attempts to set the tunable to that value.

       The specified value can take the following prefixes as base specifiers:

	      0 	Value is in octal.

	      0x	Value is in hexadecimal.

       By default, decimal is assumed.

       The specified value can take the following suffixes as unit multipliers:

	      g or G	The specified value is in gigabytes.

	      k or K	The specified value is in kilobytes.

	      m or M	The specified value is in megabytes.

       By default, the units are assumed to be bytes.

       The values of the following memory tunables may be displayed or set:

       vol_max_nmpool_sz
		 Maximum  memory  that will be used by VVR on a secondary to hold the write requests coming from the primary.  This memory is sys-
		 tem-wide and restricts all secondary RVGs on the system. It may also be useful to increase this  tunable  if  multiple  Secondary
		 RVGs are present on the system.

       vol_max_rdback_sz
		 Maximum memory that will be used by VVR, when write requests are being read back from the SRL. You may need to increase this tun-
		 able if you have multiple asynchronous RLINKS in one or more RVGs.

       vol_max_wrspool_sz
		 Used in the clustered version of VVR.

       vol_min_lowmem_sz
		 Minimum Threshold of available VVR memory needed to keep the write requests in memory on the primary RVG to send it to secondary.
		 If  available	VVR  memory  is less than this threshold, write requests are freed early so that readbacks can be performed later.
		 This tunable is used by asynchronous RLINKs.

       vol_rvio_maxpool_sz
		 Maximum memory requested from the system by VVR for internal purposes. This tunable has a direct impact on the performance of VVR
		 as  it  prevents one I/O operation from using all the memory in the system.  The value of vol_rvio_maxpool_sz must be at least 10
		 times greater than the value of the maximum I/O size.

       volpagemod_max_memsz
		 Maximum memory, measured in kilobytes, that is allocated for caching FastResync and cache object metadata by  the  instant  snap-
		 shots feature of VxVM.  This tunable has a default value of 6144KB(6MB) of physical memory.

		 The memory allocated for this cache is exclusively dedicated to it.  It is not available for other processes or applications.

		 Setting the value of volpagemod_max_memsz below 512KB fails if cache objects or volumes that have been prepared for instant snap-
		 shot operations are present on the system.

		 If you do not use the FastResync or DRL features that are implemented using a version	20  DCO  volume,  the  value  of  volpage-
		 mod_max_memsz	can  be  set to 0.  However, if you subsequently decide to enable these features, you can use vxtune to change the
		 value to a more appropriate one.

OPTIONS

       -r	 (Raw) By default, tunable values are displayed in kilobytes.  This option causes values to be displayed in bytes.

EXAMPLES

       Display the tunable parameters that vxtune supports:

		     vxtune

       Display the value of vol_min_lowmem_sz on a host:

		     vxtune vol_min_lowmem_sz

       Modify the value of vol_min_lowmem_sz to 2 megabytes on a host:

		     vxtune vol_min_lowmem_sz 2M

EXIT CODES

       The vxtune utility exits with a non-zero status if the attempted operation fails.

       A non-zero exit code is not a complete indicator of the problems encountered but denotes the first condition that prevented further  execu-
       tion of the utility.

NOTES

       The vxtune command only affects the tunable values on the host on which it is run. If required, you must run the command separately on each
       host for which you want to change the tunable values (for example, for the log-owner node and any of its failover nodes in a cluster).

       Values that have been specified using vxtune are persistent across reboots.

SEE ALSO

       vrport(1M), vxmemstat(1M), vxsnap(1M)

       Veritas Volume Replicator Configuration Notes
       Veritas Volume Manager Administrator's Guide

VxVM 5.0.31.1							    24 Mar 2008 							vxtune(1M)