Views:

How do I upgrade my vSrot 4.8.0 server to vStor 4.8.1
Summary
The focus of this upgrade to vStor is on the foundational resilience of vStor and other appliances in the Suite and user experience enhancements
One of the major components of the upgrades to the vStor 4.8.1 Appliances is the operating system change. This is a replacement of CentOs 7.9 with Alma Linux 8.5. During this migration process, some additional steps need to be performed to upgrade from previous versions. 
This upgrade to Alma Linux 8.5 will improve the ability to respond more rapidly to any newly discovered vulnerabilities. 
This release also contains a number of new features, updates, and bug fixes. Please see What's New on Catalogic MySupport for more information. 
Should you see any failures during this process or need assistance please contact Catalogic Technical Support
Pre-requisites for the upgrade.

  • DPX 4.8.0
  • For Physical Appliance verify hardware compatibility with RedHat 8.5 by running command "lspci -nn" and use following link to analyze output.
                   https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html/considerations_in_adopting_rhel_9/assembly_hardware-enablement_considerations-in-adopting-rhel-9
  • Ensure there are no jobs running or scheduled to start running during the upgrade process
  • Verify there is sufficient space available on /var and / mount points, there should be at least 4 Gb available on each
  • For a vStor Virtual Appliance
    • Ensure you have taken a snapshot of the appliance via the Hypervisor
    • Check the SCSI controller on the VMware virtual machine and make sure that it is a VMware Paravirtual Controller. This will not be the case if this Appliance has been created with the pre-DPX 4.7.1 release.
      • Steps to change the SCSI Controler on VMware:
        • Reboot the appliance and select the installed 3.x  Kernel from the boot menu via the VMWare Remote Console
        • While the VM is running
          • Right-click on the VM -> Select Edit Settings
          • Select ADD NEW DEVICE, add a SCSI Controller, Select VMware Paravirtual as Type
          • Login to the Appliance using the dpxadmin account
          • Switch to root access using: sudo bash
          • Run the following command to load the driver to the kernelinitramfs

mkinitrd -f -v /boot/initramfs-$(uname -r).img $(uname -r)
Note : Please make sure there is no whitespace at the end of the command

  • Shut down the Right-Click on VM Select Edit VM settings
    • Expand SCSI controller 0
    • Select Change Type and set the type to VMware Paravirtual
    • Power on the VM
      • Select the installed 3.x Kernel from the boot menu via the VMWare Remote Console
      • This should now be ready to perform the upgrade process specified below
  • For Hyper-V appliances please check if this is a Gen 1 appliance, If it is it will need to be converted to Gen 2. Please please contact Catalogic Technical Support for assistance in converting before the upgrade.
Upgrade Process
The upgrade process is a two-step process where the 1st phase of the upgrade is the operating system migration and the second is to upgrade the DPX stack and the DPX core components.
  • Copy the iso and Upgrade Script to a location with more than 10GB of free space
  • Phase 1
    • Reboot the machine and select the installed 3. x  Kernel from the boot menu via the VMWare Remote Console
      • Note: From this point, vStor will not be available
    • Login to the Appliance using the admin account
    • Switch to root access using: sudo bash
    • Go to the location of the script with: cd <script_location>
    • Change the execution bit of the script with: chmod +x <script_name>
    • Execute the os upgrade phase by using the --upgrade-os parameter to the script and the iso
      • ./update_vstor_4.8.1.sh --upgrade-os vstor_with_os_full_4.8.1_physical.iso
      • At this stage, a pre-upgrade check will be performed, and should it fail information will be provided on why it failed and the log file name and location will be provided. If you are not able to resolve these failures Please contact Catalogic Technical Support.
        Once the pre-update checks are complete, the Leapp installer will be installed with an updater kernel.
    • After the script has been completed, the appliance will reboot and complete the OS update.  You can follow this update using the virtual machine console of the hypervisor.
    • Once the OS update is complete a second reboot will take place.
    • After the second reboot you can move on to the second phase of the update.
  • Phase 2
    • Login to the Appliance using the admin account
    • Switch to root access using: sudo bash
    • Go to the location of the script with: cd <script_location>
    • Run the DPX update phase of the script with iso and follow the prompts.
      • ./update_vstor_4.8.1.sh vstor_with_os_full_4.8.1_physical.iso
    • Once the upgrade script completes, the appliance needs to be rebooted.

With this process completed the vStor Appliance is now fully updated to vStor 4.8.1 and backups can be resumed and scheduled normally.

Comments (0)