How Do I Perform an In-Place Upgrade from the Latest RHEL 6 to the Latest RHEL 7?
Red Hat Enterprise Linux 7 (RHEL 7) is the first major release of RHEL to allow in-place upgrades from the previous major RHEL release (RHEL 6). An in-place upgrade offers a way of upgrading a system to a new major release of RHEL by replacing the existing operating system. The following guide will lead you through the process of upgrading package-based Enterprise Agent's underlying RHEL 6 operating system to RHEL version 7.
ThousandEyes followed the above Red Hat guide and successfully performed the Enterprise Agent upgrade. At the time of the upgrade, a ThousandEyes Enterprise Agent installed on RHEL 6.10 x86_64 Server Edition Virtual Machine (VMware) was upgraded to RHEL 7.6 x86_64 Server Edition.
Depending on your Enterprise Agent's hardware performance, the whole process could take more or less than an hour; plan your maintenance window accordingly. Your Enterprise Agent won't perform any tests during the upgrade.
Depending on your Enterprise Agent's software custom configurations, additional steps may be required to restore those custom configurations. Carefully analyze the generated preupgrade report.
The following guide assumes that no custom configurations took place on your Enterprise Agent's Operating System.
64-Bit Operating Systems Only
Upgrading from RHEL 6 Server Edition to RHEL 7 Server Edition is supported for x86_64 architecture (64 bit), but not for x86 architecture (32 bit). The support is assured by your contract with Redhat, not by ThousandEyes.
If your Enterprise Agent is running RHEL 6 x86 architecture, you should consider replacing it with a clean installation of RHEL 7 Server Edition x86_64 architecture.
Upgrading Not Supported on Hyper-V (and Possibly Others)
Red Hat states that only KVM and VMWare virtualization platforms are supported for in-place upgrades. Hyper-V is an example of an unsupported platform.
All the commands below should be run as root. To reduce the content repetition, all "sudo" command prefixes have been removed and the whole guide assumes that you are running each command in a root shell.
To reach the root shell, use the following command:
$ sudo -s
1. Prepare for the Upgrade
1.1 Create a Virtual Machine Snapshot
If you have the possibility of creating a backup snapshot of your virtual machine, we encourage you to do so. This will enable you to revert to the known-good state in case the upgrade does not go as smoothly as anticipated.
1.2 Check That Your Subscription to RHEL Repositories Is Valid and Active
If the "-b" switch was used to install the BrowserBot component in the step above, enable the te-browserbot service. The upgrade process does not handle this task transparently.
# systemctl enable te-browserbot
If you skip this step, the BrowserBot service will not start automatically on the next reboot.
3.4 Enable Tim Synchronization
If you had previously installed the ntpd service, make sure the service is enabled and started. If you didn't have the ntpd service installed before the upgrade, we recommend you install it by running the following command: yum install ntp.
# systemctl enable ntpd
# systemctl start ntpd
3.5 Upgrade to the Latest Point Release
The major version upgrade may not have upgraded your operating system to the latest point release. It is recommended to follow Red Hat's point releases.
# yum update -y
3.6 (Optional) Resolve Any Remaining Issues Reported in Step 1.5
If the report generated by the pre-upgrade tool identified any potential issues, now is a good time to resolve them.
Troubleshooting Upgrade Issues
When the upgrade does not seem to be going as planned, the following suggestions outline basic troubleshooting activities. If you cannot figure out what is causing the issue, reach out to [email protected] and we'll help you out.
Problems with te-agent and te-browserbot Package Installation
The first thing to do if the agent software installation fails is the inspection of the installation logs. Use the following command to do so:
# cat /tmp/install_thousandeyes*.log
The Agent Does Not Show Up as Online in the Platform
Inspect the agent logs with the following command:
# tail -f /var/log/te-agent.log
The Agent Does Not Automatically Upgrade to the Latest Version
Are you subscribed to Red Hat? Is your subscription valid?
Check your subscription with the following command:
# subscription-manager list
The following resources provide related information: