Page tree
Skip to end of metadata
Go to start of metadata

For cPanel & WHM version 62

(Home >> cPanel >> Manage cPAddons Site Software)

Overview

The Manage cPAddons Site Software interface allows you to upgrade or uninstall individual installations of cPAddon software.

Note:

To configure the cPAddons that you wish to offer to all of your users, use WHM's Install cPAddons Site Software interface (Home >> cPanel >> Install cPAddons Site Software).

cPAddon moderation

If you enable cPAddon moderation, users cannot install or update the specified cPAddons without your approval. To turn on moderation for cPAddons, enable the cPAddons Site Software moderation notification option in WHM's Tweak Settings interface (Home >> Server Configuration >> Tweak Settings)

To specify which cPAddons require moderation, select the checkboxes that correspond to the cPAddons that you wish to moderate and click Update Moderation.

Search for cPAddons

To search for cPAddons, perform the following steps:

  1. Next to Show, select one of the following options to specify the type of cPAddons that you wish to view:
    • All Outdated Installations — WHM displays all out-of-date cPAddon scripts.
    • Orphaned Installations — WHM displays all cPAddons that you cannot upgrade because the link between the cPAddon in WHM and its copy in cPanel is either broken or not upgradable.

      Note:

      Orphaned installations result from any of the following actions:

      • If you remove the cPAddon from the Install cPAddons Site Software interface.
      • If you remove the cPAddon via the file system rather than via cPanel & WHM.
      • If you manually move the /.cpaddons directory to another location.
      • If you make manual revisions to the cPaddon's .yaml file.
      • If you make manual updates to the cPAddon in WHM's Manage cPAddons Site Software interface (Home >> cPanel >> Manage cPAddons Site Software) after you install the cPAddon in cPanel's Site Software interface (Home >> Software >> Site Software).

    • All Installations — WHM displays all installed cPAddons.
  2. Select the user whose cPAddons you wish to view, or select All Users.
  3. Click Manage. WHM then displays each cPAddon that matches your search criteria, along with the user, latest version available, and currently installed version.
  4. Click Currently installed in WHM to use the Install cPAddons interface to view, install, and update the cPAddons that your users can access.

Approve a moderation request and install a cPAddon

The Manage cPAddons Site Software interface displays any pending installation requests at the top of the interface in the Pending Moderation Requests section.

To approve a site software moderation request and install a cPAddon, click the name of the module inside of that section.

Force update outdated cPAddons

To force any outdated cPAddons to update, perform the following steps:

  1. From the second menu, select Upgrade all installs that need it.
  2. Select the user for whom you wish to apply the upgrade. Select All Users to upgrade the installation for all users.
  3. Click Go.

Uninstall deprecated cPAddons

To uninstall deprecated cPAddons, perform the following steps:

  1. From the second menu, select Uninstall All Orphaned Installations.
  2. Select the user for whom you wish to uninstall the cPAddons, or select All Users and click Go.
  3. On the next page, click Yes I am sure I want to do this to confirm that you wish to uninstall the deprecated cPAddons.

cPAddon data after deletion

When you remove a cPAddon, WHM also removes its data.

  • If the cPAddon created the database, and no other cPAddons use it, WHM removes the database entirely. This includes any tables that users created.
  • If the cPAddon that you remove did not create the database, or if another cPAddon currently uses that database, WHM only removes the tables that correspond to that cPAddon. This can lead to an empty database on the server.

We recommend that you delete any other cPAddons that share a database before you delete the cPAddon that initially created the database. If you delete the cPAddon that created the database first, an empty database will remain on the server.

Use cPanel's MySQL Databases interface (Home >> Databases >> MySQL Databases) to manually delete empty cPAddon databases.

Additional documentation