Mailman-htdig

From Wikitech
(Difference between revisions)
Jump to: navigation, search
(htdig)
(update)
Line 1: Line 1:
This is a patched version of GNU [[Mailman]] which integrates support for searching list archives using htdig.
+
This is a patched version of GNU [[Mailman]] which integrates support for searching list archives using htdig. This is integrated in the Wikimedia Mailman .deb.
  
As of November 3, 2006 this is operational on [[goeje]].
+
=== Mailman patches ===
 
+
== Installation ==
+
 
+
=== Mailman ===
+
 
Apply these patches to the Mailman source before installation:
 
Apply these patches to the Mailman source before installation:
 
* [http://www.openinfo.co.uk/mm/patches/444879/index.html archive adjustment for better searching]
 
* [http://www.openinfo.co.uk/mm/patches/444879/index.html archive adjustment for better searching]
 
* [http://www.openinfo.co.uk/mm/patches/444884/index.html htdig integration]
 
* [http://www.openinfo.co.uk/mm/patches/444884/index.html htdig integration]
  
The patch documentation describes how to enable it; this is already on in the mailman configuration file.
+
The patch documentation describes how to enable it; this is not enabled in the default Mailman configuration file in the package.
  
 
=== htdig ===
 
=== htdig ===
  
htdig can be installed via yum on fedora.
+
htdig can be installed via yum on fedora and APT on Ubuntu.
  
 
'''Fun warning!''' Search result pages will [http://mail.python.org/pipermail/mailman-users/2002-May/020252.html come up blank with no error messages] if <tt>htsearch</tt> is unable to locate the 'COMMON_DIR' which contains its HTML templates and images.
 
'''Fun warning!''' Search result pages will [http://mail.python.org/pipermail/mailman-users/2002-May/020252.html come up blank with no error messages] if <tt>htsearch</tt> is unable to locate the 'COMMON_DIR' which contains its HTML templates and images.
Line 24: Line 20:
 
== Index updating ==
 
== Index updating ==
  
Search indexes are updated by a nightly cronjob, at <tt>/usr/local/mailman/cron/nighty_htdig</tt>. I've put this in mailman's personal crontab.
+
Search indexes are updated by a nightly cronjob, at <tt>/usr/share/mailman/cron/nightly_htdig</tt> which is called from <tt>/etc/cron.d/mailman</tt>.  
  
 
== Setup notes ==
 
== Setup notes ==
  
 
Initially, lists are set up for htdig as they first receive a mail after the configuration is enabled; but they won't be indexed until the cronjob next runs. (It can also be manually run, of course.)
 
Initially, lists are set up for htdig as they first receive a mail after the configuration is enabled; but they won't be indexed until the cronjob next runs. (It can also be manually run, of course.)

Revision as of 22:10, 6 January 2007

This is a patched version of GNU Mailman which integrates support for searching list archives using htdig. This is integrated in the Wikimedia Mailman .deb.

Contents

Mailman patches

Apply these patches to the Mailman source before installation:

The patch documentation describes how to enable it; this is not enabled in the default Mailman configuration file in the package.

htdig

htdig can be installed via yum on fedora and APT on Ubuntu.

Fun warning! Search result pages will come up blank with no error messages if htsearch is unable to locate the 'COMMON_DIR' which contains its HTML templates and images.

For some reason, the fedora package installs this directory at /usr/share/htdig but the binaries look for it at /var/www/html/htdig. I made a manual symlink to that disused location.

Additionally, that directory should be aliased in to /htdig on the mail web server so that the icons show up in result pages; for the current setup I just symlinked it in from the docroot.

Index updating

Search indexes are updated by a nightly cronjob, at /usr/share/mailman/cron/nightly_htdig which is called from /etc/cron.d/mailman.

Setup notes

Initially, lists are set up for htdig as they first receive a mail after the configuration is enabled; but they won't be indexed until the cronjob next runs. (It can also be manually run, of course.)

Personal tools
Namespaces

Variants
Actions
Navigation
Ops documentation
Wiki
Toolbox