DSpace/C2/Email-configuration-for-DSpace-on-Ubuntu-Linux-OS/English

Script : Email Configuration for DSpace

Author : Pankaj Patil

Keywords: DSpace Rebuild, DSpace Email Configuration, dspace.cfg, Rebuild script, DSpace gmail configuration

Visual Cue	Narration
Slide: Title	Welcome to this Spoken Tutorial on Email Configuration for DSpace.
Slide: Learning Objectives	In this tutorial, we will learn to Configure an email for DSpace Prepare a shell script to rebuild DSpace Send a test email from DSpace
Slide: System requirements	This tutorial is recorded using Ubuntu Linux OS 18.04 DSpace version 6.3 gedit text editor and Firefox web browser However you may use any other text editor or browser of your choice.
Slide: Pre-requisites	To practice this tutorial, You should have installed DSpace 6.3 and You should have a working internet connection.
Slide: Pre-requisites	Pre-requisites: You should have familiarity with basic Linux commands. If not then go through the prerequisite Linux tutorials on this website.
Slide : Code files	The commands used in this tutorial are available in the Code Files link on this tutorial page. Please download and extract the file before practicing.
Switch to gedit text editor and open the file	I have opened the code file in the gedit text editor on my machine. And I will use the same file to copy-paste the commands during the demonstration. Shortcut to paste on the terminal is Shift, Ctrl and V keys.
Slide : Necessity of Email Configuration	In DSpace we have to configure the email settings to send emails from DSpace.
Slide : Necessity of Email Configuration	DSpace sends emails to the users for various activities such as *Email verification during registration Notification emails during Item submission and review Getting Dspace user’s feedback and Notifications to Community and Collection subscribers
Only Narration	Let us begin.
Press Ctrl+Alt+T keys	Open the terminal by pressing Ctrl, Alt and T keys simultaneously on the keyboard. Ensure that you have root permissions to run the commands.
Only Narration	Here onwards, please remember to press the Enter key after typing each command.
[Terminal] type: sudo su - dspace	Now, we will login as user dspace. Type sudo su - dspace If prompted, then type the password of the admin user to login.
[Terminal] type: sudo gedit /home/dspace/dspace-6.3-src-release/dspace/config/dspace.cfg	Type the command as shown to open dspace configuration file. If prompted, type the root user password. dspace.cfg file opens in the gedit text editor.
Point to Email settings	Scroll down and locate the Email settings section.
Slide: SMTP Services	DSpace requires SMTP service to send and receive emails. SMTP services like Gmail, SendinBlue, SendGrid, Pepipost, Amazon SES or Mandrill can be used. Additionally, custom SMTP services can also be set up and used.
mail.server = smtp.gmail.com	In this demonstration, I will configure a Gmail SMTP mail server. So, first I’ll set the value for mail.server as smtp.gmail.com
mail.server.username =dspace.u1@gmail.com mail.server.password =d$pace2019*	Next we have to enter a valid gmail ID for mail.server.username. I will use the admin’s mail id, which is dspace.u1@gmail.com You can also use the same email id which you gave as your admin mail id. The value for mail.server.password has to be the password of dspace.u1@gmail.com. The typed password will be visible to everyone. So I have blurred it for this demonstration.
Comment mail.server.port	We will use gmail’s SMTP port (SSL): 465, to connect to the SMTP server. So, let us disable the default SMTP port which is 25. To do so, type # in front of the line mail.server.port.
From Address for mail	Now, give a valid email address for mail.from.address. This email id will be considered as the from address for the recipients. Here I will type the value as dspace.u1@gmail.com
Feedback recipient email	Please type a valid email address for feedback.recipient If a user submits any feedback in DSpace, then those feedback will be sent to this email id. Here also I will type the value as dspace.u1@gmail.com
System administrator email	We have to give a valid email address for mail.admin. System notifications and administration emails will be sent to mail.admin address. I will type the value as dspace.u1@gmail.com here.
Mail.extraproperties >> remove # symbol	Next, we will configure the SMTP port (SSL): 465. Scroll down and locate the line #mail.extraproperties. Remove # symbol at the beginning mail.extraproperties.
Remove # symbol	Also, remove # symbol at the beginning of the next two consecutive lines, as shown.
Save and close file	Save and close the file.
Slide : Rebuild DSpace	Whenever we customize DSpace, it is necessary to rebuild DSpace. Rebuild process involves*Compilation of source code Installation of Webapp Deployment of DSpace on Tomcat server. We will prepare a shell script to rebuild DSpace, and use it whenever required.
[Terminal] type: sudo gedit $HOME/Rebuild-DSpace	Open a new file named Rebuild-DSpace in a text editor.
[Terminal] type: sudo service tomcat8 stop’’’ sleep 5 cd /home/dspace/dspace-6.3-src-release mvn -U clean package’’’ cd /home/dspace/dspace-6.3-src-release/dspace/target/dspace-installer ant update sleep 5 sudo service tomcat8 start	Type the shell commands as shown in the text editor. We have used these commands in the earlier tutorial to build dspace.
Press Ctrl+S keys	Save and close the file.
[Terminal] type: sudo chmod 777 $HOME/Rebuild-DSpace	Type the command as shown to provide executable permissions to Rebuild-DSpace. If prompted, enter the admin password to proceed further.
[Terminal] type: $HOME/Rebuild-DSpace	Let us rebuild DSpace by typing the following command. The rebuild process may take some time depending upon your internet speed.
[Terminal] Highlight BUILD SUCCESSFUL	On successful completion, BUILD SUCCESSFUL message will appear on the screen.
Narration only	This means we have deployed DSpace email configuration on Tomcat server.
Narration only	Next we have to configure some settings in the Gmail account which we have used. To access gmail through DSpace, less secure apps in gmail settings should be turned ON.
[browser] Login to gmail as dspace.u1@gmail.com	To do so, login to the respective gmail account which we have typed in the Email settings of DSpace.
[browser] Type the url: https://www.google.com/settings/security/lesssecureapps	Then in the address bar, type the URL as shown.
[browser] Turn the toggle on for Allow less secure apps	Turn ON the toggle button for Allow less secure apps.
Only narration	We have done the required configurations. Now let us send a test mail. To do so, go to the terminal.
[Terminal] type: sudo $HOME/dspace-install/bin/dspace test-email	Then type this command to send a test email. Test email will be sent to the mail id which was set in mail.admin in dspace.cfg file.
[Browser] Open the gmail account	Let us cross verify this. Switch to the browser where our mail account is logged in. Now check the Inbox for new mail.
[Browser] Point to the DSpace test mail	Here is the DSpace test email. We have successfully configured the mail configuration and also sent a test mail in DSpace.
Logout from gmail	Once done, sign out from the gmail account.
Only Narration	This brings us to the end of this tutorial. Let us summarize.
Slide Summary	In this tutorial we learnt to*Configure email for DSpace Prepare a shell script to rebuild DSpace and Sent test email from DSpace
Slide : About Spoken Tutorial project	The video at the following link summarises the Spoken Tutorial project. Please download and watch it.
Slide : Spoken Tutorial workshops	The Spoken Tutorial Project team conducts workshops and gives certificates. For more details, please write to us.
Slide: Answers for THIS Spoken Tutorial	Please post your timed queries in this Forum.
Slide: Acknowledgement -I	Spoken Tutorial project is funded by MHRD, Government of India.
Slide: Acknowledgement -II	DSpace spoken tutorial series is funded by the National Virtual Library of India, Ministry of Culture, Government of India.
Narration only	This script and video for this tutorial was contributed by Pankaj Patil from IIT Bombay. This is Nancy Varkey signing off. Thank you for joining.

Contributors and Content Editors

Nancyvarkey, Pankajpatil694, Pravin1389