Click this button to go to the index for this section.

volencap(8)
NAME
  volencap, vol-reconfig, voladvdomencap - Encapsulate disks, partitions, or
  AdvFS domains

SYNOPSIS
  /usr/sbin/volencap [ -g diskgroup ] [ -p volprefix ]
      [ privlen=nn ] [ nconfig=nn ]
      { diskname | partition_name | domain_name	 } ...

  /usr/sbin/volencap -k { diskname | partition_name
      | domain_name  } ...

  /usr/sbin/volencap -k -a

  /usr/sbin/volencap -s

  /sbin/vol-reconfig

FLAGS
  -g diskgroup
      Puts the encapsulated disk into the disk group specified by disk group
      ID or disk group name.

  -p volprefix
      Instructs volencap to use the specified volprefix	 as the prefix for
      LSM volume names generated. This is useful if the LSM volume names
      generated already exist.

  -k diskname | partition_name | domain_name  ...
      Instructs volencap to remove any pending encapsulation requests for the
      specified disk(s), partition(s), or domain(s).

  -k -a
      Instructs volencap to remove all pending encapsulation requests.

  -s  Displays all pending encapsulation requests.

ATTRIBUTES
  privlen=nn
      Specifies the size of the LSM private region in bytes, for example,
      privlen=1024.

  nconfig=nn
      Specifies the number of log copies and copies of the configuration
      database, for example, nconfig=0.




DESCRIPTION
  Disk partitions that have data can be added to LSM using the encapsulation
  process. This enables users with existing data in disk partitions to easily
  migrate to the use of LSM volumes instead of disk partitions. The volencap
  script generates LSM command scripts that are later executed by the
  /sbin/vol-reconfig command to convert disk partitions to LSM volumes.

  When /sbin/vol-reconfig is executed, the partition must not be in use
  (i.e., not mounted or open as a raw device).	By running the volinstall
  command, the /sbin/vol-reconfig command can be added to the /etc/inittab
  file, which will cause /sbin/vol-reconfig to be executed on the next system
  reboot. Alternatively, /sbin/vol-reconfig can be executed manually on the
  command line.

  The volencap script can be used to encapsulate one or many disk partitions
  or an AdvFS domain.  When a disk is encapsulated, an LSM volume is created
  for each in-use partition on that disk.  When an AdvFS domain is
  encapsulated, all disk partitions in the domain are converted to LSM
  volumes.

  Refer to the Logical Storage Manager manual for more details.

NOTES
  Starting with Version 4.0, the volencap script includes the functionality
  that was previously handled in the voladvdomencap script.  For backward
  compatibility, the /usr/sbin/voladvdomencap command is currently supported
  as a link to /usr/sbin/volencap.

EXAMPLES
   1.  To encapsulate all disk partitions on the boot disk rz0 to LSM, enter:
	    # volencap rz0

       A system reboot is required to make the actual changes. During the
       system reboot, /sbin/vol-reconfig is executed, which executes the LSM
       command scripts created by volencap.

   2.  To encapsulate only the root (rz0a) and swap (rz0b) partitions on the
       boot disk, enter:
	    # volencap rz0a rz0b

   3.  To convert all disk partitions in the AdvFS domain dom1 to LSM
       volumes, enter:
	    # volencap dom1

       If the AdvFS filesets in domain dom1 are not mounted, then /sbin/vol-
       reconfig can be executed on the command line.

   4.  To encapsulate the specific partition rz1g to an LSM volume, enter:
	    # volencap rz1g

RELATED INFORMATION
  Commands: volinstall(8), volintro(8)

  Guides: Logical Storage Manager