Knowledgebase

Introduction

The AppConfig system configures cPanel & WHM attributes and registers WHM plugins. Use AppConfig to register WHM plugins or to specify application attributes in cPanel, WHM, or Webmail.

Create AppConfig configuration files to specify each application's configuration settings.

Update AppConfig files for 11.38.1+

The upgrades to the AppConfig system in cPanel & WHM version 11.38.1 require the following changes to AppConfig configuration files:

• cPanel and Webmail applications — Add the features key to the AppConfig file.
• WHM applications — Add the acls key to the AppConfig file.

Optional WHM application updates

To take advantage of the upgrades to the AppConfig system in cPanel & WHM version 11.38.1, perform the following steps:

1. Create an upgrade script.
   • Use the version arguments that the system passes to upgrade scripts to run the script as soon as the server reaches cPanel & WHM version 11.38.1 or higher.
   • Ensure that the script moves your application to its own subdirectory in the  /usr/local/cpanel/whostmgr/docroot/ directory. For example, move the /cgi/addon_securityadvisor.cgi file to the /cgi/addons/securityadvisor/index.cgifile. 
2. Create a new AppConfig configuration file. Set the upgrade script as the upgradecall key's value.

Test application

A test application for cPanel & WHM version 11.38.1 is available on Github:

• https://github.com/CpanelInc/addon_securityadvisor
• https://github.com/CpanelInc/addon_securityadvisor/blob/master/pkg/appconfig/securityadvisor.conf
• https://github.com/CpanelInc/addon_securityadvisor/blob/master/pkg/install
• https://github.com/CpanelInc/addon_securityadvisor/blob/master/pkg/bin/upgrade