The Community Forums

Interact with an entire community of cPanel & WHM users!
  1. This site uses cookies. By continuing to use this site, you are agreeing to our use of cookies. Learn More.

Installing @Mail 5.3 on Cpanel Server.

Discussion in 'cPanel Developers' started by pinepapplepete, Jun 16, 2008.

  1. pinepapplepete

    pinepapplepete Registered

    Joined:
    Jun 16, 2008
    Messages:
    2
    Likes Received:
    0
    Trophy Points:
    1
    This is a guide for those of you who wish to use @Mail with your CPanel system as a replacement to CPanel's WebMail Client.

    This is a guide to installing th WebMail Client Only version of @Mail.

    For details visit: http://atmail.com

    1) Before you install: requirements and dependencies

    @Mail requires the following software:

    * MySQL Libraries - http://www.mysql.com/
    * Apache Webserver - Usually installed by default with most Linux Distributions and Unix Variants - http://httpd.apache.org/
    * PHP 4.X or newer - http://www.php.net/
    * PHP MySQL support - http://us2.php.net/mysql
    * Mail Parse extension - PECL :: Package :: mailparse. http://pecl.php.net(For Red Hat based systems you can use the php-pecl-mailparse package found in the DAG repository.)
    * Set Max Filesize Upload PHP variable to 16MB or higher - Set the php.ini variable upload_max_filesize to larger than 16MB (higher for larger attachment support). Usually php.ini is located at /etc/php.ini. You will need to restart the web server to enable this change.

    2) Download and extract @Mail WebMail Client Download the @Mail archive and extract it.

    tar xvzf atmailphp5.tgz -C /tmp

    Move the webmail directory under your web server’s DocumentRoot, or VirtualHost directory (These can be found in your apache configuration file.)

    mv /tmp/atmail/ /path/to/document/root/atmail/

    Next, change the ownership of the directory to the web server user. This is required for @Mail to save configuration files via the web and used during the install process. For example:

    chown -R nobody /path/to/documntroot/atmail/

    3) Installation Wizard

    You are now ready to access your website and begin the installation process. Point your browser to your webserver http://yourdomain.com/atmail/
    @Mail Pre-Installation Check
    At the @Mail Pre-installation check screen, you will be shown information any problems with needed server software and PHP settings. You may end up needing to make some changes to your /etc/php.ini file, or find that you need to install various software dependencies.

    When you are ready, select Continue to proceed with the installation.

    Step 1)

    [​IMG]

    Please select a default language and read through the license agreement. Select Yes I agree to the above license and Continue once you are happy with the license agreement and language.

    If you experience troubles here and you are unable to proceed past Step 1, you will have to make some changes to the following files. After these changes have been made you will be able to continue with the installation.

    /path/to/document/root/atmail/install/html/english/step1.phtml
    /path/to/document/root/atmail/install/step1.php
    /path/to/document/root/atmail/install/index.php

    /path/to/document/root/atmail/install/html/english/step1.phtml

    Find:

    <select name=”lang”>
    <option value=”\”>$name</option>
    </select>


    Change to:

    <select name=”atmail_lang”>
    <option value=”\”>$name</option>
    </select>


    /path/to/document/root/atmail/install/step1.php

    Find:

    if (isset($_POST[’submit’]) && isset($_REQUEST[’lang’]))
    {
    if (in_array($_REQUEST[’lang’], $supportedLanguages))
    $_SESSION[’step1′][’lang’] = $lang = $_REQUEST[’lang’];
    else
    $errors[’invalid_lang’] = true;


    Chnge to:

    if (isset($_POST[’submit’]) && isset($_REQUEST[’atmail_lang’]))
    {
    if (in_array($_REQUEST[’atmail_lang’], $supportedLanguages))
    $_SESSION[’step1′][’atmail_lang’] = $lang = $_REQUEST[’atmail_lang’];
    else
    $errors[’invalid_lang’] = true;


    /path/to/document/root/atmail/install/index.php

    Find:

    // Set our lang var if known
    $lang = isset($_SESSION[’step1′][’lang’]) ? $_SESSION[’step1′][’lang’] : ‘english’;


    Change to:

    // Set our lang var if known
    $lang = isset($_SESSION[’step1′][’atmail_lang’]) ? $_SESSION[’step1′][’atmail_lang’] : ‘english’;

    Step 2)

    [​IMG]

    If possible use a non-privileged mysql account, not the default root user. The default database name is atmail. If this is a new installation, you should see check boxes that allow you to create the @Mail database and it’s tables.

    NOTE: If you are re-installing @Mail with an existing database make sure to remove any check mark in the database creation options.

    Select Continue when you are ready to proceed.

    Step 3)

    [​IMG]

    Next, you must define the SMTP hostname for Webmail to send outgoing messages. By default the localhost SMTP server is used, you may need to define another SMTP server if one is not running on the local server.

    SMTP/Admin Email Selection

    Make sure you have access to relay messages via the SMTP server and that the IP address of your server is allowed to send messages.

    Next, define the administrative email-address, this address will be used in the WebMail interface to notify end users of who to contact for support.

    Select Continue when you are ready to proceed.

    Step 4)

    [​IMG]

    You must register your copy of @Mail. Please follow the links to generate a new serial key so as to most accurately reflect this installation.

    Select Continue when you are ready to proceed.

    Step 5)

    [​IMG]

    @Mail includes an administration panel which is used to control users, modify system settings, view logs and run system maintenance tasks. You should specify the username and password you wish to use for the WebAdmin panel. The installer will create an Apache .htaccess file to password-protect the directory.

    4) @Mail installation is now complete.

    For additional support, please visit our web site http://atmail.com/ - Or send us an Email : support@staff.atmail.com
     

Share This Page