www.pudn.com > umpl_xmail-2.11.rar > README
UMPL for Xmailserver 2.11
* Introduction
* Features
* Before You start
* Installing umpl xmail
o using perl-installer
o Installing by hand
* Updating umpl xmail
o Automatic update using perl-installer
o Updating by hand
* Misc
o Getting started
o Files / Directories
o License
o Credits
o Changelog
* Screenshots
* Download
Introduction
Many Sysadmins have to solve the problem of giving customers the ability of
creating, modifying and deleting email-users on their own. For such needs of
virtual email hosting Xmailserver is a really good choice. This article covers
how to install and configure the umpl-xmail webmail and admintool which helps
to make the postmasters' live easier.
umpl-xmail is intented to be used on any Linux / BSD platform (designed for
Linux/Apache). The code should also work on windows-servers but you will have
to search for bugs on your own.
If you have questions about umpl-xmail feel free to contact me at
schmidt_nospam_@waaf.net.
Features
After the installation you are able to use the following features - multilingual,
at the moment:
german, english, spanish, french, italian, dutch, slovenian, hungarian,
turkish, polish, russian, swedish
Root-Interface ( http://umpl-xmail.tld/root/ ):
* creating, modifying and deleting domains incl. root/postmaster-user
* creating and deleting aliasdomains
* managing Account / Diskspace Quotas
* modifying postmaster-accounts (password)
* main server configuration
* managing frozen messages
Domain-Postmaster Interface ( http://umpl-xmail.tld/index.php ):
* creating and deleting users within the domain
* modifying users within the domain (password, forward etc.)
* statistics (MailboxSize etc.)
* creating, modifying and deleting of aliases within the domain
User Interface ( http://umpl-xmail.tld/index.php ):
* modifying of the userdata (password, forward, finger-informationen)
* Full featured interface for POP3 incl. MIME-attachments, HTML-/TXT - Mail
Changer, Reply, Forward, header-view
* interface for sending email incl. MIME-attachments
* Contactlist
* Signature
* Spamblocker
* Auto Reply
Software needed before starting
You have to install (if not done by now) several components before you start.
Without these software umpl-xmail will NOT work.
These are:
* Xmailserver, see: Xmailserver homepage, Xmailserver how-to
* Apache Webserver (or any other httpd, speaking php4), see: Apache http-server
project homepage
* PHP4 (incl. MySQL-libraries), see: PHP.net
* MySQL Server, see: MySQL AB homepage
* [ Perl5 (needed by installer, no xtr-libs required) ]
* [ Bash (needed by autoreply) ]
Installing umpl xmail
- please see INSTALL!
Updating umpl xmail
- please see INSTALL!
Misc
umpl_xmail is (c) 2001-2004 waaf.net computing, released under Gnu Puplic
License - This means you can use, share and modify this software, but it whould
be usefull if you also contribute by developing and helping free software! e.g.
by creating new language templates ;-)
If you want to say thanks to the authors you can do this by sending e.g. a
picture postcard to:
waaf.net computing
Achim Schmidt
Haster Strasse 42
DE 49191 Belm
Germany
schmidt_NOSPAM_@waaf.net
(remove _NOSPAM_)
Getting startet
After having installed umpl-xmail you can start like that:
ˇ log in at /root using the $XM_user & $XM_passwrd values out of user_data.php.
ˇ create domain.com with pw test and a quota of 20 users and 100MB.
ˇ log in at /index.php using user: root@domain.com and pw test.
ˇ navigate to root-admin and you can create a user willi@domain.com with pw
test2 and a quota of 10 MB
ˇ now you can log in as user willi@domain.com with pw test2 at /index.php
ˇ the non-root users can't access root-admin but use webmail, forwarding, etc.
Thats the system - hope you enjoy it!
Files / Directories
# install-dir (to give during install)
/ # install-dir
/ *.php # PHP-Files Enduser-Interface
/user_data.php # data for Xmail & MySQL
/root_*.php # PHP-Files Postmaster-Admin
/inc/ * # include-Files for Postmaster & Enduser-Interface
/img/ * # images
/root/ # Root-Admin
/root/ *.php # PHP-Dateien Root-Admin
/root/class* # Include-Files for Root-Interface
/root/img/ * # images
/tmp/* # tmp files used by webmail (attachements)
/autoreply/* # autoreply messages in txt-format
/README # text-documentation
/INSTALL # text-install-documentation
/LICENSE # text-gpl
License
This program is free software; you can redistribute it and/or modify it under
the terms of the GNU General Public License as published by the Free Software
Foundation; either version 2 of the License, or (at your option) any later
version. This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
details. You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software Foundation, Inc.,
675 Mass Ave, Cambridge, MA 02139, USA.
For more details see: http://www.gnu.org/copyleft/gpl.html
Credits
Thanks to those people for contributing to this project:
Paul Heijman, SOGware http://www.diggie.nl/ code for server communication
Manuel Lemos http://www.phpclasses.org/ code For MIME-Coding outgoing Mail & pop3 protocol
Charley Collins umpl-code for Autoreply
Theo Rosbag Autoreply-bash-script (c)2001 TPS Developement
Jens Wedler, , http://waaf.net/ umpl libraries
the Horde project http://www.horde.org/ rocking function decode_mime_string()
Translators:
Name eMail / Homepage Language Version
Rolf Schwarzenberg rolf_AT_schwarzenberg.cl spanish 2.11
Roberto Pavesi servitel_AT_servitelit.com, http://servitelit.com/ italian 2.11
Sasa Stupar sasa_AT_stupar.homelinux.net slovenian 2.11
Frédéric Landry fred.landry_AT_pqm.net french 2.11
Tanguy Janssens info_AT_jetsoft.be, http://www.jetsoft.be/ dutch 2.11
Csapó Balázs csapo_AT_jelenet.hu hugarian 2.11
Ozgun AKSOY jdred_AT_gmx.net turkish 2.9
David Svensson david.svensson_AT_h4rd.c0r3.org swedish 2.9
Vladimir Miropolsk mva_AT_intersat.ru russian 2.9
Michal Borkowski morcom_AT_sieciosklep.com, http://www.wiwat.pl/ polish 2.11
Nabil Attar nabil.attar_AT_aws-syria.com arabic 2.11
Theodoros Xanthopoulos ge01835_AT_teikoz.gr, http://www.teikoz.gr/ greek 2.11
2004, April 02, Achim Schmidt schmidt_AT_waaf.net, http://achim.schmidt.tc/