cPanel

The sysinfo.config File


Overview

The /var/cpanel/sysinfo.config file stores the server’s system information settings. cPanel & WHM uses this file to determine which RPMs to download during installation and upgrades.

If the detection system fails to correctly identify the distribution or version of Linux, you can manually override those settings.

Warning:

This feature is for advanced users only. Changes that you make to the default configuration may render your server nonfunctional. Exercise caution when you edit this file.

Initial settings

cPanel & WHM runs the /usr/local/cpanel/scripts/gensysinfo script as part of nightly maintenance to automatically generate the sysinfo.config file. The system will not update the file if it is less than a day old.

If the sysinfo.config file does not exist or becomes corrupt, log in to the server via SSH as the root user and run the /usr/local/cpanel/scripts/gensysinfo script to generate a new file.

Keys and default settings

The following table lists the keys that the system stores in the /var/cpanel/sysinfo.config file:

Key Description Possible values Example
ises Whether the OS distribution is an Enterprise system. This is a legacy parameter as of cPanel & WHM version 11.38.
  • 0 — Default value.
  • 1 — The server distribution contains Corporate, Advanced Server, or Enterprise in its name.
  • 2 — The server distribution is CloudLinux™, AlmaLinux, or CentOS.
2
lock A list of RPM and sysinfo.config file keys that you do not want the system to update. A comma-separated list of RPM or sysinfo.config file key names:

  • release
  • rpm_arch
  • rpm_dist
  • rpm_dist_ver
rpm_dist,rpm_arch
release The Linux distribution’s release number. A valid string. 6.6
rpm_arch The OS’s architecture. x86_64 — A 64-bit system. x86_64
rpm_dist The name of the system’s OS distribution.
  • amazon
  • centos
  • rhel
  • cloudlinux
  • almalinux
centos
rpm_dist_ver The system’s OS distribution’s version number.
  • 6
  • 7
  • 8
  • unknown — If the rpm_dist_ver key uses this value, run the /usr/local/cpanel/scripts/gensysinfo script.

The rpm_dist_ver value must match the system’s initial version of the operating system’s distribution.

6

Related Articles

Leave a Reply

Your email address will not be published. Required fields are marked *