Trusted, Bureaucrats, Administrators
12,424
edits
Changes
From Amahi Wiki
→Known Issues
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 64-bit ]] <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 />
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, [http://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.0 05 ([[Fedora_19|Fedora 19]]) released November 23January 1, 20132014
==== Known Issues ====
* Quota information present in During the configuration, the ClamAV definitions download sometimes takes too long. It can cause the database needs setup to fail, depending on availability of their server.** The proposed work around is to be removed or hiddenrun the ClamAV virus definition update after setup is complete.* 32* Comment out line 164 (<code>/usr/bin/freshclam -bit binaries need to be builtv</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 ====
* Incorporate a mail backup mechanism
* Streamline code and validate form fields
* Enable port 587 for sending mailMove mailbox data files to share (See [[Amahi_Mail_System#Tips|Tips]] below)
==== How to Install/Uninstall (Automated) ====
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.# Create Open terminal [[Open_Terminal_as_root|as '''root''' user]], and create a web app in Amahi named '''ams''' (see Amahi application [[Amahi_7_Create_Manual_Web_App|Create Manual https://www.amahi.org/apps/web-apps Web App in Amahi 7]]provides this capability.).# Open a terminal window, become '''root''', and navigate Navigate to '''''/var/hda/web-apps/ams''''' directory.# Download [https://dl.dropboxusercontent.com/u/1380867/mail-server-1.005.zip mail-server-1.005.zip] (sha1sum 6a2cb6aa290644c9faba1fe89bf13dd9e185ef214d5623d5d00a4d66512455deaec688fc49a34782) to this directory and extract it into '''''html''''' directory of '''''ams''''' (archive [http://dl.getdropbox.com/u/1380867/FilesList.html contentfile 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><nowiki>http://ams </nowiki></b> in 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, select the click the '''NEXT''' button and the data will be added to the database.
# Next, a screen will appear with a '''INSTALL''' button, click it to begin. You will also notice a log link so you can monitor the install.
===== Example Install Terminal Session =====
cd /var/hda/web-apps/ams
wget https://dl.dropboxusercontent.com/u/1380867/mail-server-1.005.zipmkdir -p elevated
cd html
unzip ../mail-server-1.005.zipchmod 755 *.shchown -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>
==== How to Uninstall (Manual) ====
To uninstall, do the following:
# Open a terminal window, become [[Open_Terminal_as_root|as '''root'''user]], and navigate to '''''/var/hda/web-apps/ams/html''''' directory.
# Remove the database.
# Ensure mail-remove.sh is executable.
# From the '''''html''''' directory, run the script. This may take a while to complete.
# Remove the web app in Amahi named '''ams''' (see [Amahi application [Amahi_7_Create_Manual_Web_App|Create Manual https://www.amahi.org/apps/web-apps Web App in Amahi 7]] provides this capability.) and close the terminal window.
===== Example Uninstall Terminal Session =====
cd /var/hda/web-apps/ams/html
hda-create-db-and-user -d mail
./mail-remove.sh}}</pre><br>
==== Add-Ons ====
You can now add the Mailman software to your Amahi Mail System. Follow the instructions at [http://wiki.amahi.org/index.php/Amahi_Mailman Amahi Mailman].
<u>FetchYahoo</u><br>
Add capability to fetch Yahoo mail:
* Download the latest [http://fetchyahoo.twizzler.org/ FetchYahoo]
==== Tips ====
* To permanently change your hostname from '''localhost.localdomain''', see this [http://www.labtestproject.com/using_linux/permanently_change_hostname_on_fedora article].
* You can change the Login Credentials for the integrated database manager/web-based installer by doing the following:
*# * Open the Login-class.php file in the '''''/var/hda/web-apps/ams/html''''' 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 ./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; ====Troubleshooting====* Should 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...
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.ccf'''''f and uncomment the line starting with "# submission"
*# Reload postfix -->
==== Conclusion ====
You should now be able to log in to your account. There will be 2 messages, one is a welcome and the other is a SPAM test to show it's working. Direct any questions or comments to <<u>support [at] https://forums.amahi [dot.org the forums] org</u>>.
