freshStartScript/README.md

Fresh Start Installation Script 🚀

A powerful bash script for automating Proxmox installations with monitoring tools and system health checks.

✨ Features

• 📦 Installs essential system packages
• 📊 Sets up Prometheus Node Exporter (v1.8.2)
• 🔍 Configures system health monitoring daemon (hwmon)
• ✅ Performs initial dry-run test of monitoring systems

📋 Prerequisites

• Debian-based system (Proxmox)
• Root/sudo access
• Internet connectivity

🛠️ Installation

Execute these commands as root:

chmod +x freshStart.sh
./freshStart.sh

or if you want to run instantly without downloading (recommended)

curl -s http://10.10.10.63:3000/LotusGuild/freshStartScript/raw/branch/main/freshStart.sh | bash

📦 Components Installed

System Packages

• python3-pip
• smartmontools
• iperf3
• python3-psutil
• python3-requests
• lm-sensors
• neofetch
• rsync

Prometheus Node Exporter

✅ Installed as a systemd service ✅ Runs on default port 9100 ✅ Configured to start on boot

Hardware Monitoring Daemon (hwmon)

✅ Installed as a systemd service and timer ✅ Performs regular system health checks every 15 minutes ✅ Creates tickets for detected issues ✅ NEW: API key configuration via /etc/hwmonDaemon/.env

⚙️ Configuration

hwmonDaemon API Key Setup

The script will prompt you for an API key during installation. You can:

Option 1: Enter during installation

Enter API key (or press Enter to skip): d8f356a06bd5612eca9c5ff948b592a56020cc61937764461458372c9ef30931

Option 2: Configure later Edit the configuration file:

nano /etc/hwmonDaemon/.env

Add your API key:

TICKET_API_KEY=your_actual_api_key_here
TICKET_API_URL=http://10.10.10.45/create_ticket_api.php

The .env file is created with restricted permissions (chmod 600) for security.

🔍 Verification

Verify service status after installation:

systemctl status node_exporter
systemctl status hwmon.timer

Test hwmonDaemon with dry-run:

/usr/bin/env python3 -c "import urllib.request; exec(urllib.request.urlopen('http://10.10.10.63:3000/LotusGuild/hwmonDaemon/raw/branch/main/hwmonDaemon.py').read().decode('utf-8'))" --dry-run

Check if API key is loaded:

cat /etc/hwmonDaemon/.env
journalctl -u hwmon.service | grep "TICKET_API_KEY"

🌐 Network Requirements

Service	Purpose
GitHub	Node Exporter download
10.10.10.63:3000	hwmon daemon files (Gitea)
10.10.10.45	Ticket API access

📁 File Locations

File/Directory	Purpose
/etc/hwmonDaemon/.env	API key configuration
/var/log/hwmonDaemon/	hwmon log files
/etc/systemd/system/hwmon.service	hwmon systemd service
/etc/systemd/system/hwmon.timer	hwmon systemd timer
/usr/local/bin/node_exporter	Node Exporter binary

🔧 Troubleshooting

hwmonDaemon not creating tickets

Check if API key is configured:

cat /etc/hwmonDaemon/.env

Check logs for authentication errors:

journalctl -u hwmon.service -n 50

Update API key after installation

Edit the configuration file:

nano /etc/hwmonDaemon/.env

No service restart needed - changes take effect on next run.