PLESK 7 NEW FEATURES HOW-TO RESOURCES
Copyright (C) 1999-2004 SWsoft, Inc. All rights reserved. Distribution of this work or derivative of this work in any form is prohibited unless prior written permission is obtained from the copyright holder. Linux is a registered trademark of Linus Torvalds. RedHat is a registered trademark of Red Hat Software, Inc. All other trademarks and copyrights are the property of their respective owners. 13800 Coppermine Road, Suite 112, Herndon, VA, 20171 USA Ph.: 703 815-5670, Fax.: 703 815-5675 2
Contents APPLICATION VAULT 3 HOW TO: Install an application package.....4 HOW TO: Install and configure an application........8 SPAMASSASSIN 11 HOW TO: Configure mail filters at the server level.... 12 HOW TO: Configure mail filters at the user level...15 TROUBLE TICKETING SYSTEM (TTS) 18 HOW TO: Configure the Trouble Ticketing System.....19 HOW TO: Submit a ticket.. 24 HOW TO: Process tickets.. 27 COLDFUSION SUPPORT 28 HOW TO: Install ColdFusion......29 HOW TO: Configure ColdFusion... 31 3
APPLICATION VAULT The Application Vault functionality allows for installing and configuring various web applications, such as counters, guest books, forums, photo galleries, etc. The Administrator of Plesk can add web applications in the form of application packages to the server enabling users deploy and configure the available applications on their domains (as well as subdomains). Terminology Application the application itself, installed on the domain and available for usage; Application package the set of files and data storing the application archive, from which the application is installed on the domain. In this section HOW TO: Install an application package How to access the Application Vault configuration How to install an application package from the control panel How to install an application package manually How to refresh the Application Packages list How to view info on application How to remove an application package HOW TO: Install and configure an application How to access the Application Vault on domain How to deploy an application on the domain How to configure the application How to access the application How to remove an application 4
HOW TO: Install an application package SUMMARY This article explains how to install an application package in Plesk. How to access the Application Vault configuration Click the Application Vault icon at the Server preferences page, group Services. How to install an application package from the control panel Select the application package file using the Browse button and click Send File. The selected application package will be uploaded and registered in the database. How to install an application package manually Access the server console as user root and upload the application package file to the server file system. Install the package, e.g.: # rpm -i bbclone-0.33.1-1.rpm 5
How to refresh the Application Packages list In order to view all installed packages, please refresh the Application Packages list. Click the Refresh icon. Refresh the Application Packages list every time you manually install or remove an application package. How to view info on application You can view information on available application packages by clicking on the application package name in the list. The information states the name and the version of the package, a brief description as well as a set of requirements that must be fulfilled in the domain hosting setup in order for the application to function. For instance, the package bbclone is a counter and requires PHP support configured for the domain. 6
How to remove an application package In order to remove one or several application packages, select the corresponding checkboxes and click Remove selected. If an application from a removed package was installed on a domain it will remain there, but all the information about it will be removed from the Plesk database. 7
HOW TO: Install and configure an application SUMMARY This article explains how to install and configure an application on a domain. How to access the Application Vault on domain Select a domain with configured physical hosting and click the Application Vault icon in the Hosting group. How to deploy an application on the domain Click the Add Application icon. Select the application package you wish to install on the selected domain. Note: you can also choose to install it on a subdomain select it in the Subdomain drop-down menu. You can view information on available application packages by clicking on the application package name in the list. If there is a documentation available for the application, it will be accessible through the icon. 8
Click Install. Some applications require certain parameters be entered before executing the installation. Click Finish once you are done editing the required parameters. Note: It is not allowed to install one application into a sub-directory of another application. However, most applications allow installing several copies for the same domain but in different directories. 9
When the installation of the application is complete, the application will appear on the Applications list. How to configure the application You can edit the parameters of an application by clicking on the application name in the list. How to access the application Use the icon in the Applications list to access the URL of the application. How to remove an application In order to remove one or several applications, select the corresponding checkboxes and click Remove selected. 10
SPAMASSASSIN SpamAssassin is a mail filter which attempts to identify spam. Using its rule base, it uses a wide range of heuristic tests on mail headers and body text to identify "spam", also known as unsolicited commercial email. Once identified, the mail can then be optionally tagged as spam for later filtering using the user's own mail user-agent application. (SpamAssassin is a third-party product integrated with Plesk. For more information on the product please refer to its web location: http://www.spamassassin.org/) Plesk allows for setting up and using black lists and white lists for filtering mail at the server level as well as at the user level. In this section HOW TO: Configure mail filters at the server level How to Access the SpamAssassin Server level Spam filter configuration How to set the spam filter usage policies How to configure the server level settings How to edit the Server-wide black list How to edit the Server-wide white list How to edit the Server-wide ignore list HOW TO: Configure mail filters at the user level How to activate Spam Filter for a mail name How to configure personal settings How to edit the Black list How to edit the White list How to train the filters 11
HOW TO: Configure mail filters at the server level SUMMARY This article explains how to set up server level mail filters: black, white and ignore lists, rules for spam recognition, and how to enable users set up and make use of the mail filters for their own mail accounts. How to Access the SpamAssassin Server level Spam filter configuration Click the SpamAssassin icon at the Server preferences page, group Services. How to set the spam filter usage policies Check the Server wide settings checkbox to allow configuring and applying filtering on the server level. Check the Personal settings checkbox to allow clients configure and use SpamAssassin for filtering their mail. Click the Set button to accept changes. How to configure the server level settings If the Server wide settings option was activated at the previous step, all the mail will be pre-processed on the server according to the following settings. Specify the number of hits required for a message in order to be marked as spam by entering the value into the Hits required for spam input field. Check the Modify spam mail subject checkbox if you want the subject text of messages recognized as spam to be appended with a specific tag (this helps to filter out the spam). You can also modify the tag itself. 12
Click the Set button to accept changes. How to edit the Server-wide black list All messages coming from the E-mail addresses that match those specified in the black list will automatically be marked as spam. To add a new pattern to the list, enter the pattern into the Email pattern input field and click the Add button. To remove a pattern from the list, select it and click the Remove button. How to edit the Server-wide white list All messages coming from the E-mail addresses that match those specified in the white list will never be marked as spam. 13
To add a new pattern to the list, enter the pattern into the Email pattern input field and click the Add button. To remove a pattern from the list, select it and click the Remove button. How to edit the Server-wide ignore list Mail will not be filtered for the mail accounts specified in this list. Only the mail accounts based on this server can be put on this list. To add a new pattern to the list, enter the pattern into the Email pattern input field and click the Add button. To remove a pattern from the list, select it and click the Remove button. 14
HOW TO: Configure mail filters at the user level SUMMARY This article explains how to activate the spam filtering functionality for a mail account and set up user level mail filters: black and white lists, and the rules for spam recognition. How to activate Spam Filter for a mail name Select the mail name you wish to activate Spam Filter for. By default Spam Filter is deactivated (the corresponding icon is displayed in gray). Go to Mailbox. Check the Enable spam filtering checkbox. Click OK to save changes and return to the mail name management page. The Spam Filter icon is now displayed in color. How to configure personal settings All the incoming mail for the mail name will be processed according to the following settings. Check the Use server wide settings if you wish the server level filtering settings to apply when filtering your mail. Specify the number of hits required for a message in order to be marked as spam by entering the value into the Hits required for spam input field. 15
Check the Modify spam mail subject checkbox if you want the subject text of messages recognized as spam to be appended with a specific tag (this helps to filter out the spam). You can also modify the tag itself. Click the Set button to accept changes. How to edit the Black list All messages coming from the E-mail addresses that match those specified in the black list will automatically be marked as spam. The Administrator s black list section contains the black list patterns added by the Administrator. You can leave them be a part of your own black list or you can remove them. Your own black list entries will be added to the user s black list section. To add a new pattern to the list, enter the pattern into the Email pattern input field and click the Add button. To remove a pattern from the list, select it and click the Remove button. How to edit the White list All messages coming from the E-mail addresses that match those specified in the white list will never be marked as spam. The Administrator s white list section contains the white list patterns added by the Administrator. You can leave them be a part of your own white list or you can remove them. Your own white list entries will be added to the user s white list section. 16
To add a new pattern to the list, enter the pattern into the Email pattern input field and click the Add button. To remove a pattern from the list, select it and click the Remove button. How to train the filters You can train your mail filters on actual messages you receive. Click the Training icon in the Tools group to access the Spam filter training page. The headers for all mail that comes to your mailbox will are listed here. Each such header you can select to mark as spam, ham (good mail) or forget. Marking a header as spam will result in recognition of same or similar mail as spam; Marking a header as ham will result in recognition of same or similar mail as not spam; Option forget clears the database of any rules (spam or ham) previously set for this header. Use the Clear button if you want to clear the SpamAssassin database. Click OK to save the changes and return to the Spam Filter page. 17
TROUBLE TICKETING SYSTEM The Trouble Ticketing System allows users report problems they may encounter while using Plesk to competent personnel and receive feedback and support. In this section HOW TO: Configure the Trouble Ticketing System How to access the Trouble Ticketing System configuration How to create a new queue How to create a new priority How to create a new category How to complete the TTS configuration How to configure Mail Gate for submitting tickets HOW TO: Submit a ticket How to access the trouble ticket submitting facilities How to submit a new ticket How to add events to the ticket HOW TO: Process tickets How to process local tickets How to process tickets from other servers 18
HOW TO: Configure the Trouble Ticketing System SUMMARY This article explains how to configure the TTS: create queues, priorities and categories, and how to activate the system. How to access the Trouble Ticketing System configuration Click Trouble Tickets in the navigation pane. The Trouble Ticketing System page appears. 19
Before users are able to submit tickets, the Administrator must perform an initial configuration of TTS. To this effect, you should create at least one instance of Queue, Priority and Category and then activate TTS on the General Config page. How to create a new queue Click the Queues icon. The page opens displaying the queues registered in the system. The list of queues will be empty at a new system. Click the Add New Queue icon. The queue properties page appears. 20
Enter the queue title, select the Enabled checkbox and click OK. The new queue appears on the Queues list. How to create a new priority Click the Priorities icon. The page opens displaying the priorities registered in the system. Click the Add New Priority icon. The Priority properties page appears. Enter the priority title, select the Enabled checkbox and click OK. The new property appears on the Priorities list. How to create a new category Click the Categories icon. The page opens displaying the categories registered in the system. Click the Add New Category icon. The Category properties page appears. Enter the category title, select the Enabled checkbox and click OK. 21
The new property appears on the Categories list. How to complete the TTS configuration Click the General Config icon. The General Config page opens. Specify the server id in the Server id field, enable the Allow customers to submit tickets checkbox, and select the default queue, priority and category. Click the Enable icon. TTS gets activated. Now clients, domain owners, mailbox users can submit trouble tickets to the TTS through the control panel. Click OK to save changes and return to the main page. 22
How to configure Mail Gate for submitting tickets Optionally, the tickets can be submitted by e-mail provided that the Administrator has configured the mail gate. To do this, click the Mail Gate Config icon on the main TTS page. The mail gate configuration page opens. Fill out the following fields: Notification Sender's Name the name that will be used for e-mail notification messages Notification Sender's Return Address the notification sender s return e-mail address POP3 Server POP3 server, the mail should be fetched from POP3 Login login name for accessing the POP3 server New POP3 password POP3 password that will be used for getting mail Confirm POP3 Password password confirmation Query mail once in [ ] min define the time interval between mail queries. Ticket subject must start with [ ] specify the combination of symbols the subject line of mail messages must start with. This is required for spam protection. Once the required fields are filled out, click Enable. The mail gate is activated. Click OK to save changes and return to the main page. 23
HOW TO: Submit a ticket SUMMARY This article explains how users (clients, domain owners, mail users) can submit tickets. How to access the trouble ticket submitting facilities Click Trouble Tickets in the navigation pane. Note: you must be logged in as either a client, or domain owner, or a mail user. How to submit a new ticket Click the Add New Ticket icon. The ticket submission page opens. 24
Fill out the required fields: Ticket Subject and Ticket Body. Select a category from the drop-down box. Click OK. The new ticket appears on the Tickets list. How to add events to the ticket Select the ticket you wish to add an event for. Each event consists of an action performed with a ticket, and a comment related to this action. At the bottom of this page you can see the ticket s event history. 25
Click OK to save changes and return. 26
HOW TO: Process tickets SUMMARY This article explains how local tickets as well as tickets from other servers can viewed and processed. How to process local tickets Now return to the administrator s session. On the main TTS page you see the List Local Tickets group with five icons and brief ticketing statistics. Selecting one of these icons the administrator gets to the page listing the tickets, similar to the one seen at the client s session. The five icons provide the selective ticket presentation in accordance with their respective labels. How to process tickets from other servers The Servers icon in the bottom Global TTS group allows viewing a summary on ticketing at the remote servers, provided that there are slave server accounts registered with control panel. 27
COLDFUSION ColdFusion is the solution for building and deploying powerful web applications and web services. Using the proven tag-based scripting and built-in services in ColdFusion, web application developers can easily harness the power of the Java platform without the complexity. (ColdFusion is a third-party product integrated with Plesk. For more information on the product please refer to its web location: http://www.macromedia.com/software/coldfusion) In this section HOW TO: Install ColdFusion How to install ColdFusion on your server HOW TO: Configure ColdFusion How to access the ColdFusion configuration How to configure ColdFusion How to enable ColdFusion support for the users domains 28
HOW TO: Install ColdFusion SUMMARY This article explains how to install ColdFusion and what installation parameters should be used. How to install ColdFusion on your server Run the ColdFusion installer: # sh coldfusion-61-lin.bin You will be prompted for information necessary for installing ColdFusion. Below are a number of steps from the installer with the indication of what you should select or specify according to what Plesk requires for this installation. <skip> ===================================================== Install Type ------------ Select ->1- Install new version of ColdFusion MX ===================================================== Install Configuration --------------------- Select ->1- Server configuration or 2- J2EE configuration (ColdFusion MX with JRun 4) ===================================================== Choose Install Folder --------------------- Please write down or remember this path. You will be required to enter when configuring ColdFusion. <skip> ===================================================== Configure Web Servers --------------------- Select ->2- Continue with installation 29
You do not need to configure your webserver(s) at this moment. ===================================================== Init System ----------- Answer 'y' You need ColdFusion MX to start at system boot. <skip> Important: After you have completed these installation steps you must proceed to "Server" -> "ColdFusion Settings" in the control panel to configure the installation (See the following article HOW TO: Configure ColdFusion). You do not need to 'go to /opt/coldfusionmx/bin' as stated in the ColdFusion MX installation instruction. 30
HOW TO: Configure ColdFusion SUMMARY This article explains how to perform the post-install configuration of ColdFusion. How to access the ColdFusion configuration Click the ColdFusion Settings icon at the Server Administration Page, Services group. How to configure ColdFusion Select the desired installation configuration (Server Configuration or J2EE), and specify the directory ColdFusion was installed to. Click OK to complete the configuration and return to the Server Administration Page. How to enable ColdFusion support for the users domains When setting up physical hosting for a domain, on the Physical Hosting Setup page select the ColdFusion support checkbox to enable the ColdFusion scripting. 31