Testlink guide

From Slacked

This information is for new admins installing Charybdis. Please read EVERYTHING and follow all instructions.

Contents 1 Before you start 2 Installing the IRCd 2.1 Configure 2.2 Configuration 2.2.1 ircd.conf 2.2.1.1 SID 2.2.1.2 Bind to IP 2.2.1.3 Ports 2.2.1.4 Oper host spoofing 2.2.1.5 DNS 2.2.2 link.conf 2.3 All done 2.4 Crontab 2.5 Problems?

Before you start

The following is absolutely REQUIRED for ALL servers, they MUST be installed:

• ntpd/openntpd (to ensure your clock is accurate) - http://www.ntp.org
• svn, the subversion client (used in update-conf) - http://www.subversion.org
• wget or fetch (used below) - http://www.wget.org

Installing the IRCd

You'll need to download the latest tarball:

Linux:

wget http://www.stack.nl/~jilles/irc/charybdis-2.2.0.tar.gz

FreeBSD:

fetch http://www.stack.nl/~jilles/irc/charybdis-2.2.0.tar.gz

Configure

You MUST increase the maximum nicklen to 30.

./configure --with-maxnicklen=30

charybdis should always be installed to ~/ircd NOT the source directory.

Configuration

NOTE: Any change made to global.conf/global.hub.conf will be LOST. Local changes should be made to the ircd.conf file instead. Do not place conflicting parameters in ircd.conf (i.e. don't define anything in inspircd.conf that is already defined elsewhere).

ircd.conf

SID

An SID will be assigned to your server on approval of your testlink application.

Bind to IP

The vhost parameter contains the IP address to bind the ircd to, this should be your ircd IP, e.g.

vhost = "192.168.10.5";

Ports

The listen block lists the IP address and ports the ircd will listen on.

Client servers should listen on ports 6660-6669, 7000 as well as 9090, the server-to-server port. If this is not possible 6667, 7000 and 9090 are the absolute minimum and only if you have a good reason for not listening to more ports.

listen {
    host = "192.168.10.5";
    port = 6660 .. 6669, 7000, 9090;
};

Oper host spoofing

In order to enable oper host spoofing in the ircd you should change the user parameters of the spoofed auth block to your own hostmask, you can have as many user parameters as you wish.

You MUST use staff.slacked.org as the spoofed host.

auth {
    user = "*@*.example.net";
    user = "*foo@*.example.com";

    spoof = "staff.slacked.org";

    flags = spoof_notice, kline_exempt, exceed_limit, dnsbl_exempt, no_tilde;

    class = "opers";
};

DNS

For performance it is sometimes beneficial to run a local caching nameserver on 127.0.0.1 and use that. This is only an option if you have root access to the server your ircd is hosted on OR you have a good working relationship with the system administrator.

link.conf

You will need to get the details of your link lines and primary and secondary hubs from an administrator.

All done

Now you should be ready to start charybdis.

Crontab

Edit your crontab and add the following entries:

*/5 * * * * ~/ircd/bin/update-conf
47 * * * * ~/ircd/bin/routing-client

The update-conf script runs every 5 minutes and synchronises your global.conf with the rest of the network.

Problems?

If you have problems talk to someone on staff.

If you experience a problem with the ircd, you can launch charybdis in the foreground with:

cd ~/ircd/bin
./ircd -foreground

This may help narrow down the problem.