Schedule Integration

Schedule Integration

Server Sync integrates directly into the Pelican Schedule system.

SyncTaskSchema

Registers "Server Sync" as a task type in the Schedule system:

Task Execution

1. Load pair and check if enabled
2. Acquire cache lock: server_sync_schedule_{pairId} (10 min timeout)
3. If sync_mode = on_restart: Stop partner server + wait 15s
4. Execute SyncService::executeSync()
5. If sync_mode = on_restart: Start partner server
6. Release lock

Automatic Scheduler

A scheduler runs every minute:

server-sync:run-due — every minute, without overlapping (15 min lock)
server-sync:cleanup-logs — daily

Flow (every minute):

1. Reset stale syncs: Pairs in running status for >30 min → set to failed
2. Check concurrent limit: Calculate available slots
3. Load due pairs: SyncPair::dueForSync() (limited to available slots)
4. Execute synchronously (not via queue)

Log Cleanup:

Daily, all SyncLog entries older than log_retention_days are deleted.

Create Sync Schedule (Admin)

Creates a schedule with preconfigured tasks:

Preset Options:

Schedule Mirroring

When enabled, the schedule is automatically mirrored to the partner server:

• Mirror name: "{originalName} [Sync Mirror]"
• only_when_online = false (sync runs even when server is offline)
• All tasks are cloned
• Changes to the original schedule are automatically synchronized
• Deleting the source schedule removes the mirror