Maintenance and Troubleshooting - FLARE-forecast/flare-forecast.github.io GitHub Wiki

GitHub Maintenance

Task Description Frequency
Splitting large data file Split observational data files before they reach the GitHub file size limit (100 MB) Once a year
Purging history Purge old GitHub branches commits Once a year

Gateway Maintenance

Task Description Frequency
Applying security updates Apply system updates to the gateway Once a year
Service check Ensure all services are working as expected after updates Once a year

JetStream VM Maintenance

Task Description Frequency
Delete old GitHub repository backups Remove outdated GitHub repository backups to free up disk space Once a year

Troubleshooting

No daily email Missing graphs in daily email Gateway down notification from HealthChecks.io No data or logs were pushed to GitHub from GitHub Monitor FTP connection issues from data logger to Gateway Loose or Faulty Ethernet Cable Directory permissions problem FTP authentication problem Disk Full Issue on Jetstream VMs (JS Front and FLARE GitHub Runner) File exceeds 100 MB limit on local Git repo Git Object File Empty Error

Troubleshooting

Issue Possible Reason
No daily email Failure in send-email-fcre GitHub Action / Failure in send-email-sunp GitHub Action
Missing graphs in daily email Failure in wvwa-generate-graphs GitHub Action / Failure in sunp-generate-graphs GitHub Action
Gateway down notification from HealthChecks.io Gateway is off / Gateway has no internet access
No data or logs were pushed to GitHub No new data or logs are available / data or logs cannot be pushed due to connection issues / data or logs cannot be pushed due to other issues such as Git error
FTP connection issues from data logger to Gateway Loose or Faulty Ethernet Cable / Directory permissions problem / FTP authentication problem
Disk Full Issue on JetStream VMs (JS Front and FLARE GitHub Runner) Failure in purging the GitHub backup history / Failure in purging unused Docker images
File exceeds 100 MB limit on local Git repo Failure in annual file split
Git Object File Empty Error Possible interruption in Git process due to power cut off especially in battery powered gateways