Important Notes
Make sure no Control Panel files are open for editing under the root user account. We strongly recommend that you test all your custom scripts before upgrading your production environment. Be aware that OnApp does not support UEFI on static compute resources. You should disable UEFI on your compute resources before installing OnApp. If you are using WHMCS modules for OnApp, it is not recommended to update your cloud to the latest release. To ensure that all WHMCS modules are working correctly you need to be running an LTS OnApp version.
Check Your Cloud Configuration
Starting with OnApp 5.4, networks are made up of sub-networks called IP nets which contain ranges of IP addresses. To make your system compatible with the new networking scheme, a rake task will run with the installer. The rake task will modify your networks to contain IP ranges and IP nets. If a network contains two or more consecutive IP addresses of the same range of addresses, they will be united into one IP range. Individual IPs will each constitute an IP range. For each of the IP ranges an IP net will be added to the network. If at least one conflict is found in the configuration, the cloud will not be updated. If your cloud configuration is correct, the CP installer will be run and your networks will be modified to include IP nets and IP ranges. Prior to the update procedure, it is required to check your cloud configuration. The cloud should comply with the following requirements for a successful upgrade: If one or several of the IP address you've added to the cloud do not correspond with their prefix, the system will offer to switch on the force option. When the force option is enabled, the system will automatically change the IP address to correspond with their prefix. For example, if you've had a 198.168.0.1/255.255.0.0 IP address with 8 as its prefix, the system will change the address to 198.168.0.1/255.0.0.0. If any inconsistencies are detected in your system, the update procedure will stop and the networks will undergo no changes. In such a case, you need to address the issues that have been found and run the CP installer again. If it is not possible to fix the cloud configuration, please, contact our support team. If the configuration of the cloud meets the requirements listed above, the update to OnApp 5.4 will go smoothly, and all networks will be modified to include IP nets and IP ranges. When you run the Control Panel installer the system will check your configuration. You can view the log at log/ip_consistency_check.log. If any inconsistencies are found, the log might contain any of the following warning messages:
At first upgrade your static compute resources. Download and install the latest OnApp YUM repository file: Install the pv utility package: (for CentSO 7.x only) Install psmisc package: Update storageAPI: When upgrading from OnApp 5.3 to 5.4 it is not required to upgrade static backup servers.Upgrade Static Compute Resources
# rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-5.4.noarch.rpm
# yum install pv
# yum install psmisc
# yum update onapp-storageAPI
Upgrade Control Panel Server
To upgrade your Control Panel server: Download and install the latest OnApp YUM repository file: Upgrade OnApp Control Panel installer package: Update your server OS components (if required): (Optional) If you need some custom Control Panel configuration, set the values before the installer script runs. Run Control Panel installer: You may wish to reboot your Control Panel server to take advantage of a new kernel if it is installed. It is not required immediately as a part of the upgrade process though.# rpm -Uvh http://rpm.repo.onapp.com/repo/onapp-repo-5.4.noarch.rpm
# yum update onapp-cp-install
# /onapp/onapp-cp-install/onapp-cp-install.sh -y
# vi /onapp/onapp-cp.conf
# /onapp/onapp-cp-install/onapp-cp-install.sh
If you face the problem with viewing the maps on VS/Smart/Application server creation wizard (Locations step), refer to the Add Google Map API Key document.
Getting support for your upgrade
You can use the information in this document to perform your own upgrade to the 5.4 version of the OnApp Cloud. However, if you have a full OnApp Cloud license, you are entitled to free upgrade support from the OnApp Support team.
If you would prefer to have the Support team perform the upgrade for you, just raise a ticket in the normal way. Please be aware, however, that there may be a queue! For help with your upgrade, visit the OnApp community forum: http://forum.onapp.com.