Child pages
  • Contact Manager
For cPanel & WHM version 74

Skip to end of metadata
Go to start of metadata


(WHM >>  Home >> Server Contacts >> Contact Manager)

Overview

This interface allows you to specify when your server sends notifications for each communication type, and the importance of each type of alert.

Notes:

  • Any modifications to the settings in this interface affect the root user. To modify the contact settings for a reseller, navigate to cPanel's Contact Information interface (cPanel >> Home >> Preferences >> Contact Information).
  • For notifications, your server uses the information that you enter in the Contact Information tab of WHM's Basic WebHost Manager Setup interface (WHM >> Home >> Server Configuration >> Basic WebHost Manager Setup).
  • To modify this information, click Edit, a new interface will appear.
  • For information about how to customize the templates that the system uses to generate these notifications, read our Notification Templates documentation.

Communication Type

To set your alert preferences, perform the following steps:

  1. Use the menus under the Communication Type tab to specify the importance of alerts that you wish to receive for each communication type. 

    • For example, if you only wish to receive email alerts about events that use the High importance level, select High only from the menu next to Email.

    • To disable a communication type, select None.

    • Your server uses the system contact information for notifications. To modify the system contact information, click Edit to navigate to WHM's Basic WebHost Manager Setup interface (WHM >> Home  >> Server Configuration >> Basic WebHost Manager Setup ).
  2. Click Save.

Test a communication type

To test notifications via HipChat™, ICQ, Post to URL, or Pushbullet™, click Test in the appropriate row. The system will send a test notification to the destination for that communication type.

Note:

Your server only displays Test links for active communication types.

Notifications

Click the Notifications tab to list available alert types, the priority with which the system sends each alert, and which communication types will receive each alert. 

  • Select the desired priority for each alert type in the appropriate row. 
  • The interface displays icons that indicate which communication types will receive that particular alert.

The following table describes the events that trigger each type of alert and the template file that the system uses to create the notification:

Alert TypeEvent that triggers your server to generate the alertNotification Template File Locations
Account CreationA system administrator or reseller creates an account.wwwacct/Notify.*.tmpl
Account RemovalA system administrator or reseller removes an account.
  • killacct/Notify.*.tmpl
  • killacct/PostTerminateCleanup.*.tmpl
Account SuspensionsA system administrator or reseller suspends an account.suspendacct/Notify.*.tmpl
Account UnsuspensionsA system administrator or reseller unsuspends an account.unsuspendacct/Notify.*.tmpl
Account Upgrades/DowngradesA user modifies the package for an account, or uses WHM's Upgrade/Downgrade an Account interface (WHM >> Home >> Account Functions >> Upgrade/Downgrade an Account).upacct/Notify.*.tmpl
Altered RPMs CheckThe /usr/local/cpanel/scripts/check_cpanel_rpms script finds altered RPMs.Check/CpanelRPMs.*.tmpl
AppConfig Registration NotificationsThe system registers an application with AppConfig.appconfig/Notify.*.tmpl
AutoSSL cannot request a certificate because all of the website’s domains have failed DCV.AutoSSL cannot request a certificate because all of the website’s domains have failed DCV.AutoSSL/CertificateExpiring.*.tmpl
AutoSSL has deferred normal certificate renewal because a domain on the current certificate has failed DCV.AutoSSL has deferred normal certificate renewal because a domain on the current certificate has failed DCV.AutoSSL/CertificateExpiringCoverage.*.tmpl
AutoSSL has installed a certificate successfully.


AutoSSL installed an SSL certificate.

Note:

This setting only takes effect when the Notify when AutoSSL has renewed a certificate successfully. setting is enabled in WHM’s Manage AutoSSL interface ( WHM >> Home >> SSL/TLS >> Manage AutoSSL ).

AutoSSL/CertificateInstalled.*.tmpl
AutoSSL has renewed a certificate, but the new certificate lacks at least one domain that the previous certificate secured. 

AutoSSL has renewed a certificate, but the new certificate lacks at least one domain that the previous certificate secured.

Note:

This setting only takes effect only when the Notify when AutoSSL has renewed a certificate and the new certificate lacks at least one domain that the previous certificate secured. setting is enabled in WHM’s Manage AutoSSL interface (WHM >> Home >> SSL/TLS >> Manage AutoSSL).

AutoSSL/CertificateInstalledReducedCoverage.*.tmpl
AutoSSL has renewed a certificate, but the new certificate lacks one or more of the website’s domains.AutoSSL has renewed a certificate, but the new certificate lacks one or more of the website’s domains.AutoSSL/CertificateInstalledUncoveredDomains.*.tmpl

AutoSSL will not secure new domains because a domain on the current certificate has failed DCV (Domain Control Validation), and the certificate is not yet in the renewal period.

AutoSSL cannot add any additional domains because domains that fail validation exist on the current certificate.

AutoSSL/CertificateRenewalCoverage.*.tmpl

Backup DelayedThe backup process continued to run after 16 hours.Backup/Delayed.*.tmpl
Backup Failed To FinishThe system failed to finish a backup.Backup/Failure.*.tmpl
Backup FailureAn account experienced a backup failure.AdminBin/FullBackup.*.tmpl
Backup SuccessfulA backup succeeds.Backup/Success.*.tmpl
Backup Transport ErrorA backup encountered transport errors.Backup/Transport.*.tmpl
Bandwidth Data Processing TimeoutThe system timed out while it attempted to process bandwidth data.Logd/Notify.*.tmpl
Bandwidth File Conversion Disk Space FailureThe system does not have enough free disk space to upgrade bandwidth files.installbandwidth/Notify.*.tmpl
Bandwidth LimitsAn account exceeds its bandwidth limit.BandwidthUsageExceeded/Owner.*.tmpl
Branding MigrationThe system migrates a custom branding to the new version.migrate_branding/Notify.*.tmpl
Cgiemail Cleanup ScriptThe system ran the /usr/local/cpanel/scripts/clean_cgiemail script. This script removes the cgiemail RPM and copies of the cgiemail/cgiecho scripts from users' cgi-bin directories.CleanCgiemal/Notify.*.html
ClamAV Upgrade ChangesThe system sends a reminder that it now upgrades ClamAV via the RPM system.Install/ClamavConnector.*.tmpl
CloudLinux License Detected

The system detects a CloudLinux license and provides installation instructions.

CloudLinux/Update.*.tmpl
Conversion of cpupdate.conf settings to local.versionsThe system converted settings in the cpupdate.conf file to settings in the local.versions file.RPMVersions/Notify.*.tmpl
Conversion of cpupdate.conf Settings to local.versions (legacy notification)The system converted settings in the cpupdate.conf file to settings in the local.versions file.RPMVersions/Notify.*.tmpl
Convert Addon Domain to Account NotificationsA system administrator or reseller converts an addon domain into an account.ConvertAddon/ConversionCompleted.*.tmpl
Corrupt Database TablesThe /scripts/check_mysql script found corrupted database tables.

Check/MySQL.*.tmpl

cPanel & WHM End of Life NoticeThe cPanel & WHM version that exists on the server will reach its End Of Life soon.Update/EndOfLife.*.tmpl
cPanel Account PasswordA user changed their password.ChangePassword/User.*.tmpl
cPanel Backup

WHM generates a backup.

Note:

This event does not apply to cPanel account backups that a cPanel user generates.

Backup/Success.*.tmpl
cPanel Backup (legacy notification)

WHM generates a legacy backup.

Note:

This event does not apply to cPanel account backups that a cPanel user generates.

Backup/Success.*.tmpl
cPanel Backup Destination DisabledA user disables a backup destination.Backup/Disabled.*.tmpl
cPanel Backup Destination Disabled (legacy notification)
A user disables a legacy backup destination.Backup/Disabled.*.tmpl
cPanel Configuration ChecksThe system cannot find the /var/cpanel/cpanel.config file, and also cannot find the cpanel.config.cache file.Config/CpConfGuard.*.tmpl
cPanel Update FailuresThe cPanel & WHM system fails to update.upcp/UpdateNowFailed.*.tmpl 
cPHulk Configuration IssuescPHulk experiences configuration issues.cPHulk/FixcPHulkConf.*.tmpl 
cPHulk Database Integrity NoticescPHulk detects database corruption issues.Install/CheckcPHulkDB.*.tmpl
cPHulkd Brute Force cPHulk detects a brute force attempt. cPHulk/ BruteForce.*.tmpl  
cPHulkd Login Notifications

The system detects a login with the root account.

Note:

This option is not available if cPHulk is disabled.


cPHulk/Login.*.tmpl
cPHulkd Notifications

cPHulk generates an alert. cPHulk is cPanel & WHM's brute force protection feature.

Note:

The system sends a notice only once in a 24-hour window for a specific username, service, and IP address combination.

cPHulk/Login.*.tmpl
Database Deprecation Notifications

The system detects that it no longer needs several MySQL® databases which cPanel & WHM previously used.

Install/DatabaseDeprecations.*.tmpl
dbindex Cache File Out Of DateThe dbindex cache file is out-of-date by more than four hours.dbindex/Warn.*.tmpl
Digest Authentication Disabled Due to Account Rename

An account's domain name changed, so the system notifies the system administrator that it has disabled Digest Authentication.

DigestAuth/Disable.*.tmpl
Disk Integrity CheckThe system checks the integrity of a hard disk.Check/Smart.*.tmpl
Disk Usage WarningsDisk usage notifications.chksrvd/Diskusage.*.tmpl
DNS Cluster ErrorThe system encountered an error with the DNS Cluster.DNSAdmin/ClusterError.*.tmpl
DNS Resolver Performance IssuesThe server's DNS resolvers respond slowly or do not respond at all.Check/Resolvers.*.tmpl
EasyApache 4 conflict removedEasyApache 4 attempted to resolve a package conflict.EasyApache/EA4_ConflictRemove.*.tmpl
EasyApache 4 template updatedThe system detects an updated EasyApache 4 template.EasyApache/EA4_TemplateCheckUpdated.*.tmpl
EasyApache Configuration EasyApache 4 encountered a missing handler.EasyApache/EA4_LangHandlerMissing.*.tmpl
Email Client ConfigurationSend the mail client configuration file to a new mail user.Mail/ClientConfig.*.tmpl
Exim Update FailuresExim failed to update.Check/EximConfig.*.tmpl
Filesystem Quotas ReadyThe system successfully finished the process to enable filesystem quotas.Quota/SetupComplete.*.tmpl
Forced Disable of Digest AuthA user or the system disables the Web Disk Digest Authentication feature.Accounts/DigestAuthResetNeeded*.tmpl
Generic NotificationsAny event that generates an alert and does not appear this list.


Greylist System ChangesAn administrator or the system removed a mail provider from the Greylisting Common Mail Providers list.Greylist/CommonProviderRemoval.html.tmpl
Horde Maintenance NotificationsAn error occurred during Horde database maintenance.Install/Horde.*.tmpl
Horde Table Conversion FailureThe system failed to convert the Horde database to SQLite.Horde/MySQLToSQLite.*.tmpl
Hostname Change NotificationsThe system launched a background task to update the hostname in individual Horde databases.DAV/ChangeHostname.*.tmpl
Hostname conflicts with a cPanel user accountThe server's hostname is identical to a cPanel user account's site.Check/HostnameOwnedByUser.*.tmpl
Hung Service ChecksThe system detected a hung device and restarted it.chksrvd/Hang.*.tmpl
Installation of purchased SSL certificatesThe system installed SSL certificates that a user purchased through the cPanel Market.Market/SSLWebInstall.*.tmpl
Instant Message FailureThe system failed to send a notification via an instant message.iContact/SendIMFailed.*.tmpl
Invalid DomainsThe system detects invalid domains.Check/InvalidDomains.*.tmpl
Invalid Hostname For Main IP AddressThe system cannot resolve the hostname to the correct IP address.

Check/ValidServerHostname.*.tmpl

IP Address DNS CheckThe system runs the /usr/local/cpanel/scripts/ipcheck script.

Check/IP.*.tmpl

Kernel Crash CheckThe system finds specific errors in the output of the dmesg command.Check/Oops.*.tmpl
Large Amount of Outbound Email DetectedA mail user exceeded the preconfigured threshold of 500 unique outbound messages (excludes mailing lists).Mail/SpammersDetected.*.tmpl
Lost Contact With DNS ClusterThe system could not contact a server in the DNS Cluster.DNSAdmin/UnreachablePeer.*.tmpl
Mail Server Out of MemoryThe mail server ran out of memory while it processed mail for an account.MailServer/OOM.*.tmpl
Maximum Hourly Emails ExceededA domain exceeded the threshold for the maximum number of sent emails in an hour.Mail/HourlyLimitExceeded.*.tmpl
MyDNS Zone Import Failure

The system fails to import zone files into the MyDNS database.

ImportMyDNSdb/Failure.*.tmpl
MyDNS Zone Import In Progress

An import of zone files into the MyDNS database is in progress.

ImportMyDNSdb/InProgress.*.tmpl
MyDNS Zone Import Successful

The system successfully imported zone files into the MyDNS database.

ImportMyDNSdb/Success.*.tmpl
Notices concerning goods and services purchased via the cPanel MarketA user purchases an SSL certificate or other product through the cPanel Market.SSLWebInstall.*.tmpl
Notification of New Addon DomainsA user creates an addon domain.parkadmin/Notify.*.tmpl
Notification of Outdated Software

The system detected outdated software.

Note:

These notifications are for applications on your server. You can control notices for cPanel & WHM updates with the System Update Failures and Update Failures settings.

OutdatedSoftware/Notify.*.tmpl
NSD DNS Zones Corrupted

The system detected corrupt DNS zones.

NSD/BadZones.*.tmpl
Outgoing Email Threshold ExceededA domain exceeds the daily emails sent threshold defined by the Number of emails a domain may send per day before the system sends a notification. option in WHM's Tweak Settings interface (WHM >> Home >> Server Configuration >> Tweak Settings).Mail/SendLimitExceeded.*.tmpl
Package Extension Name ConflictsThe system renames a package extension and updates all dependent package extensions to use the new filename due to a name conflict.Install/PackageExtension.*.tmpl
POP before SMTP enabledThe system found that POP Before SMTP is enabled, which is a security risk.Check/PopBeforeSMTPEnabled.*.tmpl
queueprocd Critical ErrorsThe Queue Processor daemon shut down because of repeated critical errors.queueprocd/Notify.*.tmpl
Reboot To Enable Filesystem Quotas ReminderThe system requires a reboot in order to enable filesystem quotas.Quota/RebootRequired.*.tmpl
Remote MySQL Connection Failure

The system encountered a remote MySQL connection issue.

Check/MysqlConnection.*.tmpl
Remote MySQL Server NotificationsThe remote MySQL server detects database tables that you must repair.Check/MySQL.*.tmpl  
Root Compromise ChecksThe system detects that your server's root account is compromised.Check/Hack.*.tmpl
Scheduled Backup Will Start SoonThe system sends this notification before it runs a backup.Backup/PreBackupNotice.*.tmpl
Script Terminated Due to Deprecated CallThe system performed a deprecated call within a script and terminated the script.Logger/Notify.*.tmpl
Security Advisor State Change

WHM's Security Advisor feature (WHM >> Home >> Security Center >> Security Advisor) detected new issues with high importance.

Check/SecurityAdvisorStateChange.*.tmpl

Service failures (ChkServd)cPanel & WHM detects that a service has failed, recovered, or timed out.chksrvd/Notify.*.tmpl
Service SSL Certificate ExpirationA service-level SSL certificate has expired. For more information, read our Manage Service SSL Certificates documentation.Check/SSLCertExpired.*.tmpl
Service SSL Certificate Expires SoonA service-level SSL certificate expires soon. For more information, read our Manage Service SSL Certificates documentation.Check/SSLCertExpiresSoon.*.tmpl
SSHD Configuration ErrorThe system detects an attempt to change the sshd_config file.SSHD/ConfigError.*.tmpl
SSL certificates expiringAn account's SSL certificate expires soon. For more information, read our SSL TLS Wizard documentation.AutoSSL/CertificateExpiring.*.tmpl
Stalled Process NotificationsA user's process stalled.OverLoad/CpuWatch.*.tmpl
Stalled Statistics and Bandwidth Process NotificationsA process stalled while it processed a user's statistics and bandwidth data.OverLoad/LogRunner.*.tmpl
Stats and Bandwidth Processing ErrorsA process experiened an error while it processed a user's statistics and bandwidth data.Stats/Lagging.*.tmpl
Stuck ScriptThe system detects a stuck script.StuckScript/Notify.*.tmpl
System Log Approaches 2GB

A log file currently approaches 2 GB in size.

Note:

To automatically rotate log files at the end of each month, use WHM's Log Rotation feature (WHM >> Home >> Service Configuration >> Apache Configuration).

Check/Biglog.*.tmpl
System Out Of MemoryThe system terminated a process to avoid a crash due to low memory.chkservd/OOM.*.tmpl
System Update FailuresThe system fails to update.upcp/UpdateNowFailed.*.tmpl
Uncategorized Notifications
A notification that an existing notification type and template does not already handle.Application/base.*.tmpl
Unmonitored ServicesEvery two weeks, the system scans all active services and sends a notification that lists all of the unmonitored services.Check/UnmonitoredEnabledServices.*.tmpl
Update Blocker - Service Deprecation NoticeThe cPanel & WHM update failed because of a deprecated service.Update/ServiceDeprecated.*.tmpl
Update Blocker - System Cannot Install RPMsThe system detected an unstable RPM database and cannot install any RPMs, so the upcp script cannot proceed.Update/CantInstallRPMs.*.tmpl
Update Failure Due to Immutable Files

The system cannot update cPanel & WHM due to immutable files.

Check/ImmutableFiles.*.tmpl
Update FailuresUpdate failure notifications.Update/Now.*.tmpl
Update Version Blocker

The system fails to update because of an upgrade version blocker.

Update/Blocker.*.tmpl
Upgrade Required - Service Is OutdatedThe system will automatically upgrade a service.Update/UpgradeRequired.*.tmpl
User Disabled Two-Factor AuthenticationA user disabled two-factor authentication.

TwoFactorAuth/UserDisable.*.tmpl

User Disk Usage WarningUsers approach or reach their disk quota limits.
  • Quota/DiskWarning.*.tmpl
  • Quota/List.*.tmpl
User Enabled Two-Factor AuthenticationA user enabled two-factor authentication.

TwoFactorAuth/UserEnable.*.tmpl

User Theme UpdateThe upgrade to cPanel & WHM version 54 updated users from the x3 or x3mail themes to the Retro style for the Paper Lantern theme.PaperLantern/UpdateUsers.*.tmpl

Additional documentation