Upgrade Cloud with Static Servers (6.0 to 6.1)

This guide explains how to upgrade OnApp Cloud 6.0 to 6.1 for a cloud with static servers. Follow the procedure listed below in the provided order to upgrade your cloud. All the packages (Control Panel and 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


To upgrade static compute resources, follow the next procedure:

  1. Make sure your compute resource is visible and online on the Control Panel.
  2. To update from 6.0 version, download and install the latest OnApp YUM repository file:

    # rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-6.1.noarch.rpm
  3. Upgrade OnApp compute resource installer package:

    # yum update onapp-hv-install
  4. Update your server OS components: 

    For Xen compute resources

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

    For KVM compute resources

    # /onapp/onapp-hv-install/onapp-hv-kvm-install.sh -y
  5. Run the compute resource installer:

    For Xen compute resource:

    # /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).

    For KVM compute resource:

    # /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).

    -dInstall OnApp Storage related packages. Applicable for CentOS 7.x only
    -h
    Print this info

    Please, answer ‘yes’ when installer prompts to initiate images, templates, and ISOs download. 

  6. Reboot static compute resources.

    The kernel and Xen packages update is a part of the "Upgrade Static Compute Resources" default procedure. If the kernel or Xen packages were upgraded, reboot KVM/Xen compute resources to use the new kernel and/or Xen packages.

    If you do not have the /home/mq/onapp/messaging/credentials.yml file on your compute resources and you plan to deploy 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


To upgrade static compute resources, follow the next procedure:

  1. To update from 6.0 version, download and install the latest OnApp YUM repository file:

    # rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-6.1.noarch.rpm



  2. Upgrade OnApp Backup Server installer package:

    # yum update onapp-bk-install
  3. Update your server OS components:

    # /onapp/onapp-bk-install/onapp-bk-install.sh -y
  4. Run Backup Server installer:

    # /onapp/onapp-bk-install/onapp-bk-install.sh
     The full list of Backup Server installer options.

    Usage: 

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

    Where:

    -c CONFIG_FILE
    Custom installer configuration file. Otherwise, the pre-installed one is used.
    -v BK_VERSION
    Custom Backup 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 Load Balancer Virtual Appliance, OnApp CDN Appliance and Application Server Appliance templates download. The download is initiated if '-a' option is used.

    -bInitiate Base templates download
    -dInstall OnApp Storage related packages. Applicable for CentOS 7.x only.
    -hPrint this info