Files
meshcore-bot/install-service.sh
agessaman a76c17bb02 Update .gitignore and enhance install-service.sh for virtual environment management
- Added patterns to .gitignore to exclude log files and local configuration files.
- Improved the install-service.sh script to verify the integrity of the virtual environment and ensure pip is available and up to date before installing dependencies.
2026-03-18 18:05:20 -07:00

747 lines
32 KiB
Bash
Executable File
Raw Permalink Blame History

This file contains invisible Unicode characters
This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
#!/bin/bash
# MeshCore Bot Service Installation Script
# This script installs the MeshCore Bot as a system service
# Supports both Linux (systemd) and macOS (launchd)
#
# This script will:
# 1. Create a dedicated system user for the bot (Linux only)
# 2. Copy bot files to installation directory
# 3. Set up proper file permissions
# 4. Install and enable the service (systemd or launchd)
# 5. Create a Python virtual environment with dependencies
#
# Usage:
# ./install-service.sh # Normal installation (non-destructive if already installed)
# ./install-service.sh --upgrade # Upgrade mode (copies new files, updates dependencies)
# ./install-service.sh -u # Short form of --upgrade
#
# Prerequisites:
# - Linux system with systemd OR macOS
# - Python 3.7+ installed
# - sudo access (script will prompt if needed)
# - Run from the meshcore-bot directory
set -e
# Colors for output
RED='\033[0;31m'
GREEN='\033[0;32m'
YELLOW='\033[1;33m'
BLUE='\033[0;34m'
CYAN='\033[0;36m'
NC='\033[0m' # No Color
# Detect operating system
OS="$(uname -s)"
IS_MACOS=false
IS_LINUX=false
if [[ "$OS" == "Darwin" ]]; then
IS_MACOS=true
SERVICE_TYPE="launchd"
elif [[ "$OS" == "Linux" ]]; then
IS_LINUX=true
SERVICE_TYPE="systemd"
else
echo "Error: Unsupported operating system: $OS"
echo "This script supports Linux (systemd) and macOS (launchd)"
exit 1
fi
# Configuration - OS-specific paths
SERVICE_NAME="meshcore-bot"
PLIST_NAME="com.meshcore.bot"
if [[ "$IS_MACOS" == true ]]; then
SERVICE_USER="$(whoami)" # macOS: use current user or _meshcore
SERVICE_GROUP="staff"
INSTALL_DIR="/usr/local/meshcore-bot"
LOG_DIR="/usr/local/var/log/meshcore-bot"
SERVICE_FILE="com.meshcore.bot.plist"
LAUNCHD_DIR="/Library/LaunchDaemons"
else
SERVICE_USER="meshcore"
SERVICE_GROUP="meshcore"
INSTALL_DIR="/opt/meshcore-bot"
LOG_DIR="/var/log/meshcore-bot"
SERVICE_FILE="meshcore-bot.service"
SYSTEMD_DIR="/etc/systemd/system"
fi
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
# Parse command line arguments (before sudo check so help works)
UPGRADE_MODE=false
for arg in "$@"; do
case $arg in
--upgrade|-u)
UPGRADE_MODE=true
;;
--help|-h)
echo "MeshCore Bot Service Installation Script"
echo ""
echo "Usage: $0 [OPTIONS]"
echo ""
echo "Options:"
echo " --upgrade, -u Upgrade mode: update files and dependencies"
echo " --help, -h Show this help message"
echo ""
echo "Examples:"
echo " $0 # Normal installation (non-destructive if already installed)"
echo " $0 --upgrade # Upgrade existing installation"
echo " $0 -u # Short form of --upgrade"
exit 0
;;
*)
echo "Error: Unknown option: $arg" >&2
echo "Use --help for usage information" >&2
exit 1
;;
esac
done
# Function to print section headers
print_section() {
echo ""
echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${BLUE}$1${NC}"
echo -e "${CYAN}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
}
# Function to print info messages
print_info() {
echo -e "${CYAN}${NC} $1"
}
# Function to print success messages
print_success() {
echo -e "${GREEN}${NC} $1"
}
# Function to print warning messages
print_warning() {
echo -e "${YELLOW}${NC} $1"
}
# Function to print error messages
print_error() {
echo -e "${RED}${NC} $1"
}
if [[ "$UPGRADE_MODE" == true ]]; then
print_section "MeshCore Bot Service Upgrader"
print_info "Running in UPGRADE mode - will update files and dependencies"
else
print_section "MeshCore Bot Service Installer"
fi
echo ""
if [[ "$IS_MACOS" == true ]]; then
print_info "Detected macOS - will install as launchd service"
print_info "The bot will start automatically on boot using launchd"
else
print_info "Detected Linux - will install as systemd service"
print_info "The bot will run as a dedicated user and start automatically on boot"
fi
echo ""
# Check if script has execute permissions
if [ ! -x "$0" ]; then
print_warning "Script does not have execute permissions. Attempting to set them..."
chmod +x "$0" 2>/dev/null || {
print_error "Could not set execute permissions. Please run: chmod +x install-service.sh"
exit 1
}
print_success "Execute permissions set"
fi
# Capture original user before sudo (for macOS)
ORIGINAL_USER="${SUDO_USER:-$USER}"
# Check if running as root, if not re-execute with sudo
if [[ $EUID -ne 0 ]]; then
print_warning "This script requires root privileges to install system services"
print_info "Re-executing with sudo..."
echo ""
exec sudo "$0" "$@"
fi
# Verify we're in the right directory
if [ ! -f "meshcore_bot.py" ]; then
print_error "This script must be run from the meshcore-bot directory"
print_error "Expected file not found: meshcore_bot.py"
print_info "Please cd to the meshcore-bot directory and run this script again"
exit 1
fi
# Check for service file
if [ ! -f "$SERVICE_FILE" ]; then
print_error "Service file not found: $SERVICE_FILE"
if [[ "$IS_MACOS" == true ]]; then
print_info "Expected: com.meshcore.bot.plist"
else
print_info "Expected: meshcore-bot.service"
fi
exit 1
fi
# OS-specific service manager checks
if [[ "$IS_MACOS" == true ]]; then
if ! command -v launchctl &> /dev/null; then
print_error "launchctl is not available on this system"
print_error "This script requires macOS with launchd"
exit 1
fi
else
if ! command -v systemctl &> /dev/null; then
print_error "systemd is not available on this system"
print_error "This script requires a Linux system with systemd"
exit 1
fi
fi
# Check if Python 3 is available
if ! command -v python3 &> /dev/null; then
print_error "Python 3 is not installed or not in PATH"
print_error "Please install Python 3.7 or higher before running this script"
exit 1
fi
print_section "Step 1: Setting Up Service User"
if [[ "$IS_MACOS" == true ]]; then
# Use original user if available, otherwise root
if [[ -n "$ORIGINAL_USER" && "$ORIGINAL_USER" != "root" ]]; then
SERVICE_USER="$ORIGINAL_USER"
SERVICE_GROUP="$(id -gn "$ORIGINAL_USER" 2>/dev/null || echo "staff")"
else
SERVICE_USER="root"
SERVICE_GROUP="wheel"
fi
print_info "macOS: Service will run as user '$SERVICE_USER'"
print_info "On macOS, launchd services run as the specified user"
print_success "Using user: $SERVICE_USER"
else
print_info "Creating a dedicated system user '$SERVICE_USER' for security"
print_info "This user will run the bot service with minimal privileges"
# Create service user and group
if ! id "$SERVICE_USER" &>/dev/null; then
useradd --system --no-create-home --shell /bin/false "$SERVICE_USER"
print_success "Created system user: $SERVICE_USER"
else
print_warning "User $SERVICE_USER already exists (skipping creation)"
fi
# Add user to dialout group for serial port access (Linux)
print_info "Configuring serial port access permissions"
if getent group dialout > /dev/null 2>&1; then
if groups "$SERVICE_USER" | grep -q "\bdialout\b"; then
print_warning "User $SERVICE_USER is already in dialout group"
else
usermod -a -G dialout "$SERVICE_USER"
print_success "Added $SERVICE_USER to dialout group for serial port access"
fi
else
print_warning "dialout group not found - serial port access may require manual configuration"
print_info "If using serial connection, you may need to: sudo usermod -a -G dialout $SERVICE_USER"
fi
# Also check for other common serial port groups (tty, uucp, lock)
for group in tty uucp lock; do
if getent group "$group" > /dev/null 2>&1; then
if ! groups "$SERVICE_USER" | grep -q "\b$group\b"; then
usermod -a -G "$group" "$SERVICE_USER" 2>/dev/null && print_info "Added $SERVICE_USER to $group group" || true
fi
fi
done
fi
print_section "Step 2: Creating Installation Directories"
print_info "Creating directory structure for bot installation"
# Create installation directory
if [ -d "$INSTALL_DIR" ]; then
if [[ "$UPGRADE_MODE" == true ]]; then
print_info "Installation directory $INSTALL_DIR already exists"
print_info "Upgrade mode: will update files while preserving configuration"
else
print_warning "Installation directory $INSTALL_DIR already exists"
print_info "Non-destructive mode: will update files without removing existing installation"
print_info "Use --upgrade flag for explicit upgrade mode"
fi
else
mkdir -p "$INSTALL_DIR"
print_success "Created installation directory: $INSTALL_DIR"
fi
# Create log directory
mkdir -p "$LOG_DIR"
print_success "Created log directory: $LOG_DIR"
print_section "Step 3: Copying Bot Files"
if [[ "$UPGRADE_MODE" == true ]]; then
print_info "Upgrading files in $INSTALL_DIR"
print_info "Only newer files will be copied, preserving existing configuration"
else
print_info "Copying bot files to $INSTALL_DIR"
print_info "Existing files will be updated only if source is newer"
fi
# Function to copy files intelligently
copy_files_smart() {
local source_dir="$1"
local dest_dir="$2"
local files_copied=0
local files_skipped=0
local files_updated=0
# Use rsync if available (better for this use case)
if command -v rsync &> /dev/null; then
print_info "Using rsync for efficient file copying"
# Preserve config.ini if it exists
local preserve_config=""
if [ -f "$dest_dir/config.ini" ]; then
preserve_config="--exclude=config.ini"
print_info "Preserving existing config.ini (not overwriting)"
fi
# Note: --update flag preserves files in alternatives/ if destination is newer or same
# This protects user's custom alternative commands while allowing updates to repository files
if [ -d "$dest_dir/modules/commands/alternatives" ]; then
print_info "Preserving existing alternative commands (only updating if source is newer)"
fi
# Preserve install dir's local/ entirely (user custom commands and service plugins)
# Never overwrite or delete anything under $dest_dir/local/
if [ -d "$dest_dir/local" ]; then
print_info "Preserving existing local/ directory (not overwriting)"
fi
# Exclude patterns
rsync -a --update --exclude='.git' \
--exclude='__pycache__' \
--exclude='*.pyc' \
--exclude='*.pyo' \
--exclude='.DS_Store' \
--exclude='venv' \
--exclude='*.db' \
--exclude='*.db-shm' \
--exclude='*.db-wal' \
--exclude='*.log' \
--exclude='backups' \
--exclude='local/' \
$preserve_config \
"$source_dir/" "$dest_dir/" 2>/dev/null || {
print_warning "rsync had some issues, falling back to manual copy"
}
# If install dir has no local/, create minimal structure from source so service has valid layout
if [ ! -d "$dest_dir/local" ]; then
print_info "Creating local/ directory structure (first-time install)"
mkdir -p "$dest_dir/local/commands" "$dest_dir/local/service_plugins"
[ -f "$source_dir/local/README.md" ] && cp "$source_dir/local/README.md" "$dest_dir/local/" || true
[ -f "$source_dir/local/__init__.py" ] && cp "$source_dir/local/__init__.py" "$dest_dir/local/" || true
[ -f "$source_dir/local/commands/.gitkeep" ] && cp "$source_dir/local/commands/.gitkeep" "$dest_dir/local/commands/" || true
[ -f "$source_dir/local/service_plugins/.gitkeep" ] && cp "$source_dir/local/service_plugins/.gitkeep" "$dest_dir/local/service_plugins/" || true
fi
print_success "Files synchronized using rsync"
return 0
fi
# Fallback: manual copy with find
print_info "Using manual file copy (consider installing rsync for better performance)"
# Preserve alternatives directory if it exists
if [ -d "$dest_dir/modules/commands/alternatives" ]; then
print_info "Preserving existing alternative commands (not overwriting)"
fi
# Preserve install dir's local/ entirely - never overwrite when it exists
if [ -d "$dest_dir/local" ]; then
print_info "Preserving existing local/ directory (not overwriting)"
fi
# Copy files, preserving config.ini if it exists
while IFS= read -r file; do
local rel_path="${file#$source_dir/}"
local dest_file="$dest_dir/$rel_path"
local dest_dir_path="$(dirname "$dest_file")"
# Skip excluded patterns
[[ "$rel_path" == *".git"* ]] && continue
[[ "$rel_path" == *"__pycache__"* ]] && continue
[[ "$rel_path" == *".pyc" ]] && continue
[[ "$rel_path" == *".pyo" ]] && continue
[[ "$rel_path" == *".DS_Store"* ]] && continue
[[ "$rel_path" == *"/venv/"* ]] && continue
[[ "$rel_path" == *".db" ]] && continue
[[ "$rel_path" == *".db-shm" ]] && continue
[[ "$rel_path" == *".db-wal" ]] && continue
[[ "$rel_path" == *".log" ]] && continue
[[ "$rel_path" == *"/backups/"* ]] && continue
# Preserve install dir's local/ entirely - skip all files under local/ when dest has local/
if [[ "$rel_path" == "local/"* ]] && [ -d "$dest_dir/local" ]; then
files_skipped=$((files_skipped + 1))
continue
fi
# Preserve alternatives directory - only update if source file is newer
if [[ "$rel_path" == "modules/commands/alternatives/"* ]] && [ -d "$dest_dir/modules/commands/alternatives" ]; then
if [ -f "$dest_file" ]; then
# File exists in destination - only update if source is newer
if [ "$file" -nt "$dest_file" ]; then
# Source is newer, will update below
:
else
# Destination is same or newer - preserve user's version
files_skipped=$((files_skipped + 1))
continue
fi
fi
# File doesn't exist in destination, or source is newer - will copy below
fi
# Create destination directory if needed
mkdir -p "$dest_dir_path"
# Special handling for config.ini - preserve existing if it exists
if [[ "$rel_path" == "config.ini" ]] && [ -f "$dest_file" ]; then
files_skipped=$((files_skipped + 1))
continue
fi
# Copy if destination doesn't exist or source is newer
if [ ! -f "$dest_file" ] || [ "$file" -nt "$dest_file" ]; then
if cp "$file" "$dest_file" 2>/dev/null; then
if [ -f "$dest_file" ]; then
files_updated=$((files_updated + 1))
else
files_copied=$((files_copied + 1))
fi
else
print_warning "Could not copy $rel_path"
fi
else
files_skipped=$((files_skipped + 1))
fi
done < <(find "$source_dir" -type f 2>/dev/null)
print_success "File sync complete: $files_updated updated, $files_copied new, $files_skipped unchanged"
}
# Copy files using smart copy function
copy_files_smart "$SCRIPT_DIR" "$INSTALL_DIR" || {
print_error "Failed to copy files. Check permissions and disk space"
exit 1
}
# Write .version_info at install dir so web viewer and packet_capture show version after install
if command -v git &>/dev/null && [ -d "$SCRIPT_DIR/.git" ]; then
GIT_HASH="$(git -C "$SCRIPT_DIR" rev-parse --short HEAD 2>/dev/null || echo "unknown")"
if VERSION="$(git -C "$SCRIPT_DIR" describe --exact-match HEAD 2>/dev/null)"; then
INSTALLER_VER="$VERSION"
else
INSTALLER_VER="dev-${GIT_HASH}"
fi
printf '%s\n' "{\"installer_version\": \"${INSTALLER_VER}\", \"git_hash\": \"${GIT_HASH}\"}" > "$INSTALL_DIR/.version_info"
print_success "Wrote version info (${INSTALLER_VER}) to $INSTALL_DIR/.version_info"
fi
# If no config.ini in install dir, create it from config.ini.example
if [ ! -f "$INSTALL_DIR/config.ini" ]; then
if [ -f "$INSTALL_DIR/config.ini.example" ]; then
cp "$INSTALL_DIR/config.ini.example" "$INSTALL_DIR/config.ini"
print_success "Created $INSTALL_DIR/config.ini from config.ini.example (no config was present)"
elif [ -f "$SCRIPT_DIR/config.ini.example" ]; then
cp "$SCRIPT_DIR/config.ini.example" "$INSTALL_DIR/config.ini"
print_success "Created $INSTALL_DIR/config.ini from config.ini.example (no config was present)"
else
print_warning "config.ini.example not found. Create $INSTALL_DIR/config.ini manually before starting the bot."
fi
fi
# Create venv and install dependencies before chown so the service user ends up
# owning a complete, working venv (avoids partial root-owned venv and import errors).
print_section "Step 4: Setting Up Python Virtual Environment"
if [ -d "$INSTALL_DIR/venv" ]; then
print_info "Virtual environment already exists at $INSTALL_DIR/venv"
print_info "Preserving existing virtual environment"
if [[ "$UPGRADE_MODE" == true ]]; then
print_info "Upgrade mode: will update dependencies"
else
print_info "Will update dependencies if requirements.txt changed"
fi
else
print_info "Creating an isolated Python environment for the bot"
print_info "This ensures dependencies don't conflict with system Python packages"
python3 -m venv "$INSTALL_DIR/venv"
print_success "Created virtual environment at $INSTALL_DIR/venv"
fi
# Verify virtual environment looks healthy
VENV_PYTHON="$INSTALL_DIR/venv/bin/python"
if [ ! -x "$VENV_PYTHON" ]; then
print_error "Python virtual environment at $INSTALL_DIR/venv appears to be incomplete or corrupted"
print_error "Expected Python executable not found at: $VENV_PYTHON"
print_info "Try removing $INSTALL_DIR/venv and re-running this installer to recreate it:"
echo " sudo rm -rf $INSTALL_DIR/venv"
echo " sudo ./install-service.sh"
exit 1
fi
# Ensure pip is available and up to date inside the venv
print_info "Ensuring pip is available and up to date in the virtual environment"
$VENV_PYTHON -m ensurepip --upgrade >/dev/null 2>&1 || true
$VENV_PYTHON -m pip install --quiet --upgrade pip >/dev/null 2>&1 || true
# Install dependencies in venv using python -m pip (more portable than calling pip directly)
print_info "Installing Python dependencies from requirements.txt"
print_info "This may take a few minutes depending on your internet connection..."
if [ ! -f "$INSTALL_DIR/requirements.txt" ]; then
print_error "requirements.txt not found in installation directory"
exit 1
fi
$VENV_PYTHON -m pip install --quiet -r "$INSTALL_DIR/requirements.txt" || {
print_error "Failed to install Python dependencies"
print_info "You may need to check your internet connection or Python version"
exit 1
}
print_success "Installed all Python dependencies"
print_section "Step 5: Setting File Permissions"
print_info "Configuring file ownership and permissions for security"
print_info "The service user will own all files, with appropriate read/write permissions"
# Set ownership
chown -R "$SERVICE_USER:$SERVICE_GROUP" "$INSTALL_DIR"
chown -R "$SERVICE_USER:$SERVICE_GROUP" "$LOG_DIR"
print_success "Set ownership to $SERVICE_USER:$SERVICE_GROUP"
# Set permissions
chmod 755 "$INSTALL_DIR"
find "$INSTALL_DIR" -type f -name "*.py" -exec chmod 644 {} \; 2>/dev/null || true
find "$INSTALL_DIR" -type f -name "*.ini" -exec chmod 644 {} \; 2>/dev/null || true
find "$INSTALL_DIR" -type f -name "*.txt" -exec chmod 644 {} \; 2>/dev/null || true
find "$INSTALL_DIR" -type f -name "*.json" -exec chmod 644 {} \; 2>/dev/null || true
find "$INSTALL_DIR" -type d -exec chmod 755 {} \; 2>/dev/null || true
# Make main script executable
chmod 755 "$INSTALL_DIR/meshcore_bot.py"
print_success "Configured file permissions"
print_section "Step 6: Installing Service"
if [[ "$IS_MACOS" == true ]]; then
print_info "Installing launchd plist file to enable automatic startup"
print_info "The service will be configured to start on boot and restart on failure"
# Create LaunchDaemons directory if it doesn't exist
mkdir -p "$LAUNCHD_DIR"
# Update plist with actual installation paths and copy to LaunchDaemons
if [ -f "$LAUNCHD_DIR/$SERVICE_FILE" ] && [[ "$UPGRADE_MODE" != true ]]; then
print_info "Plist file already exists at $LAUNCHD_DIR/$SERVICE_FILE"
print_info "Skipping update (use --upgrade to update service configuration)"
else
print_info "Updating plist file with installation paths"
# Use a more portable approach for path substitution
if command -v python3 &> /dev/null; then
python3 -c "
import sys
import re
with open('$SERVICE_FILE', 'r') as f:
content = f.read()
content = content.replace('/usr/local/meshcore-bot', '$INSTALL_DIR')
content = content.replace('/usr/local/var/log/meshcore-bot', '$LOG_DIR')
with open('$LAUNCHD_DIR/$SERVICE_FILE', 'w') as f:
f.write(content)
"
else
# Fallback to sed (works on both macOS and Linux)
sed "s|/usr/local/meshcore-bot|$INSTALL_DIR|g; s|/usr/local/var/log/meshcore-bot|$LOG_DIR|g" "$SERVICE_FILE" > "$LAUNCHD_DIR/$SERVICE_FILE"
fi
print_success "Copied and configured plist file to $LAUNCHD_DIR/"
fi
# Set ownership
chown root:wheel "$LAUNCHD_DIR/$SERVICE_FILE"
chmod 644 "$LAUNCHD_DIR/$SERVICE_FILE"
print_success "Set plist permissions"
print_section "Step 7: Loading Service"
# Check if service is already loaded
if launchctl list "$PLIST_NAME" &>/dev/null; then
if [[ "$UPGRADE_MODE" == true ]]; then
print_info "Service already loaded - reloading in upgrade mode"
launchctl unload "$LAUNCHD_DIR/$SERVICE_FILE" 2>/dev/null || true
launchctl load "$LAUNCHD_DIR/$SERVICE_FILE" 2>/dev/null || {
print_error "Failed to reload service. Check plist syntax and permissions."
exit 1
}
print_success "Service '$PLIST_NAME' reloaded in launchd"
else
print_info "Service '$PLIST_NAME' is already loaded"
print_info "Skipping reload (use --upgrade to reload service configuration)"
fi
else
print_info "Loading service into launchd"
launchctl load "$LAUNCHD_DIR/$SERVICE_FILE" 2>/dev/null || {
print_error "Failed to load service. Check plist syntax and permissions."
exit 1
}
print_success "Service '$PLIST_NAME' loaded into launchd"
fi
print_info "Note: The service is loaded but not started yet. You'll start it after configuration."
else
# Check if service file already exists
if [ -f "$SYSTEMD_DIR/$SERVICE_NAME.service" ]; then
if [[ "$UPGRADE_MODE" == true ]]; then
print_info "Service file already exists - updating in upgrade mode"
cp "$SERVICE_FILE" "$SYSTEMD_DIR/"
print_success "Updated service file in $SYSTEMD_DIR/"
systemctl daemon-reload
print_success "Systemd configuration reloaded"
else
print_info "Service file already exists at $SYSTEMD_DIR/$SERVICE_NAME.service"
print_info "Skipping update (use --upgrade to update service configuration)"
fi
else
print_info "Installing systemd service file to enable automatic startup"
print_info "The service will be configured to start on boot and restart on failure"
cp "$SERVICE_FILE" "$SYSTEMD_DIR/"
print_success "Copied service file to $SYSTEMD_DIR/"
systemctl daemon-reload
print_success "Systemd configuration reloaded"
fi
print_section "Step 7: Enabling Service"
# Check if service is already enabled
if systemctl is-enabled "$SERVICE_NAME" &>/dev/null; then
print_info "Service '$SERVICE_NAME' is already enabled for automatic startup"
else
print_info "Enabling service to start automatically on system boot"
systemctl enable "$SERVICE_NAME" >/dev/null 2>&1
print_success "Service '$SERVICE_NAME' enabled for automatic startup"
fi
print_info "Note: The service is enabled but not started yet. You'll start it after configuration."
fi
if [[ "$UPGRADE_MODE" == true ]]; then
print_section "Upgrade Complete!"
echo ""
print_success "MeshCore Bot has been successfully upgraded!"
else
print_section "Installation Complete!"
echo ""
print_success "MeshCore Bot has been successfully installed as a system service!"
fi
echo ""
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${BLUE}📋 Next Steps${NC}"
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo ""
echo -e "${CYAN}1. Configure the bot:${NC}"
echo -e " ${YELLOW}sudo nano $INSTALL_DIR/config.ini${NC}"
echo " Edit the configuration file with your bot settings, API keys, and device information"
echo ""
if [[ "$IS_MACOS" == true ]]; then
echo -e "${CYAN}2. Start the service:${NC}"
echo -e " ${YELLOW}sudo launchctl load -w $LAUNCHD_DIR/$SERVICE_FILE${NC}"
echo -e " Or: ${YELLOW}sudo launchctl start $PLIST_NAME${NC}"
echo ""
echo -e "${CYAN}3. Verify it's running:${NC}"
echo -e " ${YELLOW}sudo launchctl list | grep $PLIST_NAME${NC}"
echo -e " Or check logs: ${YELLOW}tail -f $LOG_DIR/meshcore-bot.log${NC}"
echo ""
echo -e "${CYAN}4. View live logs (optional):${NC}"
echo -e " ${YELLOW}tail -f $LOG_DIR/meshcore-bot.log${NC}"
echo " Press Ctrl+C to exit log view"
else
echo -e "${CYAN}2. Start the service:${NC}"
echo -e " ${YELLOW}sudo systemctl start $SERVICE_NAME${NC}"
echo ""
echo -e "${CYAN}3. Verify it's running:${NC}"
echo -e " ${YELLOW}sudo systemctl status $SERVICE_NAME${NC}"
echo " You should see 'active (running)' in green"
echo ""
echo -e "${CYAN}4. View live logs (optional):${NC}"
echo -e " ${YELLOW}sudo journalctl -u $SERVICE_NAME -f${NC}"
echo " Press Ctrl+C to exit log view"
fi
echo ""
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${BLUE}🔧 Service Management Commands${NC}"
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo ""
if [[ "$IS_MACOS" == true ]]; then
echo -e " ${CYAN}Start service:${NC} ${YELLOW}sudo launchctl start $PLIST_NAME${NC}"
echo -e " ${CYAN}Stop service:${NC} ${YELLOW}sudo launchctl stop $PLIST_NAME${NC}"
echo -e " ${CYAN}Restart service:${NC} ${YELLOW}sudo launchctl stop $PLIST_NAME && sudo launchctl start $PLIST_NAME${NC}"
echo -e " ${CYAN}Check status:${NC} ${YELLOW}sudo launchctl list | grep $PLIST_NAME${NC}"
echo -e " ${CYAN}View logs:${NC} ${YELLOW}tail -f $LOG_DIR/meshcore-bot.log${NC}"
echo -e " ${CYAN}View error logs:${NC} ${YELLOW}tail -f $LOG_DIR/meshcore-bot.error.log${NC}"
echo -e " ${CYAN}Unload service:${NC} ${YELLOW}sudo launchctl unload $LAUNCHD_DIR/$SERVICE_FILE${NC}"
echo -e " ${CYAN}Load service:${NC} ${YELLOW}sudo launchctl load $LAUNCHD_DIR/$SERVICE_FILE${NC}"
else
echo -e " ${CYAN}Start service:${NC} ${YELLOW}sudo systemctl start $SERVICE_NAME${NC}"
echo -e " ${CYAN}Stop service:${NC} ${YELLOW}sudo systemctl stop $SERVICE_NAME${NC}"
echo -e " ${CYAN}Restart service:${NC} ${YELLOW}sudo systemctl restart $SERVICE_NAME${NC}"
echo -e " ${CYAN}Check status:${NC} ${YELLOW}sudo systemctl status $SERVICE_NAME${NC}"
echo -e " ${CYAN}View logs:${NC} ${YELLOW}sudo journalctl -u $SERVICE_NAME -f${NC}"
echo -e " ${CYAN}View recent logs:${NC} ${YELLOW}sudo journalctl -u $SERVICE_NAME -n 100${NC}"
echo -e " ${CYAN}Disable auto-start:${NC} ${YELLOW}sudo systemctl disable $SERVICE_NAME${NC}"
echo -e " ${CYAN}Enable auto-start:${NC} ${YELLOW}sudo systemctl enable $SERVICE_NAME${NC}"
fi
echo ""
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${BLUE}📁 Important File Locations${NC}"
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo ""
echo -e " ${CYAN}Configuration file:${NC} ${YELLOW}$INSTALL_DIR/config.ini${NC}"
echo -e " ${CYAN}Log directory:${NC} ${YELLOW}$LOG_DIR${NC}"
echo -e " ${CYAN}Installation directory:${NC} ${YELLOW}$INSTALL_DIR${NC}"
if [[ "$IS_MACOS" == true ]]; then
echo -e " ${CYAN}Service plist:${NC} ${YELLOW}$LAUNCHD_DIR/$SERVICE_FILE${NC}"
else
echo -e " ${CYAN}Service file:${NC} ${YELLOW}$SYSTEMD_DIR/$SERVICE_NAME.service${NC}"
fi
echo ""
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo -e "${BLUE} Additional Information${NC}"
echo -e "${BLUE}━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━${NC}"
echo ""
print_info "The service is configured to:"
echo " • Start automatically on system boot"
if [[ "$IS_MACOS" == true ]]; then
echo " • Restart automatically if it crashes (with 10 second throttle)"
echo " • Run as user '$SERVICE_USER'"
echo " • Log to: $LOG_DIR/meshcore-bot.log"
echo ""
print_info "After editing config.ini, restart the service for changes to take effect:"
echo -e " ${YELLOW}sudo launchctl stop $PLIST_NAME && sudo launchctl start $PLIST_NAME${NC}"
else
echo " • Restart automatically if it crashes (with 10 second delay)"
echo " • Run as user '$SERVICE_USER' for security"
echo " • Log to systemd journal (view with journalctl)"
echo ""
print_info "Serial port access:"
echo " • User '$SERVICE_USER' has been added to dialout group for serial port access"
echo " • If using serial connection, ensure the service is restarted after installation"
echo " • Group membership changes take effect after service restart"
echo ""
print_info "After editing config.ini, restart the service for changes to take effect:"
echo -e " ${YELLOW}sudo systemctl restart $SERVICE_NAME${NC}"
fi
echo ""
if [[ "$UPGRADE_MODE" == true ]]; then
print_success "Upgrade complete! The bot files have been updated."
print_info "You may want to restart the service to apply changes:"
if [[ "$IS_MACOS" == true ]]; then
echo -e " ${YELLOW}sudo launchctl stop $PLIST_NAME && sudo launchctl start $PLIST_NAME${NC}"
else
echo -e " ${YELLOW}sudo systemctl restart $SERVICE_NAME${NC}"
fi
else
print_success "Installation complete! The bot is ready to configure and start."
fi
echo ""