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)


Before upgrading static compute resources with integrated storage, you should first check if you have enough memory for the storage upgrade. To do that, run the following command:

/usr/pythoncontroller/python3 ./check_ram_is.cpython-38.pyc
  • If there is enough RAM and you can proceed with upgrade, you will see the following response:

    Cloud is ready to upgrade
  • If there is not enough memory on the storage controller for the upgrade, you will see the following response:
Warning increase RAM for IS Controller 0 at HV 192.168.1.37 at least to 2278 MB

Warning increase RAM for IS Controller 1 at HV 192.168.1.38 at least to 1248 MB

Warning increase RAM for IS Controller 0 at HV 192.168.1.38 at least to 1248 MB

In this case, you should increase the Controller RAM to the number shown in the above script. After doing that you can proceed with the upgrade.


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