Files
yacy_search_server/help/IndexCreateQueues_p.md
2026-07-10 00:20:29 +02:00

4.0 KiB


page: htroot/IndexCreateQueues_p.html help: help/IndexCreateQueues_p.md title: '' Crawl Queue package: index-management access: admin kind: admin-page backend_java: source/net/yacy/htroot/IndexCreateQueues_p.java

'' Crawl Queue

Purpose

Crawl Queue shows pending and failed indexing work.

Use it to understand why documents have not reached the searchable index yet.

What You Can Do Here

  • Crawl Queue shows pending and failed indexing work.
  • Select the narrowest URL, host, field, query, queue, or collection scope.
  • Treat deletion, rebuilding, and reloading as maintenance operations with visible search impact.

Page Architecture

Index pages expose stored documents through URL, host, path, Solr field, or queue views. Read-only inspection and destructive maintenance often share the same page, so the target scope matters more than the button label.

Control Meaning Values or examples
pattern Filter expression. It decides which records are included, excluded, displayed, exported, or processed on this page. Text value; use the page label and surrounding context to choose the exact content.
option Choice value. Options: 5 = Initiator, 3 = Profile, 4 = Depth, 6 = Modified Date, 2 = Anchor Name, 1 = URL. 5 = Initiator, 3 = Profile, 4 = Depth, 6 = Modified Date, 2 = Anchor Name, 1 = URL
delete Deletes the selected object or scope. Use only with explicit confirmation. Delete

Correct Use

Use inspection before maintenance. First identify the exact URL, host, field, queue, collection, or query scope, then choose the action. Deletion and re-indexing can be expensive or irreversible from the user's point of view, so never broaden the scope just to make a command easier.

Access And Safety

Administrator access is required. YaCy protects _p pages as administration pages.

Protected related endpoint(s): /IndexCreateQueues_p.html.

Automation And API

Page backend: source/net/yacy/htroot/IndexCreateQueues_p.java.

Endpoint Method Access Backend
/IndexCreateQueues_p.html POST admin source/net/yacy/htroot/IndexCreateQueues_p.java

Parameter Guide

The table explains values that an agent or script must set deliberately. Parameters not relevant to a task should be omitted or left at the page default.

Parameter Meaning and valid values Care
pattern Filter expression. It decides which records are included, excluded, displayed, exported, or processed on this page. Set only when this option is part of the intended request; otherwise omit it and let YaCy use the page default.
option Choice value. Options: 5 = Initiator, 3 = Profile, 4 = Depth, 6 = Modified Date, 2 = Anchor Name, 1 = URL. Set only when this option is part of the intended request; otherwise omit it and let YaCy use the page default.
delete Deletes the selected URL, path, or index scope. Confirm the scope first. Can remove data, stop work, expose access, or make a broad operational change. Use only with explicit confirmation and an exact target.
sort Sort field or sort direction. Controls the scope or format of the result. Prefer the narrowest value that answers the request.
urlsPerHost Host or domain scope. Set only when this option is part of the intended request; otherwise omit it and let YaCy use the page default.

Example request shape:

POST /IndexCreateQueues_p.html
Content-Type: application/x-www-form-urlencoded

pattern=...&option=...&delete=...&embed=...&sort=...

What To Expect

The response should make the selected index scope clearer: records listed, queues changed, errors shown, fields rebuilt, or deletion confirmed. Verify user-visible impact with search after maintenance actions.

  • Related index work is usually reached through IndexBrowser_p.html, IndexControlURLs_p.html, queue pages, deletion pages, or re-indexing monitors.