Installing MatrIRX v1

From OoKoo.org

zelolobas MatrIRX IRC Services by MagicalTux

Contents 1 Installing/Linking 1.1 MatrIRX Configuration 1.2 Unreal IRCd Configuration 2 Conclusion

Installing/Linking

Installation of MatrIRX is extremely simple.

MatrIRX Configuration

I will go over the config file and explain each line to you.

$conf['remote']['type']='Unreal'; // Only UnrealIRCd is supported right now

You really don't need to change this, as the comment says.

$conf['remote']['host']='192.168.2.4'; // Remote IRC server to connect to

The IP Address of the IRCd you're connecting to, mine was 192.168.2.4, just an example

$conf['remote']['port']=9050; // Remote port

The port that your IRCd is listening on for services connections, mine was on 9050, just an example

$conf['remote']['password']='passhere'; // link password

The linking password, needed to 'login' to the IRCd

$conf['local']['name']='matrirx.domain.net'; // Name of the MatrIRX server 

The link name, You'll see more of this and why its important in the unrealircd.conf part, mine began with matrirx., but yours can be anything.

$conf['local']['desc']='Powered by MatrIRX'; // Description

This is what shows up as the desc. when you type /links in your client. Example; "matrirx.sakainen.net irc.sakainen.net :1 Powered by MatrIRX" is from my links list.

$conf['local']['numeric']=10; // Numeric ID of the server

Used for UnrealIRCd, bascially the ID# of a Link, You can leave it default, but you should check with your other services to make sure these IDs don't clash

$conf['local']['root']='Jagger'; // (deprecated) Services root 

I used mine, although it is deprecated I still put my nick

// TODO: Code the new unreal cloak algorythm OR don't use it anymore
$conf['network']['cloak']='00000000'; // cloak key CRC

This setting is deprecated and the new cloak system should be backported from MatrIRX 2.

$conf['network']['ircnetwork']='Sakai'; // Network name

Should be the same in your IRCd's configuration. Can cause linking problems if not set correctly.

// Config of module "stats"
$conf['stats']['nick']='Stats'; // Nick of the service

You can skip all the configuration part about Stats, as it's only if you have the Stats bot which was not publicly released.

Unreal IRCd Configuration

Now that we are done going over the SERVICES part, we will now overview the IRCd Part. I will put mine as examples. Note: This is your unrealircd.conf file.

link            matrirx.domain.net {
       username        *;
       hostname        *;
       bind-ip         *;   
       port            9050;
       hub             *;
       password-connect "";
       password-receive "passhere";
       class           servers;
};

• matrirx.domain.net: is the name of the link like in the $conf['local']['name']='matri.domain.net'; line can be anything as long as both match
• 9050: the port that the MatrIRX Server is connecting to
• passhere: put that as the linking password that you had setup in the config files

You can also add that (not required) :

ulines {
       matrirx.domain.net;   
};

NOTE that should match with the others alike it!

Conclusion

Hope this helped someone. =P

After reading this, you should be able to make them link first try without a problem. If something is wrong, missing, dated?, or not understandable PM me ( Jagger ) on irc.ookoo.org SUFFER!

More will be added as MatrIRX is developed.