Upgrading

This page explains how to upgrade your UnrealIRCd to a newer version if you stay on the same series: so 5.2.x to 5.2.y or 6.0.x to 6.0.y.

IMPORTANT: If you are upgrading from UnrealIRCd 5 to 6, then see Upgrading from 5.x.

= Automated upgrade (*NIX) = Simply run:  if you want to:
 * upgrade from 5.0.9 or later to 5.2.x
 * upgrade from 6.0.x to a later 6.0.y

The  will keep 5.x users on 5.x, so no need to worry about accidental upgrades from U5 to U6. If you want to upgrade from 5.x to 6.x with the new upgrade command, see here.

After the command has finished, read the output on the terminal. It will tell you if the upgrade went OK and your configuration file needs updating or not. If all is good then you can restart the IRCd to complete the upgrade.

Exit status
For advanced users interested in the exit status of the ./unrealircd upgrade command (eg for mass-scripting purposes):
 * Exit code 0: Upgrade and configtest successful. You can restart the IRCd now.
 * Exit code 1: An error occured
 * Exit code 5: Upgrade successful but configuration file needs updating. Do not restart IRCd but make changes first.
 * Exit code 10: No newer version available

= Manual upgrade (*NIX) = You can upgrade form any 5.X.X version to any 5.Y.Y version.

NOTE: If you are upgrading from old unsupport major version, see Upgrading from 4.x or Upgrading from 3.2.x.


 * 1) Backup your existing /home/xxx/unrealircd directory:
 * cp -Rav /home/xxx/unrealircd /home/xxx/unrealircd.bak
 * 1) Download and install latest version of UnrealIRCd. See Installing from source and stop before Creating a configuration file.
 * 2) Double check: make sure you ran make install as this will install all new files in /home/xxx/unrealircd.
 * 3) Configuration test to make sure the IRCd will boot later (this will not start the ircd, it will only TEST the configuration!):
 * cd /home/xxx/unrealircd
 * ./unrealircd configtest
 * This should print out:
 * Configuration test passed OK
 * If you see warnings/errors, fix them and run ./unrealircd configtest again until all issues are fixed.
 * 1) Now you can restart the IRCd so it uses the new version:
 * cd /home/xxx/unrealircd
 * ./unrealircd restart
 * cd /home/xxx/unrealircd
 * ./unrealircd restart

= Windows =
 * 1) Just in case, make a backup of your UnrealIRCd directory (C:\Program Files\UnrealIRCd 5).
 * 2) Surf to https://www.unrealircd.org/ and click Downloads. Pick your branch, download the installer
 * 3) Run the installer
 * 4) Now restart your IRC Server (Stop UnrealIRCd, then Start UnrealIRCd)