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 January 1, 2014
==== Known Issues ====
==== Change Log ====
* Upgraded to [[Amahi_7|Amahi 7]] on [[Fedora_19|Fedora 19]]
* Added 32-bit binaries
* Changed web page background color
* 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.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]).
==== 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 =====
* 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 Daysfor 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
** This should <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 <u>new [[Storage_and_file_sharing#Step_2:_Create_Shares|share</u> ]] named <b>ams</b> in Amahi dashboard Shares tab.** Open terminal [[Open_Terminal_as_root|Open a terminal as '''root'''user]] and execute the following commands:
cd /var/hda/web-apps/ams
sed -i '55s57s|/home/vmail|/var/hda/files/ams|' html/mail-setup.sh; sed -i '63s65s|/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/authmsqlrcauthmysqlrc; ====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...
