The source-installation can be used to setup the complete Mailserver/WebMail mode of Atmail. This document will illustrate how to configure the Atmail software from source. If you only want to setup the WebMail client, please refer to the WebMail-source installation guide.
Before you install Atmail please make sure you meet the minimum Requirements.
Install Script
It is recommended that you use the server-install.php script to configure your Atmail system.
The purpose of this script is to configure the Atmail application for the server, and to save the runtime settings to the main Configuration file (Config.php).
For non Linux systems ( FreeBSD, Solaris, etc ) before running the server-install.php script, the username 'atmail' must be created as a system account. Using the useradd/adduser utility depending on your OS. The UID of the new user must be UID 3000. For Linux systems the server-install.php script will automatically add the user-account to the system.
You run the installation script by running the following commands:
% tar xvfz atmailphp5server.tgz -C /usr/local/
% cd /usr/local/atmail/
% php server-install.php
Atmail must be installed under the default pathname of /usr/local/atmail/ - The atmail5.tgz archive has the directory structure pre-setup. Using the tar command extract the archive into the /usr/local directory.
If hard-disk space is an issue of the selected partition, the Atmail directory can be moved to another volume so long as the /usr/local/atmail directory is symbolically linked to the new directory.
Below is a walk through of the command-line installation script server-install.php:
The following few prompts will set up your MySQL Database for Atmail. You will need to supply a MySQL user that has permission to create databases.
Using Atmail you can scale the software solution by storing user email/account information on a separate machine from the webserver.
It is recommended to use Atmail and mySQL on the same machine for userbases under <>
MySQL Database system configuration for Atmail
After this step you will have the option of creating the tables for the Atmail database, and test the MySQL configuration details are correct.
Then, continue:
Groupware and Webserver Configuration
Domain Name Configuration
Next you must specify the domain names for which you wish to host email accounts:
Continue to specify the Administrator email address and accept the configuration of Gzip compression and mod_deflate if they are detected as available.
In the next step of configuration, the installation utility will compile the SMTP server ( Exim ), POP3/IMAP server, Spamassassin and optionally the AV scanner from source.
Before installing these modules your system must have the gcc compiler installed with the relevant system libraries/headers ( gcc is installed as standard under common Unix platforms ).
The mySQL header and library files are also required to be installed before installation. These library files should be installed by default with mysql, otherwise you can obtain the header/library files from the Mysql.com site ( Download the RPM or binary for your selected system, otherwise build the mySQL server from source).
Installing the SMTP server
Installing the POP3/IMAP Server
Optional Spamassassin and Anti-Virus Installation
Atmail Diagnostic utility
The next [optional] installation step is to run a diagnostic utility to verify local mail delivery for your Atmail system.
The following tests are performed: Account signup, message sending, message viewing via WebMail, and POP3 access. Note that the diagnostic utility can also be used via the graphical Webadmin to verify the installation.
Once the installation is complete, Atmail will start the services via the atmailserver init script and the software can be accessed via the address:
http://youraddress.com/mail/
Here you can access the WebMail interface of Atmail and setup a new email-account at your selected domain. To begin using the WebAdmin interface of Atmail visit the URL:
http://youraddress.com/mail/webadmin/
After visiting the Webadmin you must enable a password for the access using the Webadmin → Security → Admin Password menu
Post-Install
Atmail uses the SysV startup scheme, the atmailserver startup script will be located:
% /etc/init.d/atmailserver
You can start, restart and stop the services for Atmail, by using these commands after the script, for example:
% /etc/init.d/atmailserver start
% /etc/init.d/atmailserver restart
% /etc/init.d/atmailserver stop
沒有留言:
張貼留言