Red Hat Training
A Red Hat training course is available for RHEL 8
Chapter 13. Preparing the system for IdM client installation
This chapter describes the conditions your system must meet to install an Identity Management (IdM) client.
13.1. DNS requirements for IdM clients
Client installer by default tries to search for _ldap._tcp.DOMAIN DNS SRV records for all domains that are parent to its hostname. For example, if a client machine has a hostname client1.idm.example.com, the installer will try to retrieve an IdM server hostname from _ldap._tcp.idm.example.com, _ldap._tcp.example.com and _ldap._tcp.com DNS SRV records, respectively. The discovered domain is then used to configure client components (for example, SSSD and Kerberos 5 configuration) on the machine.
However, the hostnames of IdM clients are not required to be part of the primary DNS domain. If the client machine hostname is not in a subdomain of an IdM server, pass the IdM domain as the --domain option of the ipa-client-install command. In that case, after the installation of the client, both SSSD and Kerberos components will have the domain set in their configuration files and will use it to autodiscover IdM servers.
Additional resources
- For details on DNS requirements in IdM, see Host name and DNS requirements for IdM.
13.2. Port requirements for IdM clients
Identity Management (IdM) clients connect to a number of ports on IdM servers to communicate with their services.
On IdM client, these ports must be open in the outgoing direction. If you are using a firewall that does not filter outgoing packets, such as firewalld, the ports are already available in the outgoing direction.
Additional resources
- For information about which specific ports are used, see Port requirements for IdM.
13.3. IPv6 requirements for IdM clients
Identity Management (IdM) does not require the IPv6 protocol to be enabled in the kernel of the host that you want to enroll into IdM. For example, if your internal network only uses the IPv4 protocol, you can configure the System Security Services Daemon (SSSD) to only use IPv4 to communicate with the IdM server. You can do this by inserting the following line into the [domain/NAME] section of the /etc/sssd/sssd.conf file:
lookup_family_order = ipv4_onlyAdditional resources
-
For more information about the
lookup_family_orderoption, see thesssd.conf(5)man page.
13.4. Installing IdM client packages from the idm:client stream
In RHEL8, the packages necessary for installing an Identity Management (IdM) client are shipped as a module.
The idm:client stream is the default stream of the idm module. Use this stream to download the IdM client packages if you do not need to install server components on your machine. Using the idm:client stream is especially recommended if you need to consistently use IdM client software that is supported long-term, provided you do not need server components, too.
Do not use the idm:client stream if you are planning to install an IdM replica on the host. In that case, use the idm:DL1 stream instead.
Prerequisites
When switching to the
idm:clientstream after you previously enabled theidm:DL1stream and downloaded packages from it, you need to first explicitly remove all the relevant installed content and disable theidm:DL1stream before enabling theidm:clientstream.For details on how to proceed, see Switching to a later stream.
ImportantTrying to enable a new stream without disabling the current one results in an error.
Procedure
To download the packages necessary for installing an IdM client:
# yum module install idm
13.5. Installing IdM client packages from the idm:DL1 stream
In RHEL8, the packages necessary for installing an Identity Management (IdM) client are shipped as a module.
The idm:DL1 stream needs to be enabled before you can download packages from it. Use this stream to download the IdM client packages if you need to install IdM server components on your machine.
Prerequisites
When switching to the
idm:DL1stream after you previously enabled theidm:clientstream and downloaded packages from it, you need to first explicitly remove all the relevant installed content and disable theidm:clientstream before enabling theidm:DL1stream.For details on how to proceed, see Switching to a later stream.
ImportantTrying to enable a new stream without disabling the current one results in an error.
Procedure
To switch to the RPMs delivered through the
idm:DL1stream:# yum module enable idm:DL1 # yum distro-sync
To download the packages necessary for installing an IdM client:
# yum module install idm:DL1/client