Join Failure When Joining a UCS System to a UCS 5.0-10 Primary Directory Node
Problem
When attempting to join a UCS system that is not running UCS version 5.0-10 to a Primary Directory Node that is on UCS 5.0-10, the join process fails during execution of the univention-join
script.
Warning: UCS version on dc0.ucs5schoolhejne.intranet is lower (5.010) than local version (5.08). This constellation is not supported.
Executing univention-join
results in the following output:
root@ucs5:~# univention-join
univention-join: joins a computer to an UCS domain
copyright (c) 2001-2024 Univention GmbH, Germany
Enter Primary Directory Node Account : Administrator
Enter Primary Directory Node Password:
Search Primary Directory Node: done
Check Primary Directory Node:
**************************************************************************
* Join failed! *
* Contact your system administrator *
**************************************************************************
* Message: Please visit https://help.univention.com/t/8842 for common problems during the join and how to fix them -- Warning: UCS version on dc0.ucs5schoolhejne.intranet is lower (5.010) than local version (5.08). This constellation is not supported.
**************************************************************************
Root Cause
The issue occurs due to a strict UCS version check introduced in UCS 5.0-10. The join process validates that the Primary Directory Node is not running a lower UCS version than the joining system. If this is the case, the join is aborted with the above error.
This behavior is documented in the following Bug report:
Bug 58212 – UCS join fails due to version mismatch check
Workaround
To bypass the UCS version check during the join process, the -disableVersionCheck
flag can be passed to the univention-join
command.
Example:
univention-join -disableVersionCheck
Note: This workaround should only be used in controlled environments and with a full understanding of the implications.
Resolution
To avoid this issue entirely, ensure that all UCS systems involved in the join process are running the same UCS version. Ideally, the joining system is on the same version than the Primary Directory Node.
Additional Information
For general troubleshooting and common join errors, refer to the following article:
https://help.univention.com/t/8842