Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Known Issues
{{MessageBox|backgroundcolor = #FBB|image =Warning.png|heading =WARNING|message = This should only be attempted by advanced users.<br>It is still under development.}}<b>DISCLAIMER:</b> This is for Amahi 7 on [[Fedora_19|Fedora 19]] <u>ONLY</u>! Although tested, use at your own risk. I cannot guarantee that it will work for your system or not cause any serious problems.<br /><br /> ==== Purpose ====The primary intent of the [http://www.amahi.org/apps/amahi-mail-system Amahi Mail System] is to allow you to use your Home Digital Assistant ([[Intro|HDA]]) as a mail server. * It allows you to send/receive mail from your [[Intro|HDA]]. There are some quirks depending on if you have a registered domain with a paid service provider (i.e. [http://www.godaddy.com GoDaddy], [http://www.hostgator.com Host Gator], etc). With these services, there is typically what is called a MX record associated with the domain name. This will allow you to send/receive mail as your hostname (i.e. myhda@home.com). * If you use the free ones (i.e. user.yourhda.com, [Categoryhttp:Apps//www.no-ip.org no-ip.org], etc), you will have to [[Masquerade_email_address|masquerade your email address]] as your ISP (i.e. myhda@yourisp.com). This will ensure you can receive email replies from those you send from your [[Intro|HDA]]. ==== Current Version ====1.05 ([[Fedora_19|Fedora 19]]) released January 1, 2014 ==== Known Issues ====* During the configuration, the ClamAV definitions download sometimes takes too long. It can cause the setup to fail, depending on availability of their server.** The proposed work around is to run the ClamAV virus definition update after setup is complete.** Comment out line 164 (<code>/usr/bin/freshclam -v</code>) in ''mail-setup.sh'' script. ** Run this separately after configuration is complete when you will see the notification ''You have 2 new messages.'' ==== Change Log ====* Upgraded to [[Amahi_7|Amahi 7]] on [[Fedora_19|Fedora 19]]* Added 32-bit binaries* Changed web page background color* Remove quota info from web pages* Enable port 587 for sending mail* Removed mail quota from Postfix configuration* Fixed certificate errors when using spaces* Streamlined uninstall script for better cleanup* Added script to update mail certificate* Inserted additional logging messages ==== Future Enhancements ====* Expand instructions to include how to configure mail clients* Incorporate a mail backup mechanism* Streamline code and validate form fields* Move mailbox data files to share (See [[Amahi_Mail_System#Tips|Tips]] below) ==== How to Install/Uninstall (Automated) ====* Special access must be requested to install [http://www.amahi.org/apps/amahi-mail-system Amahi Mail System].* Once granted, install/uninstall via the Applications tab in the Amahi Dashboard. ==== How to Install (Manual) ====
Here's the sequence of events to get the virtual email server up and running:# Restart your [[Intro|HDA]] so it's fresh for the install. This is not required, just a recommendation.# Open terminal [[Open_Terminal_as_root|as '''root''' user]], and create a web app in Amahi named '''ams''' (Amahi application [https://www.amahi.org/apps/web-apps Web App] provides this capability.).# Navigate to '''''/var/hda/web-apps/ams''''' directory.# Download [https://dl.dropboxusercontent.com/u/1380867/mail-server-1.05.zip mail-server-1.05.zip] (sha1sum 4d5623d5d00a4d66512455deaec688fc49a34782) to this directory and extract it into '''''html''''' directory of '''''ams''''' (archive [http://dl.getdropbox.com/u/1380867/FilesList.html file list]).# Ensure you recursively change ownership of the files to apache:users.# Need to make a directory called '''''elevated''''' in '''''ams'''''. Copy mail-setup.sh and del-maildir.sh to that location.# Ensure mail-setup.sh and del-maildir.sh are executable.# Create the database and insert the data from the mail.sql file located in the '''''config''''' directory. # Navigate to <b>DISCLAIMER<nowiki>http://ams</nowiki></b> Although this has been testedin your favorite web browser and you should see the login page.# Enter credentials (admin/amahi) and choose Login to display the install page (See [[Amahi_Mail_System#Tips|Tips]] for how to change the login info).# Complete all the required info. Once finished, use at your own riskselect the click the '''NEXT''' button and the data will be added to the database. I cannot guarantee that # Next, a screen will appear with a '''INSTALL''' button, click it to begin. You will work for also notice a log link so you can monitor the install.# Use your favorite mail client, [http://www.amahi.org/apps/roundcube Roundcube], [http://www.amahi.org/apps/atmail AtMail], or [http://www.amahi.org/apps/squirrelmail SquirrelMail] to access your system new mail account.# Use the built-in tool to manage Virtual User information in the database. [http://www.amahi.org/apps/dadabik DadaBIK], [http://www.amahi.org/apps/phpmyadmin phpMyAdmin], or not cause any serious problems[http://www.amahi.org/apps/adminer Adminer] can also be utilized.
===== Example Install Terminal Session =====
<pre>su -
cd /var/hda/web-apps/ams
wget https://dl.dropboxusercontent.com/u/1380867/mail-server-1.05.zip
mkdir -p elevated
cd html
unzip ../mail-server-1.05.zip
chmod 755 *.sh
chown -R apache:users * ../elevated
cp mail-setup.sh ../elevated
cp del-maildir.sh ../elevated
hda-create-db-and-user mail
mysql -umail -pmail mail < config/mail.sql</pre>
<u>FetchYahoo</u>
Add capability to fetch Yahoo mail:
* Download the latest [http://fetchyahoo.twizzler.org/ FetchYahoo]
* Install instructions included
==== Pre-Configuration Tips ====
* To permanently change your hostname from '''localhost.localdomain''', see this [http://www.labtestproject.com/using_linux/permanently_change_hostname_on_fedora article].
* Since You can change the Postfix RPM was built custom, it needs to be excluded from updates. Failure to do so could break your Amahi Mail System after updatesLogin Credentials for the integrated database manager/web-based installer by doing the following:** Open the Login-class. Make php file in the following change to '''''/etcvar/yum.confhda/web-apps/ams/html''''':directory** On lines 29 and 32, change to whatever works for you exclude=postfix** Save and now you can log in using the new credentials
* Change the sender default email address format (i.e. root@hda.amahi.net) by following [[Masquerade_email_address|Masquerade email address]] tutorial.
* Move mailbox data files to share
** <u>MUST</u> be accomplished prior to doing the install (Step #12).
** Will ensure if you uninstall, mailbox data files will be preserved.
** Create a new [[Storage_and_file_sharing#Step_2:_Create_Shares|share]] named <b>ams</b> in Amahi dashboard Shares tab.
** Open terminal [[Open_Terminal_as_root|as '''root''' user]] and execute the following commands:
cd /var/hda/web-apps/ams
sed -i '57s|/home/vmail|/var/hda/files/ams|' html/mail-setup.sh;
sed -i '65s|/home/vmail|/var/hda/files/ams|' html/mail-setup.sh;
sed -i '74s|/home/vmail|/var/hda/files/ams|' html/users.php;
sed -i '12s|/home/vmail|/var/hda/files/ams|' html/config/authmysqlrc;
==== Version Changes Troubleshooting====* Added option for secure(https) or unsecure(http) webmail accessShould your mail server hang up and stop working, you can most likely fix it with the <b>mail-stop.sh</b> and <b>mail-start.sh</b> scripts included in the app. Open terminal [[Open_Terminal_as_root|as '''root''' user]] and do the following:<pre>cd /var/hda/web-apps/ams/html./mail-stop.sh./mail-start.sh</pre>
* If you get the message " warning: SASL authentication failure: No worthy mechs found." [[Open_Terminal_as_root|open a terminal as '''root''']] and execute the following:
yum install cyrus-sasl{,-plain}
: Restart Postfix
systemctl restart postfix
<!--* Add '''NEW''' users to the foo.com domain (does not include any DNS MX records). Modify the '''mail''' database and substitute your information accordingly:
*# In the '''users''' table, insert a new record with the following information...
*#* ''user'': <u>user@foo.com</u>
*#* ''password'': choose 'ENCRYPT' for the function and enter the users password. (Alternatively, you can have the user enter their password)
*#* ''quota'': do NOT edit this field (unless you know what you are doing)
*# In the '''forwardings''' table, insert a new record for each forwarded email addresses to <u>user@foo.com</u>
*# Run the command line below to set up the '''''/home/vmail/foo.com/user''''' mail files:
{{Code|mailx -s Welcome user@foo.com < /var/hda/web-apps/ams/html/config/welcome.txt}}
* Add an additional mail domain (does not include any DNS MX records). Modify the ''mail'' database and substitute your information accordingly:
*# Scenario - Creating a mail domain e.g. :
*#* ''domain'' is: <u>bar.com</u>
*#* ''server'' is: <u>foo.bar.com</u>
*#* ''admin user'' is: <u>me@bar.com</u>
*# In the mail mySQL database tables:
*#* ''domain'': add <u>bar.com</u>
*#* ''transport'': add <u>bar.com</u>
*#* ''user'': add <u>me@bar.com</u>
*#* ''forward'': add <u>postmaster@bar.com</u>, and <u>abuse@bar.com</u> to <u>me@bar.com</u>
*# Run the command line below to set up the '''''/home/vmail/bar.com/me''''' mail files:
{{Code|mailx -s Welcome me@bar.com < /var/hda/web-apps/ams/html/config/welcome.txt}}
* For every domain supported, the following either need to be added as users or forwarded. Without them a site MAY end up on various spam block lists:
{{Text|Text=postmaster@foo.com
abuse@foo.com}}-->
<!--* Some ISPs block port 25 for mail. Thus a remote user would be able to retrieve mail, but not send mail. To accommodate this, port 587 is used by email clients for sending mail.
*# To enable port 587, edit '''''/etc/postfix/master.cf''''' and uncomment the line starting with "# submission"
*# Reload postfix -->
