Files
iDRAC_fan_controller/lxc/README-LXC.md
Benoit ae017a2833 🚀 Ajout version Proxmox autonome et mise à jour URLs repository
 NOUVELLE VERSION PROXMOX AUTONOME :
- Script d'installation totalement autonome pour Proxmox VE
- Création automatique du container LXC Ubuntu 22.04
- Configuration hardware et IPMI automatisée
- Interface utilisateur avec ASCII art et couleurs
- Compatible avec le pattern community-scripts

🛠️ FONCTIONNALITÉS AVANCÉES :
- Outils d'administration intégrés (idrac-setup, idrac-status, etc.)
- Scripts helpers avec interface colorée
- Healthcheck et monitoring automatiques
- Configuration par défaut optimisée pour Dell
- Gestion des erreurs et diagnostics

📱 INTERFACE UTILISATEUR :
- Menu de configuration avancée
- Rapport d'installation détaillé
- Instructions post-installation contextuelles
- Scripts d'aide intégrés au container

🔗 MISE À JOUR REPOSITORY :
- Toutes les URLs mises à jour avec git.benoitsz.com
- Documentation cohérente sur toutes les versions
- Liens Gitea pour issues et support

📚 DOCUMENTATION COMPLÈTE :
- README-PROXMOX.md avec guide détaillé
- Comparaison des 3 versions (Docker, LXC, Proxmox)
- Instructions d'installation ultra-rapide
- Guide de dépannage spécialisé

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

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-01 11:04:36 +02:00

193 lines
4.2 KiB
Markdown

# Installation LXC pour Proxmox
Ce guide vous explique comment installer le contrôleur de ventilateurs Dell iDRAC dans un container LXC Proxmox.
## Prérequis
### 1. Container LXC Proxmox
- Template Ubuntu 22.04 LTS
- Container **privilégié** (requis pour l'accès IPMI)
- Accès réseau configuré
### 2. Configuration Proxmox
Dans l'interface Proxmox ou en ligne de commande :
```bash
# Rendre le container privilégié
pct set <VMID> -privilege 1
# Activer nesting si nécessaire
pct set <VMID> -features nesting=1
# Configuration des ressources (exemple)
pct set <VMID> -memory 512 -cores 1
```
### 3. Accès IPMI
**Option A - iDRAC local (dans le container sur l'hôte physique) :**
```bash
# Ajouter l'accès au périphérique IPMI dans la configuration LXC
echo "lxc.cgroup2.devices.allow: c 10:* rwm" >> /etc/pve/lxc/<VMID>.conf
echo "lxc.mount.entry: /dev/ipmi0 dev/ipmi0 none bind,optional,create=file" >> /etc/pve/lxc/<VMID>.conf
```
**Option B - iDRAC distant :**
Aucune configuration matérielle supplémentaire requise.
## Installation
### 1. Téléchargement
```bash
# Dans le container LXC
cd /tmp
wget -O - https://git.benoitsz.com/benoit/iDRAC_fan_controller/archive/main.tar.gz | tar -xz
cd Dell_iDRAC_fan_controller-main/lxc
```
### 2. Installation automatique
```bash
chmod +x install-lxc.sh
./install-lxc.sh
```
Le script va :
- Installer ipmitool
- Créer la structure de répertoires
- Copier les fichiers
- Configurer le service systemd
- Créer le fichier de configuration
## Configuration
### 1. Édition de la configuration
```bash
nano /opt/idrac-fan-controller/config/environment
```
### 2. Paramètres principaux
```bash
# Connexion iDRAC
IDRAC_HOST=local # ou IP pour iDRAC distant
IDRAC_USERNAME=root # si iDRAC distant
IDRAC_PASSWORD=calvin # si iDRAC distant
# Seuils de température (°C)
CPU_TEMPERATURE_1=30
CPU_TEMPERATURE_2=40
CPU_TEMPERATURE_3=50
CPU_TEMPERATURE_4=60
# Vitesses correspondantes (%)
FAN_SPEED_1=10
FAN_SPEED_2=30
FAN_SPEED_3=60
FAN_SPEED_4=80
# Seuil de sécurité
CPU_TEMPERATURE_THRESHOLD=70
```
## Utilisation
### Gestion du service
```bash
# Démarrer
systemctl start idrac-fan-controller
# Arrêter
systemctl stop idrac-fan-controller
# Redémarrer
systemctl restart idrac-fan-controller
# Statut
systemctl status idrac-fan-controller
# Activer au démarrage (déjà fait par l'installation)
systemctl enable idrac-fan-controller
```
### Surveillance
```bash
# Logs en temps réel
journalctl -u idrac-fan-controller -f
# Logs récents
journalctl -u idrac-fan-controller -n 50
# Test de santé
/opt/idrac-fan-controller/healthcheck.sh
```
## Dépannage
### Vérification IPMI
```bash
# Test de base
ipmitool fru
# Si erreur "Could not open device"
ls -la /dev/ipmi*
# Doit montrer /dev/ipmi0 ou similaire
# Vérifier les permissions
id
# Doit être root dans le container
```
### Erreurs communes
**"Could not open device at /dev/ipmi0"**
- Vérifier que le container est privilégié
- S'assurer que l'accès IPMI est configuré dans Proxmox
- Redémarrer le container après les changements
**Service qui ne démarre pas**
```bash
# Vérifier la syntaxe du fichier de configuration
systemctl status idrac-fan-controller
# Tester manuellement
cd /opt/idrac-fan-controller
sudo -u root bash Dell_iDRAC_fan_controller.sh
```
## Désinstallation
```bash
cd /tmp/Dell_iDRAC_fan_controller-main/lxc
chmod +x uninstall-lxc.sh
./uninstall-lxc.sh
```
## Comparaison Docker vs LXC
| Aspect | Docker | LXC |
|--------|---------|-----|
| **Installation** | Pull image | Script d'installation |
| **Configuration** | Variables ENV | Fichier de config |
| **Gestion** | docker-compose | systemctl |
| **Logs** | docker logs | journalctl |
| **Ressources** | Container isolé | Container système |
| **Accès hardware** | Device mapping | Accès direct |
| **Maintenance** | Image updates | Package updates |
| **Backup** | Image + volumes | Snapshot LXC |
## Avantages LXC
- **Performance** : Pas d'overhead Docker
- **Intégration** : Gestion native avec Proxmox
- **Accès hardware** : Plus direct et simple
- **Ressources** : Utilisation optimale
- **Logs** : Intégrés avec systemd
- **Maintenance** : Mise à jour avec le système