Meridian handbook
ReferenceCLI

search

engine-dmo search: The search index and the query log. Every subcommand, argument and flag.

The search index and the query log.

CommandWhat it does
engine-dmo search capabilitiesWhat the configured backend supports
engine-dmo search rebuildReindex every published document, resumable and online
engine-dmo search statusThe configured backend, its health and what is indexed
engine-dmo search synonyms importSeed synonyms from config/search/synonyms.yaml; rules already held are left alone
engine-dmo search synonyms listThe synonym rules the database holds
engine-dmo search testRun a query and show what came back
engine-dmo search verifyCompare the index with what is published and report any drift
engine-dmo search zero-resultsWhat visitors searched for and did not find

engine-dmo search capabilities

What the configured backend supports.

engine-dmo search capabilities [flags]

--json prints the command’s own JSON document. Runs in a project.

engine-dmo search rebuild

Reindex what is published, then delete what is indexed and no longer published. The run is recorded where the admin’s search index screen shows it; a rebuild that failed or whose process stopped is resumed from where it got to unless --fresh is given.

engine-dmo search rebuild [flags]
FlagTypeDefaultMeaning
--freshboolstart over rather than resume a rebuild that did not finish
--sitestringrebuild one site’s indexes (default: every site)

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo search status

The configured backend, its health and what is indexed.

engine-dmo search status

--json prints the command’s own JSON document. Runs in a project.

engine-dmo search synonyms import

Load the seed file’s rules into the database, origin seed. A rule the site and locale already holds (the same one-way source, or the same terms) is left as it is, whoever wrote it, so a second import creates nothing. Every rule is checked first and nothing is written when one is refused. New rules are queued for the search backend, which the running server’s workers push; nothing is reindexed.

engine-dmo search synonyms import [flags]
FlagTypeDefaultMeaning
--dry-runboolreport what would be created and write nothing
--filestringthe seed file (default: config/search/synonyms.yaml)

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo search synonyms list

The synonym rules the database holds.

engine-dmo search synonyms list [flags]
FlagTypeDefaultMeaning
--localestringone locale’s rules (default: every locale)
--sitestringone site’s rules (default: every site)

--json prints the command’s own JSON document. Runs in a project.

engine-dmo search test

Run a query and show what came back.

engine-dmo search test <query> [flags]
ArgumentRequiredRepeatable
queryyesno
FlagTypeDefaultMeaning
--localestringlocale (default: the site’s default)
--sitestringsite key (default: the default site)

--json prints the text output in the JSON envelope. Runs in a project.

engine-dmo search verify

Compare the index with what is published and report any drift.

engine-dmo search verify

Aliases: check. --json prints the text output in the JSON envelope. Runs in a project.

engine-dmo search zero-results

What visitors searched for and did not find.

engine-dmo search zero-results [flags]
FlagTypeDefaultMeaning
--limitint50how many to list
--sincestring30dwindow, such as 30d or 168h
--sitestringsite key (default: the default site)

--json prints the command’s own JSON document. Runs in a project.