Managing Modules

In this version of Plesk, you can extend the functionality of your control panel without upgrade. This can be done by installing additional functional components, available as modules developed by SWsoft, Inc. or third parties.

The modules can be easily installed, removed, and configured directly from the control panel.

The modules come as a single RPM package, a self-extracting shell script, or in any other form suitable to your operating system. If you wish, you can also install the module from the command line. When you install the module on server using the control panel, you are taken to the module’s configuration screen.

Plesk comes shipped with Firewall, VPN, File Server and Counter-Strike Game Server modules.

Installing Modules

The modules are not installed automatically during installation of Plesk; you should install them if needed. You can install a module to the Plesk server in two ways: from the control panel (recommended), and from the command line.

In order to install a module to a Plesk server:

1) Click Manage Modules, then Add Module, then select a module package file, and click OK.

Or

2) Login as root to the server, where Plesk is installed. Run the command /usr/local/psa/admin/bin/modulemng --install --file=<module_filename>.

Example: /usr/local/psa/admin/bin/modulemng --install --file=cs-gs-1.0.0-rh9.build72041021.16.i586.rpm

The modules that come with Plesk are located in the directory /opt/modules in Plesk distribution.

Installing license keys for modules

Some modules might require you to install a license key in order to be able to use them. You can check out the terms of usage on the module manufacturer’s web site, or look them up in the control panel’s Modules management screen: for each module installed there is a corresponding list entry accompanied by an icon, which shows whether license key is required. There are three types of icon that indicate the following:

- the module does not require a license key

- the module requires a license key, and the key is installed

- the module requires a license key, but the key is not installed.

To access the modules management functions, click Manage Modules.

If a module is provided by SWsoft, Inc. and requires a license key, you can obtain it from SWsoft, Inc. using the License Manager function in the control panel.

In other cases, you should obtain the information on installation of license keys for modules from the module provider.

Accessing module configuration

Configuration steps vary depending on each module. Once you install a module on the server using the control panel, you are taken to the module’s configuration screen.

If you installed the module from the command line, you need to configure it via Plesk.

To access the module configuration screen:

1) Click the button labeled with module’s name.

Or

2) Click Manage Modules. In the list of modules, click the module’s name presented as link.

Removing modules

You can remove modules from Plesk in two ways: from the control panel (recommended), and from the command line.

To remove a module using a control panel:

1) Click Manage Modules, then select a checkbox corresponding to the module you wish to remove, and click Remove Selected.

Or

2) Login as root to the server, where Plesk is installed. Run the command /usr/local/psa/admin/bin/modulemng --remove --module=<module_codename>.

Example: /usr/local/psa/admin/bin/modulemng --remove --module=cs-gs

You can look up a module’s codename by running the following command:

# echo "SELECT name, display_name FROM psa.Modules;" | mysql -uadmin –p<admin_password> psa