79 lines
2.7 KiB
Plaintext
79 lines
2.7 KiB
Plaintext
=============================
|
|
Installation Guide for Configuring a Koha Server to Use a Gmail Account as its SMTP Server
|
|
=============================
|
|
|
|
Copyright (C) 2010 Foundations Bible College (http://www.foundations.edu)
|
|
|
|
Koha is free software; you can redistribute it and/or modify it
|
|
under the terms of the GNU General Public License as published by
|
|
the Free Software Foundation; either version 3 of the License, or
|
|
(at your option) any later version.
|
|
|
|
Koha is distributed in the hope that it will be useful, but
|
|
WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
GNU General Public License for more details.
|
|
|
|
You should have received a copy of the GNU General Public License
|
|
along with Koha; if not, see <https://www.gnu.org/licenses>.
|
|
|
|
Author: Chris Nighswonger (cnighswonger AT foundations DOT edu
|
|
|
|
Feedback/bug reports: Koha Developer's List:
|
|
http://lists.koha.org/mailman/listinfo/koha-devel
|
|
|
|
This document last modified: 13 February 2010
|
|
|
|
Configuration Instructions
|
|
=============================
|
|
|
|
To use your gmail account as an SMTP server you will need to execute the following from a shell prompt.
|
|
|
|
(These steps are taken from http://jonspriggs.posterous.com/use-gmails-smtp-gateway-using-the-command-lin)
|
|
|
|
sudo apt-get install openssl xinetd
|
|
|
|
sudo tee /usr/bin/gmail-smtp <<EOF >/dev/null
|
|
#!/bin/sh
|
|
# Thanks to http://ubuntuforums.org/showthread.php?t=918335 for this install guide
|
|
/usr/bin/openssl s_client -connect smtp.gmail.com:465 -quiet 2>/dev/null
|
|
EOF
|
|
sudo chmod +x /usr/bin/gmail-smtp
|
|
|
|
sudo tee /etc/xinetd.d/gmail-smtp <<EOF >/dev/null
|
|
# default: on
|
|
# description: Gmail SMTP wrapper for clients without SSL support
|
|
# Thanks to http://ubuntuforums.org/showthread.php?t=918335 for this install guide
|
|
service gmail-smtp
|
|
{
|
|
disable = no
|
|
bind = localhost
|
|
port = 10025
|
|
socket_type = stream
|
|
protocol = tcp
|
|
wait = no
|
|
user = root
|
|
server = /usr/bin/gmail-smtp
|
|
type = unlisted
|
|
}
|
|
EOF
|
|
sudo /etc/init.d/xinetd reload
|
|
|
|
Edit Mail/Sendmail.pm and set the port to 10025. (Note: This file will be located where ever your Perl libraries are.)
|
|
|
|
Script Setup Instructions
|
|
=============================
|
|
|
|
After successfully executing the above steps, you will need to run the process_message_queue.pl script with the
|
|
following syntax:
|
|
|
|
perl process_message_queue.pl -u librarian@foo.tld -p supersecret -m LOGIN
|
|
|
|
This, of course, assumes that you have all other scripts in place and functional to generate notices.
|
|
|
|
Misc Helpful Notes
|
|
=============================
|
|
|
|
NOTE: In order to debug problems, you can set the debug level in Mail/Sendmail.pm to 11 which will give plenty of
|
|
commentary to STDOUT.
|