Wikibugs

Revision as of 21:36, 26 July 2012

Wikibugs is a bot which writes bug reports to IRC. It is a perl mail pipe processor which is executed by the MTA. It writes IRC-formatted log lines to a file, to be read by an IRC client such as ircecho.

The source is in svn.

Ops

It runs on mchenry, the mail server. It's installed at /usr/local/bin/wikibugs, and exim is configured to start it via /etc/exim4/aliases/wikimedia.org

To start the IRC part:

/usr/local/bin/start-wikibugs-bot

To kill the IRC part:

killall -u wikibugs

Related services

Depends on:

• lists.wikimedia.org wikibugs-l list
  • If for some reason the bug has been down, check that on wikibugs-l mailman that wikibugs-irc is receiving mail and not muted due to a bounce
  • bugzilla.wikimedia.org source of bug mail notifications
• irc.freenode.net for output into #mediawiki

How to set it up

First, install the perl dependencies:

• apt-get install build-essential
• perl -MCPAN -e 'install Email::MIME'
  • this may not work. See this thread which explains you must go into CPAN shell and do:
    • o conf make /usr/bin/make
• svn export --force svn+ssh://svn.wikimedia.org/svnroot/mediawiki/trunk/tools/wikibugs /usr/local/bin
• Set up a filter in the MTA. For example the current configuration on mchenry uses the following line in /etc/exim4/aliases/wikimedia.org, presumably with wikibugs-irc subscribed to the mailing list:

  wikibugs-irc: |/usr/local/bin/wikibugs.pl

• useradd wikibugs
• Start the bot using /usr/local/bin/start-wikibugs-bot