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

From Libopedia
Jump to navigation Jump to search
 
(141 intermediate revisions by the same user not shown)
Line 1: Line 1:
 
<center>
 
<center>
−
'''[[SUNScholar/Prepare Ubuntu|Prepare Ubuntu - Index]]'''
+
  '''[[SUNScholar/Prepare Ubuntu/S08|NEXT - STEP 8]]'''
 
</center>
 
</center>
  
−
==Step 7. Setup the Postfix mail server==
+
==Step 7. Install the Postfix mail server==
−
==Step 7.1: Install the software==
+
DSpace needs to send emails in order to facilitate submission workflows etc.
−
In order to be able to use email with your Dspace server install the postfix mail server as follows:
+
 
−
sudo apt-get install postfix
+
<font color="red">'''Ideally before setting this up, you should speak to your campus email administrator.'''</font>
  
 +
==Local Postfix Email Sending Server Installation==
 +
===Step 7.1: First we purge old software===
 +
Type the following;
 
  sudo dpkg --purge exim4
 
  sudo dpkg --purge exim4
  
−
==Step 7.2: Setup the mail server config files==
+
===Step 7.2: Then we install the Postfix software===
−
Next we edit the Postfix '''main.cf''' file as follows:
+
Install the Postfix mail server by typing 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.''
+
When asked for type of setup, select "'''Internet with Smarthost'''".
  
−
See below for an example of the config file:
+
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.
−
<pre>
 
−
# See /usr/share/postfix/main.cf.dist for a commented, more complete version
 
  
 +
See links below for more detail before continuing.
 +
sudo apt-get install postfix
 +
*http://help.comodo.com/topic-157-1-288-4540-configuring-postfix-to-use-a-smarthost.html
 +
*http://www.dnsexit.com/support/mailrelay/postfix.html
 +
*http://gopalthorve.com/install-postfix-mta-and-configure-smarthost
  
−
# Debian specific:  Specifying a file name will cause the first
+
===Step 7.3: Finally we setup a default mailname===
−
# line of that file to be used as the name.  The Debian default
+
Now we edit the servers "mailname" by typing as follows:
−
# 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.
 
−
 
 
−
{{NANO}}
 
−
 
 
−
==Step 7.3: Setup default mailname==
 
−
Now we edit the servers mailname by typing as follows:
 
 
  sudo nano /etc/mailname
 
  sudo nano /etc/mailname
−
Add one line only which should be the hostname of your server.
+
Add one line only which should be the hostname (URL) of your server, for example: ''scholar.sun.ac.za''.
  
−
{{NANO}}
+
==Optional Extras==
 +
*[[SUNScholar/Prepare Ubuntu/S07/Alternatives|Alternative Sender Email Server Gateway Choices]]
 +
*[[SUNScholar/Prepare Ubuntu/S07/Advanced|Advanced Postfix Email Sender Configuration]]
 +
*[[SUNScholar/Prepare Ubuntu/S07/Testing|Email Tests]]
  
−
Now we restart Postfix by typing as follows:
+
==References==
−
sudo /etc/init.d/postfix restart
+
*https://help.ubuntu.com/community/Postfix
−
 
+
*http://www.smtp2go.com/docs/postfix
−
==Step 7.4: Setup the email aliases==
+
*http://www.tecmint.com/setting-up-email-services-smtp-and-restricting-access-to-smtp
−
The "root" and dspace user email address are setup as follows.
+
*http://www.tecmint.com/setup-postfix-mail-server-in-ubuntu-debian
−
 
+
*https://www.linux.com/learn/how-install-and-test-postfix-mail-server
−
Type the following.
+
*https://easyengine.io/tutorials/mail/postfix-debugging
−
sudo nano /etc/aliases
+
*http://manage.jujucharms.com/charms/precise/postfix
−
Add aliases as per example below:
+
*http://xmodulo.com/2014/01/how-mail-server-works.html
−
<pre>
+
*http://blog.stuartlewis.com/2009/09/05/using-gmail-with-dspace
−
# Added by installer for initial user
+
*https://roundcube.net
−
root:  me@my.edu.ac.za
+
*http://wiki.lib.sun.ac.za/index.php/SUNScholar/Install_DSpace/S09
−
dspace: me@my.edu.ac.za
+
<center>
−
</pre>
+
   '''[[SUNScholar/Prepare Ubuntu/S06|PREVIOUS - STEP 6]]'''
−
Change the '''me@my.edu.ac.za''' to your email address.
+
</center>
−
 
 
−
{{NANO}}
 
−
 
 
−
To activate the new aliases type the following:
 
−
sudo newaliases
 
−
 
 
−
==Step 7.5: Send a test email to root==
 
−
Install the command line mailer program as follows:
 
−
sudo apt-get install mailutils
 
−
Now we can send a test email to the root user by typing as follows:
 
−
mail -s "Test Email from root" root
 
−
Press the "Enter" key and type some message content. Press '''CTL+D''' and then '''Enter''' to send the mail.
 
−
 
 
−
Check the following log for any delivery errors as follows:
 
−
sudo tail -n 20 /var/log/mail.log
 
−
If there are no delivery errors your mail server is setup. Well done.
 
−
----
 
−
Below is a screenshot of the yearly postifx  mail queue
 
−
 
 
−
[[File:Sunscholar-postfix mailqueue-year.png]]
 
−
 
 
−
   '''[[SUNScholar/Prepare Ubuntu/S06|PREVIOUS]]'''
 
  
−
  '''[[SUNScholar/Prepare Ubuntu/S08|NEXT]]'''
+
[[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"