*** UNIX MANUAL PAGE BROWSER ***

volencap(8) System Manager's Manual 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 Puts the encapsulated disk into the disk group specified by disk group ID or disk group name. Instructs volencap to use the specified volpre- fix as the prefix for LSM volume names generated. This is useful if the LSM volume names generated already exist. Instructs volencap to remove any pending encapsulation requests for the specified disk(s), partition(s), or domain(s). Instructs volencap to remove all pending encapsulation requests. Displays all pending encapsulation requests. ATTRIBUTES Specifies the size of the LSM private region in bytes, for example, privlen=1024. 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 encapsula- tion 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 exe- cuted 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/init- tab 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 parti- tions 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 do- main 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 functional- ity that was previously handled in the voladvdomencap script. For backward compatibility, the /usr/sbin/voladvdomencap command is cur- rently supported as a link to /usr/sbin/volencap. EXAMPLES 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 exe- cutes the LSM command scripts created by volencap. To encapsu- late only the root (rz0a) and swap (rz0b) partitions on the boot disk, enter: # volencap rz0a rz0b 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. To en- capsulate the specific partition rz1g to an LSM volume, enter: # volencap rz1g RELATED INFORMATION Commands: volinstall(8), volintro(8) Guides: Logical Storage Manager delim off volencap(8)