Development Team/ircd-darenet/INSTALL

Current revision as of 18:18, 12 March 2010

DareNET Development Wiki - Development Team/ircd-darenet/INSTALL

Chances are our Server Management Team will install and configure the ircd; however, in the event they don't here are some instructions on how to do so. If you have any questions, please consult with a Server Management Team member.

Step 1 - Ensuring you have the required packages

Before you attempt to compile and install ircd-darenet, you should first make sure you have the necessary packages needed for a successful install. So, ensure you have the packages below installed on your machine.

OpenSSL
libssl-dev - (for enabling ssl -- openssl-devel on redhat)
autoconf - (to avoid errors when running make)
automake
gawk
flex
bison
PCRE

The named packages above can be fetched (on a Debian-based system) with apt-get; portage on gentoo, and so on.

For example:

sudo apt-get install openssl libssl-dev autoconf automake

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

Step 2 - Installing IRCd-DareNET

IRCd-DareNET is intended for use on DareNET; therefore, you should not need to edit any configuration settings prior to installing it.

cd ircd-darenet

./configure --prefix=$HOME/ircd

Once that is done, run:

make clean install distclean

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

cd /home/user/ircd

Step 3 - Editing the configuration file

This is a farily painless process, and should only take between 5 - 10 minutes.

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 the Server Management Team so they can setup lsync for your server, which will fetch the additional configuration settings needed and keep them updated automagically.

@@ Line 1: / Line 1: @@
-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.
+{{Header|1 = <h2>'''[[Development Team|DareNET Development Wiki]]''' - {{FULLPAGENAME}}</h2>}}
+__NOTOC__Chances are our Server Management Team will install and configure the ircd; however, in the event they don't here are some instructions on how to do so. If you have any questions, please consult with a Server Management Team member.
+== Step 1 - Ensuring you have the required packages ==
-== Step 1 - Obtaining ircd-darenet ==
+Before you attempt to compile and install ircd-darenet, you should first make sure you have the necessary packages needed for a successful install. So, ensure you have the packages below installed on your machine.
-First, SSH into your server, and run the following command:
+* OpenSSL
+* libssl-dev - ''(for enabling ssl -- openssl-devel on redhat)''
-'''<code>svn co <url> ircd-darenet</code>'''
+* autoconf - ''(to avoid errors when running make)''
-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 (needed for lsync)
+* gawk
+* flex
+* bison
+* PCRE
-The named packages above can be fetched (on a Debian-based system) with apt-get.
+The named packages above can be fetched (on a Debian-based system) with apt-get; portage on gentoo, and so on.
 For example:
-'''<code>sudo apt-get install openssl libssl-dev autoconf automake gawk</code>'''
+<font color="navy">'''<code>sudo apt-get install openssl libssl-dev autoconf automake</code>'''</font>
 The actual names of the packages above may vary, depending on your distribution.
-== Step 3 - Installing ircd-darenet ==
+== Step 2 - 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:
+IRCd-DareNET is intended for use on DareNET; therefore, you should not need to edit any configuration settings prior to installing it.
-'''<code>cd ircd-darenet</code>'''
+<font color="navy">'''<code>cd ircd-darenet</code>'''</font>
-You can use one centralized directory if you'd like; however, we don't really recommend it. Additionally, DO NOT forget to enable ssl:
+<font color="navy">'''<code>./configure --prefix=$HOME/ircd</code>'''</font>
-'''<code>./configure --prefix=$HOME/ircd --enable-ssl</code>'''
 Once that is done, run:
-'''<code>make</code>'''
+<font color="navy">'''<code>make clean install distclean</code>'''</font>
-then:
-'''<code>make install</code>'''
 If everything runs smoothly, you should now have an ircd directory:
-'''<code>cd /home/user/ircd</code>'''
+<font color="navy">'''<code>cd /home/user/ircd</code>'''</font>
-== Step 4 - Editing the configuration file ==
+== Step 3 - Editing the configuration file ==
-Unlike most ircd's and networks, this is a fairly painless process on DareNET.
+This is a farily painless process, and should only take between 5 - 10 minutes.
 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>'''
+<font color="navy">'''<code>wget -O ircd.conf <nowiki>http://www.darenet.org/files/ircd/ircd.conf</nowiki></code>'''</font>
-Edit the configuration lines as needed. Once you have done that, contact a Server Manager so they can setup lsync for your server, which will fetch the additional configuration settings needed and keep them updated automagically.
-== Updates ==
-If you have been told you need to update your server, please see this [[Development Team/ircd-darenet/Updating|guide]].
+Edit the configuration lines as needed. Once you have done that, contact the Server Management Team so they can setup lsync for your server, which will fetch the additional configuration settings needed and keep them updated automagically.