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]] <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 />
==== Current Version ====
1.04 05 ([[Fedora_19|Fedora 19]]) released December 31January 1, 20132014
==== Known Issues ====
* Certificate not generated if spaces used in credentialsDuring the configuration, the ClamAV definitions download sometimes takes too long. Until resolved It can cause the setup to fail, substitute underscores 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>) for spaces in Country, State, City, Organization, or Unit''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
* 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.
# Open terminal [[Open_Terminal_as_root|Open a terminal 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.).
# Navigate to '''''/var/hda/web-apps/ams''''' directory.
# Download [https://dl.dropboxusercontent.com/u/1380867/mail-server-1.0305.zip mail-server-1.0305.zip] (sha1sum ac1358a89ada6be4b810259908c81e5e05bb06314d5623d5d00a4d66512455deaec688fc49a34782) 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.
<pre>su -
cd /var/hda/web-apps/ams
wget https://dl.dropboxusercontent.com/u/1380867/mail-server-1.0305.zipmkdir -p elevated
cd html
unzip ../mail-server-1.0305.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 terminal [[Open_Terminal_as_root|Open a terminal 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 =====
<pre>su -
cd /var/hda/web-apps/ams/html
hda-create-db-and-user -d mail
./mail-remove.sh</pre><br>
* 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|Open a terminal as '''root'''user]] and do the following:
<pre>cd /var/hda/web-apps/ams/html
./mail-stop.sh
./mail-start.sh</pre>
* Change If you get the sender default email address format (imessage " warning: SASL authentication failure: No worthy mechs found.e. root@hda.amahi.net) by following " [[Masquerade_email_addressOpen_Terminal_as_root|Masquerade email addressopen a terminal as '''root''']] tutorial.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...
==== 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. Direct any questions or comments to <<u>support [at] https://forums.amahi [dot.org the forums] org</u>>.
