Upgrade Cloud with Integrated Storage Static Servers (from 6.2)

  • To upgrade to 6.3, the MySQL version must be >= 5.6.4. For database migration instructions, refer to Migrate Control Panel Database to MariaDB 10.4.
  • Upgrade can be performed only on IS static compute resources without virtual servers. If any VSs are added to a compute resource, it is necessary to have at least two IS static compute resources to perform the upgrade the following way:
    1. Migrate all VSs from one compute resource to other available compute resource in the compute zone with the required capacity.
    2. Upgrade another compute resource which is now empty.
    3. Migrate VSs from the next compute resource to the upgraded compute resource.
    4. Repeat the process for all remaining compute resources.

This guide explains how to upgrade OnApp Cloud 6.2 to 6.3 for a cloud with Integrated Storage static servers. Follow the procedure listed below in the provided order to upgrade your cloud. All the packages (Control Panel and Integrated Storage Static compute resources) must belong to the same major version to ensure the best performance of your cloud.


Upgrade Control Panel Server


To upgrade the Control Panel server, follow the procedure at Upgrade Guide for Control Panel Server


Upgrade Static Compute Resources with Integrated Storage (CentOS7 KVM only)


To upgrade static compute resources with integrated storage, follow the next procedure:

  1. Download the OnApp YUM repository file:

    # rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-6.3.noarch.rpm
  2. Disable services monitoring (by monit, if used), stop storage controller and libvirt related services:

    # monit unmonitor all
    # /etc/init.d/SANController stop
    # systemctl stop libvirtd
    # /etc/init.d/storageAPI stop


  3. Update system packages (if required):

    # /onapp/onapp-hv-install/onapp-hv-kvm-install.sh -y
  4. Run compute resource installer (to update OnApp, compute resource and Integrated Storage components):

    # /onapp/onapp-hv-install/onapp-hv-kvm-install.sh
  5. Reboot compute resource if it is requested by the installer (on step 3).
  6. If reboot isn’t required, remove the onapp-storage-startup.lock file:

    # rm -f /run/onapp-storage-startup.lock
  7. If reboot isn’t required, run Storage startup script:

    # /onapp/onapp-storage-startup/onapp-storage-startup.sh

Upgrade Backup Server with Integrated Storage (CentOS7 KVM only)



To upgrade backup servers with Integrated Storage, follow the next procedure:

  1. Download the OnApp YUM repository file:

    # rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-6.3.noarch.rpm
  2. Stop storage controller related services:

    # /etc/init.d/SANController stop
    # /etc/init.d/storageAPI stop
  3. Update system packages (if required):

    # /onapp/onapp-bk-install/onapp-bk-install.sh -y
  4. Run Backup Server installer (to update OnApp Backup Server and Integrated Storage components):

    # /onapp/onapp-bk-install/onapp-bk-install.sh
  5. If reboot isn’t required (you are on the recent kernel): remove the onapp-storage-startup.lock file:

    # rm -f /run/onapp-storage-startup.lock
  6. If reboot isn’t required (you are on the recent kernel): run Storage startup script:

    # /onapp/onapp-storage-startup/onapp-storage-startup.sh