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: ./unrealircd upgrade 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 ./unrealircd upgrade 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.
- Backup your existing /home/xxx/unrealircd directory:
-
cp -Rav /home/xxx/unrealircd /home/xxx/unrealircd.bak
-
- Download and install latest version of UnrealIRCd. See Installing from source and stop before Creating a configuration file.
- Double check: make sure you ran make install as this will install all new files in /home/xxx/unrealircd.
- 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
-
Configuration test passed OK
-
- Now you can restart the IRCd so it uses the new version:
-
- cd /home/xxx/unrealircd
- ./unrealircd restart
-
