Questo contenuto non è disponibile nella lingua selezionata.
Chapter 4. Searching Identity Management entries from the command line
Locate and view Identity Management (IdM) entries by using search filters and display commands.
4.1. Overview of listing IdM entries Copia collegamentoCollegamento copiato negli appunti!
Identify specific entries within the Identity Management (IdM) database by using search filters and keywords. You can use the ipa *-find commands to retrieve lists of objects and to filter results based on user membership or attribute matches.
Useful search commands
To list all the
findcommands, use thegreputility with theipa helpcommand:ipa help commands | grep find
$ ipa help commands | grep findCopy to Clipboard Copied! Toggle word wrap Toggle overflow To list all users in the IdM database, use the following command:
ipa user-find
$ ipa user-findCopy to Clipboard Copied! Toggle word wrap Toggle overflow To list user groups whose specified attributes contain a keyword, run:
ipa group-find <keyword>
$ ipa group-find <keyword>Copy to Clipboard Copied! Toggle word wrap Toggle overflow For example the
ipa group-find admincommand lists all groups whose names or descriptions include the stringadmin:Copy to Clipboard Copied! Toggle word wrap Toggle overflow To search for groups that contain a particular user:
ipa group-find --user=<user_name>
$ ipa group-find --user=<user_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow To search for groups that do not contain a particular user:
ipa group-find --no-user=<user_name>
$ ipa group-find --no-user=<user_name>Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.2. Showing details for a particular entry Copia collegamentoCollegamento copiato negli appunti!
Retrieve the full technical configuration and attribute list for a specific Identity Management (IdM) entry. You can use the ipa <object>-show command to display detailed information for a single object, such as a host, user, or service, rather than a filtered list of multiple results.
Procedure
To display details for a specific entry, run the
ipa <object>-showcommand followed by the name of the entry. For example:ipa host-show server.example.com
$ ipa host-show server.example.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow The CLI displays the full record for the specified object:
Host name: server.example.com Principal name: host/server.example.com@EXAMPLE.COM ...
Host name: server.example.com Principal name: host/server.example.com@EXAMPLE.COM ...Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.3. Adjusting the search size and time limit Copia collegamentoCollegamento copiato negli appunti!
Some queries, such as requesting a list of IdM users, can return a very large number of entries. By tuning these search operations, you can improve the overall server performance when running the ipa *-find commands, such as ipa user-find, and when displaying corresponding lists in the Web UI.
- Search size limit
Defines the maximum number of entries returned for a request sent to the server from a client’s CLI or from a browser accessing the IdM Web UI.
Default: 100 entries.
- Search time limit
Defines the maximum time (in seconds) that the server waits for searches to run. Once the search reaches this limit, the server stops the search and returns the entries discovered in that time.
Default: 2 seconds.
If you set the values to -1, IdM does not apply any limits when searching.
Setting search size or time limits too high can negatively affect server performance.
4.3.1. Adjusting the search size and time limit in the command line Copia collegamentoCollegamento copiato negli appunti!
You can adjust the search size and time limits globally or for a specific entry to optimize search performance and responsiveness.
Procedure
To display current search time and size limits in CLI, use the
ipa config-showcommand:ipa config-show Search time limit: 2 Search size limit: 100
$ ipa config-show Search time limit: 2 Search size limit: 100Copy to Clipboard Copied! Toggle word wrap Toggle overflow To adjust the limits globally for all queries, use the
ipa config-modcommand and add the--searchrecordslimitand--searchtimelimitoptions. For example:ipa config-mod --searchrecordslimit=500 --searchtimelimit=5
$ ipa config-mod --searchrecordslimit=500 --searchtimelimit=5Copy to Clipboard Copied! Toggle word wrap Toggle overflow To temporarily adjust the limits only for a specific query, add the
--sizelimitor--timelimitoptions to the command. For example:ipa user-find --sizelimit=200 --timelimit=120
$ ipa user-find --sizelimit=200 --timelimit=120Copy to Clipboard Copied! Toggle word wrap Toggle overflow
4.3.2. Adjusting the search size and time limit in the Web UI Copia collegamentoCollegamento copiato negli appunti!
You can adjust global search size and time limits using the IdM Web UI to optimize search performance and responsiveness.
Procedure
- Log in to the IdM Web UI.
- Click IPA Server.
- On the IPA Server tab, click Configuration.
Set the required values in the Search Options area.
Default values are:
- Search size limit: 100 entries
- Search time limit: 2 seconds
- Click Save at the top of the page.