Files
mc-webui/scripts/watchdog/install.sh
MarekWo 2f82c589c7 feat(watchdog): Hardware USB bus reset for stuck LoRa devices
Implement a smart auto-detection and low-level fcntl ioctl reset mechanism for LoRa USB devices. This 'last resort' recovery is triggered if the meshcore-bridge container fails to recover after 3 restarts within an 8-minute window. Includes updates to the installer, systemd service, and newly added README.

Co-Authored-By: Gemini CLI <noreply@google.com>
2026-02-22 20:15:27 +00:00

159 lines
4.2 KiB
Bash
Executable File

#!/bin/bash
#
# mc-webui Container Watchdog Installer
#
# This script installs the watchdog service that monitors Docker containers
# and automatically restarts unhealthy ones.
#
# Usage: sudo ./install.sh [--uninstall]
#
set -e
# Colors
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
NC='\033[0m'
info() { echo -e "${GREEN}[INFO]${NC} $1"; }
warn() { echo -e "${YELLOW}[WARN]${NC} $1"; }
error() { echo -e "${RED}[ERROR]${NC} $1"; exit 1; }
# Check if running as root
if [ "$EUID" -ne 0 ]; then
error "Please run as root: sudo $0"
fi
# Get the directory where this script is located
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
MCWEBUI_DIR="$(dirname "$(dirname "$SCRIPT_DIR")")"
SERVICE_NAME="mc-webui-watchdog"
SERVICE_FILE="/etc/systemd/system/${SERVICE_NAME}.service"
LOG_FILE="/var/log/mc-webui-watchdog.log"
# Uninstall
if [ "$1" == "--uninstall" ]; then
info "Uninstalling ${SERVICE_NAME}..."
if systemctl is-active --quiet "$SERVICE_NAME"; then
systemctl stop "$SERVICE_NAME"
info "Service stopped"
fi
if systemctl is-enabled --quiet "$SERVICE_NAME" 2>/dev/null; then
systemctl disable "$SERVICE_NAME"
info "Service disabled"
fi
if [ -f "$SERVICE_FILE" ]; then
rm "$SERVICE_FILE"
systemctl daemon-reload
info "Service file removed"
fi
echo -e "${GREEN}Uninstallation complete!${NC}"
echo ""
echo "Note: Log file preserved at: $LOG_FILE"
echo "To remove logs: sudo rm $LOG_FILE"
exit 0
fi
# Install
info "Installing ${SERVICE_NAME}..."
info " mc-webui directory: $MCWEBUI_DIR"
# Check if watchdog.py exists
if [ ! -f "$SCRIPT_DIR/watchdog.py" ]; then
error "watchdog.py not found in $SCRIPT_DIR"
fi
# Check if docker is available
if ! command -v docker &> /dev/null; then
error "Docker is not installed or not in PATH"
fi
# Create log file with proper permissions
if [ ! -f "$LOG_FILE" ]; then
touch "$LOG_FILE"
chmod 644 "$LOG_FILE"
info "Created log file: $LOG_FILE"
fi
# Create service file with correct paths
info "Creating systemd service file..."
cat > "$SERVICE_FILE" << EOF
[Unit]
Description=mc-webui Container Watchdog
Documentation=https://github.com/MarekWo/mc-webui
After=network.target docker.service
Requires=docker.service
[Service]
Type=simple
User=root
Environment=MCWEBUI_DIR=${MCWEBUI_DIR}
Environment=CHECK_INTERVAL=30
Environment=LOG_FILE=${LOG_FILE}
Environment=HTTP_PORT=5051
Environment=AUTO_START=true
Environment=USB_DEVICE_PATH=${USB_DEVICE_PATH}
ExecStart=/usr/bin/python3 -u ${SCRIPT_DIR}/watchdog.py
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
EOF
info "Reloading systemd..."
systemctl daemon-reload
info "Enabling service..."
systemctl enable "$SERVICE_NAME"
info "Starting service..."
systemctl start "$SERVICE_NAME"
# Wait a moment for service to start
sleep 3
# Check if service is running
if systemctl is-active --quiet "$SERVICE_NAME"; then
info "Service is running!"
# Test health endpoint
if command -v curl &> /dev/null; then
HEALTH=$(curl -s http://127.0.0.1:5051/health 2>/dev/null || echo "")
if echo "$HEALTH" | grep -q '"status":"ok"'; then
info "Health check passed!"
else
warn "Health check failed - service may still be starting"
fi
fi
else
error "Service failed to start. Check: journalctl -u $SERVICE_NAME"
fi
echo ""
echo -e "${GREEN}Installation complete!${NC}"
echo ""
echo "The watchdog is now monitoring your containers."
echo ""
echo "Features:"
echo " - Checks container health every 30 seconds"
echo " - Automatically restarts unhealthy containers"
echo " - Saves diagnostic logs before restart"
echo " - Performs hardware USB bus reset if LoRa device is stuck"
echo ""
echo "Useful commands:"
echo " systemctl status $SERVICE_NAME # Check service status"
echo " sudo journalctl -u $SERVICE_NAME -f # View service logs"
echo " tail -f $LOG_FILE # View watchdog logs"
echo " curl http://localhost:5051/status # Check container status"
echo " curl http://localhost:5051/history # View restart history"
echo " sudo $0 --uninstall # Uninstall"
echo ""
echo "Diagnostic files are saved to /tmp/mc-webui-watchdog-*.log"