mirror of
https://github.com/n0mjs710/HBlink4.git
synced 2026-11-08 04:19:26 +00:00
cortandClaude Opus 5
6f6dadd6ac
HBlink4 draws operators who have never run a network server before, and several things in the install path assumed otherwise. Sample configuration split in two. config_sample.json was a feature showcase, and copying it as documented produced a broken server: its example repeater pattern claimed IDs 310000-312999 with a passphrase of its own, so an operator whose repeater fell in that range was rejected with no way to diagnose it (patterns match first-wins and never fall through to "default"). It also shipped an outbound link and an OpenBridge trunk enabled against hosts that do not exist, and bound both address families to one port, which cannot work. It is now a minimal working config needing one edit -- the passphrase. The full reference moves to config_advanced_sample.json with its link examples disabled and the ID overlap called out. Ship IPv4-only. Dual-stack is fully supported and now documented as four concrete layouts, each verified to bind; it is simply not the default, because most repeaters are IPv4 and the same-port bind conflict is not something a new operator should have to learn first. The built-in default when the key is absent stays false, so existing installs are unaffected. "IPv6 is globally disabled" drops from WARNING to INFO -- it is now the recommended setting and should not read as a fault. install_services.sh: refuse paths containing a space, $ or % (systemd mis-parses them in ExecStart=, and a space previously produced a unit that passed verification and then failed at start); escape & in the path substitution; render and verify units in a temp dir so a failed substitution cannot leave a broken unit in /etc/systemd/system. Check the things that otherwise surface only in the journal: complete checkout, Python 3.9+, server and dashboard dependencies, both config files, and agreement between the two halves of the dashboard event link. readme: seven numbered steps with no diversions, adding the prerequisites (python3-venv, which Debian and Ubuntu users hit constantly) and the firewall ports, neither of which were mentioned. Also: the dashboard logged a hardcoded localhost:8080 regardless of the configured port; run_all.sh now fails clearly on missing config instead of a traceback; pyproject's comment claimed systemd should invoke the console scripts, contradicting how the units actually work. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
91 lines
2.8 KiB
Bash
Executable File
91 lines
2.8 KiB
Bash
Executable File
#!/bin/bash
|
|
# Start both HBlink4 server and dashboard
|
|
# Usage: ./run_all.sh
|
|
|
|
set -e
|
|
|
|
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
|
|
cd "$SCRIPT_DIR"
|
|
|
|
# Colors for output
|
|
GREEN='\033[0;32m'
|
|
BLUE='\033[0;34m'
|
|
YELLOW='\033[1;33m'
|
|
NC='\033[0m' # No Color
|
|
|
|
# Check if virtual environment exists
|
|
if [ ! -d "venv" ]; then
|
|
echo -e "${YELLOW}Virtual environment not found. Create it first:${NC}"
|
|
echo -e "${YELLOW} python3 -m venv venv${NC}"
|
|
echo -e "${YELLOW} ./venv/bin/pip install -r requirements.txt -r requirements-dashboard.txt${NC}"
|
|
exit 1
|
|
fi
|
|
|
|
# Neither program starts without its configuration, and the failure is much
|
|
# clearer said here than as a traceback two screens further down.
|
|
if [ ! -f "config/config.json" ]; then
|
|
echo -e "${YELLOW}No config/config.json yet. Create it from the sample:${NC}"
|
|
echo -e "${YELLOW} cp config/config_sample.json config/config.json${NC}"
|
|
echo -e "${YELLOW}Then change 'passphrase' from CHANGE-ME to a password of your choosing.${NC}"
|
|
exit 1
|
|
fi
|
|
|
|
if grep -q '"passphrase": "CHANGE-ME"' config/config.json; then
|
|
echo -e "${YELLOW}config/config.json still has the placeholder passphrase CHANGE-ME.${NC}"
|
|
echo -e "${YELLOW}Repeaters will connect with it as-is, but anyone who has read the${NC}"
|
|
echo -e "${YELLOW}sample config knows it. Set a real one before going live.${NC}"
|
|
echo
|
|
fi
|
|
|
|
if [ ! -f "dashboard/config.json" ]; then
|
|
echo -e "${YELLOW}No dashboard/config.json -- creating it from the sample.${NC}"
|
|
cp dashboard/config_sample.json dashboard/config.json
|
|
fi
|
|
|
|
# Activate virtual environment
|
|
echo -e "${BLUE}Activating virtual environment...${NC}"
|
|
source venv/bin/activate
|
|
|
|
# Check if dashboard requirements are installed
|
|
if ! python3 -c "import fastapi" 2>/dev/null; then
|
|
echo -e "${YELLOW}Dashboard dependencies not found. Installing...${NC}"
|
|
pip install -r requirements-dashboard.txt
|
|
fi
|
|
|
|
# Function to cleanup on exit
|
|
cleanup() {
|
|
echo -e "\n${YELLOW}Stopping services...${NC}"
|
|
kill $(jobs -p) 2>/dev/null || true
|
|
wait 2>/dev/null || true
|
|
echo -e "${GREEN}All services stopped${NC}"
|
|
}
|
|
|
|
trap cleanup EXIT INT TERM
|
|
|
|
echo -e "${GREEN}Starting HBlink4 services...${NC}"
|
|
echo
|
|
|
|
# Start dashboard in background
|
|
echo -e "${BLUE}Starting Dashboard (bind/port from dashboard/config.json)...${NC}"
|
|
python3 run_dashboard.py &
|
|
DASHBOARD_PID=$!
|
|
|
|
# Give dashboard time to start
|
|
sleep 2
|
|
|
|
# Start HBlink4 server
|
|
echo -e "${BLUE}Starting HBlink4 server...${NC}"
|
|
python3 run_hblink.py config/config.json &
|
|
HBLINK_PID=$!
|
|
|
|
echo
|
|
echo -e "${GREEN}Services started:${NC}"
|
|
echo -e " Dashboard: see 'web' section of dashboard/config.json (PID: $DASHBOARD_PID)"
|
|
echo -e " HBlink4: see 'global' bind/port in config/config.json (PID: $HBLINK_PID)"
|
|
echo
|
|
echo -e "${YELLOW}Press CTRL+C to stop all services${NC}"
|
|
echo
|
|
|
|
# Wait for processes
|
|
wait $HBLINK_PID $DASHBOARD_PID
|