Changes

From Amahi Wiki
Jump to: navigation, search
2,005 bytes added ,  00:50, 20 March 2015
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 14 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 />
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.8.6 05 ([[Fedora_19|Fedora 1419]]) released May 11January 1, 20112014
==== Known Issues ====
* Creating new users does not automatically create During the configuration, the user's mailboxClamAV definitions download sometimes takes too long. Workaround It can cause the setup to fail, depending on availability of their server.** The proposed work around is to send an email from an existing user to run the new userClamAV virus definition update after setup is complete.* Deleting users does not remove their mailbox. In terminal as root user, do ''rm -rf * Comment out line 164 (<code>/homeusr/vmailbin/domainfreshclam -v</usercode>) in ''mail-setup.sh'' script. ** Run this separately after configuration is complete when you will see the notification '' ( change domain and user to match your system)You have 2 new messages.''
==== Change Log ====
* Upgraded to [[Amahi_7|Amahi 7]] on [[Fedora_19|Fedora 1419]]* Command line installation replaced with a WebAdded 32-based installerbit binaries* Removed custom built Postfix (with Quota support) and Maildrop packages* Included Fedora Postfix and Maildrop packagesChanged web page background color* Removed DCC due to instability on install* Packaged [http://www.amahi.org/apps/squirrelmail SquirrelMail] separately, removing it Remove quota info from the coreweb pages* Store system settings (host, user, and certificate information) in MySQL database* New logo and screen shot Enable port 587 for applicationsending mail* Added Instructions to explain initial setup and Virtual User Management* Refined input form to detect HDA hostname and first userRemoved mail quota from Postfix configuration* Fixed Log display to not redirect certificate errors when install finishesusing spaces* Added initial Login Credentials to install log* Updated missing Postfix configuration entries* Changed Welcome/SPAM Test mail to be sent by postmaster* Included configuration information in install log* Added database front-end Streamlined uninstall script for virtual user management* Created separate install and help guidance* Enabled port 587 for sending mailbetter cleanup* Added user authentication script to secure integrated database managerupdate mail certificate* Minor code updates to secure install* Streamlined forms and minor code updatesInserted additional logging messages
==== Future Enhancements ====
* 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) ====
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.# Enable Advanced Settings in the Amahi Dashboard (Settings-->Settings)# Create Open terminal [[Open_Terminal_as_root|as '''root''' user]], and create a web app in Amahi named '''mailams'''(Amahi application [https://www.amahi.org/apps/web-apps Web App] provides this capability.).# Open a terminal window, become Navigate to '''root''', and navigate to <u>/var/hda/web-apps/mail</u> ams''''' directory.# Download [httphttps://dl.getdropboxdropboxusercontent.com/u/1380867/mail-server-1.8.6.tar05.gz zip mail-server-1.8.6.tar05.gzzip] (sha1sum b7dc87c5373d06772e1693fcc5844882d8dbebab4d5623d5d00a4d66512455deaec688fc49a34782) to this directory and extract it into <u>'''''html</u> ''''' directory of mail '''''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 <u>'''''ams'''''. Copy mail</u> -setup.sh and copy maildel-setupmaildir.sh to that location.# Ensure mail-setup.sh is and del-maildir.sh are executable.# Create the database and insert the data from the mail.sql file located in the <u>conf</u> '''''config''''' directory. # Navigate to <b><nowiki>http://mail 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. Ensure you do not uses spaces in any data fields (i.e. mycity, my_city, or my.city are acceptable). 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.
# 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 new mail account.
===== Example Install Terminal Session =====
{{Code|<pre>su -cd /var/hda/web-apps/mailamswget httphttps://dl.getdropboxdropboxusercontent.com/u/1380867/mail-server-1.8.6.tar05.gzzipmkdir -p elevated
cd html
tar -xzpf unzip ../mail-server-1.805.zipchmod 755 *.6shchown -R apache:users * .tar.gz/elevated
cp mail-setup.sh ../elevated
chmod 755 ../elevated/mailcp del-setupmaildir.shchown -R apache:users ../html ../elevated
hda-create-db-and-user mail
mysql -umail -pmail mail < confconfig/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 <u>'''''/var/hda/web-apps/mailams/html</u> ''''' directory.
# Remove the database.
# Ensure mail-remove.sh is executable.
# From the '''''html''''' directory, run the script. This may take a while to complete.# Close the terminal window and remove Remove the web app in Amahi named '''mailams'''(Amahi application [https://www.amahi.org/apps/web-apps Web App] provides this capability.) and close the terminal window.
===== Example Uninstall Terminal Session =====
{{Code|<pre>su -cd /var/hda/web-apps/mailams/htmlchmod 755 mail-remove.sh
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...
*#* ''user'': <u>user@foo.com</u>
*#* ''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/mailams/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. :
*#* ''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/mailams/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 -->
==== 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>>.
<b>NOTE:</b> These scripts were adapted from the [http://www.howtoforge.com/virtual-users-and-domains-with-postfix-courier-mysql-and-squirrelmail-fedora-1418-x86_64 Virtual Users And Domains With Postfix, Courier, MySQL And SquirrelMail (Fedora 14 18 x86_64)] tutorial written by [http://twitter.com/falko Falko Timme].
[[Category:Apps]]
12,424

edits