Knowledgebase

Applies To

• OS: CentOS Linux 7.9.2009 (EOL)

• Control Panel: cPanel & WHM 11.110+

• Package Manager: yum

• Architecture: x86_64

Summary

On CentOS 7, cPanel updates may fail with the following blocker:

Cannot upgrade to 11.110.x until needed system packages are installed:
boost169-program-options

This error cannot be resolved permanently on CentOS 7 because:

• CentOS 7 is End-of-Life

• Required dependency boost169-program-options does not exist in:

  • CentOS base

  • CentOS Vault

  • EPEL

  • CentOS SCL (Software Collections)

• cPanel no longer supports CentOS 7

• Newer cPanel builds expect dependencies unavailable on EL7

This KB documents:

• How to correctly restore Vault, SCL, and EPEL (archive) repositories

• Why the dependency still cannot be satisfied

• The only supported resolution

Symptoms

• /scripts/upcp fails

• yum reports missing boost169-program-options

• Repositories appear enabled but package cannot be found

• yum list available boost169* returns nothing

Root Cause

1. CentOS 7 is EOL

   • Default mirrors are deprecated

2. cPanel update logic still enforces a legacy dependency name

3. That dependency no longer exists in any EL7 repository

4. Even after restoring all repositories, yum cannot provide the package

Verified by:

yum list available '*boost169*'
repoquery --repoid=centos-sclo-rh --repoid=centos-sclo-sclo -a | grep boost169

➡ No results.

Verified Repository Recovery (Correct Setup)

1. CentOS Base Repositories (Vault)

Create /etc/yum.repos.d/CentOS-Vault.repo:

[base]
name=CentOS-7 - Base
baseurl=http://vault.centos.org/7.9.2009/os/x86_64/
enabled=1
gpgcheck=0

[updates]
name=CentOS-7 - Updates
baseurl=http://vault.centos.org/7.9.2009/updates/x86_64/
enabled=1
gpgcheck=0

[extras]
name=CentOS-7 - Extras
baseurl=http://vault.centos.org/7.9.2009/extras/x86_64/
enabled=1
gpgcheck=0

2. Enable Software Collections (SCL)

Install SCL release packages:

yum install -y centos-release-scl centos-release-scl-rh

/etc/yum.repos.d/CentOS-SCLo-scl-rh.repo

[centos-sclo-rh]
baseurl=http://vault.centos.org/7.9.2009/sclo/$basearch/rh/
enabled=1

/etc/yum.repos.d/CentOS-SCLo-scl.repo

[centos-sclo-sclo]
baseurl=http://vault.centos.org/7.9.2009/sclo/$basearch/sclo/
enabled=1

Disable all mirrorlist= entries.

3. Complete Archived EPEL 7 Configuration (Correct & Safe)

Create /etc/yum.repos.d/epel.repo:

cat > /etc/yum.repos.d/epel.repo <<'EOF'
[epel]
name=Extra Packages for Enterprise Linux 7 - $basearch (archive)
baseurl=https://archives.fedoraproject.org/pub/archive/epel/7/$basearch/
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
metadata_expire=7d
skip_if_unavailable=True

[epel-debuginfo]
name=Extra Packages for Enterprise Linux 7 - $basearch - Debug (archive)
baseurl=https://archives.fedoraproject.org/pub/archive/epel/7/$basearch/debug/
enabled=0
gpgcheck=1
repo_gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
metadata_expire=7d
skip_if_unavailable=True

[epel-source]
name=Extra Packages for Enterprise Linux 7 - Source (archive)
baseurl=https://archives.fedoraproject.org/pub/archive/epel/7/SRPMS/
enabled=0
gpgcheck=1
repo_gpgcheck=0
gpgkey=file:///etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7
metadata_expire=7d
skip_if_unavailable=True
EOF

Import GPG key:

rpm --import /etc/pki/rpm-gpg/RPM-GPG-KEY-EPEL-7

4. Rebuild yum Cache

yum clean all
yum makecache fast
yum repolist

Expected repositories:

• base

• updates

• extras

• centos-sclo-rh

• centos-sclo-sclo

• epel

• EA4-c7

• cpanel-plugins

Critical Finding (Confirmed)

Even with all repositories fully restored and working:

yum install boost169-program-options

Result:

No package boost169-program-options available.

And:

yum list available '*boost169*'

➡ No matching packages

Why?

• boost169-program-options does not exist in any EL7-compatible repo

• cPanel internally ships Boost 1.80 (cpanel-boost-program-options)

• But updater still enforces a legacy system RPM name

Reference Commands Used

cat /etc/redhat-release
yum repolist
yum makecache fast
yum list available '*boost169*'
repoquery --repoid=centos-sclo-rh --repoid=centos-sclo-sclo -a