UMPL for Xmailserver 2.11

 

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 join the umpl xmail mailinglist at http://lists.waaf.net/mailman/listinfo/umpl-xmail or contact me at schmidt_nospam_@waaf.net.


top
 

Features

After the installation you are able to use the following features (multilingual, at the moment: german, english, spanish, french, italian, dutch, slovenian, russian, polish, swedish, turkish, hungrian, arabic and greek):

Root-Interface ( http://umpl-xmail.tld/root/ ): Domain-Postmaster Interface ( http://umpl-xmail.tld/index.php ): User Interface ( http://umpl-xmail.tld/index.php ):
top
 

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:


top



 

Installing umpl xmail

Info This is the description for first-time installation.
If you want update an existing umpl-xmail installation you can go to the next point!

There are two different ways to install - I suggest using the perl-installer! If you can't use it ( because of having no root-access to the web-/ mysql-/ mailserver or having the services shared on diifferent machines ) you can also install and configure umpl xmail by hand.
The perl-installer and upgrade scripts will run on all ***x-like platforms and where successfully tested on the following systems:
- Linux: SuSE 7.3, 8.0, 8.2, 9.0 (perl 5.61 and 5.8), Debian Woody (perl 5.6 and 5.8).
- M$-Windows (Cygwin): XP, 2000 (perl 5.6, 5.61, 5.8.2).
If you have serious problems running it, please contact umpl-xmail_AT_lists.waaf.net

 

Installing with perl-installer

 

Installing by hand

Please check: http://umpl.de/xmail/index27.html (Description for V2.7, but still the same to do for installing)


top



 

Updating umpl xmail

InfoThis is the description for updating an existing umpl-xmail installation.
There are two different ways to update - I suggest using the perl-installer! If you can't use it ( because of having no root-access to the web-/ mysqlserver or having the services shared on different machines ) you can also install and configure umpl xmail by hand.
Currently the perl-installer does only support updating from Version 2.9 or 2.10.

 

Automatic update using perl-installer (umpl_xmail_upgrade)

 

Updating by hand

Please check: http://umpl.de/xmail/index27.html (Description for V2.7, but still the same to do for updating)


top
 

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 started

Info Beginning with Version 2.10 autoreply.sh is bundled with umpl_xmail, which needs to know the correct MAIL_ROOT!
If you don't have Mail_ROOT at /var/MailRoot/ please change it inside '$doc_root/autoreply.sh!

Info People that use umpl_xmail on Microsoft Windows environment (e.g. Roxen or IIS) please take an closer look to README.W32!



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/*			# text-files with users vacation-messages	

	/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 / giving inspiration to this project:
Davide Libenzi http://www.xmailserver.org/davide.html father of xmailserver
Paul Heijman, SOGware http://www.diggie.nl/ code for server communication
Manuel Lemos mlemos_AT_acm.org http://www.phpclasses.org/ code For MIME-Coding outgoing Mail & pop3 protocol
Charley Collins charley_AT_collins.ch http://www.collins.ch/ umpl-code for Autoreply
Theo Rosbag rosbag_AT_thbird.org http://xmail.thbird.org/ Autoreply-bash-script (c)2001 TPS Developement
Jens Wedler, wedler_AT_waaf.net, http://waaf.net/ umpl libraries
the Horde project http://www.horde.org/ rocking function decode_mime_string()


Translators:
Rolf Schwarzenberg rolf_AT_schwarzenberg.cl spanish till 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, http://jelenet.hu/hungarian 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.comarabic2.11
Theodoros Xanthopoulos ge01835_AT_teikoz.gr, http://www.teikoz.gr/greek2.11

 

Changelog


top

2004, April 02 Achim Schmidt





[ Main Side ]   [ Screenshots ]   [ Download ]   [ umpl xmail @freshmeat ]