GSP/Panel
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Panel/docs/features/SCHEDULER_SYSTEM.md
Frank Harris 3829a4a83d worshop work
2026-06-08 16:09:54 -05:00

2.5 KiB
Raw Permalink Blame History

Scheduler System

Workspace reference: GSP-WORKSPACE.md

Current State

The scheduler is implemented through the cron Panel module and agent-side Schedule::Cron execution.

Important references:

  • docs/modules/SCHEDULER.md
  • Panel/modules/cron/cron.php
  • Panel/modules/cron/shared_cron_functions.php
  • Agent_Linux/ogp_agent.pl
  • Agent-Windows/OGP64/OGP/ogp_agent.pl

Current Strengths

  • It can schedule server actions.
  • It can schedule Steam updates and server content actions.
  • It already has a visible UI and agent execution path.

Current Weaknesses

  • It is too command-string oriented.
  • Customer-safe and admin-only actions are not separated cleanly enough.
  • Task run history is not rich enough.
  • Error reporting and conflict handling need work.

Recommended Direction

  • typed actions
  • explicit permissions
  • stored task history
  • clear logs and results
  • no customer raw shell commands by default

Server Content / Workshop Actions

The Scheduler must use Server Content Manager actions for Workshop automation. Do not build a separate Workshop scheduler.

Current Server Content actions:

Action Key Purpose
server_content_check_updates Check content update state.
server_content_check_workshop_updates Check Workshop update state.
server_content_install_updates_if_stopped Install only when the server is stopped.
server_content_install_updates_next_restart Queue updates for the next restart.
server_content_install_updates_now Install available updates immediately.
server_content_install_updates_and_restart Install updates, wait, then restart.
server_content_update_all Update all server content records.
server_content_validate_files Validate server content files.
server_content_backup_before_update Backup before applying updates.

Workshop-specific aliases:

Action Key Purpose
workshop_update Update installed Workshop items through Server Content Manager.
workshop_update_and_restart Update Workshop items and request a safe restart.
workshop_download_only Download/cache Workshop items without installing into live folders.
workshop_install_pending_on_restart Install items marked as pending during the restart/maintenance window.

Implementation references:

  • Panel/modules/cron/shared_cron_functions.php
  • Panel/modules/addonsmanager/server_content_actions.php
  • Panel/modules/addonsmanager/workshop_action.php