This page tells you how email in Launchpad is handled, how to configure mail, and how to inject sample data into mailing list archives. Please help us improve this documentation, and contact us if you have questions.
There are various kinds of emails in Launchpad:
Mailing lists (represented by Launchpad teams). A mailing list has an address TEAM_NAME@lists.launchpad.net, archives (https://lists.launchpad.net/TEAM_NAME), and an administrative interface (https://lists.canonical.com/mailman/admin/TEAM_NAME). Launchpad uses Mailman to process these kinds of mails.
Emails sent from one user to another (that is, an email sent "by" Launchpad, but really sent by user Alice when Alice uses the https://edge.launchpad.net/~barry/+contactuser form to contact user Barry.
- Emails sent by Launchpad itself, such as emails sent to subscribers when a bug is changed.
- Emails received by Launchpad itself, such as emails sent by users to manipulate the bug tracker.
We should document all these kinds of email here, but right now this page is really in draft state, so it's just a grab bag of various information. We'll continue to improve it; please help us if you can.
Outgoing mail is configured using configs, so you'll need a config that puts outgoing mail somewhere you can see it. Like so:
WARNING: this configuration info may be outdated; it's taken from documentation that was last modified in Sep 2008:
<configure xmlns="http://namespaces.zope.org/zope" xmlns:mail="http://namespaces.zope.org/mail" i18n_domain="zope"> <mail:smtpMailer name="smtp" hostname="mail.wooz.org" port="25" /> <mail:stubMailer name="barry" from_addr="firstname.lastname@example.org" to_addr="email@example.com" mailer="smtp" rewrite="false" /> <mail:testMailer name="test-mailer" /> <mail:mboxMailer name="mbox" filename="/tmp/launchpad.mbox" overwrite="true" mailer="test-mailer" /> <!-- <mail:queuedDelivery permission="zope.SendMail" queuePath="/var/tmp/launchpad_mailqueue" mailer="barry" /> --> <mail:directDelivery mailer="mbox" permission="zope.SendMail" /> </configure>
You can then specify the config to make:
make LPCONFIG=+abentley run_all
Mailing List Archives
In the course of working on bug #357775 (mailing list archive UI improvements), we used these steps to test the new archive interface code:
Log in to launchpad.dev as "firstname.lastname@example.org" (this test user should already exist, and have the appropriate administrative privileges).
Create a new team mltest.
- Create a mailing list for that team.
Approve the mailing list at http://launchpad.dev/+mailinglists.
Inject the sample data, which you get from http://launchpadlibrarian.net/26091302/lp-ml-test-data.tar.gz:
tar zxfv lp-ml-test-data.tar.gz
./inject.sh ## (while launchpad.dev is running, of course) ##
There are 999 messages in the data. They're originally from the Emacs Devel mailing list archive, but although I've left the names the same, the sender ("From:") addresses have all been replaced with <email@example.com>, so they will successfully load into a list whose only owner/subscriber is firstname.lastname@example.org. If you have any problems loading the messages, try:
ls -lR /var/tmp/mailman/qfiles (it should be empty) tail -f /var/tmp/mailman/logs/*
Visit the archive: http://lists.launchpad.dev/mltest/maillist.html
You should see the first of five index pages there. Click on the "go to Thread Index" link to make sure the thread index is working too (http://lists.launchpad.dev/mltest/threads.html).
See the original merge proposal for details.