www.pudn.com > umpl_xmail-2.11.rar > INSTALL
UMPL for Xmailserver 2.11
* 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
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
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 (perl 5.61 and 5.8), Debian Woody.
- M$-Windows (Cygwin ): XP, 2000 (perl 5.6 and 5.61).
If you have serious problems running it, please report to schmidt_AT_waaf.net!
!!!!!!!!!!!! Windows-users please read README.W32 !!!!!!!!!!!
Installing with perl-installer
* Get the latest sources of umpl xmail at http://umpl.de/xmail/download.html
and untar it, e.g.:
cd /tmp/
wget httpd://umpl.de/download/umpl_xmail-2.11.tar.gz
tar xfz umpl_xmail-2.11.tar.gz
cd umpl_xmail-2.11
* Run the included install-skript and answer the questions.
./umpl_xmail_install-211.pl
Running the installer will do the following for you (You can choose if the
commands are done by the installer or written to a textfile for manual
processing!):
o Create all needed directories and permitions in a target-dir ( under your
webservers doc_root )
o Create Xmail Ctrl-Account (if XmCrypt & ctrlaccounts.tab are reachable)
o Create Mysql User & Database (if wanted, written to txt-file!)
o Create Mysql Tables (written to txt-file!)
o Create umpl xmail configuration
o Copy all PHP & HTML files to target-dir
* After having finished you will at least have to do the following:
o Run the created textfile with mysql-commands to do all MySQL stuff, e.g.
mysql -uroot -p < umpl_xmail_install.mysql
o IF you choosed to run commands by hand during installation you also have to
run the created textfile with sh-commands, e.g.
sh umpl_xmail_install.sh
* You can now add a VIRTUAL HOST for umpl xmail OR simply run it within a
subdirector of your doc_root.
* Start using umpl xmail by: open your browser and go to http://umpl-xmail-
server/root/ OR http://server/umpl-xmail-dir/root/ and log in with the data
created during installation and that can be found at user_data.php ($XM_user
and $XM_passwrd).
Installing by hand
Choose "doing commands by hand" at installation/updating via perl-installer.
Please check: http://umpl.de/xmail/index27.html (Description for V2.7, not more
maintained!)
Updating umpl xmail
This 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 and 2.10
Automatic update using perl-installer (umpl_xmail_upgrade)
* Get the latest sources of umpl xmail at http://umpl.de/xmail/download.html
and untar it, e.g.:
cd /tmp/
wget httpd://umpl.de/download/umpl_xmail-2.11.tar.gz
tar xfz umpl_xmail-2.11.tar.gz
cd umpl_xmail-2.11
* Run one of the included upgrade-scripts and answer the questions, e.g.
./umpl_xmail_upgrade_29-210.pl # if you have V2.9
./umpl_xmail_upgrade_210-211.pl # if you have V2.10
o If you have an older version running, please first upgrade to 2.9 or 2.10!
Running the upgrade-script will do the following for you (You can choose if
the commands are done by the installer or written to a textfile for manual
procesing!):
o Update Mysql Tables (written to txt-file!)
o Make Backups of files to be renewed
o Copy all updated files to target-dir
* After having finished you will at least have to do the following:
o Run the created textfile with mysql-commands to do all MySQL stuff, e.g.
mysql -uroot -p < umpl_xmail_install.mysql
o IF you choosed to run commands by hand during installation you also have to
run the created textfile with sh-commands, e.g.
sh umpl_xmail_install.sh
Updating by hand
Choose "doing commands by hand" at installation/updating via perl-installer
Please check: http://umpl.de/xmail/index27.html (Description for V2.7, not more
maintained!)
2004, April 02 Achim Schmidt