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
==== 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.
=== Current Version = How to Install (Manual) ====1.5 as of 3 Oct 09
===== 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 Login Credentials for the integrated database manager/web-based installer by doing the Postfix RPM was built custom, it needs to be excluded from updatesfollowing:** Open the Login-class. Failure to do so could break your Amahi Mail System after updates. Make php file in the following change to '''''/var/hda/web-apps/etcams/yum.confhtml''''':directory** On lines 29 and 32, change to whatever works for you** 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. * Update mail certificate** Should you need to update the mail certificates, use the mail-cert-update.sh script.** Prior to executing the script, you will want to update the values for Country, State, City, Organization, Organizational Unit, and Number of Days for the certificate to be valid.** Once complete, you can execute the script to update the mail server certificates. su - cd /var/hda/web-apps/ams/html exclude=postfix*./mail-cert-update.sh
* 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;
==== Script download links: Troubleshooting====32* Should your mail server hang up and stop working, you can most likely fix it with the <b>mail-bit: http://dlstop.getdropbox.comsh</u/1380867/32bit-virtual-b> and <b>mail-1.5.tarstart.gzsh<br /b>64-bit: scripts included in the app. httpOpen terminal [[Open_Terminal_as_root|as '''root''' user]] and do the following:<pre>cd /var/dl.getdropbox.comhda/web-apps/uams/1380867html./64bit-virtual-mail-1stop.5sh.tar/mail-start.gzsh<br /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 -->
