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: @@
-This guide was written for those installing ircd-darenet on DareNET.
+{{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 ==
-First, SSH into your server, then run:
+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.
-<code>svn co URL(given to you by Server Management team) ircd-darenet</code>
+* OpenSSL
+* libssl-dev - ''(for enabling ssl -- openssl-devel on redhat)''
+* autoconf - ''(to avoid errors when running make)''
+* automake
+* gawk
+* flex
+* bison
+* PCRE
-The system will begin to download the latest version of ircd-darenet, as used on DareNET.
+The named packages above can be fetched (on a Debian-based system) with apt-get; portage on gentoo, and so on.
-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
-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>
+<font color="navy">'''<code>sudo apt-get install openssl libssl-dev autoconf automake</code>'''</font>
-'''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 2 - Installing IRCd-DareNET ==
-<code>cd ircd-darenet</code>
+IRCd-DareNET is intended for use on DareNET; therefore, you should not need to edit any configuration settings prior to installing it.
-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:
+<font color="navy">'''<code>cd ircd-darenet</code>'''</font>
-<code>./configure --libdir=$HOME/ircd --mandir=$HOME/ircd --bindir=$HOME/ircd --enable-ssl</code>
+<font color="navy">'''<code>./configure --prefix=$HOME/ircd</code>'''</font>
 Once that is done, run:
-<code>make</code>
+<font color="navy">'''<code>make clean install distclean</code>'''</font>
-Then:
+If everything runs smoothly, you should now have an ircd directory:
-<code>make install</code>
+<font color="navy">'''<code>cd /home/user/ircd</code>'''</font>
-If everything runs smoothly, you should now have an ircd directory:
+== Step 3 - Editing the configuration file ==
-<code>cd /home/user/ircd</code>
+This is a farily painless process, and should only take between 5 - 10 minutes.
-Then fetch the ircd.conf to the ircd directory:
+First, fetch the ircd.conf to the ircd directory:
-<code>wget -O ircd.conf http://www.darenet.org/downloads/ircd/ircd.conf</code>
+<font color="navy">'''<code>wget -O ircd.conf <nowiki>http://www.darenet.org/files/ircd/ircd.conf</nowiki></code>'''</font>
-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 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.