From 8e537b5d29b01f9400fb0be4945d4c07bbd45f3f Mon Sep 17 00:00:00 2001 From: repstein2 Date: Sat, 7 Nov 2026 17:11:24 -0500 Subject: [PATCH] Document optional background IRRDB updates and large listings --- docs/features/irrdb.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/features/irrdb.md b/docs/features/irrdb.md index ba43f415..6adfdd35 100644 --- a/docs/features/irrdb.md +++ b/docs/features/irrdb.md @@ -155,3 +155,17 @@ bgpq3 -S RIPE -l pl -j -m 24 AS-BTIRE bgpq3 -S RIPE -l pl -j -m 48 -6 AS-BTIRE ``` + +## Optional background updates + +Manual IRRDB updates can run outside the HTTP request without changing the application's default queue connection. Set `IRRDB_QUEUE_CONNECTION=irrdb`, run database migrations, and rebuild cached configuration. Supervise a worker as the web application user: + +``` +php artisan queue:work irrdb --queue=irrdb --sleep=2 --tries=1 --timeout=1500 --memory=768 --max-time=3600 +``` + +The dedicated connection uses the `irrdb_jobs` table and a retry interval of 1800 seconds. Keep worker timeout below the retry interval. Restart workers after deploying changes. A persistent cache supporting atomic locks is required; configure the same cache for web, worker, and scheduled IRRDB imports. + +Leaving the environment variable unset preserves existing queue selection. Pagination, batched writes, and writer serialization apply independently. Listing search matches the start of a prefix or ASN. Change previews are limited to 50 entries with exact totals retained. Failed imports roll back their transaction and leave previously committed records available. + +The worker must be supervised and monitored: jobs cannot complete while it is stopped. This feature does not reload route-server configurations or restart BGP sessions.