infrastructure

IPA Locations

Manage IPA locations for DNS-based service discovery and client affinity. Locations enable clients to discover nearby services automatically based on DNS SRV record priorities. Features include location creation and management, server-to-location assignment, automatic DNS SRV record updates, and integration with DNS for optimized service discovery and reduced cross-site authentication traffic.

5 commands
infrastructure

Manipulate DNS locations

EXAMPLES

Find all locations:

ipa location-find

Show specific location:

ipa location-show location

Add location:

ipa location-add location --description 'My location'

Delete location:

ipa location-del location

Commands


Command Description


location-add Add a new IPA location.

location-del Delete an IPA location.

location-find Search for IPA locations.

location-mod Modify information about an IPA location.

location-show Display information about an IPA location.


location-add

Usage: ipa [global-options] location-add NAME [options]

Add a new IPA location.

Arguments


Argument Required Description


NAME yes IPA location name


Options


Option Description


--description DESCRIPTION IPA Location description

--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

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

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


location-del

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

Delete an IPA location.

Arguments


Argument Required Description


NAME yes IPA location name


Options


Option Description


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



location-find

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

Search for IPA locations.

Arguments


Argument Required Description


CRITERIA no A string searched in all relevant object attributes


Options


Option Description


--name NAME IPA location name

--description DESCRIPTION IPA Location description

--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”)


location-mod

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

Modify information about an IPA location.

Arguments


Argument Required Description


NAME yes IPA location name


Options


Option Description


--description DESCRIPTION IPA Location description

--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.


location-show

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

Display information about an IPA location.

Arguments


Argument Required Description


NAME yes IPA location name


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.

Related Topics