You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@whimsical.apache.org by ru...@apache.org on 2016/08/23 20:18:49 UTC
[whimsy] branch master updated: common mail configuration and minor
cleanup
This is an automated email from the ASF dual-hosted git repository.
rubys pushed a commit to branch master
in repository https://git-dual.apache.org/repos/asf/whimsy.git
The following commit(s) were added to refs/heads/master by this push:
new 2b59751 common mail configuration and minor cleanup
2b59751 is described below
commit 2b5975114f1c0865d7509aba9daa6de6f6d1d6d8
Author: Sam Ruby <ru...@intertwingly.net>
AuthorDate: Tue Aug 23 16:18:22 2016 -0400
common mail configuration and minor cleanup
---
MACOSX.md | 50 +++++++++++++++++++++++++++++++++++++++++--
config/secretary-workbench.md | 36 +------------------------------
2 files changed, 49 insertions(+), 37 deletions(-)
diff --git a/MACOSX.md b/MACOSX.md
index 5836a55..4282e9c 100644
--- a/MACOSX.md
+++ b/MACOSX.md
@@ -106,7 +106,6 @@ cn: Sam Ruby
Notes:
- * The ldapsearch command is the standard LDAP utility on MacOSX.
* To pick up the latest code, the above needs to be run from the directory
you issued the `git clone` command. Alternately, provide the full path
to the `whimsy/lib` directory on the `ASF::LDAP.configure` command.
@@ -114,6 +113,7 @@ Notes:
require this command to be run again.
* Alternatives to running this command can be found in step 4 of
[DEVELOPMENT.md](https://github.com/apache/whimsy/blob/master/DEVELOPMENT.md)
+ * The `ldapsearch` command is the standard LDAP utility on MacOSX.
Start Apache httpd
@@ -195,8 +195,8 @@ Save your changes.
Verify that you can access the server using this new alias:
-$ curl whimsy.local
```
+$ curl whimsy.local
<html><body><h1>It works!</h1></body></html>
```
@@ -295,6 +295,52 @@ you need to adjust this, edit the `SetEnv PATH` line in
again.
+Configure sending of mail
+-------------------------
+
+Every mail delivery system appears to be different. Once whitelisted,
+`sendmail` works fine on `whimsy-vm3.apache.org`. Others may require
+passwords or may throttle the rate at which emails can be sent.
+
+The one option that appears to work for everybody is gmail.
+
+Create a `~/.whimsy` file, and add the following content:
+
+```
+---
+:sendmail:
+ delivery_method: smtp
+ address: smtp.gmail.com
+ port: 587
+ domain: apache.org
+ user_name: username
+ password: password
+ authentication: plain
+ enable_starttls_auto: true
+```
+
+Verify this works:
+
+```
+$ ruby whimsy/tools/testmail.rb
+```
+
+Note Gmail will just be used as a delivery mechanism, you can still
+use a different address (such as your @apache.org email address) as
+the *from* address. The `domain` above should match the host portion of
+the from address.
+
+Should your Apache user id differ from your local user id, either specify your
+ASF user id as the first parameter to the testmail.rb program, or set the USER
+environment variable to your ASF user id before running this script.
+
+If this fails, check your email for a response from Google. You may need
+to approve this application.
+
+Information on other ways to configure sending mail can be found at
+[DEVELOPMENT.md](DEVELOPMENT.md#setup) step 6.
+
+
Additional (application specific) configuration
-----------------------------------------------
diff --git a/config/secretary-workbench.md b/config/secretary-workbench.md
index 52c6490..42a0503 100644
--- a/config/secretary-workbench.md
+++ b/config/secretary-workbench.md
@@ -34,42 +34,8 @@ specifying the `--depth` parameter. Just identify where each can be found.
For the last entry, specify the name of a new file location which will be used
in the next step to configure mail. I suggest `.secmail` in your home
-directory. This needs to be a full path (i.e., don't start with a `~`).
+directory. This needs to be a full path (i.e., don\u2019t start with a `~`).
-Configure mail
---------------
-
-Every mail delivery system appears to be different. Once whitelisted, `sendmail` works fine on `whimsy-vm3.apache.org`. Others may require passwords or may throttle the rate at which emails can be sent.
-
-The one option that appears to work for everybody is gmail.
-
-Start by copying the `secmail.rb` template to the location you specified in
-your `local_paths.yml`. For example, if you took the recommendatio above, issue:
-
-```
-$ cp secmail.rb ~/.secmail
-```
-
-Edit the file, and replace the line that says `delivery_method :sendmail`
-with the following block of code:
-
-```
-delivery_method :smtp,
- address: "smtp.gmail.com",
- port: 587,
- domain: "apache.org",
- authentication: "plain",
- user_name: "<your-gmail-user-name>",
- password: "<your-gmail-password>",
- enable_starttls_auto: true
-```
-
-Note that the code later in the file determines what *from* address will be
-used in the email (and the `domain` above should match the host portion of
-this address). Gmail will just be used as a delivery mechanism.
-
-Also note that the $USER value in this script is your Apache user id, which
-may be different than your local user id.
Configure Apache to display documents received
--------------
--
To stop receiving notification emails like this one, please contact
['"commits@whimsical.apache.org" <co...@whimsical.apache.org>'].