Requirements for a successful join into the UCS domain

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.

DNS settings:
The join tries to find the name of UCS master system (host -t SRV "_domaincontroller_master._tcp.$(dnsdomainname)") for all configured DNS servers. If this fails, please check the UCR variables nameserver1, nameserver2, nameserver3 and verify that one of them is set to the UCS master system’s IP address.

Network connection:
If a ping to the UCS master system fails, the join is aborted. Please check that the master system is online and reachable (ping $master).

SSH login:
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

UCS version:
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).

1 Like