kajvdh / ircd-balancer Goto Github PK

IRCD-Balancer allows you to spread IRC clients between multiple IRC servers. Why would you want to do this? Several methods of usage have come in use:

• Keeping the IRC leaves hidden from public view
• One entry point to the IRC network or network segment

Built in resource limits have been implimented to automatically shut-off the server should the balancer become overwhelmed with unwanted traffic, whilst allowing existing clients to continue talking safely. This has become handy for networks that attract DDOS attacks.

IRCD-Balancer is built using Node.js, so you must have this installed first. http://nodejs.org/

• Clone the git repository:

  $ git clone [email protected]:prawnsalad/IRCD-Balancer.git

• Read and edit the configuration file:

  $ nano ircdbalancer_conf.js

• Download and unzip the source from: https://github.com/prawnsalad/IRCD-Balancer/zipball/master

• Read and edit the configuration file:

  $ nano ircdbalancer_conf.js

There is an upstart script (ircdbalancer_upstart.conf) provided that may be used to install ircdbalancer as a deamon.

• Copy ircdbalancer_upstart.conf to your upstart init folder

  $ sudo cp ircdbalancer_upstart.conf /etc/init/ircdbalancer.conf

• Copy all the ircdbalancer sources to its application folder

  $ mkdir /opt/ircdbalancer $ cp ./* /opt/ircdbalancer/

You can now use the following commands to control ircdbalancer:

$ start ircdbalancer
$ stop ircdbalancer
$ restart ircdbalancer

From the source folder:

$ node ircdbalancer.js

As a deamon:

$ start ircdbalancer

Once running, you can interact with ircdbalancer to update the config or look at simple statistics without turning the server off.

If running a deamon:

$ nc -U /opt/ircdbalancer/control.sock

If running as normal, you can simply type into the console.

Enable / disable basic statistic reporting

$ stats

View the current IRCD pool

$ pool

Reload the configuration and rebind the server listeners

$ rehash

Report bugs using the issue tracker on github: https://github.com/prawnsalad/IRCD-Balancer/issues