volencap(8) — Maintenance
NAME
volencap, volreconfig − Encapsulates 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
OPTIONS
−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.
−sDisplays all pending encapsulation requests.
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 /usr/sbin/volencap command is used to encapsulate one or many disk partitions or AdvFS domains.
If an individual partition is specified for encapsulation, the volencap command creates a nopriv disk and a volume for that partition.
If an entire disk is specified, the volencap command creates a nopriv disk and volume for each in-use partition on the disk.
If an AdvFS domain is specified, all disk partitions in the domain are converted to LSM volumes.
You can use the volencap command to encapsulate the partitions on the boot disk, including the root file system, primary swap, usr and var partitions, to place them under LSM control. See the Logical Storage Manager manual for more information on encapsulating these partitions.
The volencap command can be run directly or through the voldiskadm menus. The volencap command generates LSM commands that are later executed by the /sbin/volreconfig command to perform the actual conversion of disk partitions to LSM volumes.
The system must be rebooted to complete the encapsulation procedure. If you cannot reboot the system, defer the encapsulation procedure until you can reboot the system. When the system reboots, the LSM command scripts (created by the volencap command) execute.
See the Logical Storage Manager manual for more details.
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.
EXAMPLES
•To encapsulate all disk partitions on the boot disk called dsk0 to LSM volumes, enter:
# volencap dsk0
# volreconfig
The volreconfig command will request confirmation prior to rebooting the system. The LSM command scripts created by the volencap command will execute as the system reboots.
•To encapsulate only the root file system (dsk0a) and swap (dsk0b) partitions on the boot disk, enter:
# volencap dsk0a dsk0b
# volreconfig
The volreconfig command will request confirmation prior to rebooting the system. The LSM command scripts created by the volencap command will execute as the system reboots.
•To convert all disk partitions in the AdvFS domain called dom1 to LSM volumes, enter:
# volencap dom1
# volreconfig
The volreconfig command will determine if the domain is active, and if so, request confirmation prior to rebooting the system. The LSM command scripts created by the volencap command will execute as the system reboots.
If the AdvFS filesets in domain dom1 are not mounted, then /sbin/volreconfig can be executed on the command line.
•To encapsulate the specific partition dsk1g to an LSM volume, enter:
# volencap dsk1g
# volreconfig
The volreconfig command will determine if the partition is open, and if so, request confirmation prior to rebooting the system. The LSM command scripts created by the volencap command will be executed as the system reboots.