Tool:Meetbot

Toolforge tools
meetbot
Description	MeetBot instance
Keywords	irc, python
Maintainer(s)	Hashar, MarkTraceur, Tim Landscheidt, Daniel Kinzler (View all)
Source code	opendev.org
License	BSD 3-clause "Modified" License
Issues	Open tasks · Report a bug

meetbot is a MeetBot instance that keeps minutes for meetings, office hours, etc. held in #wikimedia-office ^connect.

Usage

m:Meetbot has some notes for users.

See https://wiki.debian.org/MeetBot#Howto for common commands.

See http://meetbot.debian.net/Manual.html for the full manual.

Administration

meetbot uses the IRC nick wm-labs-meetbot. The associated NickServ mail address ends up with User:Tim Landscheidt so contact him if you delete the password.

Service

Log into the Toolforge login server. ssh tools-login.wmflabs.org (see Help:Toolforge).
Access the tools.meetbot user. become meetbot.

Restart:

If necessary, stop the bot with jstop meetbot.
Start the bot with jstart ~/bin/meetbot.
If necessary, restart the webserver with webservice restart.

Install

meetbot runs as a continuous job on Tools. To install:

Make sure the package supybot is installed.
Clone the OpenStack fork repository of the MeetBot Python module to a local directory and install it to ~/.local with python setup.py install --user.
Create ~/.lighttpd.conf with the content:

# Enable basic directory index.
$HTTP["url"] =~ "^/?" {
        dir-listing.activate = "enable"
}

Create ~/wm-labs-meetbot.conf with the content:

supybot.nick: wm-labs-meetbot
supybot.networks: freenode
supybot.networks.freenode.password: very-secret
supybot.networks.freenode.servers: irc.freenode.net:6667
supybot.networks.freenode.channels: #wikimedia-office
supybot.directories.conf: /data/project/meetbot/conf
supybot.directories.data: /data/project/meetbot/data
supybot.directories.data.tmp: /data/project/meetbot/data/tmp
supybot.directories.backup: /data/project/meetbot/backup
supybot.directories.plugins: /data/project/meetbot/.local/lib/python2.7/site-packages/supybot/plugins
supybot.directories.log: /data/project/meetbot/logs
supybot.plugins: MeetBot Admin Misc User Owner Config Channel
supybot.plugins.Admin: True
supybot.plugins.Channel: True
supybot.plugins.Config: True
supybot.plugins.MeetBot: True
supybot.plugins.Misc: True
supybot.plugins.Owner: True
supybot.plugins.User: True
supybot.plugins.MeetBot.enableSupybotBasedConfig: True
supybot.plugins.MeetBot.logFileDir: /data/project/meetbot/public_html
supybot.plugins.MeetBot.logUrlPrefix: https://tools.wmflabs.org/meetbot/
supybot.plugins.MeetBot.endMeetingMessage: Meeting ended %(endtime)s %(timeZone)s.  Information about MeetBot at %(MeetBotInfoURL)s . (v %(__version__)s)\nMinutes:        %(urlBasename)s.html\nMinutes (text): %(urlBasename)s.txt\nMinutes (wiki): %(urlBasename)s.wiki\nLog:            %(urlBasename)s.log.html
supybot.plugins.MeetBot.writer_map: HTML2:.html HTMLlog2:.log.html MediaWiki:.wiki Text:.txt

Protect ~/wm-labs-meetbot.conf against overwriting by supybot with chmod -w ~/wm-labs-meetbot.conf.
Create ~/bin/meetbot with the content:

#!/bin/bash

# supybot doesn't start if it can't make a backup file.
/bin/rm -f ~/wm-labs-meetbot.conf.bak

# Start supybot itself.
/usr/bin/supybot ~/wm-labs-meetbot.conf

Make ~/bin/meetbot executable with chmod +x ~/bin/meetbot