Rack-Soft, LLC © 2002-2006 4PSA Qmail Manager 1.1.6 for Plesk 8 / Plesk 7.
Manual Version 0.20 For suggestions regarding this manual contact: docs@4psa.com © Copyrights 2002 – 2006 Rack-Soft, LLC. All rights reserved Distribution of this work or derivative of this work is prohibited unless prior written permission is obtained from the copyright holder. Plesk is a Registered Trademark of SWsoft, Inc. Linux is a Registered Trademark of Linus Torvalds. RedHat is a Registered Trademark of Red Hat Software, Inc. FreeBSD is a Registered Trademark of FreeBSD, Inc.
Table of Contents Preface ............................................................................................................4 Who Should Read This Guide................................................................................ 4 Typographical Conventions .................................................................................. 5 Chapter 1 About 4PSA Qmail Manager ............................................................6 4PSA Qmail Manager 1.1.6 Features.....................
Preface Who Should Read This Guide This User’s Guide must be read by the administrator of the Plesk server.
Typographical Conventions Style Meaning char – code Code snippets, shell command line examples char – bold code Commands that must be chosen or typed in console or in the web interface char – italic Program output quotes, quotes from related documentation or from other sources char – link Link to an Internet address char – bold Important text Notes – Additional information, it’s advisable to read these areas Tips – Important advices, it’s highly advisable to read these areas Note, Tip & Attenti
Chapter 1 About 4PSA Qmail Manager 4PSA Qmail Manager is a server-level application that provides advanced Qmail server management for Plesk servers. The application consists of a single administrator module that allows the server administrator to control various Qmail server options and manage the queued messages.
About 4PSA Qmail Manager 4PSA Qmail Manager 1.1.6 Features • Plesk integrated • A single administrator module • The possibility to define and use settings templates: o The following predefined templates are included: Aggressive, Improved and Default. o Over twenty Qmail advanced settings can be used in templates to increase the email service performance and reliability.
Chapter 2 The Administrator Module The 4PSA Qmail Manager administrator module can be accessed by logging in the Plesk with the admin account. To access the 4PSA Qmail Manager interface, in the Custom navigation menu click 4PSA Qmail Manager link. The 4PSA Total Backup toolbar is available on top of the application’s interface.
The Administrator Module 1. Qmail Queue Management In the Qmail queue area (click the Queue button available in the toolbar) the server administrator can search the queue based on several criteria.
The Administrator Module • Queue – Search only in the selected queue (local or remote) • Bounces only – When this option is selected, 4PSA Qmail Manager will display only bounce messages from the selected queue To perform the search based on the selected options, click the Search button. To view all the messages from the selected queue, click the Show All button. Search Results Based on the search criteria you provided, 4PSA Qmail Manager displays the queued messages that matched these criteria.
The Administrator Module The server administrator can view all the queued messages, refresh the displayed information and remove selected messages. In order to view all the messages available in the queue, the admin must click the Show All link. To update the information displayed by 4PSA Qmail Manager, he must click the Refresh link. To remove the selected messages the administrator must check the corresponding checkboxes and click the Remove selected link.
The Administrator Module • Restart – When you click this button, 4PSA Qmail Manager will restart the Qmail server. This button is enabled only when Qmail server is running. 3. Qmail Control Files In this area, the server administrator can control Qmail behavior by modifying the content of Qmail control files. To access this area, in the toolbar click the Control files button. The content of the qmail control files is handled through predefined templates. You can add, edit or remove the existing templates.
The Administrator Module permanently undeliverable, Qmail sends a single-bounce notice back to the envelope message sender. The From field of the email will contain the address bouncefrom@bouncehost, although its envelope sender address is empty. • concurrencylocal – The maximum number of simultaneous local delivery attempts. Default: 10. If the value is 0, local deliveries will be put on hold. concurrencylocal is limited at compile time to 1000.
The Administrator Module databytes counts bytes as stored on disk, not as transmitted through the network. It does not count the qmail-smtpd received value, the qmail-queue received value, or the envelope. If the environment variable DATABYTES is set, it overrides databytes. • doublebouncehost – The double-bounce host. Default: me, if that file is provided by the server administrator. Otherwise it will be doublebouncehost. • doublebounceto – The name of the user who will receive doublebounces.
The Administrator Module The QMAILIDHOST environment variable overrides idhost. • localiphost – This is the replacement host name for local IP addresses. Default: me, if that file is provided by the server administrator. Qmailsmtpd is responsible for recognizing dotted-decimal addresses for the current host. When it finds a recipient address with the form box@[d.d.d.d], where d.d.d.d is a local IP address, it replaces [d.d.d.d] with localiphost. This is done before rcpthosts.
The Administrator Module • timeoutsmtpd - Number of seconds qmail-smtpd will wait for each new buffer of data from the remote SMTP client. Default: 1200. In order to apply the template to Qmail control files, check Save and apply template to Qmail. 4. Settings In this area, the server administrator can view which 4PSA Qmail Manager version is installed on the server and can change interface settings. To access this area, in the toolbar click the Settings button.
The Administrator Module • License file – You can use this form to upload the license key to the server. If you can access other pages in 4PSA Qmail Manager, this means that your license is valid and you do not have to upload a new one. • Get license from licensing server - You can use this form to query the licensing server. This function can only be used when there is a license key loaded on the server. The first time you install the product it is required to upload the license key.
Appendix A Server Compatibility 4PSA Qmail Manager is shipped in different installation achieves for different Plesk versions: - Plesk 7.1.1 Reloaded and Plesk 7.5.3 Reloaded. These versions have Plesk7x prefix in the installation archive name. - Plesk 7.5.4 and upper versions of Plesk 7.5 Reloaded. These versions have Plesk75 prefix in the installation archive name. - Plesk 8.0 and upper versions. These versions have Plesk8 prefix in the installation archive name.
Server Compatibility • RedHat Linux 9 The file qmanagerXXX_buildXXXXXX.XX_RHEL4Plesk8.tar.gz compatibility with the following operating systems: provides • RedHat Enterprise Linux 4.0 • CentOS 4.x The file qmanagerXXX_buildXXXXXX.XX_FC3Plesk8.tar.gz compatibility with the following operating systems: provides • Fedora Linux Core 3 The file qmanagerXXX_buildXXXXXX.XX_FC4Plesk8.tar.
Server Compatibility The file qmanagerXXX_buildXXXXXX.XX_Suse93Plesk8.tar.gz provides compatibility with the following operating systems: • Suse 9.3 The file qmanagerXXX_buildXXXXXX.XX_Suse100Plesk8.tar.gz provides compatibility with the following operating systems: • Suse 10 The file qmanagerXXX_buildXXXXXX.XX_Debian31Plesk8.tar.gz provides compatibility with the following operating systems: • Debian 3.1 • Ubuntu 5.10 4PSA Qmail Manager 1.1.6 for Plesk 8 / Plesk 7.