Server Roles
Display server role information showing service distribution across IPA infrastructure. Server roles indicate which services (CA, DNS, KRA, AD Trust) are enabled on each server. Features include comprehensive role status display showing server names, role types, and enablement status for infrastructure planning and redundancy verification.
Get status of roles (DNS server, CA, etc.) provided by IPA masters.
The status of a role is either enabled, configured, or absent.
EXAMPLES
Show status of ‘DNS server’ role on a server:
ipa server-role-show ipa.example.com "DNS server"Show status of all roles containing ‘AD’ on a server:
ipa server-role-find --server ipa.example.com --role="AD trust controller"Show status of all configured roles on a server:
ipa server-role-find ipa.example.comShow implicit IPA master role:
ipa server-role-find --include-master
Commands
Command Description
server-role-find Find a server role on a server(s)
server-role-show Show role status on a server
server-role-find
Usage: ipa [global-options] server-role-find [CRITERIA] [options]
Find a server role on a server(s)
Arguments
Argument Required Description
CRITERIA no A string searched in all relevant object
attributes
Options
Option Description
--server SERVER IPA server hostname
--role ROLE IPA server role name
--status STATUS Status of the role
--timelimit TIMELIMIT Time limit of search in seconds (0 is unlimited)
--sizelimit SIZELIMIT Maximum number of entries returned (0 is
unlimited)
--include-master Include IPA master entries
--all Retrieve and print all attributes from the
server. Affects command output.
--raw Print entries as stored on the server. Only
affects output format.
server-role-show
Usage: ipa [global-options] server-role-show SERVER ROLE [options]
Show role status on a server
Arguments
Argument Required Description
SERVER yes IPA server hostname
ROLE yes IPA server role name
Options
Option Description
--all Retrieve and print all attributes from the
server. Affects command output.