How to Upload an Installation Package to AV Repository

Adding an installation package to AV Repository implies uploading the files and folders of this package to the /cgitory folder and registering the new installation package in AV Repository. This can be done via Plesk Control Panel or by other means not related to Plesk, e.g. via CLI provided by Unix-specific utilities. Uploading an installation package to AV Repository is fully automated if Plesk Administrator decides in favor of Plesk Control Panel, so this approach is recommended.

No matter which way is chosen to upload a web application's installation package, the first thing to do is to create an RPM/SH/DEB distribution package and to locate it anywhere, either locally or in the network, so that is can be accessed during the upload procedure. The detailed description of how to create an installation package and wrap it into a distribution package can be seen in the How to Build an Installation Package tutorial of this documentation.

Uploading an installation package via Plesk Control Panel

1. In Plesk Control Panel, click on the Server tab in the navigation pane and get to the Server Administration page.
2. In the Services section of this page, open the Application Vault tool by clicking on the relevant icon. You will get to the Application Vault page.
3. In the Tools section, click on the Add New Application Package button. You will get to the Add new site application package page.
4. Click the Browse button and select an RPM/SH/DEB package you wish to upload to Plesk.

Once this is done, the RPM/SH/DEB package is uploaded to the web server, and the selected RPM/SH/DEB package extracts itself to the application folder specially created within the AV Repository (<plesk_root_dir>/var/cgitory).

Note: If an installation package wrapped by the selected RPM/SH/DEB package has been formed incorrectly (the rules of building its file and folder structure have been violated, or the info.xml file contains some wrong information, etc.), then Plesk will fail to register the unpacked installation package in Plesk database. It will display an error message instead, and the upload will be rolled back.

If the upload has passed through all its steps successfully, Plesk Control Panel will update the Application Vault page and the new installation package will be displayed in the list of installation packages at the bottom of the page.

Uploading an installation package via Command Line Interface

The other way to upload an installation package to Plesk is to use the SSH utility that ships with UNIX. This feature is supported to allow the upload of installation packages by programmatic means.

1. Copy the source RPM/SH/DEB package to any directory located on the web server running Plesk.
2. From SSH console, set 'read/write/execute' permissions for this RPM/SH/DEB file using the following command (the example shows how to do this for the SH file named package.sh):
3. Chmod 755 package.sh
4. From SSH console, trigger the package to start (the example demonstrates this command for files package.sh, package.rpm, and package.deb, respectively):

./package.sh

rpm -Uhv package.rpm

dpkg -i package.deb

After the package has extracted its contents to AV Repository, the package is still unregistered in Plesk database. To register it, click on the Refresh button located on the Application Vault page (Server->Application Vault). Once this is done, the Application Vault page is updated and the new installation package is displayed in the list of installation packages at the bottom of the page.