Development Team/ircd-darenet/INSTALL

Revision as of 04:42, 4 October 2008

Since ircd-darenet is currently exclusively developed for DareNET, this install guide is written with that in mind. Should you need assistance, please contact a Server Management Team member.

In This Guide:

1 Step 1 - Obtaining ircd-darenet
2 Step 2 - Ensure you have required packages
3 Step 3 - Installing ircd-darenet
4 Step 4 - Editing the configuration file

Step 1 - Obtaining ircd-darenet

First, SSH into your server, and run the following command:

svn co <url> ircd-darenet

Use the URL sent to you in your testlink e-mail for <url>, without the brackets of course.

Once you have issued this command, the system will begin to download the latest version of ircd-darenet, as used on DareNET.

Step 2 - Ensure you have required packages

Now, before we continue further, we'd like to make sure you have the packages needed for a successful install. So be sure you have the packages below installed on your box:

openssl
libssl-dev (for enabling ssl -- openssl-devel on redhat)
autoconf (to avoid errors when running make)
automake
gawk (neededfor lsync)

The named packages above can be fetched (on a Debian-based system) with apt-get.

For example:

sudo apt-get install openssl libssl-dev autoconf automake gawk

The actual names of the packages above may vary, depending on your distribution.

Step 3 - Installing ircd-darenet

Since ircd-darenet is developed for DareNET, you will not need to edit any configuration settings prior to installing it. So, let's move on to getting the server installed and running:

cd ircd-darenet

You can use one centralized directory if you'd like; however, we don't really recommend it. Additionally, DO NOT forget to enable ssl when:

./configure --prefix=$HOME/ircd --enable-ssl

Once that is done, run:

make

then:

make install

If everything runs smoothly, you should now have an ircd directory:

cd /home/user/ircd

Step 4 - Editing the configuration file

Unlike most ircd's and networks, this is a fairly painless process on DareNET.

First, fetch the ircd.conf to the ircd directory:

wget -O ircd.conf http://www.darenet.org/files/ircd/ircd.conf

Edit the configuration lines as needed. Once you have done that, contact a Server Manager so they can setup lsync for your server, which fetch the additional configuration settings and keep them updated automagically.

@@ Line 1: / Line 1: @@
-This guide was written for those installing ircd-darenet on DareNET.
+Since ircd-darenet is currently exclusively developed for DareNET, this install guide is written with that in mind. Should you need assistance, please contact a Server Management Team member.
-First, SSH into your server, then run:
+== Step 1 - Obtaining ircd-darenet ==
-'''<code>svn co URL(given to you by Server Management team) ircd-darenet</code>'''
+First, SSH into your server, and run the following command:
-The system will begin to download the latest version of ircd-darenet, as used on DareNET.
+'''<code>svn co <url> ircd-darenet</code>'''
-Before we continue further, we'd like to make sure you have the packages needed for a successful install. So be sure you have the packages below installed on your box:
+Use the URL sent to you in your testlink e-mail for <url>, without the brackets of course.
-* openssl
+Once you have issued this command, the system will begin to download the latest version of ircd-darenet, as used on DareNET.
-* libssl-dev (for enabling ssl -- openssl-devel on redhat)
-* autoconf (to avoid errors when running make)
-* automake
-The named packages above can be fetched (on a Debian based system) with apt-get:
+== Step 2 - Ensure you have required packages ==
+Now, before we continue further, we'd like to make sure you have the packages needed for a successful install. So be sure you have the packages below installed on your box:
+* openssl
+* libssl-dev (for enabling ssl -- openssl-devel on redhat)
+* autoconf (to avoid errors when running make)
+* automake
+* gawk (neededfor lsync)
+The named packages above can be fetched (on a Debian-based system) with apt-get.
 For example:
-'''<code>sudo apt-get install openssl libssl-dev autoconf automake</code>'''
+'''<code>sudo apt-get install openssl libssl-dev autoconf automake gawk</code>'''
-'''Note:''' The actual names of the packages above may vary, depending on your distribution.
+The actual names of the packages above may vary, depending on your distribution.
-With that said, we now move on to getting the server up and running.
+== Step 3 - Installing ircd-darenet ==
+Since ircd-darenet is developed for DareNET, you will not need to edit any configuration settings prior to installing it. So, let's move on to getting the server installed and running:
 '''<code>cd ircd-darenet</code>'''
-For your own convenience, and our's, we recommend using one centralized directory when running the configure script (it's up to you though). And DO NOT forget to enable ssl:
+You can use one centralized directory if you'd like; however, we don't really recommend it. Additionally, DO NOT forget to enable ssl when:
-'''<code>./configure --libdir=$HOME/ircd --mandir=$HOME/ircd --bindir=$HOME/ircd --enable-ssl</code>'''
+'''<code>./configure --prefix=$HOME/ircd --enable-ssl</code>'''
 Once that is done, run:
@@ Line 34: / Line 43: @@
 '''<code>make</code>'''
-Then:
+then:
 '''<code>make install</code>'''
@@ Line 42: / Line 51: @@
 '''<code>cd /home/user/ircd</code>'''
-Then fetch the ircd.conf to the ircd directory:
+== Step 4 - Editing the configuration file ==
+Unlike most ircd's and networks, this is a fairly painless process on DareNET.
+First, fetch the ircd.conf to the ircd directory:
 '''<code>wget -O ircd.conf <nowiki>http://www.darenet.org/files/ircd/ircd.conf</nowiki></code>'''
-You'll have to edit the configuration file a bit. Once you have done this, a Server Manager should help you finish the configuration process (e.g. get the latest network specific settings, your numeric, setup the appropriate cronjobs, etc).
+Edit the configuration lines as needed. Once you have done that, contact a Server Manager so they can setup lsync for your server, which fetch the additional configuration settings and keep them updated automagically.