Artikel ini belum diterjemahkan. Isi berikut berbahasa Inggris. Buka versi asli bahasa Inggris.
Client Integration
This guide covers joining Rocky Linux client machines to an existing FreeIPA domain. Each client must be able to resolve the FreeIPA server’s DNS records before enrollment.
Client Prerequisites
Run these steps on every client machine before joining the domain.
1. Set the Hostname
hostnamectl set-hostname client-1.example.internal2. Configure DNS to Point at FreeIPA
# Set FreeIPA server as the primary DNS
nmcli con mod ens160 ipv4.method auto ipv4.dns "192.168.100.128" ipv4.ignore-auto-dns yes
nmcli con down ens160 && nmcli con up ens160
# Verify the DNS setting took effect
nmcli dev show | grep DNS
# IP4.DNS[1]: 192.168.100.1283. Test DNS Resolution
dig ipa-server.example.internalThe client must resolve the FreeIPA server’s hostname. If this fails, all subsequent steps will fail.
Install the Client Package
dnf install -y ipa-clientJoin the Domain
ipa-client-install --unattended \
--hostname=client-1.example.internal \
--domain=example.internal \
--realm=EXAMPLE.INTERNAL \
--server=ipa-server.example.internal \
--principal=admin \
--password='YourAdmin_P@55w0rd' \
--mkhomedir \
--enable-dns-updates \
--ntp-server=pool.ntp.orgParameter reference
| Parameter | Meaning | Why |
|---|---|---|
--hostname |
Client FQDN | Registered in the FreeIPA directory |
--domain / --realm |
Must match the server | Ensures same authentication domain |
--server |
FreeIPA server hostname | Which server handles authentication |
--principal / --password |
Admin credentials | Used to create the host record on the server |
--mkhomedir |
Auto-create home dirs | Creates /home/<user> on first login |
--enable-dns-updates |
DNS self-registration | Updates DNS automatically on IP changes |
--ntp-server |
NTP source | Keeps time synced with the server |
Runtime: 2 to 5 minutes.
Verify the Client Joined Successfully
# 1. Look up an IPA user
id admin
# uid=1600000000(admin) gid=1600000000(admins) groups=1600000000(admins)
# 2. Check SSSD status
systemctl status sssd
# 3. Clear and refresh SSSD cache
sss_cache -u admin
# 4. Check Kerberos configuration
cat /etc/krb5.conf | grep -A 5 "EXAMPLE.INTERNAL"
# 5. Test SSH login
ssh admin@client-1
# First login requires the FreeIPA user passwordUninstalling a Client
To remove a client from the domain:
ipa-client-install --uninstallAlso remove the host record from the FreeIPA server:
# On the FreeIPA server
ipa host-del client-1.example.internalNext Steps
- Create users and manage permissions through FreeIPA
- Troubleshoot common issues if something goes wrong
Adapted from Dawn’s Blog : FreeIPA Complete Deployment Guide.