Running a mixed UnrealIRCd 4 and UnrealIRCd 5 network

From UnrealIRCd documentation wiki
Jump to navigation Jump to search

You can link UnrealIRCd 4.x with 5.x fine, provided you follow the 3 important recommendations below. However, there are some caveats.

Important recommendations[edit]

We only have three important recommendations:

  1. No UnrealIRCd 3.2.x. There can be no UnrealIRCd 3.2.x server on your network. This shouldn't be a problem since 3.2.x was deprecated many years ago.
  2. Use up to date services! If you use Services then upgrade these to the latest version and use the latest protocol module (usually called "unreal4"). Yes, even if the server that services links to is still on 4.x then you must still upgrade services. We currently tested and support anope 2.0.7 or higher or atheme 7.2.9 or higher.
  3. Don't run a mixed network too long. We don't recommend running a mixed network for multiple months. This is because as long as you run a mixed UnrealIRCd 4 - UnrealIRCd 5 network you'll encounter a number of issues. These can only be resolved by running a true 100% UnrealIRCd 5 network.


Below you can read all details about the user-visible issues that you may run into when your network is partially 4.x and partially 5.x.

Summary: as long as you run a mixed U4-U5 network some things won't work at all, while other things may work only partially, in particular channel-related things. It is not fatal and it will not cause a crash, but it can be confusing and annoying. That's why you don't want to run a mixed-U4-U5-network for too long.

Functionality that works fine[edit]

Some U5 functionality should cause zero problems, even network-wide when the new U5 server is linked they can immediately be useful for your U4 network:

  • Storing of *LINES and spamfilters via the tkldb module (loaded by default in U5)
  • Storing of Permanent channels (+P) via the channeldb module (loaded by default in U5)

Missing functionality on U4 servers[edit]

This is the most obvious one: new functionality for users in UnrealIRCd 5 will not work on your UnrealIRCd 4 servers. This ranges from the various new IRCv3 features, channel history, server ban exceptions (/ELINE), etc.

There can also be functionality that is half-working, which is usually more confusing, see next section.

Functionality that works partially on U5 servers which can be confusing[edit]

Channel modes have been added (eg: +H) or have been changed (eg: +f with subtype r for repeats). These features may be broken or only working partially if you run a mixed U4-U5 network.

History may be half-working[edit]

For example, if you have 4x U4 servers and 1x U5 server and enable chat history with MODE #channel +H 15:1440 then chat history will be played back only on the U5 server. Everyone will understand that. However, depending on channel membership and your linking topology, in a mixed U4-U5 network you may also be missing channel history from certain people while still seeing playback for other people. In the last 15 lines of history playback you may see Person1 talking, but Person2 from a 'far server' is not shown. This may look rather odd when you see the channel history.

New channel modes will not spread well[edit]

Similarly, channel modes may not be spreading well if you set the new +H or +f with thew new subtype 'r'. Any U4 server in the path (linking topology) will block or alter such requests. So if you have a toplogy of: U5--U4 hub--U5 then the other U5 server will not see the MODE change properly.

Cannot join channels containing non-UTF8 characters[edit]

By default in UnrealIRCd 5 channel names may only contain valid UTF8 characters (see set::allowed-channelchars). If you have some very old clients using for example Russian/Cyrillic windows-1251 codepage instead of UTF8 then this means those channels can't be joined on UnrealIRCd 5. It is recommended to tell these users to upgrade their client and use UTF8. If this is not feasible then you can change the setting.

Error messages triggered on commands[edit]

Users may get receive error messages from remote 4.x servers when certain commands are used on 5.x servers. Currently the only known command that has this behavior is TAGMSG.

Functionality removed in U5, present in U4[edit]

  • Spamfilters of type posix are no longer supported. They were already deprecated in later 4.x releases. Use spamfilter type regex instead.
  • Extended ban ~R. So instead of using MODE #chan +e ~R:Name you should use MODE #chan +e ~a:Name

On UnrealIRCd 5 you cannot set these. Setting them on UnrealIRCd 4 servers will have no effect on users connected to UnrealIRCd 5 servers.