AfterLogic XMail Server Pro Installation Instructions (Linux)

Instructions on Linux from RPM package
Install on *nix from source distribution

AfterLogic XMail Server Pro Installation from RPM package

  1. Run rpm -Uvh afterlogic-xmail-pro-[VERSION].rpm and complete the installation process.
  2. Open http://your_server_name/webmail/adminpanel page in your browser.
  3. Use "mailadm" as Login name and "12345" as Password (it is strongly recommended to change this password in the future).
  4. First of all, you should specify your license key. Until you do this, all other settings will be inaccessible.
  5. Now, you should configure your AfterLogic XMail Server installation, in particular, enable/disable and configure e-mail protocols, logging, spam protection, change admin password, etc. These general settings are available in Server tab:
  6. Now it's time to configure it, i.e. you should edit the following settings in WebMail tab:
  7. Select "Database Settings". Choose database type you wish to use: MS SQL Server or MySQL Server. To use MS SQL Server or MySQL Server database, fill "SQL Login", "SQL Password" and "Database Name" fields. If you wish to connect through DSN, you need to fill "Data Source" field. Otherwise, to connect through TCP/IP, fill "Host" field. If MySQL or MSSQL are used, you should click "Save" button and then "Create Tables" button (or "Update tables" button if you're about to update your WebMail installation from v4.2.x or below). If you didn't install WebMail Pro, just skip this step.
  8. The next step is to create necessary domains and users. You can do this in Domains and Users tabs.
  9. AfterLogic XMail Server Pro and WebMail Pro (if you installed it) are ready to use.

    Now you can start using WebMail Pro at http://your_server_name/webmail/index.php.

AfterLogic XMail Server Pro Installation from source distribution

  1. Unpack the source archive:

    tar xivf afterlogic-xmail-pro-[VERSION].tar.bz2
    cd afterlogic-xmail-pro-[VERSION]
  2. Build and install Afterlogic XMail Server:

    make -f Makefile.lnx
    cp -r MailRoot /var/
  3. Copy and symlink xmail startup script into actual rcX runlevel folder, for example - runlevel 3:

    cp xmail /etc
    chmod 755 /etc/xmail
    ln -s /etc/xmail /etc/rc3.d/S99xmail
  4. Start AfterLogic XMail Server:

    /etc/xmail start
  5. Copy webmail folders contents from the source archive into a subfolder of web-folder on your web server. For example into:

    /var/www/html/webmail
  6. Now you should assign owners and their rights:

    Change the current working directory to the folder with WebMail Pro PHP scripts:
    cd /var/www/html/webmail/

    Then, assign rights to folders and files in the WebMail Pro PHP scripts folder.

    Assign rights to folders:
    find . -type d -exec chmod 755 {} \;

    and to files:
    find . -type f -exec chmod 644 {} \;

    Now assign owner to folders and files in the WebMail Pro PHP scripts folder. You should assign the same owner other folders/files in /var/www/html/ have (assuming they have the correct owner set).

    Assign owner to folders:
    find . -type d -exec chown root.root {} \;

    and to files:
    find . -type f -exec chown root.root {} \;

    Then, change the current directory to the WebMail Pro PHP data folder (by default, it's a sub-folder of the folder which contains WebMail Pro PHP scripts):
    cd /var/www/html/webmail/data

    Now assign rights to folders and files in data folder.

    Assign rights to folders:
    find . -type d -exec chmod 755 {} \;

    and to files:
    find . -type f -exec chmod 644 {} \;

    Then, assign owner (usually, apache.apache) to folders and files in the WebMail Pro PHP data folder. Please note, Apache may be sometimes started under another user account (for example, under nobody.nogroup).

    Generally speaking, with setting the correct owner on data folder you will make sure Apache process (httpd) has read/write permissions to that folder. Thus, you should set the user account running Apache as the owner of data folder contents.

    Assign owner to folders:
    find . -type d -exec chown apache.apache {} \;

    and to files:
    find . -type f -exec chown apache.apache {} \;

    If the permission settings described above don't work for you, you may try to repeat "Assigning owners/permissions" step, but use 777 instead of 755 and 666 instead of 644 (although this is less secure).

  7. Open http://your_server_name/webmail/adminpanel page in your browser.
  8. Use "mailadm" as Login name and "12345" as Password (it is strongly recommended to change this password in the future).
  9. First of all, you should specify your license key in License Key tab. Until you do this, all other settings will be inaccessible.
  10. Now, you should configure your AfterLogic XMail Server installation, in particular, enable/disable and configure e-mail protocols, logging, spam protection, change admin password, etc. These general settings are available in Server tab:
  11. Now it's time to configure it, i.e. you should edit the following settings in WebMail tab:
  12. Select "Database Settings". Choose database type you wish to use: MS SQL Server or MySQL Server. To use MS SQL Server or MySQL Server database, fill "SQL Login", "SQL Password" and "Database Name" fields. If you wish to connect through DSN, you need to fill "Data Source" field. Otherwise, to connect through TCP/IP, fill "Host" field. If MySQL or MSSQL are used, you should click "Save" button and then "Create Tables" button (or "Update tables" button if you're about to update your WebMail installation from v4.2.x or below). If you didn't install WebMail Pro, just skip this step.
  13. The next step is to create necessary domains and users. You can do this in Domains and Users tabs.
  14. AfterLogic XMail Server Pro and WebMail Pro (if you installed it) are ready to use.

    Now you can start using WebMail Pro at http://your_server_name/webmail/index.php.