Development Team/ircd-darenet/Updating

Revision as of 08:26, 29 October 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 run:

make

then:

make install

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:
-'''<code>./configure --prefix=$HOME/ircd --enable-ssl</code>'''
-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.
 then run:
-'''<code>make</code>'''
+<font color="navy">'''<code>make</code>'''</font>
 then:
-'''<code>make install</code>'''
+<font color="navy">'''<code>make install</code>'''</font>
 If everything runs smoothly, the new version is now installed.
@@ Line 37: / Line 31: @@
 == Step 3 - New configuration settings ==
-If you were told there are new configuration settings, then you will need to complete this step; otherwise, skip to step 4.
+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:
-'''<code>wget -O new.ircd.conf <nowiki>http://www.darenet.org/files/ircd/ircd.conf</nowiki></code>'''
+<font color="navy">'''<code>wget -O new.conf <nowiki>http://www.darenet.org/files/ircd/ircd.conf</nowiki></code>'''</font>
-Edit the configuration lines as needed, and rename it ircd.conf. DO NOT /rehash.
+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 ==
-Once you have installed the updated version, and have made any necessary configuration changes, you can then safely restart the ircd. Of course, we try and plan ircd upgrades so they cause the least amount of disruption to the network. Follow the timetable given to you in the upgrade e-mail you received.
+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.
-On IRC, issue the following command:
-'''<code>/restart 120 :Upgrading</code>'''
+<font color="navy">'''<code>/restart 120 :Upgrading!</code>'''</font>