alt_rootvg_op Command

Purpose

Performs operations on existing alternate rootvg volume groups.

Syntax

To determine Volume Group Boot Disk (-q):

alt_rootvg_op -q -d disk [-D]

To rename Alternate Disk Volume Group (-v):

alt_rootvg_op -v new volume group name -d disk [-D]

To wake up Volume Group (-W):

alt_rootvg_op -W -d disk [-D]

To put to sleep Volume Group (-S):

alt_rootvg_op -S [-tD]

To clean up Alternate Disk Volume Group (-X):

alt_rootvg_op -X [volume group] [-D]

To customize Alternate Disk Volume Group (-C):

alt_rootvg_op -C [-R resolv_conf] [-s script] [-b bundle_name] [-I installp_flags] [-l images_location] [-f fix_bundle] [-F fixes] [-w filesets] [-DV]

Description

The alt_rootvg_op command can be used to determine which disk is the boot disk for a specific volume group. Use the -q flag to determine the boot disk. This can be useful when a volume group is comprised of multiple disks and a change in the bootlist is necessary.

This command can also be used to rename the alternate disk volume groups. This is especially useful when creating multiple alternate disks, on multiple volume groups, and name identification is necessary.

If data access is necessary between the current rootvg and an alternate disk, use the alt_rootvg_op command to perform a volume group wake-up operation (using the -W flag) on the non-booted volume group. The wake-up puts the volume group in a post phase 1 state (that is, the /alt_inst file systems will be mounted). The customize operation (-C flag) can be executed at this time. The wake-up operation is not intended to execute commands in a chroot environment.

The running system's operating system must be greater than or equal to the operating system version of the volume group that undergoes the wake-up operation. Therefore, you must boot the LPAR from the altinst_rootvg volume group and wake up the old_rootvg volume group. If the operating system in the altinst_rootvg volume group is a greater Technology Level (TL) or Service Pack (SP) level than the running system's operating system, although the wake-up operation is allowed, some operations on the altinst_rootvg volume group might not work properly.

The alt_rootvg_op command does not allow a "wake-up" to occur on a volume group with a greater operating system version, unless the FORCE environment variable is set to Yes.

Note:
  1. The volume group that experiences the "wake-up" is renamed altinst_rootvg.
  2. Do not execute phase 3 on the volume group that experiences the "wake-up."
  3. Do not reboot the system if there is a volume group in the "wake" state. This can cause damage or data loss to the volume group that is in the "wake" state. Volume groups in the "wake" state can be put to "sleep" with the -S flag.

When data access is no longer needed, the alt_rootvg_op command can be used to put to sleep the volume group in the "wake" state, using the -S flag. The boot image on the target alternate rootvg can be rebuilt if necessary with the -t flag. The sleep operations revert the alternate volume group to an inactive state.

When cleaning up the alternate disk volume group, the alt_rootvg_op command uses the -X flag to remove the altinst_rootvg volume group definition from the ODM database. If the target volume group is varied off at the time this operation is executed, only the ODM definitions associated with the target volume group are removed. The actual volume group data is not removed. If the volume group is bootable, you can still reboot from that volume group, by setting the bootlist to a boot disk in this volume group. The -X flag accepts a volume group name as an argument and acts on the altinst_rootvg volume group by default.

The customize operation of the alt_rootvg_op command (using the -C flag) can be used to perform the following functions on an active alternate root volume group:
  • Install software and software updates. Apply this operation only to alternate volume groups created with the rootvg copy operation.
  • Execute customization script.
  • Copy resolv.conf files.

Flags

Item Description
-b bundle_name Path name of optional file with a list of packages or filesets that will be installed after a rootvg clone. The -l flag must be used with this option.
-C Performs the customization operation on the active rootvg volume group.
-d target_disk Specifies a space-delimited list of the name or names of the target disks that will be targets of the given operation.
-D Turns on debug (sets -x output).
-f fix_bundle Optional file with a list of APARs to install after a clone of rootvg. The -l flag must be used with this option.
-F fixes Optional list of APARs (for example, IY123456) to install after a clone of rootvg. The -l flag must be used with this option.
-I installp_flags The flags to use when updating or installing new filesets into the cloned altinst_rootvg. The default flag is -acgX. The -l flag must be used with this option.
-l images_location Location of installp images or updates to apply after a clone of rootvg. This can be a directory full path name or device name (like /dev/rmt0).
-q Determines the volume group boot disk.
-R resolv_conf The resolv.conf file to replace the existing one in the rootvg. You must specify a full path name.
-s script Optional customization script to be executed during the customization phase. This file must be executable. This script is called on the running system before the /alt_inst file systems are unmounted, so files can be copied from the running system to the /alt_inst file systems before the reboot.
-S Puts to sleep the alternate root volume group that experienced the previous "wake" operation.
-t Rebuilds the alternate boot image before putting the volume group to "sleep." This flag is only valid for alternate root volume groups created with the clone or copy install operation. The -t flag requires the -S flag.
-v Name Renames an alternate disk volume group to the name specified with the Name parameter.
-V Turn on verbose output.
-w filesets List of filesets to install after cloning a rootvg. The -l flag must be used with this option.
-W Performs a wake-up on the root volume group located on the target_disk.
-X Removes the altinst_rootvg volume group definition from the ODM database.

Exit Status

Item Description
0 All alt_rootvg_op related operations completed successfully.
>0 An error occurred.

Examples

  1. To remove the original rootvg ODM database entry, after booting from the new alternate disk, enter the following command:
    alt_rootvg_op -X old_rootvg
  2. To cleanup the current alternate disk install operation, enter the following command:
    alt_rootvg_op -X 
  3. To determine the boot disk for a volume group with multiple physical volume, enter the following command:
    alt_rootvg_op -q -d hdisk0
    Illustrated Example
    # lspv
    
    hdisk0          00006091aef8b687     old_rootvg
    hdisk1          00076443210a72ea     rootvg
    hdisk2          0000875f48998649     old_rootvg
    
    # alt_rootvg_op -q -d hdisk0
    
    hdisk2
  4. To modify an alt_disk_install volume group name, enter the following command:
    alt_rootvg_op -v alt_disk_530 -d hdisk2
    Illustrated Example
    # lspv
    
    hdisk0          00006091aef8b687     rootvg
    hdisk1          00000103000d1a78     rootvg
    hdisk2          000040445043d9f3     altinst_rootvg
    hdisk3          00076443210a72ea     altinst_rootvg
    hdisk4          0000875f48998649     None
    hdisk5          000005317c58000e     None
    
    # alt_rootvg_op -v alt_disk_432 -d hdisk2
    
    #lspv
    
    hdisk0          00006091aef8b687     rootvg
    hdisk1          00000103000d1a78     rootvg
    hdisk2          000040445043d9f3     alt_disk_432
    hdisk3          00076443210a72ea     alt_disk_432
    hdisk4          0000875f48998649     None
    hdisk5          000005317c58000e     None
  5. To "wake up" an original rootvg after booting from the new alternate disk, enter the following command:
    alt_rootvg_op -W -d hdisk0
  6. To "put to sleep" a volume group that had experienced a "wake-up" and rebuild the boot image, enter the following command:
    alt_rootvg_op -S -t
  7. To update the active alternate rootvg to the latest fileset levels available in /updates and install them into the alternate root volume group, enter the following command:
    alt_rootvg_op -C -b update_all -l /updates

Location

/usr/sbin/alt_rootvg_op

Files

Item Description
/usr/sbin/alt_rootvg_op Contains the alt_rootvg_op command.