OOMon: The OO IRC Monitor Bot

How to build OOMon from a development snapshot

NOTE: Text in fixed width format is the input and output you should see. Boldface indicates user input. Highlighted text is user input that is subject to change. Output may vary slightly, depending on your configuration.

1. Retrieve the latest OOMon source snapshot via FTP using wget, curl, or an FTP client of your choosing.

$ wget ftp://grind.realfx.net/pub/irc/oomon/oomon-latest_SNAP.tar.gz --21:06:55-- ftp://grind.realfx.net/pub/irc/oomon/oomon-latest_ SNAP.tar.gz => `oomon-latest_SNAP.tar.gz' Resolving grind.realfx.net... done. Connecting to grind.realfx.net[198.182.76.5]:21... connected. Logging in as anonymous ... Logged in! ==> SYST ... done. ==> PWD ... done. ==> TYPE I ... done. ==> CWD /pub/irc/oomon ... done. ==> PASV ... done. ==> RETR oomon-latest_SNAP.tar.gz ... done. Length: 1,873,443 (unauthoritative) 100%[====================================>] 1,873,443 152.28K/s ETA 00:00 21:07:24 (152.28 KB/s) - `oomon-latest_SNAP.tar.gz' saved [1873443]

2. Extract the source tarball and enter the "oomon" directory.

$ gunzip -c oomon-latest_SNAP.tar.gz | tar xf - $ ls -l total 1944 drwx------ 5 avj avj 4096 Oct 7 15:53 oomon -rw-r--r-- 1 avj avj 1866105 Oct 7 18:07 oomon-late st_SNAP.tar.gz $ cd oomon

3. Run `configure --help` and review the options.

$ ./configure --help

4. Run `configure --prefix=<prefix> <options>`. NOTE: It's desirable at this step to know where you plan on installing oomon and be sure and use the full path (minus trailing slash) as the prefix.

$ ./configure --prefix=/home/avj/sandbox/oomon-install checking build system type... i686-pc-linux-gnu checking host system type... i686-pc-linux-gnu this is OOMon version 2.3-DEV checking for g++... g++ checking for C++ compiler default output... a.out checking whether the C++ compiler works... yes --- snip --- configure: creating ./config.status config.status: creating makefile config.status: creating defs.h -- snip -- Compiler: g++ Compiler flags: -g -O2 -Wall Linker flags: Libraries: -lresolv -lcrypt -lstdc++ -lnsl

5. Run `make` to build the executable.

$ make g++ -g -O2 -Wall -I./libs -DHAVE_CONFIG_H -DBOOST_DISABLE_THREADS -DLOGDIR=\"/home/avj/sandbox/oomon-install/logs\" -DETCDIR=\"/home/avj/sandbox/oomon-install/etc\" -c action.cc g++ -g -O2 -Wall -I./libs -DHAVE_CONFIG_H -DBOOST_DISABLE_THREADS -DLOGDIR=\"/home/avj/sandbox/oomon-install/logs\" -DETCDIR=\"/home/avj/sandbox/oomon-install/etc\" -c adnswrap.cc g++ -g -O2 -Wall -I./libs -DHAVE_CONFIG_H -DBOOST_DISABLE_THREADS -DLOGDIR=\"/home/avj/sandbox/oomon-install/logs\" -DETCDIR=\"/home/avj/sandbox/oomon-install/etc\" -c arglist.cc --- snip ---

6. Run `make install` to install OOMon in the directory you chose with `--prefix`.

$ make install /bin/mkdir -p /home/avj/sandbox/oomon-install /bin/mkdir -p /home/avj/sandbox/oomon-install/bin /bin/mkdir -p /home/avj/sandbox/oomon-install/etc /bin/mkdir -p /home/avj/sandbox/oomon-install/logs /usr/bin/install -c oomon /home/avj/sandbox/oomon-install/bin /usr/bin/install -c mkpasswd /home/avj/sandbox/oomon-install/bin /usr/bin/install -c -m 644 oomon.cf /home/avj/sandbox /oomon-install/etc/oomon.cf.sample /usr/bin/install -c -m 644 oomon.cf /home/avj/sandbox /oomon-install/etc/oomon.cf -- snip --

7. Edit the configuration files in '$PREFIX/etc' to your liking. NOTE: All configuration files have a corresponding (and identical to the original) '.sample' file to keep as a reference.

$ cd /home/avj/sandbox/oomon-install/etc $ vi oomon.cf userlist.cf remotes.cf scanner.cf oomon-motd.txt

8. Start OOMon!

$ cd /home/avj/sandbox/oomon-install/bin $ ./oomon

This document is XHTML 1.0 Strict and CSS 3 compliant. Site issues/problems? Contact <avj> [at] <users.sf.net>