This article explains how to install JetBackup 5 on RHEL 8, AlmaLinux 8, and CloudLinux 8 servers that do not support the AVX/AVX2 CPU flags.
New JetBackup 5 installations of 5.3.19.3, 5.4.0.4, and 5.4.1.1 may attempt to install the latest jetmongod package, which is based on MongoDB 8.0.24. MongoDB 8 requires AVX CPU support. If the server CPU does not support AVX, the local MongoDB installation may fail during a new installation of JetBackup 5.
I have JetBackup 5 installed on AlmaLinux 8 already. Do I need to do anything?
Existing installations do not need to use this guide as they will not fetch the jetmongod-8.0.24 package automatically with dnf updates, and will continue receiving JetBackup 5 product/software updates until the AlmaLinux 8 End-of-Life date. If you re-install JetBackup 5 on the same server, however, you may need to use this guide.
Symptoms
During a new JetBackup 5 installation, the installation may fail with an error similar to the following:
# cat /usr/local/jetapps/var/log/jetapps/20260611.203035_31546.log
<snipped>
****************************************************************************************
** Your CPU is missing the AVX instruction set flag required for the local jetmongod RPM installation. **
** Please enable AVX support on the CPU, then try again. **
****************************************************************************************
Recommendation:The JetApps installation log can be found under:
/usr/local/jetapps/var/log/jetapps/Cause
This occurs because the server CPU does not support the AVX instruction set required by the newer local jetmongod package.
On AlmaLinux 8-based systems, JetBackup 5 can still be installed with the jetmongod-4.4.X package. The MongoDB 4.4 branch does not require AVX/AVX2 CPU support, allowing JetBackup 5 to run locally on supported RHEL 8-based systems without AVX.
Resolution
If you are installing JetBackup 5 on RHEL 8, AlmaLinux 8, or CloudLinux 8 and encounter the AVX-related error above, install JetBackup 5 using the MongoDB 4.4 package.
Step 1: Install the JetApps Repository
bash <(curl -LSs https://repo.jetlicense.com/static/install)Step 2: Install JetBackup 5 with MongoDB 4.4
dnf install jetbackup5-base jetbackup5-{PANEL} jetmongod-4.4.* --enablerepo=jetapps,jetapps-{TIER}Replace {PANEL} with the correct JetBackup 5 package for your control panel. Additionally, replace jetapps-{TIER} with the proper release tier (release, rc, edge, alpha).
jetbackup5-cpanelfor cPanel/WHMjetbackup5-directadminfor DirectAdminjetbackup5-linuxfor Linux
For example, to install on a cPanel & WHM server from the release tier:
dnf install jetbackup5-base jetbackup5-cpanel jetmongod-4.4.* --enablerepo=jetapps,jetapps-releaseAlternative Option: Self-Hosted Remote MongoDB
If your server is running AlmaLinux 9 or newer or any other supported OS and your CPU does not support AVX/AVX2, the MongoDB 4.4 package cannot be used. Instead, configure JetBackup 5 to use a self-hosted remote MongoDB instance.
You may also use the remote MongoDB option if you prefer to host MongoDB separately from the JetBackup 5 server, even if you have AVX flags available for your CPU.
Please refer to the guide below for more information:
Installing and Configuring a Self-Hosted Remote MongoDB
Summary
- MongoDB 8.0.24 requires AVX CPU support.
- Servers without AVX/AVX2 may fail to install the local
jetmongodpackage during a fresh installation of JetBackup 5 on AlmaLinux 8. - On RHEL 8, AlmaLinux 8, and CloudLinux 8, install JetBackup 5 with
jetmongod-4.4.*to bypass the AVX flag requirement. - On AlmaLinux 9 or newer without AVX/AVX2, use the Self-Hosted Remote MongoDB option instead or enable AVX/AVX2 flags on the CPU.
If you encounter any issues following this guide, please reach out to our Support Technicians via support@jetbackup.com and we'd be happy to assist.
