Symantec logo

Upgrading the Veritas software on a standalone system

 To upgrade a Veritas Storage Foundation product on a standalone system

  1. Log in as superuser.
  2. If you are upgrading Veritas Storage Foundation for DB2, resynchronize all existing snapshots before upgrading.

    # /opt/VRTS/bin/db2ed_vmsnap -D DB2DATABASE -f SNAPPLAN \

    -o resync

  3. Check if the system's root disk is under VxVM control by running this command:

    # df -v /

    The root disk is under VxVM control if /dev/vx/dsk/bootdg/rootvol is listed as being mounted as the root (/) file system. If so, unmirror and unencapsulate the root disk as described in the following steps:

    1. Use the vxplex command to remove all the plexes of the volumes rootvol, swapvol, usr, var, opt and home that are on disks other than the root disk.

      For example, the following command removes the plexes mirrootvol-01, and mirswapvol-01 that are configured on a disk other than the root disk:

      # vxplex -o rm dis mirrootvol-01 mirswapvol-01


        Note   Do not remove the plexes on the root disk that correspond to the original disk partitions.


    2. Enter the following command to convert all the encapsulated volumes in the root disk back to being accessible directly through disk partitions instead of through volume devices. There must be at least one other disk in the rootdg disk group in addition to the root disk for vxunroot to succeed.

      # /etc/vx/bin/vxunroot

      Following the removal of encapsulation, the system is rebooted from the unencapsulated root disk.

      If your system is running VxVM 4.1 MP2, the following remnants of encapsulation will still be present:

      • Partition table entries for the private and public regions
      • GRUB or LILO configuration entries for VxVM

If you are upgrading from 4.1 MP2, also perform step c through step g to correct these entries. Otherwise, proceed to step 4.

  1. Run the fdisk command on the root disk, as shown in this example:

    # fdisk -l /dev/sda

    Disk /dev/sda: 36.3 GB, 36398825472 bytes

    255 heads, 63 sectors/track, 4425 cylinders

    Units = cylinders of 16065 * 512 = 8225280 bytes

Device Boot    Start   End     Blocks    Id  System

/dev/sda1       1       13      104391    83  Linux

/dev/sda2       14      2001    15968610  83  Linux

/dev/sda3       1       4425    35543781  7e  Unknown

/dev/sda4       2002    4425    19470780  5   Extended

/dev/sda5       2002    3001    8032468+  83  Linux

/dev/sda6       3002    3003    16033+    82  Linux swap

/dev/sda7     4425      4425    1024      7f  Unknown

Partitions /dev/sda3 and /dev/sda7 with identifiers 7f and 7e correspond to the private and public regions respectively.

  1. Run the fdisk command again to remove the private and public partitions, /dev/sda3 and /dev/sda7.

    # fdisk /dev/sda

    The number of cylinders for this disk is set to 4425.

    There is nothing wrong with that, but this is larger than

    1024,and could in certain setups cause problems with:

    1) software that runs at boot time (e.g., old versions of

    LILO)

    2) booting and partitioning software from other OSs

    (e.g., DOS FDISK, OS/2 FDISK)

Command (m for help): d

Partition number (1-7): 3

Command (m for help): d

Partition number (1-7): 7

Command (m for help): w

The partition table has been altered!

Calling ioctl() to re-read partition table.

WARNING: Re-reading the partition table failed with

error 16: Device or resource busy.

The kernel still uses the old table.

The new table will be used at the next reboot.

Syncing disks.

    1. Edit the /etc/fstab file, and ensure that the entries for the root file system (/) and for other file systems on the root disk correspond to the correct disk partitions. If they do not, make any necessary changes to allow the system to boot correctly. For the example layout, no update is necessary. However, if the VxVM private region had been /dev/sda6, and other logical partitions followed it in the listing, the numbers of these partitions would decrease by 1. For example, /dev/sda7 would become/dev/sda6 , /dev/sda8 would become /dev/sda7, and so on.

      Alternatively, you can copy /etc/fstab.b4vxvm back to /etc/fstab if you are certain that the entries are still valid.

    2. Correct the configuration of the boot loader that is used on your system.
    3. For the GRUB boot loader, edit the /boot/grub/menu.lst file.

      Remove all entries between and including the vxvm_root_default_START and vxvm_root_default_END comment markers, as shown in this example:

      #vxvm_root_default_START ( do not remove)

      # Default menu entry number has been set to vxvm_root.

      # - the vxvm_root default entry number is: 3

      # - the original default entry number is: 0

      # - the selected default entry number is: 0

      # - the original grub configuration is in: \

      /boot/grub/menu.lst.b4vxvm

      default=3

      #vxvm_root_default_END ( do not remove)

Remove all entries between and including the vxvm_root_START and vxvm_root_END comment markers, as shown in this example:

#vxvm_root_START ( do not remove)

title vxvm_root

root (hd0,0)

kernel /vmlinuz root=/dev/sda2 vga=0x314 console=tty0 \

console=ttyS0 selinux=0 resume=/dev/sda6 elevator=cfq \

showopts initrd /VxVM_initrd.img

#vxvm_root_END ( do not remove)

Change to the original boot kernel that was used before the root disk was encapsulated by uncommenting the line that starts #default, as shown in this example:

color white/blue black/light-gray

#default 0

timeout 8

which would become:

color white/blue black/light-gray

default 0

timeout 8

Save the changes to the /boot/grub/menu.lst file.

Alternatively, you can copy /boot/grub/menu.lst.b4vxvm back to /boot/grub/menu.lst if you are certain that the entries are still valid.

Remove all entries between and including the vxvm_rootgeom_START and vxvm_rootgeom_END comment markers, as shown in this example:

#vxvm_rootgeom_START ( do not remove )

#NOTE: Only vxvm_root entry will be able to boot the

# system, while your root disk is under Volume Manager.

# Also, running -R/lock/fallback options of LILO may

# render your system unbootable.

disk=/dev/vx/dsk/bootdg/rootvol

bios=0x80

sectors=63

heads=255

cylinders=4425

partition=/dev/vx/dsk/bootdg/bootvol

start=63

#vxvm_rootgeom_END ( do not remove )

Remove all entries between and including the vxvm_root_START and vxvm_root_END comment markers, as shown in this example:

#vxvm_root_START ( do not remove)

image=/boot/vmlinuz

label=vxvm_root

initrd=/boot/VxVM_initrd.img

read-only

append="root=/dev/sda2 vga=0x314 console=tty0 \

console=ttyS0 selinux=0 resume=/dev/sda6 elevator=cfq \

showopts"

#vxvm_root_END ( do not remove)

Change to the argument to the default= attribute from vxvm_root to Linux, as shown in this example:

boot=/dev/sda

default=Linux

timeout=50

Save the changes to the /etc/lilo.conf file.

Alternatively, you can copy /etc/lilo.conf.b4vxvm back to /etc/lilo.conf if you are certain that the entries are still valid.

Run the following command after updating the /etc/lilo.conf file:

# /sbin/lilo

  1. Reboot the system.
  1. Use the following command to check if any VxFS file systems or Storage Checkpoints are mounted:

# df -T | grep vxfs

  1. Unmount all Storage Checkpoints and file systems:

# umount /checkpoint_name

# umount /filesystem

  1. Verify that all file systems have been cleanly unmounted:

# echo "8192B.p S" | fsdb -t vxfs filesystem | grep clean

flags 0 mod 0 clean clean_value

A clean_value value of 0x5a indicates the file system is clean, 0x3c incidates the file system is dirty, and 0x69 indicates the file system is dusty. A dusty file system has pending extended operations.

  1. If a file system is not clean, enter the following commands for that file system:

# fsck -t vxfs filesystem

# mount -t vxfs filesystem mountpoint

# umount mountpoint

This should complete any extended operations that were outstanding on the file system and unmount the file system cleanly.

There may be a pending large fileset clone removal extended operation if the umount command fails with the following error:

file system device busy

You know for certain that an extended operation is pending if the following message is generated on the console:

Storage Checkpoint asynchronous operation on file_system

file system still in progress.

    1. If an extended operation is pending, you must leave the file system mounted for a longer time to allow the operation to complete. Removing a very large fileset clone can take several hours.
    2. Repeat step 12 to verify that the unclean file system is now clean.
  1. Stop activity to all VxVM volumes. For example, stop any applications such as databases that access the volumes, and unmount any file systems that have been created on the volumes.
  2. Stop all the volumes by entering the following command for each disk group:

    # vxvol -g diskgroup stopall

    To verify that no volumes remain open, use the following command:

    # vxprint -Aht -e v_open

  3. Make a record of the mount points for VxFS file systems and VxVM volumes that are defined in the /etc/fstab file. You will need to recreate these entries in the /etc/fstab file on the freshly installed system.
  4. Shut down the system.
  5. Install Red Hat Enterprise Linux 4 Update 3 or SUSE Linux Enterprise Server 9 SP3 on your system.

      Caution   This is likely to destroy any existing data on any disks that are touched by the installation procedure. During installation, do not reconfigure any disks other than the root disk or those disks that were previously in the rootdg disk group. To ensure the integrity of your data, it is recommended that you back it up before starting the upgrade.


  6. Perform any necessary preinstallation checks. See Preinstallation instructions for more information.
  7. Upgrade Veritas Storage Foundation 5.0 or Veritas Storage Foundation 5.0 for DB2 and any additional required packages by running the installer script as described in Installing the Veritas Storage Foundation software.
  8. Reinstate the mount points in the /etc/fstab file that you recorded in step 9.
  9. Reboot the upgraded systems.
  10. Restart all the volumes by entering the following command for each disk group:

    # vxvol -g diskgroup startall

There are several optional configuration steps that you may want to perform: