application_help PDF Print E-mail
Written by sa_admin   
Friday, 15 January 2010 18:45

How to Deploy an Application to a Domain

The contents of AV Repository is visible both on the server-side level (to Plesk Administrator) and on the level of a domain (to Domain User). Both these users are allowed to install applications from AV Repository on the domain side: Plesk Administrator can do it on any domain located on the server, while Domain User can do it on his own domain only.

If you are a Domain User, proceed through the following steps:

  1. On the navigation pane located at the left-hand area of Plesk Control Panel, choose the Home link.
  2. In the Hosting section of the Domain page, click on the Application Vault tool. You will get to the Installed applications page. At the bottom, this page will display the list of web applications installed on the domain (if there is not an application installed, the list is empty).
  3. In the Tools section of this page, click on the Add New Application button. You will get to AV Repository (the Installation: select an application to be installed page).

    Note: The same page is accessible directly from Desktop (Plesk Control Panel -> Desktop->Tools section->Install a site application button).

  4. If AV Repository is not empty, the Installation: � page will display the list of installation packages that can be deployed on the domain side. Check the application you wish to install on your domain and click the install button located in the right upper corner of the list. You will get to the Site application installation page where you need to specify your preferences for this application. Of special importance are two of these settings.
  5. In the Installation preferences section of this page, choose Install application to "/https" virtual host if you wish this application to run in the SSL-protected manner, otherwise choose "/http".
  6. If you install the first application on your domain, you will be able to choose between two destination directories in the Installation preferences section of the same page, that is, between Document Root and the folder with the application's name.

    Note: If you choose the Document Root destination folder, the application will be deployed to the root directory of the domain, which will make it impossible to install any other applications on this domain until this one is deleted. The deployment policy used in Application Vault is as follows: you can deploy as many applications on a domain as you need, each application isolated in its own application folder, or you can install one and the only application directly to the root folder of a domain.

  7. In sections Database preferences, Administrator's preferences, etc. of the Site application installation page, enter passwords as required. A password should be 5 to 16 characters long, and it should not contain the login name used in this "login - password" pair.

Note: When installing an application on the domain, Plesk automatically generates the default name for the application's folder. If the domain has a similar application installed with the same preferences (namely, to the same /httpdocs or /httpsdocs root folder), then Plesk asks to give a different name to the application folder as the folder with the default name already exists. Important: the same is true if an application has been installed, then deleted, and now is being installed again. In this case, the files created by the previous application instance may still remain in the file system, and so does the application folder named by default if it contains such files.

Once all the steps are passed through, Plesk starts the installation routine during which it verifies the installation package structure and virtual host settings (whether the required technologies like PHP, CGI, Apache ASP, etc. are supported), checks the disk space and databases available, then deploys and configures the application, and registers it in Plesk database.

Finally, Plesk updates the Installed Applications page and displays it to the user and shows the newly installed web application in the list of installed applications at the bottom of the page.

If you are a Plesk Administrator, you can deploy an application on the selected domain as follows:

  1. On the navigation pane located to the left, choose the Domains link.
  2. Once you have got to the Domains page, check the domain you wish to deploy on in the list of domains located at the bottom of the page.
  3. Follow the instructions given for Domain User, beginning from step 2.