How to upgrade from SLES 15 to SLES 16 when InfoScale 9.2 is part of the upgrade path

book

Article ID: 1000766161

calendar_today

Updated On:

Description

SLES 16 release has eliminated support for VTOC-formatted disks. Because of this OS-level change, if there are plans to upgrade systems from SLES 15 to SLES 16 with InfoScale, it is necessary to first convert all the affected disks from VTOC to GPT before completing the OS migration.

Before starting the upgrade process

  • Confirm that the InfoScale deployment is currently running an older InfoScale version such as 9.1 on SLES 15.

  • Identify whether any disks in the cluster use VTOC or non-GPT labels. Use the vxmediadisc utility (/etc/vx/diag.d/vxmediadisc -p <disk path such as /dev/sdc>) to get the disk data.

  • Plan a maintenance window for a process that includes the InfoScale upgrade, disk conversion, OS upgrade, reboot, and a package refresh.

  • Ensure to understand the process flow. The sequence of these steps matters:

    • Ensure to take backups of the disk labels and the cluster configuration before the disk conversion.

    • Upgrade InfoScale 9.2 on SLES 15.

    • Convert the VTOC disks to GPT first, and then perform the SLES 16 OS upgrade.

    • Upgrade to InfoScale 9.2 on SLES 16 after the OS migration and reboot.

 

Back up storage and cluster configuration items

Before starting the upgrade, take a backup of the following:

  • Disk VTOC label metadata for each affected disk

  • VCS configuration: (/etc/VRTSvcs/conf/config/main.cf)

  • Disk group configuration using  /opt/VRTS/bin/vxconfigbackup

  • Any other environment-specific configuration files required for recovery

Do not skip the disk label backup. The disk backup steps must be completed before running vxdisk convertgpt <disk>. These backups provide a fallback path if the conversion fails for some reason and there is a need to revert the configuration to the earlier state.

 

Disk labels backups

Perform the following steps on a system running an older qualified InfoScale release, for example InfoScale 9.1, on SLES 15 SP7. The examples below use /dev/sdc . Replace the device path with the correct disk for your environment.

  1. Back up sectors 0 through 256. This captures the VTOC labels, VxVM ID blocks, and primary PRIVHEAD.

     
     
    dd if=/dev/sdc of=/tmp/sdc_head.img bs=512 count=257
  2. Back up sector 496. This captures the alternate PRIVHEAD.

     
     
    dd if=/dev/sdc of=/tmp/sdc_altphi.img bs=512 skip=496 count=1
  3. Back up the last 33 sectors of the disk. This preserves the original end-of-disk region before the backup GPT is written there.

     
     
    SECTORS=$(blockdev --getsz /dev/sdc)
    dd if=/dev/sdc of=/tmp/sdc_tail.img bs=512 skip=$((SECTORS - 33)) count=33
  4. Verify that the backup files exist and that their sizes are correct.

     
     
    ls -l /tmp/sdc_head.img
    ls -l /tmp/sdc_altphi.img
    ls -l /tmp/sdc_tail.img
    • /tmp/sdc_head.img should be 131584 bytes (257 * 512)

    • /tmp/sdc_altphi.img should be 512 bytes

    • /tmp/sdc_tail.img should be 16896 bytes (33 * 512)

  5. Back up all the disk group configuration data.

   /etc/vx/bin/vxconfigbackup [-f] [-l directoryname]

 

VCS cluster configuration backup


Back up the VCS configuration file (/etc/VRTSvcs/conf/config/main.cf), other custom agents, and LLT and GAB configuration files.

haconf -dump -makero
hasnap -backup -f /tmp/vcs_backup.zip -n -m “Pre-upgrade backup”
 
 

 

OS and InfoScale upgrade procedure

  1. Start with an older qualified InfoScale release, for example InfoScale 9.1, on SLES 15 SP7.

  2. Back up all required configuration and disk metadata:

    • Back up the disk VTOC labels for each affected disk and the disk group configuration as per the steps mentioned in the Disk label backup section above.

    • Back up the VCS configuration file (/etc/VRTSvcs/conf/config/main.cf) as per the steps mentioned in the VCS cluster configuration backup section above.

    • Back up any additional files needed by your environment.

  3. Upgrade InfoScale to version 9.2 on SLES 15 using the InfoScale installer (DVD or tarball) for SLES 15.

    • Use either a full upgrade or a rolling upgrade, as appropriate for the environment.

  4. Ensure all disk groups are in the imported state, then convert every affected VTOC disk to GPT.

    Run the following command:

     
     
    vxdisk convertgpt <disk>
    Sample : 
    # vxdisk -eo alldgs list
    DEVICE       TYPE           DISK        GROUP        STATUS               OS_NATIVE_NAME   ATTR
    dl360g12-01-vm3_vmdk0_0 auto:cdsdisk   dl360g12-01-vm3_vmdk0_0  sdg1        online shared        sdi   
     
    # vxdisk convertgpt dl360g12-01-vm3_vmdk0_0
    # echo $?
         0
    # fdisk -l /dev/sdi
    Disk /dev/sdi: 16 GiB, 17179869184 bytes, 33554432 sectors
    Disk model: Virtual disk
    Units: sectors of 1 * 512 = 512 bytes
    Sector size (logical/physical): 512 bytes / 512 bytes
    I/O size (minimum/optimal): 512 bytes / 512 bytes
    Disklabel type: gpt
    Disk identifier: 8C38A958-65BD-11F1-B1CF-AADDD36B3E67
     
    Device     Start      End  Sectors Size Type
    /dev/sdi3     48 33554398 33554351  16G Solaris reserved 3
    #
    Repeat the command for all VTOC disks that require conversion.

If vxdisk convertgpt fails, review the vxconfigd log, correct the reported issue, and retry the conversion:
# cat /etc/vx/log/vxconfigd.log


    5. Verify that no disks in the cluster remain VTOC-labeled.

 Use the vxmediadisc utility to confirm that conversion is complete:

  /etc/vx/diag.d/vxmediadisc -p <disk path such as /dev/sdc>
 
 
 

Sample output of disk /dev/sdc ; the Partition Table Type parameter displays the disk type as GPT.

# /etc/vx/diag.d/vxmediadisc -p /dev/sdc
vxmediadisc: Disk /dev/sdc is partitioned.
Partition Table Contents
Revision:                      1
Partition Table Type:          GPT
Partition Table OStype:        CDS
Number of partitions:          128
Number of used partitions:     1
Partition Numbers 0 - 1 are Empty
Partition Number 2:
     Partition Entry Type:          CDS
     Partition Entry Tag:           0x0f (Private)
     Partition Entry Start:         0x0000000000000030 (48)
     Partition Entry Size:          0x0000000746afffaf (31250710447)
     Partition Entry Name:          symc_cdsdisk

Partition Numbers 3 - 127 are Empty
vxmediadisc: Media format for /dev/sdc = cdsdisk (VxVM)
vxmediadisc: /dev/sdc generated by = All Supported
vxmediadisc: /dev/sdc is a SCSI disk.
vxmediadisc: Number of sectors:     31250710528
vxmediadisc: Sector size:           512
vxmediadisc: Number of disk reads:  1
CDS ID Block Contents
     Magic ID String:               VxVMDISK
     Checksum:                      0x00000A9E
     Structure Version:             0x00000002
     Flags:                         0x00000004 (IS_CDS)
     Priv Offset (Sectors):         0x00000000000000D0 (208)

Fabricated Geometry :
     tracks/cylinder: 1262
     sectors/track: 378
     cylinders: 65510
  1. Upgrade the operating system from SLES 15 to SLES 16 by using the OS-recommended procedure.

    Example commands may include:

     
     
    zypper refresh
    zypper patch
    zypper install suse-migration-sle16-activation
  2. Reboot the systems after the OS upgrade to SLES 16 completes.

  3. Upgrade to InfoScale 9.2 using the CPI installer from the InfoScale release media (DVD or tarball) for SLES 16.

    This step updates the InfoScale 9.2 SLES 15 RPMs to the corresponding SLES 16 RPMs.

  4. Verify that all InfoScale objects are up and running normally after the upgrade completes.

 

Disk label restore

Use this procedure only if there is a need to revert the disks to their original VTOC state. The examples below assume the backup files were created from /dev/sdc.

1. Restore sectors 0 through 256, including the original VTOC labels and primary PRIVHEAD.

    dd if=/tmp/sdc_head.img of=/dev/sdc bs=512 count=257 conv=notrunc

2. Restore sector 496, including the original alternate PRIVHEAD.

    dd if=/tmp/sdc_altphi.img of=/dev/sdc bs=512 seek=496 count=1 conv=notrunc

3. Restore the last 33 sectors to remove the backup GPT and restore the original end-of-disk data.

   SECTORS=$(blockdev --getsz /dev/sdc)
dd if=/tmp/sdc_tail.img of=/dev/sdc bs=512 seek=$((SECTORS - 33)) count=33 conv=notrunc

4. Instruct the kernel to re-read the partition table.

   blockdev --rereadpt /dev/sdc


5. Scan all the disks:

   vxdisk scandisks

6. Verify that the disk labels are reverted to VTOC using the vxmediadisc utility.

  /etc/vx/diag.d/vxmediadisc -p <disk path such as /dev/sdc>

 

Sample output for disk /dev/sdc; the Partition Table Type parameter displays the disk type as VTOC:

# /etc/vx/diag.d/vxmediadisc -p /dev/sdc
vxmediadisc: Disk /dev/sdc is partitioned.
Partition Table Contents
Revision:                      1
Partition Table Type:          Symantec CDS VTOC
Partition Table OStype:        CDS
Number of partitions:          8
Number of used partitions:     2
Partition Numbers 0 - 1 are Empty
Partition Number 2:
     Partition Entry Type:          Symantec CDS
     Partition Entry Flags:         0x01
     Partition Entry Tag:           0x05 (Backup)
     Partition Entry Start:         0x0000000000000000 (0)
     Partition Entry Size:          0x00000000027ff970 (41941360)
Partition Numbers 3 - 6 are Empty
Partition Number 7:
     Partition Entry Type:          CDS
     Partition Entry Flags:         0x01
     Partition Entry Tag:           0x0f (Private)
     Partition Entry Start:         0x0000000000000000 (0)
     Partition Entry Size:          0x00000000027ff970 (41941360)
vxmediadisc: Media format for /dev/sdc = cdsdisk (VxVM)
vxmediadisc: /dev/sdc generated by = All Supported
vxmediadisc: /dev/sdc is a SCSI disk.
vxmediadisc: Number of sectors:     41943040
vxmediadisc: Sector size:           512
vxmediadisc: Number of disk reads:  1
CDS ID Block Contents
     Magic ID String:               VxVMDISK
     Checksum:                      0x00000A62
     Structure Version:             0x00000002
     Flags:                         0x00000004 (IS_CDS)
     Priv Offset (Sectors):         0x0000000000000100 (256)
VTOC Geometry :
     tracks/cylinder: 16
     sectors/track: 41
     cylinders: 63937
Fabricated Geometry :
     tracks/cylinder: 255
     sectors/track: 189
     cylinders: 870

Issue/Introduction

This article describes how to upgrade from SLES 15 to SLES 16 when InfoScale 9.2 is part of the upgrade path. The key requirement is disk label conversion for systems that use Volume Table of Contents (VTOC) or other non-GPT disk labels.

Important: This procedure is required only for systems with VTOC or non-GPT labeled disks. If all disks are already GPT-labeled, follow the standard major OS upgrade documentation for SLES 15 to SLES 16 and the normal InfoScale upgrade process.