Operating System Upgrade

Running Harmony Controller on CentOS/RHEL 7.4 and 7.5 is deprecated and will be discontinued in the next release. For instructions to upgrade the Operating System with or without internet is provided in the sections below.

Note

When upgrading an older CentOS version to a currently supported version (CentOS 7.9 onwards), Do not make a blanket yum update. In a blanket update, Docker version gets upgraded to 20.x, which is not supported BY Harmony Controller. It is recommended that OS components be upgraded selectively or Docker upgrade is excluded from the OS upgrade.

Upgrade of CentOS/RHEL with Internet

Follow the instructions to upgrade the Operating system (OS) with internet:

  1. Run the following commands:

    $ sudo yum check-update
    $ sudo yum clean all
    
  2. Reboot the machine, once the above commands are executed:

    $ sudo reboot
    
  3. Run the following command, to update CentOS/RHEL to the latest version:

    $ sudo yum update
    
  4. Verify the OS version after upgrade:

    $ cat /etc/redhat-release
    

Upgrade of CentOS/RHEL Without Internet

Follow the instructions to upgrade the Operating system (OS) without internet:

Prerequisites

Procedure

  1. Prior to upgrading the OS version, note down the current OS version. Current version is available in “/etc/redhat-release” file.

  2. Run the following command to check the OS version:

    $ cat /etc/redhat-release
    
  3. Mount the downloaded ISO image using:

    $ sudo mkdir /mnt/iso
    $ sudo mount -o loop <path to iso> /mnt/iso
    
  4. Create the file “/etc/yum.repos.d/repo.repo” with following content:

    [centos7-Server]
    name=CentOS7 Server
    baseurl=file:///mnt/iso
    gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-CentOS-7
    enabled=1
    gpgcheck=1
    
  5. Run following commands to update the CentOS to the latest version:

    $ sudo yum clean all
    $ sudo yum repolist enabled
    $ sudo yum --disablerepo=* --enablerepo=centos7-Server update
    
  6. Verify the OS version after upgrade:

    $ cat /etc/redhat-release
    
  7. After upgrade unmount the ISO image and remove “/etc/yum.repos.d/repo.repo” file using:

    $ sudo umount /mnt/iso
    $ sudo rm -rf /etc/yum.repos.d/repo.repo