Update Preferences

For WHM version 11.30

( Main >> Server Configuration >> Update Preferences)

This feature allows you to define how you wish to update your server's software.

cPanel & WHM Updates

Using this interface, you can select which release tier you wish to use and how you want to handle updates.

You should select a cPanel & WHM tier according to what you value most: stability or new features and update frequency.

Release tier

The cPanel & WHM release tiers are:

Tier Description Publication Frequency
STABLE Has received considerable public exposure, testing, and verification. Published least frequently.
RELEASE Feature-complete and well tested. New installations default to RELEASE. Published more frequently than STABLE.
CURRENT Tested and verified, but may not contain all proposed functionality of a release. Similar to the "release candidate" tier used under other publication schemes. Published more frequently than RELEASE.
EDGE Has received only rudimentary testing. Features are subject to further modification. Usually lacks official public documentation.* Published most frequently (up to several times per week).
Long-term support If you do not wish to update cPanel & WHM, you can set your server to run a designated cPanel & WHM version for as long as we support it. We call these designated versions our "long-term support" versions. Not applicable.

* note Note: Due to the dynamic nature of EDGE builds, you should only use EDGE for compatibility and functionality testing in a controlled environment. This tier is not recommended for production servers.

Daily updates

Next, choose whether you wish for cPanel & WHM to update automatically:

  • Update cPanel & WHM daily — If you select this option, cPanel & WHM will automatically update via cron job, every night at midnight.
  • Do not update cPanel & WHM automatically — If you select this option, in order to update cPanel & WHM, you will need to manually run /usr/local/cpanel/scripts/upcp on the command line, or use this screen.
  • Never allow updates of cPanel & WHM — If you select this option, cPanel & WHM will not update.

note Note: The maintenance portion of /usr/local/cpanel/scripts/upcp will always run as part of the nightly cron job, regardless of the update settings.

cPanel Package Updates

This box defines whether a given software package will update when its update script is run.

note Note: When the cPanel update script (/usr/local/cpanel/scripts/upcp) runs, it runs each package's update script (see the table below for a list of update scripts).

Your options are:

  • Automatic — Select this to automatically update cPanel packages whenever the relevant script runs, or is run by the cPanel update script (/usr/local/cpanel/scripts/upcp).
  • Manual Updates Only — Selecting this setting requires you to manually run the relevant script to update cPanel packages. (This means that packages will not update when /usr/local/cpanel/scripts/upcp runs.)
  • Never Update — If you select this setting, cPanel packages will not update when the relevant script runs.

cPanel packages to update

Selecting Inherit for an option below will assign it the update method selected under cPanel Package Updates above (Automatic, Manual, or Never).

Package Description Update script affected by the setting
bandmin A collection of Perl scripts for logging IP accounting data. /usr/local/cpanel/scripts/bandminup
courier Courier Mail Server, a mail transfer agent (MTA) that provides ESMTP, IMAP, POP3, webmail, and mailing list services. Read more at the Courier homepage. /usr/local/cpanel/scripts/courierup
dovecot An open-source IMAP and POP3 mail server. Read more at the Dovecot homepage. /usr/local/cpanel/scripts/dovecotup
exim A mail transfer agent (MTA) used on Unix-like operating systems. Read more at the Exim homepage. /usr/local/cpanel/scripts/eximup
ftp Pure-FTPd and ProFTPd file transfer protocol (FTP) servers. Read more at the Pure-FTPd and ProFTPd homepages. /usr/local/cpanel/scripts/ftpup
mysql MySQL relational database management software. Read more at the MySQL homepage. /usr/local/cpanel/scripts/mysqlup
nsd Open-source nameserver daemon. Read more at the NSD homepage. /usr/local/cpanel/scripts/nsdup
python A programming language. Read more at the Python homepage. /usr/local/cpanel/scripts/pythonup (This script does not install a package, but installs Python directly from source, into /usr/local/cpanel)

Operating System Package Updates (for Linux servers)

note Note: This setting appears for all servers, but is effective for Linux servers only.

This feature defines how the server will receive updates from its operating system. Essentially, this is the equivalent of running the yum update command. This means that RPMs provided by cPanel are not included with operating system package updates.

  • Automatic — Automatically update operating system packages whenever /usr/local/cpanel/scripts/upcp runs.
  • Manual Updates Only — Requires you to manually run /usr/local/cpanel/scripts/upcp to update operating system packages.
  • Never Update — Operating system packages do not update when /usr/local/cpanel/scripts/upcp runs. If you select this option, you will need to run /usr/local/cpanel/scripts/rpmup2 to update your operating system packages.

FreeBSD Ports Package Updates (for FreeBSD servers)

note Note: This setting appears for FreeBSD servers only.

This feature defines whether the server will use the FreeBSD ports tree for updating the operating system.

  • Enable — Select this setting to install packages from source using the FreeBSD ports tree.
  • Disable — Select this setting to install binary packages that the FreeBSD project distributes.

SpamAssassin® Rules Updates

This feature defines how you would like to update SpamAssassin rules.

note Note: When the cPanel update script (/usr/local/cpanel/scripts/upcp) runs, it updates SpamAssassin by running the SpamAssassin update script (/usr/local/cpanel/scripts/sa-update-wrapper).

  • Automatic — Automatically update SpamAssassin rules whenever /usr/local/cpanel/scripts/upcp runs.
  • Manual Updates Only — Requires you to manually run /usr/local/cpanel/scripts/upcp to update SpamAssassin rules.
  • Never Update — SpamAssassin rules do not update when /usr/local/cpanel/scripts/upcp runs.

For more information about SpamAssassin rules, please visit the SpamAssassin documentation.

Topic revision: r14 - 14 Sep 2011 - 17:43:27 - Main.MelanieSeibert
 

Copyright © cPanel 2000–2011.