# Documentație Proxmox Infrastructure - ROMFASTSQL

## 📚 Structură Documentație

### 🏢 Infrastructură Generală

#### **proxmox-ssh-guide.md** - Ghid Complet Proxmox Cluster
**Când să folosești:** Pentru orice operațiuni legate de infrastructura Proxmox

**Conține:**
- Cluster Proxmox (3 noduri: pve1, pvemini, pveelite)
- Configurare SSH și acces noduri
- **Lista completă LXC containers cu IP-uri**
- **Lista completă Virtual Machines**
- Comenzi Proxmox generale (`pct`, `qm`, `pvesm`)
- Storage configuration (local-zfs, backup, backup-nfs)
- Backup jobs și politici retention
- **Hartă completă IP-uri** toate serviciile
- Troubleshooting Proxmox

---

### 📦 LXC Containers

#### **oracle-database-lxc108.md** - Oracle Database XE 21c
**LXC:** 108 (central-oracle) - IP: 10.0.20.121
**Host Proxmox:** pvemini (10.0.20.201)

**Când să folosești:** Pentru orice operațiuni legate de Oracle Database

**Conține:**
- Detalii container LXC 108 (Oracle XE 21c în Docker)
- **PDB-uri (roa, roa2) - toate detaliile**
- **Useri și parole Oracle** pentru fiecare PDB
- **Connection strings** (SQL*Plus, JDBC, TNS)
- Export/Import Data Pump (expdp, impdp)
- Comenzi SQL pentru verificări (tablespace, obiecte, useri)
- Troubleshooting Oracle specific
- Diferențe Oracle 10g vs 21c (istoric migrare)

---

### 💻 Virtual Machines

#### **vm201-windows11.md** - VM 201 (roacentral)
**VM:** 201 (roacentral) - Windows 11
**Host Proxmox:** pvemini (10.0.20.201)

**Când să folosești:** Pentru informații generale despre VM 201

**Conține:**
- Configurație hardware VM
- Rol și utilizare (client aplicații Windows, SQL*Plus, reverse proxy IIS)
- Servicii instalate
- Configurare rețea
- Backup și recovery

#### **vm201-certificat-letsencrypt-iis.md** - Certificat SSL IIS
**VM:** 201 (roacentral)

**Când să folosești:** Pentru configurare și reînnoire certificate Let's Encrypt pe IIS

**Conține:**
- Instalare Win-ACME pentru certificate Let's Encrypt
- Configurare IIS cu SNI (Server Name Indication)
- Binding-uri pentru multiple domenii
- Reînnoire automată certificate
- Troubleshooting SSL/TLS
- Scripturi PowerShell pentru configurare automată

#### **vm201-troubleshooting-backup-nfs.md** - Incident VM 201
**VM:** 201 (roacentral)
**Data:** 2025-10-08

**Când să folosești:** Pentru referință troubleshooting probleme similare

**Conține:**
- Incident VM locked și backup NFS blocat
- Diagnostic și rezolvare pas cu pas
- Comenzi HA management (ha-manager)
- Force reboot și recovery
- Lecții învățate și preventie
- Comenzi utile pentru diagnostic viitor

---

### 🌐 Cluster-Wide Resources

#### **cluster-ha-monitor.sh** - Monitorizare High Availability
**Scope:** Întreg cluster Proxmox (toate nodurile)
**Locație:** `/opt/scripts/cluster-ha-monitor.sh` pe noduri

**Când să folosești:** Pentru monitorizare automată HA cluster

**Conține:**
- Script bash monitorizare HA services
- Verificare quorum cluster
- Verificare noduri online
- Notificări prin PVE::Notify (email)
- Template-uri Handlebars pentru emailuri
- Logging automat
- Cron setup pentru rulare automată

**Instalare:**
```bash
scp proxmox/cluster-ha-monitor.sh root@10.0.20.201:/opt/scripts/
ssh root@10.0.20.201 "chmod +x /opt/scripts/cluster-ha-monitor.sh"
ssh root@10.0.20.201 "/opt/scripts/cluster-ha-monitor.sh --create-templates"
```

**Rulare:**
```bash
# Verificare normală (silent, trimite notificare)
/opt/scripts/cluster-ha-monitor.sh

# Verificare verbose (afișare pe console)
/opt/scripts/cluster-ha-monitor.sh -v
```

#### **ups/** - Sistem UPS pentru Cluster
**Scope:** Întreg cluster Proxmox (toate nodurile)
**Hardware:** INNO TECH USB UPS conectat la pvemini

**Când să folosești:** Pentru configurare, monitorizare și mentenanță UPS

**Conține:**
- `ups/README.md` - Ghid complet UPS
- `ups/docs/` - Documentație detaliată
  - `INSTALARE-NUT.md` - Instalare NUT server pe Proxmox
  - `INSTALARE-WINNUT.md` - Instalare client WinNUT pe Windows
  - `UPS-SHUTDOWN-README.md` - Sistem shutdown orchestrat automat
  - `UPS-MONTHLY-TEST.md` - Test lunar automat baterie
  - `UPS-BATTERY-REPLACEMENT.md` - Procedură înlocuire baterie
- `ups/scripts/` - Scripturi automate
  - `ups-shutdown-cluster.sh` - Shutdown orchestrat cluster
  - `ups-shutdown-test.sh` - Test dry-run shutdown
  - `ups-monthly-test.sh` - Test lunar baterie automat
  - `ups-maintenance-shutdown.sh` - Shutdown pentru mentenanță
- `ups/config/` - Fișiere configurare NUT

**Quick Start:**
```bash
# Status UPS
ssh root@10.0.20.201 "upsc nutdev1"

# Test dry-run shutdown
ssh root@10.0.20.201 "/usr/local/bin/ups-shutdown-test.sh"

# Vezi ultimul test lunar baterie
ssh root@10.0.20.201 "tail -50 /var/log/ups-monthly-test.log"
```

---

### 📂 Archived / Decommissioned

#### **archived-vm107-monitor.sh** - VM 107 Monitor (DECOMMISSIONED)
**VM:** 107 (Oracle 10g Windows 7) - **NU MAI EXISTĂ**

**Status:** Script arhivat pentru referință istorică

**Notă:** VM 107 a fost decommissioned și înlocuit cu LXC 108 (Oracle XE 21c).
Vezi `oracle-database-lxc108.md` pentru sistemul actual.

---

## 🚀 Quick Start

### Acces în Proxmox
```bash
ssh root@10.0.20.201
```

### Acces în LXC 108 (Oracle)
```bash
ssh root@10.0.20.201
pct enter 108
```

### Restart Oracle Database
```bash
# Rapid (recomandat)
ssh root@10.0.20.201 "pct exec 108 -- docker restart oracle-xe"

# Restart complet LXC
ssh root@10.0.20.201 "pct restart 108"
```

### Conexiune Oracle
```bash
# SQL*Plus la PDB roa
sqlplus sys/romfastsoft@10.0.20.121:1521/roa as sysdba

# JDBC connection string
jdbc:oracle:thin:@10.0.20.121:1521/roa
```

---

## 📋 Hartă Rapidă Resurse

### Noduri Proxmox
| Nod | IP | Web GUI |
|-----|--------|---------|
| pve1 | 10.0.20.200 | https://10.0.20.200:8006 |
| **pvemini** | 10.0.20.201 | https://10.0.20.201:8006 |
| pveelite | 10.0.20.202 | https://10.0.20.202:8006 |

### LXC Containers (Servicii Active)
| VMID | Nume | IP | Serviciu | Documentație |
|------|------|-----|----------|--------------|
| 100 | portainer | 10.0.20.170 | Docker Management | proxmox-ssh-guide.md |
| 103 | dokploy | 10.0.20.167 | Deployment Platform | proxmox-ssh-guide.md |
| 104 | flowise | 10.0.20.161 | Flowise AI + Ollama | proxmox-ssh-guide.md |
| 106 | gitea | 10.0.20.165 | Git Server | proxmox-ssh-guide.md |
| **108** | **central-oracle** | **10.0.20.121** | **Oracle XE 21c** | **oracle-database-lxc108.md** |

### Virtual Machines
| VMID | Nume | OS | IP/Rol | Documentație |
|------|------|-----|--------|--------------|
| **201** | **roacentral** | **Windows 11** | **Client aplicații** | **vm201-windows11.md** |
| 300 | Win11-Template | Windows 11 | Template clonare | proxmox-ssh-guide.md |

---

## 🔗 Link-uri Utile

### Proxmox Cluster
- **pve1:** https://10.0.20.200:8006
- **pvemini:** https://10.0.20.201:8006
- **pveelite:** https://10.0.20.202:8006

### Oracle Database (LXC 108)
- Oracle Listener: `10.0.20.121:1521`
- Oracle EM Express: http://10.0.20.121:5500/em
- Portainer: http://10.0.20.121:9443

### Alte Servicii
- Portainer Principal: http://10.0.20.170:9443
- Gitea: http://10.0.20.165:3000
- Dokploy: http://10.0.20.167:3000
- Flowise AI: http://10.0.20.161:3000

---

## 📖 Navigare Rapidă - Am nevoie să...

### Infrastructură Proxmox
- **Văd toate VM-urile și LXC-urile** → `proxmox-ssh-guide.md`
- **Configurez SSH pe Proxmox** → `proxmox-ssh-guide.md` → "Configurare Inițială SSH"
- **Văd toate IP-urile** → `proxmox-ssh-guide.md` → "Hartă Rapidă IP-uri"
- **Creez backup VM/LXC** → `proxmox-ssh-guide.md` → "Gestiune Backup-uri"

### Oracle Database (LXC 108)
- **Restart Oracle Database** → `proxmox-ssh-guide.md` → "LXC 108 - Acces Rapid"
- **Conectez la Oracle Database** → `oracle-database-lxc108.md` → "Conexiuni Oracle"
- **Export/Import DMP Oracle** → `oracle-database-lxc108.md` → "Export și Import Data Pump"
- **Verific PDB-uri Oracle** → `oracle-database-lxc108.md` → "Verificări și Comenzi SQL"

### VM 201 (Windows 11)
- **Informații generale VM 201** → `vm201-windows11.md`
- **Configurez certificate SSL IIS** → `vm201-certificat-letsencrypt-iis.md`
- **Reînnoiesc certificate Let's Encrypt** → `vm201-certificat-letsencrypt-iis.md` → "Reînnoire"
- **Rezolv probleme VM locked** → `vm201-troubleshooting-backup-nfs.md` → "VM 201 Locked"
- **Rezolv probleme backup NFS** → `vm201-troubleshooting-backup-nfs.md` → "Storage backup-nfs"

### Cluster-Wide Resources
- **Monitorizez HA cluster** → `cluster-ha-monitor.sh` (script)
- **Configurez sistem UPS** → `ups/README.md`
- **Test shutdown cluster UPS** → `ups/docs/UPS-SHUTDOWN-README.md`
- **Test lunar baterie UPS** → `ups/docs/UPS-MONTHLY-TEST.md`
- **Înlocuiesc baterie UPS** → `ups/docs/UPS-BATTERY-REPLACEMENT.md`

---

## 📁 Structură Completă Directoare

```
proxmox/
├── README.md                                    # Acest fișier (index)
├── proxmox-ssh-guide.md                         # Ghid general Proxmox
│
├── oracle-database-lxc108.md                    # LXC 108 - Oracle XE 21c
│
├── vm201-windows11.md                           # VM 201 - Info generală
├── vm201-certificat-letsencrypt-iis.md          # VM 201 - SSL certificates
├── vm201-troubleshooting-backup-nfs.md          # VM 201 - Incident 2025-10-08
│
├── cluster-ha-monitor.sh                        # Script monitorizare HA cluster
│
├── ups/                                         # Sistem UPS cluster
│   ├── README.md                                # Ghid complet UPS
│   ├── docs/                                    # Documentație detaliată
│   │   ├── INSTALARE-NUT.md
│   │   ├── INSTALARE-WINNUT.md
│   │   ├── UPS-SHUTDOWN-README.md
│   │   ├── UPS-MONTHLY-TEST.md
│   │   └── UPS-BATTERY-REPLACEMENT.md
│   ├── scripts/                                 # Scripturi automate UPS
│   │   ├── ups-shutdown-cluster.sh
│   │   ├── ups-shutdown-test.sh
│   │   ├── ups-monthly-test.sh
│   │   └── ups-maintenance-shutdown.sh
│   └── config/                                  # Configurare NUT
│       ├── ups.conf
│       ├── upsd.conf
│       ├── upsd.users
│       ├── upsmon.conf
│       └── upssched.conf
│
├── scripts/                                     # Scripturi utilitare
│   ├── configure-iis-sni.ps1                    # Configurare SNI IIS (VM 201)
│   └── verify-letsencrypt.ps1                   # Verificare certificate (VM 201)
│
└── archived-vm107-monitor.sh                    # DECOMMISSIONED - VM 107
```

---

## 🎯 Flux de Lucru Recomandat

### Pentru o problemă nouă Oracle
1. **Citește:** `oracle-database-lxc108.md` → "Troubleshooting Oracle"
2. **Verifică:** Status PDB, conexiune, logs
3. **Documentează:** Notează problema și rezolvarea pentru viitor

### Pentru configurare nouă VM 201
1. **Citește:** `vm201-windows11.md` pentru context
2. **Pentru SSL:** Vezi `vm201-certificat-letsencrypt-iis.md`
3. **Testează:** Verifică configurația
4. **Documentează:** Actualizează documentele relevante

### Pentru incident Proxmox
1. **Diagnostică:** Folosește `proxmox-ssh-guide.md` → "Troubleshooting"
2. **Referință:** Vezi `vm201-troubleshooting-backup-nfs.md` pentru exemple
3. **Rezolvă:** Aplică comenzile din ghiduri
4. **Documentează:** Creează un fișier nou troubleshooting pentru incident

### Pentru mentenanță UPS
1. **Citește:** `ups/README.md` pentru overview
2. **Verifică:** Status UPS și baterie
3. **Test:** Rulează `ups-shutdown-test.sh` pentru dry-run
4. **Mentenanță:** Vezi `ups/docs/UPS-BATTERY-REPLACEMENT.md` dacă e nevoie

---

**Ultima actualizare:** 2025-11-19
**Autor:** Marius Mutu
**Proiect:** ROMFASTSQL - Infrastructure Documentation