iDRAC_fan_controller/proxmox/README-PROXMOX.md

# Installation Proxmox VE Autonome

Script d'installation **totalement autonome** pour Proxmox VE qui crée automatiquement le container LXC, installe Ubuntu, et configure l'application.

## 🚀 Installation en une commande

```bash
bash -c "$(wget -qLO - https://git.benoitsz.com/benoit/iDRAC_fan_controller/raw/branch/main/proxmox/idrac-fan-controller.sh)"
```

## ✨ Fonctionnalités du script

### Création automatique du container
- **OS**: Ubuntu 22.04 LTS
- **Type**: Container privilégié (requis pour IPMI)
- **Ressources**: 1 CPU, 512MB RAM, 4GB stockage
- **Configuration**: Optimisée pour serveur Dell

### Installation complète
- ✅ ipmitool et dépendances
- ✅ Scripts iDRAC Fan Controller
- ✅ Service systemd configuré
- ✅ Configuration par défaut
- ✅ Outils de gestion inclus

### Interface utilisateur
- 🎨 Interface colorée avec ASCII art
- 📊 Rapport d'installation détaillé
- ⚙️ Options de configuration avancées
- 🔧 Instructions post-installation

## 🛠️ Options d'installation

Le script propose plusieurs modes :

### 1. Installation par défaut
```bash
# Lancement automatique avec paramètres optimaux
bash -c "$(wget -qLO - https://git.benoitsz.com/benoit/iDRAC_fan_controller/raw/branch/main/proxmox/idrac-fan-controller.sh)"
```

### 2. Configuration avancée
- Personnalisation des ressources (CPU, RAM, stockage)
- Choix du container ID
- Configuration réseau personnalisée
- Options de sécurité

### 3. Mode verbose
- Affichage détaillé des étapes
- Logs d'installation complets
- Diagnostic en cas d'erreur

## 📋 Prérequis Proxmox

### Accès hardware (iDRAC local)
Le script configure automatiquement l'accès, mais vous devez ensuite ajouter manuellement :

```bash
# Dans la configuration du container (/etc/pve/lxc/<CTID>.conf)
lxc.cgroup2.devices.allow: c 10:* rwm
lxc.mount.entry: /dev/ipmi0 dev/ipmi0 none bind,optional,create=file
```

### Ou via interface Proxmox
1. Container → Options → Features
2. Activer "Privileged container"
3. Ajouter les périphériques IPMI

## 🎯 Utilisation post-installation

### 1. Connexion au container
```bash
pct enter <CONTAINER_ID>
```

### 2. Configuration rapide
```bash
# Script d'aide intégré
idrac-setup
```

### 3. Édition de la configuration
```bash
nano /opt/idrac-fan-controller/config/environment
```

### 4. Gestion du service
```bash
# Démarrer
systemctl start idrac-fan-controller

# Voir le statut  
systemctl status idrac-fan-controller

# Logs en temps réel
journalctl -u idrac-fan-controller -f
```

## 📊 Configuration par défaut

Le script crée cette configuration optimisée :

```bash
# Connexion iDRAC
IDRAC_HOST=local                    # Accès IPMI direct
IDRAC_USERNAME=root                 # Pour iDRAC distant
IDRAC_PASSWORD=calvin               # Pour iDRAC distant

# Seuils de température progressifs
CPU_TEMPERATURE_1=30                # → FAN_SPEED_1 (10%)
CPU_TEMPERATURE_2=40                # → FAN_SPEED_2 (30%)  
CPU_TEMPERATURE_3=50                # → FAN_SPEED_3 (60%)
CPU_TEMPERATURE_4=60                # → FAN_SPEED_4 (80%)
                                    # > 60°C → 100%

# Sécurité
CPU_TEMPERATURE_THRESHOLD=70        # → Mode Dell par défaut

# Monitoring
CHECK_INTERVAL=60                   # Vérification toutes les 60s
```

## 🔧 Dépannage

### Container ne démarre pas
```bash
# Vérifier la configuration
pct config <CTID>

# Logs de démarrage
pct start <CTID>
journalctl -u pve-container@<CTID> -f
```

### Service iDRAC ne fonctionne pas
```bash
# Dans le container
pct enter <CTID>

# Test IPMI
ipmitool fru
ls -la /dev/ipmi*

# Logs du service
journalctl -u idrac-fan-controller -f
```

### Mise à jour de l'application
```bash
# Le script inclut une fonction de mise à jour
# Relancer le script et choisir "Update"
bash -c "$(wget -qLO - https://git.benoitsz.com/benoit/iDRAC_fan_controller/raw/branch/main/proxmox/idrac-fan-controller.sh)"
```

## 🆚 Comparaison des méthodes

| Méthode | Autonome Proxmox | LXC Manuel | Docker |
|---------|------------------|------------|--------|
| **Complexité** | ⭐ (1 commande) | ⭐⭐⭐ | ⭐⭐ |
| **Configuration** | Auto | Manuel | Semi-auto |
| **Hardware** | Auto-détecté | Manuel | Device mapping |
| **Intégration** | Native Proxmox | Native | Container |
| **Performance** | ⭐⭐⭐ | ⭐⭐⭐ | ⭐⭐ |
| **Maintenance** | ⭐⭐⭐ | ⭐⭐ | ⭐⭐⭐ |

## 🎨 Fonctionnalités avancées

### Auto-détection hardware
- Détection automatique des périphériques IPMI
- Configuration optimisée selon le serveur Dell
- Validation des prérequis

### Monitoring intégré
- Healthcheck automatique
- Logs structurés avec journalctl
- Alertes en cas de problème

### Interface d'administration
```bash
# Scripts utilitaires créés automatiquement
idrac-setup          # Guide de configuration
idrac-status         # État du système  
idrac-logs           # Logs formatés
```

## 📈 Avantages du script autonome

1. **🚀 Déploiement ultra-rapide** - Container opérationnel en < 2 minutes
2. **🔧 Zéro configuration manuelle** - Tout est automatisé
3. **🎯 Optimisé Dell** - Configuration spécifique aux serveurs Dell
4. **🔄 Mise à jour simple** - Un seul script pour tout
5. **📊 Monitoring inclus** - Healthcheck et logs intégrés
6. **🛡️ Sécurisé** - Configuration systemd durcie
7. **📚 Documentation intégrée** - Aide contextuelle incluse

## 🔗 Liens utiles

- **Repository**: https://git.benoitsz.com/benoit/iDRAC_fan_controller
- **Issues**: https://git.benoitsz.com/benoit/iDRAC_fan_controller/issues
- **Community Scripts**: https://github.com/community-scripts/ProxmoxVE
- **Dell iDRAC**: Documentation officielle Dell