Searches#
file version: 8 Jul 2026
Introduction: search#
ATLAS allows to run searches for files over basic metadata (uid, size, path, …), netCDF metadata and tags. This can be done via the WebGUI and via the atlas cli.
Running a search#
If you want to search your archived data (which is probably the default), please select the hsm resource on the left and, then, click into the search field on the top right.
If you wish to run your search on the terminal, you can use the WebGUI as a graphical query builder and copy the search query afterwards (top; directly below “Search Results”):
Run the search via the terminal:
$ atlas search --resource hsm "scoutfs.path LIKE %INDEX.txt% AND scoutfs.uid = 25301 AND scoutfs.path LIKE %bm0146%"
PATH SIZE OWNER TYPE MTIME
hsm/arch/bm0146/k202158/packems_test_1/INDEX.txt 10.6K k204221 2026-04-25 22:03
hsm/arch/bm0146/k204221/iow/INDEX.txt 1.2M k204221 2025-10-16 20:43
hsm/arch/bm0146/k204221/iow2/INDEX.txt 1.2M k204221 2025-12-03 19:45
hsm/arch/bm0146/k40221/INDEX.txt 1.5K k204221 2021-10-17 12:41
4 of 4 results shown
WebGUI: Select search results#
Select search results and click an action such as “copy”.
ATLAS CLI: use search results as input in other commands#
Run the search
$ atlas search --resource hsm "scoutfs.path LIKE %INDEX.txt% AND scoutfs.uid = 25301 AND scoutfs.path LIKE %bm0146%"
PATH SIZE OWNER TYPE MTIME
hsm/arch/bm0146/k202158/packems_test_1/INDEX.txt 10.6K k204221 2026-04-25 22:03
hsm/arch/bm0146/k204221/iow/INDEX.txt 1.2M k204221 2025-10-16 20:43
hsm/arch/bm0146/k204221/iow2/INDEX.txt 1.2M k204221 2025-12-03 19:45
hsm/arch/bm0146/k40221/INDEX.txt 1.5K k204221 2021-10-17 12:41
4 of 4 results shown
Removed first row (tail -n +2), remove last two rows (head -n -2) and select the left column.
$ atlas search --resource hsm "scoutfs.path LIKE %INDEX.txt% AND scoutfs.uid = 25301 AND scoutfs.path LIKE %bm0146%" | tail -n +2 | head -n -2 | awk '{ print $1 }'
hsm/arch/bm0146/k202158/packems_test_1/INDEX.txt
hsm/arch/bm0146/k204221/iow/INDEX.txt
hsm/arch/bm0146/k204221/iow2/INDEX.txt
hsm/arch/bm0146/k40221/INDEX.txt
Use the output of search as input but the newlines need to be replaced by spaces
$ atlas tag set --name testT --value 42 `atlas search --resource hsm "scoutfs.path LIKE %INDEX.txt% AND scoutfs.uid = 25301 AND scoutfs.path LIKE %bm0146%" | tail -n +2 | head -n -2 | awk '{ print $1 }' | tr '\n' ' '`
Set tag testT=42 on hsm/arch/bm0146/k202158/packems_test_1/INDEX.txt
Set tag testT=42 on hsm/arch/bm0146/k204221/iow/INDEX.txt
Set tag testT=42 on hsm/arch/bm0146/k204221/iow2/INDEX.txt
Set tag testT=42 on hsm/arch/bm0146/k40221/INDEX.txt