Upgrade Guide for Cloud with Static Servers (5.5 to 6.0)

This guide explains how to upgrade OnApp Cloud 5.5 to 6.0 for the cloud where all servers are static. Follow the procedure listed below in the correct order to upgrade your cloud. All the packages (Control Panel and Compute resources) must belong to the same major version to ensure the best performance of your cloud.

If you do not complete an upgrade procedure, you may face issues with standard functions such as VS creation, VS migration etc.

Upgrade Control Panel Server


Follow the procedure at Upgrade Guide (5.5 to 6.0) to upgrade your Control Panel server. 


Upgrade Static Compute Resources


At first upgrade your static compute resources.

  1. Make sure your compute resource is visible and online in the Control Panel.

  2. If you have CentOS 7 Xen resources, remove the centos-release-xen-46 package: 

    bash# rpm -e centos-release-xen-46
  3. Download and install the latest OnApp YUM repository file:

    bash# rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-6.0.noarch.rpm
  4. Upgrade OnApp compute resource installer package:

    bash# yum update onapp-hv-install
  5. If required, update your server OS components using the corresponding installer (Xen or KVM) with the '-y' parameter given:

    Xen installer example

    bash# /onapp/onapp-hv-install/onapp-hv-xen-install.sh -y

    KVM installer example

    bash# /onapp/onapp-hv-install/onapp-hv-kvm-install.sh -y
  6. Run the OnApp compute resource installer script, depending on the compute resource: 

    • Run the OnApp compute resource installer script for Xen compute resources:

      bash# /onapp/onapp-hv-install/onapp-hv-xen-install.sh 

      The full list of Xen installer options: 

      Usage: 

      /onapp/onapp-hv-install/onapp-hv-xen-install.sh [-c CONFIG_FILE] [-v HV_VERSION] [-p API_VERSION] [-a] [-y] [-t] [-s] [-x] [-h]

      Where:

      -c CONFIG_FILE
      Custom installer configuration file. Otherwise, the pre-installed one is used.
      -v HV_VERSION
      Custom compute resource Tools version
      -p API_VERSION
      Custom StorageAPI version
      -a
      Do NOT be interactive. Process with automatic installation.
      -y
      Update OS packages (except for OnApp provided) with 'yum update'.
      -t

      Initiate Recovery templates and ISO(s), which are used to provision FreeBSD guests, download. The download is initiated if the '-a' option is used.

      -s
      Skip packages management: install, remove, upgrade. None of the packages are installed/updated/removed.
      - x

      Skip xen*, kernel*, and libvirt* (compute resource related RPM) packages management. Useful for update (not for fresh install).

      -h
      Print this info



    • Run the OnApp compute resource installer script for KVM compute resources:

      bash# /onapp/onapp-hv-install/onapp-hv-kvm-install.sh 

      The full list of KVM installer options: 

      Usage: 

      /onapp/onapp-hv-install/onapp-hv-kvm-install.sh [-c CONFIG_FILE] [-a] [-y] [-t] [-s] [-x] [-v HV_VERSION] [-p API_VERSION] [-h]

      Where:

      -c CONFIG_FILE
      Custom installer configuration file. Otherwise, the pre-installed one is used.
      -a
      Do NOT be interactive. Process with automatic installation.
      -v HV_VERSION
      Custom compute resource Tools version
      -p API_VERSION
      Custom StorageAPI version
      -t

      Initiate Recovery templates and ISO(s), which are used to provision FreeBSD guests, download. The download is initiated if the '-a' option is used.

      -y
      Update OS packages (except those provided by OnApp for a compute resource) with 'yum update'. Useful for update (not for fresh install).
      -s
      Skip packages management: install, remove, upgrade. Useful for update (not for fresh install).
      - x

      Skip kvm, kernel, and libvirt (compute resource related RPM) packages management. Useful for update (not for fresh install).

      -h
      Print this info



  7. Reboot static compute resources.

    For KVM compute resources only: the kernel package update is a part of the "Upgrade Static Compute Resources" default procedure. If the kernel package was upgraded, reboot KVM compute resources to use the new kernel package.

    If you do not have the /home/mq/onapp/messaging/credentials.yml file on your compute resources and you plan to deploy an Accelerator, run the following command on the CP server:

    • For all compute resources:

      rake hypervisor:messaging:configure
    • For certain compute resources only:

      rake hypervisor:messaging:configure['11.0.50.111 11.0.50.112']

      For information on manual configuration for Accelerator, refer to RabbitMQ Configuration for Accelerator. To perform the configuration for a number of compute resources, separate their IPs with a space.


Upgrade Static Backup Servers



  1. To upgrade your static backups servers, download and install the latest OnApp YUM repository file:

    bash# rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-6.0.noarch.rpm
  2. Update the package:

    bash# yum update onapp-bk-install
  3. If required, update your server OS components using installer with the '-y' parameter given:

    bash# /onapp/onapp-bk-install/onapp-bk-install.sh -y
  4. Run the installer. It is recommended to download Base, Load Balancer, and CDN templates while running the installer. You may rerun the installer later with the -t option.

    bash# sh /onapp/onapp-bk-install/onapp-bk-install.sh 

    The full list of installer options:

    Usage:

    /onapp/onapp-bk-install/onapp-bk-install.sh [-c CONFIG_FILE] [-a] [-y] [-t] [-b] [-v BK_VERSION] [-p API_VERSION] [-h]

    Where: 

    -c CONFIG_FILE 

    Custom installer configuration file. Otherwise, the pre-installed one is used.

    -a 

    Do NOT be interactive. Process with automatic installation.

    - v BK_VERSION Custom backup tools version
    - p API_VERSION Custom StorageAPI version
    -y 

    Update OS packages (except for the ones provided by OnApp) with 'yum update'.

    - t

    Initiate the Load Balancer Virtual Appliance, OnApp CDN Appliance, and Application Server Appliance templates download. The download is initiated if the '-a' option is used.

    - b Initiate the Base templates download
    -h 

    Print this info