Development Team/ircd-darenet/Updating

Current revision as of 10:27, 7 November 2008

Updating ircd-darenet is quick and easy! If you have received an e-mail from a Server Manager explaining that you need to update the version of ircd-darenet you're currently running, follow the steps below.

In This Guide:

1 Step 1 - Grabbing the latest version
2 Step 2 - Installing the latest version
3 Step 3 - New configuration settings
4 Step 4 - Restarting the ircd

Step 1 - Grabbing the latest version

SSH into your server, and go to the ircd-darenet directory:

cd ircd-darenet

Once inside the directory, run the following command:

svn update

Depending on the number of changes made to ircd-darenet, this process may take a few moments. Once completed, move on to step 2.

Step 2 - Installing the latest version

Once step 1 has completed, run the following command:

make clean

then

make

and finally

make install

NOTE: We highly recommend you run each command separately, as shown above. There actually is a reason for this, and it really doesn't take that much longer. If you run into any errors doing otherwise, well, we told you so ;)

If everything runs smoothly, the new version is now installed.

Step 3 - New configuration settings

Some updates may require configuration changes. This will ALWAYS be noted on the forums, and/or the update e-mail. If no configuration changes are needed, skip to step 4; otherwise, follow the instructions below:

Fetch the latest ircd.conf to the ircd directory:

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

Follow the instructions contained on the forums and/or the e-mail (e.g. edit the configuration lines as needed), then rename it to ircd.conf. To err on the safe side, DO NOT /REHASH unless the instructions contained on the forums and/or email say to do so.

Step 4 - Restarting the ircd

We try to plan all ircd upgrades so that they cause the least amount of disruption to our network. Follow the update schedule as posted on the forums, or as contained in your e-mail. Only issue a /RESTART during your scheduled slot.

/restart 120 :Upgrading!

@@ Line 3: / Line 3: @@
 == Step 1 - Grabbing the latest version ==
-First, SSH into your server, and go to the ''ircd-darenet'' directory:
+SSH into your server, and go to the '''''ircd-darenet''''' directory:
-'''<code>cd ircd-darenet</code>'''
+<font color="navy">'''<code>cd ircd-darenet</code>'''</font>
-Then, once inside the directory, run the following command:
+Once inside the directory, run the following command:
-'''<code>svn update</code>'''
+<font color="navy">'''<code>svn update</code>'''</font>
-Depending on how many changes were made between the latest version of ircd-darenet, and the version you currently have, this may take a few moments. Once this is completed, move on to step 2.
+Depending on the number of changes made to ircd-darenet, this process may take a few moments. Once completed, move on to step 2.
 == Step 2 - Installing the latest version ==
-Once step 1 is completed, run the following command:
+Once step 1 has completed, run the following command:
-'''<code>make distclean</code>'''
+<font color="navy">'''<code>make clean</code>'''</font>
-then:
+then
-'''<code>./configure --prefix=$HOME/ircd --enable-ssl</code>'''
+<font color="navy">'''<code>make</code>'''</font>
-Note, you will be asked if you want to use the same SSL certificate or create a new one. Either way, the choice is up to you.
+and finally
-then run:
+<font color="navy">'''<code>make install</code>'''</font>
-'''<code>make</code>'''
+NOTE: We highly recommend you run each command separately, as shown above. There actually is a reason for this, and it really doesn't take that much longer. If you run into any errors doing otherwise, well, we told you so ;)
-then:
+If everything runs smoothly, the new version is now installed.
-'''<code>make install</code>'''
+== Step 3 - New configuration settings ==
-If everything runs smoothly, the new version is now installed.
+Some updates may require configuration changes. This will ALWAYS be noted on the forums, and/or the update e-mail. If no configuration changes are needed, skip to step 4; otherwise, follow the instructions below:
+Fetch the latest ircd.conf to the ircd directory:
+<font color="navy">'''<code>wget -O new.conf <nowiki>http://www.darenet.org/files/ircd/ircd.conf</nowiki></code>'''</font>
+Follow the instructions contained on the forums and/or the e-mail (e.g. edit the configuration lines as needed), then rename it to ircd.conf. To err on the safe side, DO NOT /REHASH unless the instructions contained on the forums and/or email say to do so.
+== Step 4 - Restarting the ircd ==
+We try to plan all ircd upgrades so that they cause the least amount of disruption to our network. Follow the update schedule as posted on the forums, or as contained in your e-mail. Only issue a /RESTART during your scheduled slot.
+<font color="navy">'''<code>/restart 120 :Upgrading!</code>'''</font>