Add support for updating on certain days (librenms#19880)

* Add support for updating on certain days

* Update daily.php

* Update Updating.md

* distinct days

---------

Co-authored-by: Tony Murray <murraytony@gmail.com>

Author: laf

daily.php

@@ -53,6 +53,16 @@
         exit(0);
     }
 
+    $on_days = LibrenmsConfig::get('update_on_days', []);
+
+    if (is_array($on_days) && ! empty($on_days)) {
+        $today = strtolower(date('l')); // monday..sunday
+
+        if (! in_array($today, $on_days, true)) {
+            exit(0);
+        }
+    }
+
     if (LibrenmsConfig::get('update_channel') == 'master') {
         exit(1);
     } elseif (LibrenmsConfig::get('update_channel') == 'release') {

doc/General/Updating.md

@@ -42,3 +42,16 @@ This can be disabled in the WebUI:
     ```bash
     lnms config:set update false
     ```
+
+## Updating on set days
+
+You can configure LibreNMS to only perform updates on set days. This configuration is an
+array and is blank by default.
+
+!!! setting "system/updates"
+    ```bash
+    lnms config:get update_on_days
+    ```
+    ```bash
+    lnms config:set update_on_days.+ "monday"
+    ```

lang/en/settings.php

@@ -2410,6 +2410,10 @@
                 'release' => 'Monthly',
             ],
         ],
+        'update_on_days' => [
+            'description' => 'Only run updates on these days',
+            'help' => 'If set (non-empty), daily.sh will only run code updates when today matches one of these values: monday-sunday or mon-sun. Leave empty to allow updates every day.',
+        ],
         'uptime_warning' => [
             'description' => 'Show Device as warning if Uptime below (seconds)',
             'help' => 'Shows Device as warning if Uptime is below this value. Custom maps status will reflect this setting. 0 disables warning. Default 24h',

resources/definitions/config_definitions.json

@@ -7311,6 +7311,26 @@
                 "release": "release"
             }
         },
+        "update_on_days": {
+            "default": ["monday", "tuesday", "wednesday", "thursday", "friday", "saturday", "sunday"],
+            "type": "array",
+            "options": {
+                "monday": "Monday",
+                "tuesday": "Tuesday",
+                "wednesday": "Wednesday",
+                "thursday": "Thursday",
+                "friday": "Friday",
+                "saturday": "Saturday",
+                "sunday": "Sunday"
+            },
+            "validate": {
+                "value": "array",
+                "value.*": "distinct|in:monday,tuesday,wednesday,thursday,friday,saturday,sunday"
+            },
+            "group": "system",
+            "section": "updates",
+            "order": 2
+        },
         "uptime_warning": {
             "group": "webui",
             "section": "device",