Difference between revisions of "SUNScholar/Prepare Ubuntu/S07"

From Libopedia
Jump to navigation Jump to search
 
(15 intermediate revisions by the same user not shown)
Line 6: Line 6:
 
DSpace needs to send emails in order to facilitate submission workflows etc.
 
DSpace needs to send emails in order to facilitate submission workflows etc.
  
−
'''Ideally before setting this up, you should speak to your campus email administrator.'''
+
<font color="red">'''Ideally before setting this up, you should speak to your campus email administrator.'''</font>
  
 
==Local Postfix Email Sending Server Installation==
 
==Local Postfix Email Sending Server Installation==
Line 31: Line 31:
 
Add one line only which should be the hostname (URL) of your server, for example: ''scholar.sun.ac.za''.
 
Add one line only which should be the hostname (URL) of your server, for example: ''scholar.sun.ac.za''.
  
−
==Alternative Sender Email Gateway Choices==
+
==Optional Extras==
−
You can use any email server to facilitate email messaging, however if your campus does not have an email server then you can use gmail as an email gateway. See below for more details.
+
*[[SUNScholar/Prepare Ubuntu/S07/Alternatives|Alternative Sender Email Server Gateway Choices]]
−
 
+
*[[SUNScholar/Prepare Ubuntu/S07/Advanced|Advanced Postfix Email Sender Configuration]]
−
===Using offsite Gmail server gateway===
+
*[[SUNScholar/Prepare Ubuntu/S07/Testing|Email Tests]]
−
If you do not have a campus email server to use, then try using GMail as your email gateway server. See the link below for instructions.
 
−
http://blog.stuartlewis.com/2009/09/05/using-gmail-with-dspace
 
−
<font color="red">'''Please note: For this to work, you will have to make sure the local repository server has unrestricted access to the GMail server via your campus firewall and that all the [[SUNScholar/Firewall|relevant ports are open]] on your local server.'''</font>
 
−
====Gmail Help====
 
−
* https://support.google.com/mail/answer/78775?hl=en
 
−
 
 
−
===Using onsite campus email server gateway===
 
−
Using the campus email server we setup "Postfix" as a "smarthost" which uses the campus email server as the actual MTA (mail transfer agent) to relay email.
 
−
 
 
−
See local Postfix installation steps below for instructions.
 
−
 
 
−
Also see: https://help.ubuntu.com/community/Postfix for further help.
 
−
 
 
−
==Advanced Postfix Configuration==
 
−
If you are satisfied with the installation of Postfix using the step above, you may skip this step. Otherwise continue below.
 
−
 
 
−
To review the Postfix '''main.cf''' file, type as follows:
 
−
sudo nano /etc/postfix/main.cf
 
−
 
 
−
''Tip: It is always a good idea to maximise the open nano window so that the copy and paste of long lines does not wrap around.''
 
−
 
 
−
See below for an example of the config file:
 
−
<pre>
 
−
# See /usr/share/postfix/main.cf.dist for a commented, more complete version
 
−
 
 
−
 
 
−
# Debian specific:  Specifying a file name will cause the first
 
−
# line of that file to be used as the name.  The Debian default
 
−
# is /etc/mailname.
 
−
#myorigin = /etc/mailname
 
−
 
 
−
smtpd_banner = $myhostname ESMTP $mail_name (Ubuntu)
 
−
biff = no
 
−
 
 
−
# appending .domain is the MUA's job.
 
−
append_dot_mydomain = no
 
−
 
 
−
# Uncomment the next line to generate "delayed mail" warnings
 
−
#delay_warning_time = 4h
 
−
 
 
−
readme_directory = no
 
−
 
 
−
# TLS parameters
 
−
smtpd_tls_cert_file=/etc/ssl/certs/%hostname%.pem
 
−
smtpd_tls_key_file=/etc/ssl/certs/%hostname%.key
 
−
smtpd_use_tls=yes
 
−
smtpd_tls_session_cache_database = btree:${data_directory}/smtpd_scache
 
−
smtp_tls_session_cache_database = btree:${data_directory}/smtp_scache
 
−
 
 
−
# See /usr/share/doc/postfix/TLS_README.gz in the postfix-doc package for
 
−
# information on enabling SSL in the smtp client.
 
−
 
 
−
myhostname = %hostname%
 
−
alias_maps = hash:/etc/aliases
 
−
alias_database = hash:/etc/aliases
 
−
myorigin = /etc/mailname
 
−
mydestination = %hostname% localhost
 
−
relayhost = %relay-hostname%
 
−
mynetworks = %my-subnet% 127.0.0.0/8 [::ffff:127.0.0.0]/104 [::1]/128
 
−
mailbox_size_limit = 0
 
−
recipient_delimiter = +
 
−
inet_interfaces = all
 
−
</pre>
 
−
# Change the ''' %hostname%''' to the hostname of your server.
 
−
# Change the '''%relay-hostname%''' to the hostname of your campus email server which sends and delivers email.
 
−
# Add the subnet of your campus TCP/IP network '''%my-subnet%''' to the '''mynetworks''' parameter.
 
−
# Ensure '''mydestination = %hostname% localhost''' to prevent your mail server becoming a spam email relay.
 
−
Talk to the campus system administrator about these settings.
 
−
 
 
−
Also see: http://www.postfix.org/SMTPD_ACCESS_README.html and http://en.wikipedia.org/wiki/Subnet_Mask.
 
−
 
 
−
The postfix server can be re-configured by typing the following:
 
−
sudo dpkg-reconfigure postfix
 
  
 
==References==
 
==References==
 +
*https://help.ubuntu.com/community/Postfix
 
*http://www.smtp2go.com/docs/postfix
 
*http://www.smtp2go.com/docs/postfix
 
*http://www.tecmint.com/setting-up-email-services-smtp-and-restricting-access-to-smtp
 
*http://www.tecmint.com/setting-up-email-services-smtp-and-restricting-access-to-smtp
Line 120: Line 48:
 
*https://roundcube.net
 
*https://roundcube.net
 
*http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace/S09
 
*http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace/S09
−
----
 
−
Below is a screenshot of the yearly postifx  mail queue
 
−
 
−
[[File:Sunscholar-postfix mailqueue-year.png]]
 
−
 
 
<center>
 
<center>
 
   '''[[SUNScholar/Prepare Ubuntu/S06|PREVIOUS - STEP 6]]'''
 
   '''[[SUNScholar/Prepare Ubuntu/S06|PREVIOUS - STEP 6]]'''
Line 130: Line 53:
  
 
[[Category:Installation]]
 
[[Category:Installation]]
 +
__NOTOC__

Latest revision as of 12:56, 26 August 2016

 NEXT - STEP 8

Step 7. Install the Postfix mail server

DSpace needs to send emails in order to facilitate submission workflows etc.

Ideally before setting this up, you should speak to your campus email administrator.

Local Postfix Email Sending Server Installation

Step 7.1: First we purge old software

Type the following; 

sudo dpkg --purge exim4

Step 7.2: Then we install the Postfix software

Install the Postfix mail server by typing as follows;

When asked for type of setup, select "Internet with Smarthost".

The "Smarthost" is your campus email sending server, read the wiki page below for alternatives, if you do not have a campus email sending server.

See links below for more detail before continuing. 

sudo apt-get install postfix

Step 7.3: Finally we setup a default mailname

Now we edit the servers "mailname" by typing as follows: 

sudo nano /etc/mailname

Add one line only which should be the hostname (URL) of your server, for example: scholar.sun.ac.za.

Optional Extras

References

 PREVIOUS - STEP 6
Retrieved from "http://wiki.lib.sun.ac.za/index.php?title=SUNScholar/Prepare_Ubuntu/S07&oldid=44352"