1. Pre-installation

2. Installing using Yum

3. Installing using RPM manually

4. Dependencies

5. The install Script

6. Installed Directories

7. Post Installation and Troubleshooting

7.1 Post Installation

7.2 Troubleshooting

8. Contact Support

---

1. Pre-Installation

Before installing the WebMail @Mail RPM, you should first check the following:

• Check that no other atmail installations are installed, including the evaluation version. For upgrading previous @Mail installations please reference the upgrade-guide
  
• Verify that the system has PHP installed. ( default under any common Linux distribution )
  
• Check that you are logged in as root before beginning the installation.]

@Mail can be installed using two different RPM methods. These include using the "yum" command under Fedora, or the regular RPM command manually. Both installation methods are outlined below, it is recommended to use the "yum" method for Fedora systems.

2. Installing using Yum

By using the "yum" feature of RedHat Fedora the @Mail software can be easily installed, with any missing dependencies automatically installed. This is the easiest method to install @Mail and requires the least effort.

To install follow the steps below in the exact order

1. Download the RPM package for your system, for example under the /tmp/ directory for the initial configuration.
   
2. Next, import the @Mail Public-key. This is required to allow the "yum" installer to validate the RPM package of @Mail is trusted.
   
   Manually run the rpm command as follows:
   
   

   root# rpm --import http://atmail.com/atmail-publickey.pub

   Importing the PGP key for the @Mail package
   
   This is required to trust installing the @Mail package using the yum command. Note once the Public-key is loaded no output is returned.
   
3. Next the @Mail package can be automatically installed using the "yum" command. The utility will connect to the yum-repository and automatically download any missing dependences to install the software.
   
   

   root# yum install atmailwebmail.rpm

   =============================
   Package Arch Version Repository Size
   =============================
   Installing:
   atmail-webmail noarch 4.2-1 /tmp/atmailwebmail.rpm 11 M

   Transaction Summary
   =============================
   Install 1 Package(s)
   Update 0 Package(s)
   Remove 0 Package(s)
   Total download size: 11 M
   Is this ok [y/N]: Y

   Installing: atmail-webmail ######################### [1/1]

   To complete the @Mail installation you must run the installation wizard via the command-line. Run the below commands as root, exactly as follows:

   cd /usr/local/atmail/webmail/
   php install.php client

   Once the install.php script has been run, the configuration of @Mail will be complete

   Installed: atmailwebmail.rpm

   Using yum to install @Mail via the command-line
   
   The output of the yum command will be similar as above. If any missing dependencies are detected ( e.g mysql, apache, php ) a prompt via yum will appear to install the missing packages.
   
4. Once the yum command is complete the software can be initially configured using the command-line install.php script. Follow the next step as outlined under Section 5 of the install tutorial.
   
   

3. Installing using RPM manually

1. Download the RPM package for your system
   
2. Manually run the rpm command on the @Mail RPM package, this will not install any dependencies that are missing on your system
   
   /tmp# rpm -vi atmailclient.rpm
   
   Please note the -vi flags, this is for 'verbose installation'. The installation will take between 1-5 minutes depending the speed of the hardware. Do not exit from the RPM command once run.
   
   If you receive an error during the RPM installation, validate you have the correct Dependencies installed for @Mail. See below for a complete listing.

4. Dependencies

@Mail requires the following dependant applications - If using the yum installation method any missing dependencies will be automatically installed.

• Mysql-Server ( if the @Mail Application will be accessing the MySQL server on the same system.)
  
• Mysqlclient - http://www.mysql.com/
  
• Apache/httpd - Apache is required and is usually installed by default with most Linux Distributions and Unix Variants - http://httpd.apache.org/
  
• PHP 5.0+ recommended . Minimum PHP 4.3+ required - PHP is required and is usually installed by default with most Linux Distributions and Unix Variants.

To locate a missing dependency please reference: rpmfind.net -- it will give you a list of packages and dependencies, each dependency is cross-linked to a list of packages which provide them.

http://rpmfind.net

You can also find the required dependencies from the Linux CD Installation discs

5. The Install Script

The Installation script is a PHP script that is run after a successful RPM install, in that : all the necessary files are in the correct places and necessary services have been installed.

The purpose of this script is to configure the @Mail application and save the runtime settings to the main @Mail Configuration file (Config.php). You run the installation script by running the following commands:

# cd /usr/local/atmail/webmail/
# php install.php client

@Mail Configuration

Provide the following information to compile an libs/Atmail/Config.php
file based on your servers unique configuration.

Enter the admin email for the system.

Admin Email: [admin@yourdomain.net]:

Entering the Admin Email

You will be first asked to add the Email Administrator account. The purpose of this is to allow any @Mail error or notification emails to be sent to this account.

SQL Database Configuration

@Mail can be installed to use an SQL database backend to store user emails and account information. We recommend the use of mySQL for the Database backend for @Mail, which can be freely obtained at http://www.mysql.com/

Select the database name to store email/account information
Select Database Name: [atmail]:

Enter which user to connect to the database server. The users needs
full permissions over the table to modify/read/write
Enter Username: [root]:

Enter the password for root to connect
Enter Password for root: []:

Next, specify the hostname / IP address of the MySQL server.

Using @Mail you can scale the software solution by storing user email/account information on a separate machine from the webserver.

It is recommended to use @Mail and mySQL on the same machine for userbases under < 10,000 accounts.

If the MySQL server is setup on the same machine leave the 'Hostname' field blank. This will make @Mail communicate with the database server directly rather then opening a TCP/IP connection.
Enter Hostname: []:

MySQL Database system configuration for @Mail

After this step you will have the option of creating the tables for the @Mail database, and test the MySQL configuration details are correct.

Once the installation is complete, @Mail will startup the Mail-server and the software can be accessed via the address:

http://youraddress.com/mail/

Here you can access the WebMail interface of @Mail and setup a new email-account at your selected domain. To begin using the WebAdmin interface of @Mail 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

Please note the following:

• The file /etc/httpd/conf.d/phpatmail.conf is the webserver configuration file for @Mail.
  
  
• The /mail/ part of the @Mail URL is an alias, this provides a link from the browser http://server.com/mail/ to the path on your system where the application is installed /usr/local/atmail/webmail/
  
• A note for Virtualhosts: the Alias /mail/ can also be accessed from VirtualHosts if the username which runs the host is the same as the main httpd user 'atmail'.

7.2 Troubleshooting

1. I can't access the @Mail URL
   
   Check that your Apache Server is running and the configuration file /etc/httpd/conf.d/phpatmail.conf is in use.
   
   
2. Webadmin Interface appears does not prompt for a username/password
   
   Access the Webadmin and go to the Security -> Admin Password menu item and enter a new password: This script will update the /usr/local/atmail/webmail/webadmin/.htpasswd file, any subsequent action in the Webadmin Interface will bring up the authentication window.
   
   
3. I can't access the Webadmin Interface since I forget the username/password
   
   On the command line, cd to the Webadmin Folder and delete the existing .htpasswd and .htaccess files:
   
   # cd /usr/local/atmail/webmail/webadmin/
   
   # rm .ht*
   
   and perform the Admin Password change in the solution above to secure the Webadmin Interface.
   
   
4. Can't access POP3 / IMAP externally
   
   Review your firewall to allow the following ports:
   
   25 ( SMTP )
   80 ( Web )
   110 ( POP3 )
   143 ( IMAP )
   
   
5. Permission errors or messages can't be received
   
   Check that your @Mail directories are owned by the user of your Websever. Generally the username should be apache, nobody, httpd or wwwuser depending on your server. The @Mail directory /usr/local/atmail/webmail/ must have the ownership for read/write by the Webserver user.
   
   
6. Can't IP relay or use the SMTP for outgoing messages
   
   Access the Webadmin -> Config -> SMTPto specify IP ranges for relay, or enable SMTP-authentication support under the WebAdmin -> Services -> SMTP Settings menu.
7. I receive the following error when using the "yum" installation method.
   "Warning: rpmts_HdrFromFdno: V3 DSA signature: NOKEY, key ID 8df56d05
   Error: Could not find the GPG Key necessary to validate pkg ..."
   
   When installing the @Mail package using the yum command, the GPG public key must be installed to trust the software package. Using the following command to install the key:
   
   rpm --import http://atmail.com/atmail-publickey.pub
   
   Then re-install using the yum command to resume installation.

8. Contact Support

For additional support, please visit the @Mail Knowledge base at: http://kb.atmail.com/ for Hints/Tips and advice on how to install and administer the software.

For technical support via email please contact: support@CalaCode.com