After the installation of a (non-master) UCS system the next step is to join the system into the UCS domain. There are several requirements in order to successfully join a system. All these requirements are checked before the actual join during the installation/setup or the manual join via the Univention Mangement Console (UMC).
If these checks fail, the join is aborted. Normally a re-installation is not necessary, just fix the problem and try to join again (as root via the UMC -> “Domain Join” module, or via the
univention-join command line tool). Below a list of requirements and some information on how to fix potential problems can be found.
The join tries to find the name of UCS master system (
host -t SRV "_domaincontroller_master._tcp.$domainname") for all configured DNS servers. If this fails, please check the UCR variables
nameserver3 and verify that one of them is set to the UCS master system’s IP address.
If a ping to the UCS master system fails, the join is aborted. Please check that the master system is online and reachable (
In order to join the ssh login of the join user (normally Administrator) on the master system has to be possible (
ssh Administrator@$master). Make sure the join user is member of at least one of the following groups: Domain Admins,DC Slave Hosts,Computers,DC Backup Hosts
The UCS version of the UCS master cannot be lower than the version of the joining system. If the joining system has a higher version, the master has to be updated first (or the system has to be re-installed with the appropriate UCS version).