Dxcadmin: /* 📲 Telegram integration (optional) */

2025-11-22T16:40:41Z

📲 Telegram integration (optional)

← Older revision		Revision as of 16:40, 22 November 2025
Line 97:		Line 97:
	* A backup completes		* A backup completes

	For full setup instructions, see: [~~https://wiki.dxcluster.org/wiki/~~Sending_messages_to_the_sysop_via_Telegram Sending messages to the sysop via Telegram]		For full setup instructions, see: [[Sending_messages_to_the_sysop_via_Telegram\|Sending messages to the sysop via Telegram]]

	== 🧠 Notes ==		== 🧠 Notes ==

EA3CV: Created page with " = 🛠️ Node Backup and Update with check_build = == 📋 Description == The `check_build` command is a DXSpider utility script that checks for new builds (updates) in the MOJO branch. If a new build is available, it can: * Perform a full backup of the current node installation * Retain previous backup archives * Automatically update the node (Git hard reset + pull) This tool does not aim to replace the standard `git` update method, but is especially useful for sys..."

2025-04-09T16:55:40Z

Created page with " = 🛠️ Node Backup and Update with check_build = == 📋 Description == The `check_build` command is a DXSpider utility script that checks for new builds (updates) in the MOJO branch. If a new build is available, it can: * Perform a full backup of the current node installation * Retain previous backup archives * Automatically update the node (Git hard reset + pull) This tool does not aim to replace the standard `git` update method, but is especially useful for sys..."

New page

= 🛠️ Node Backup and Update with check_build =

== 📋 Description ==
The `check_build` command is a DXSpider utility script that checks for new builds (updates) in the MOJO branch. If a new build is available, it can:

* Perform a full backup of the current node installation
* Retain previous backup archives
* Automatically update the node (Git hard reset + pull)

This tool does not aim to replace the standard `git` update method, but is especially useful for sysops who are cautious about updates potentially breaking their nodes. In case of failure, a full backup ensures the service can be restored quickly.

The script can be run manually from the DXSpider shell or scheduled via `crontab`.

== ⚙️ Features ==

* Verifies if a newer build is available on the remote repository.
* If backup is enabled:
** Creates a full backup using `rsync`
** Compresses it as `spider.YYYYMMDD.HHMMSS.tar.gz`
** Retains up to a configurable number of backup files
* Performs a full Git reset and update
* Optionally notifies via Telegram if configured

== ▶️ Usage ==
From the DXSpider shell:<pre>
check_build <Y/N> <num_backups>
</pre>Where:

* `Y` = Enable backup before updating
* `N` = Update without backup
* `num_backups` = Number of backups to retain (default: 10)

== 🕒 Example crontab configuration ==
Run the command Monday to Friday at 04:00 with backup enabled, keeping 7 backups:<pre>
0 4 * * 1,2,3,4,5 run_cmd("check_build Y 7")
</pre>Update the script daily (thanks to G6NHU) with:<pre>
30 0 * * * spawn('cd /spider/local_cmd; wget -qN https://raw.githubusercontent.com/EA3CV/dxspider_info/main/check_build.pl -O /spider/local_cmd/check_build.pl')
32 0 * * * run_cmd('load/cmd')
</pre>

== 💾 Installation ==
Download the script from the official repository:

[https://github.com/EA3CV/dxspider_info/blob/main/check_build.pl View on GitHub - check_build.pl]

Save it as:<pre>
/spider/local_cmd/check_build.pl
</pre>

== 🔄 Restoring a backup ==
If something goes wrong during the update:

1. Locate the latest backup archive in `/home/sysop/spider.backup`

2. Decompress it:<pre>
cd /home/sysop
tar -xzvf spider.backup/spider.YYYYMMDD.HHMMSS.tar.gz
</pre>3. Replace the current `/spider` directory with the extracted backup

4. Restart DXSpider

== ⏪ Alternative: Using undo_newbuild.pl ==
If installed, the `undo_newbuild.pl` script allows you to quickly restore the most recent backup made by `check_build`.

Simply run:<pre>
set/undo_newbuild
</pre>This command will:

* Locate the latest backup archive in `/home/sysop/spider.backup`
* Decompress and restore it
* Restart the node automatically

=== 📥 Download ===
You can download the script from the repository:

[https://github.com/EA3CV/dxspider_info/blob/main/undo_newbuild.pl View on GitHub - undo_newbuild.pl]

Save it as:<pre>
/spider/local_cmd/undo_newbuild.pl
</pre>

== 📦 Dependencies ==
This script requires:

* Git
* rsync

To install `rsync` on Debian-based systems:<pre>
apt install rsync
</pre>

== 📲 Telegram integration (optional) ==
If the `telegram()` function is defined in `Local.pm` and Telegram bot variables (`$id`, `$token`) are set in `DXVars.pm`, the script will send notifications when:

* A backup starts
* A backup completes

For full setup instructions, see: [https://wiki.dxcluster.org/wiki/Sending_messages_to_the_sysop_via_Telegram Sending messages to the sysop via Telegram]

== 🧠 Notes ==

* Only supports the **MOJO branch** of DXSpider.
* Backup directory: `/home/sysop/spider.backup`
* Automatically excludes heavy folders: debug logs, spots, wwv, wcy, etc.
* Recommended for sysops who want to automate update and backup tasks with minimal risk.

== 👨‍💻 Author ==

* Kin EA3CV* — [mailto:ea3cv@cronux.net](mailto:ea3cv@cronux.net)

Node Backup and Update with check build - Revision history

Dxcadmin: /* 📲 Telegram integration (optional) */