infrastructure

IPA Servers

Manage IPA server entries and server configuration. Server management includes adding and removing replica servers, server role information, location assignment, and server configuration settings. Features include server enrollment, server deletion with force options, server state management, and integration with topology and server role tracking for maintaining multi-master replication infrastructure.

5 commands
infrastructure

Get information about installed IPA servers.

EXAMPLES

Find all servers:

ipa server-find

Show specific server:

ipa server-show ipa.example.com

Commands


Command Description


server-del Delete IPA server.

server-find Search for IPA servers.

server-mod Modify information about an IPA server.

server-show Show IPA server.

server-state Set enabled/hidden state of a server.


server-del

Usage: ipa [global-options] server-del NAME [options]

Delete IPA server.

Arguments


Argument Required Description


NAME yes IPA server hostname


Options


Option Description


--continue Continuous mode: Don’t stop on errors.

--ignore-topology-disconnect Ignore topology connectivity problems after removal

--ignore-last-of-role Skip a check whether the last CA master or DNS server is removed

--force Force server removal even if it does not exist


server-find

Usage: ipa [global-options] server-find [CRITERIA] [options]

Search for IPA servers.

Arguments


Argument Required Description


CRITERIA no A string searched in all relevant object attributes


Options


Option Description


--name NAME IPA server hostname

--minlevel MINLEVEL Minimum domain level

--maxlevel MAXLEVEL Maximum domain level

--timelimit TIMELIMIT Time limit of search in seconds (0 is unlimited)

--sizelimit SIZELIMIT Maximum number of entries returned (0 is unlimited)

--all Retrieve and print all attributes from the server. Affects command output.

--raw Print entries as stored on the server. Only affects output format.

--pkey-only Results should contain primary key attribute only (“name”)

--topologysuffixes TOPOLOGYSUFFIXES Search for servers with these managed suffixes.

--no-topologysuffixes NO-TOPOLOGYSUFFIXES Search for servers without these managed suffixes.

--in-locations IN-LOCATIONS Search for servers with these ipa locations.

--not-in-locations NOT-IN-LOCATIONS Search for servers without these ipa locations.

--servroles SERVROLES Search for servers with these enabled roles.


server-mod

Usage: ipa [global-options] server-mod NAME [options]

Modify information about an IPA server.

Arguments


Argument Required Description


NAME yes IPA server hostname


Options


Option Description


--location LOCATION Server DNS location

--service-weight SERVICE-WEIGHT Weight for server services

--setattr SETATTR Set an attribute to a name/value pair. Format is attr=value.

--addattr ADDATTR Add an attribute/value pair. Format is attr=value. The attribute

--delattr DELATTR Delete an attribute/value pair. The option will be evaluated

--rights Display the access rights of this entry (requires —all). See ipa man page for details.

--all Retrieve and print all attributes from the server. Affects command output.

--raw Print entries as stored on the server. Only affects output format.

--no-members Suppress processing of membership attributes.


server-show

Usage: ipa [global-options] server-show NAME [options]

Show IPA server.

Arguments


Argument Required Description


NAME yes IPA server hostname


Options


Option Description


--rights Display the access rights of this entry (requires —all). See ipa man page for details.

--all Retrieve and print all attributes from the server. Affects command output.

--raw Print entries as stored on the server. Only affects output format.

--no-members Suppress processing of membership attributes.


server-state

Usage: ipa [global-options] server-state NAME [options]

Set enabled/hidden state of a server.

Arguments


Argument Required Description


NAME yes IPA server hostname


Options


Option Description


--state STATE Server state