Reorganize proxmox documentation into subdirectories per LXC/VM

- Create cluster/ for Proxmox cluster infrastructure (SSH guide, HA monitor, UPS)
- Create lxc108-oracle/ for Oracle Database documentation and scripts
- Create vm201-windows/ for Windows 11 VM docs and SSL certificate scripts
- Add SSL certificate monitoring scripts (check-ssl-certificates.ps1, monitor-ssl-certificates.sh)
- Remove archived VM107 references (decommissioned)
- Update all cross-references between files
- Update main README.md with new structure and navigation

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Marius
2026-01-27 17:02:49 +02:00
parent 1da4c2347c
commit 4d51d5b2d2
33 changed files with 954 additions and 593 deletions

View File

@@ -1,349 +1,189 @@
# 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
## Structură Directoare
```
proxmox/
├── README.md # Acest fișier (index)
├── proxmox-ssh-guide.md # Ghid general Proxmox
├── README.md # Acest fișier (index principal)
├── oracle-database-lxc108.md # LXC 108 - Oracle XE 21c
├── cluster/ # Infrastructură cluster Proxmox
│ ├── README.md # Ghid SSH și administrare cluster
│ ├── cluster-ha-monitor.sh # Script monitorizare HA
│ └── ups/ # Sistem UPS pentru cluster
│ ├── README.md
│ ├── docs/
│ ├── scripts/
│ └── config/
├── 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
├── lxc108-oracle/ # LXC 108 - Oracle Database XE 21c
│ ├── README.md # Documentație completă Oracle
│ └── scripts/
│ ├── export-roa2.sh
│ └── export-roa2.ps1
├── cluster-ha-monitor.sh # Script monitorizare HA cluster
├── vm201-windows/ # VM 201 - Windows 11 (roacentral)
│ ├── README.md # Informații generale VM
│ ├── docs/
│ │ ├── vm201-certificat-letsencrypt-iis.md
│ │ ├── vm201-troubleshooting-backup-nfs.md
│ │ └── vm201-troubleshooting-pana-curent-2026-01-11.md
│ └── scripts/
│ ├── check-ssl-certificates.ps1
│ └── monitor-ssl-certificates.sh
── 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
── claude-agent/ # Scripturi Claude Agent
├── README.md
── *.sh
```
---
## 🎯 Flux de Lucru Recomandat
## Documentație per Componentă
### 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
### Cluster Proxmox
**Director:** `cluster/`
### 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
| Fișier | Descriere |
|--------|-----------|
| `README.md` | Ghid complet: SSH, noduri, storage, comenzi Proxmox, hartă IP-uri |
| `cluster-ha-monitor.sh` | Script monitorizare High Availability |
| `ups/` | Sistem UPS: configurare NUT, shutdown orchestrat, test baterie |
### 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
**Quick Start:**
```bash
# Acces Proxmox
ssh root@10.0.20.201
### 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
# Status cluster
ssh root@10.0.20.201 "pvecm status"
# Status UPS
ssh root@10.0.20.201 "upsc nutdev1"
```
---
**Ultima actualizare:** 2025-11-19
### LXC 108 - Oracle Database
**Director:** `lxc108-oracle/`
**IP:** 10.0.20.121 | **Host:** pvemini
| Fișier | Descriere |
|--------|-----------|
| `README.md` | PDB-uri, useri, parole, connection strings, export/import DMP |
| `scripts/export-roa2.sh` | Script export PDB roa2 |
| `scripts/export-roa2.ps1` | Script export pentru Windows |
**Quick Start:**
```bash
# Acces în container
ssh root@10.0.20.201 "pct enter 108"
# Restart Oracle
ssh root@10.0.20.201 "pct exec 108 -- docker restart oracle-xe"
# Conexiune SQL*Plus
sqlplus sys/romfastsoft@10.0.20.121:1521/roa as sysdba
```
---
### VM 201 - Windows 11
**Director:** `vm201-windows/`
**IP:** DHCP | **Host:** pvemini | **Rol:** Reverse proxy IIS, client aplicații
| Fișier | Descriere |
|--------|-----------|
| `README.md` | Configurație hardware, servicii, rețea, backup |
| `docs/vm201-certificat-letsencrypt-iis.md` | Certificate SSL Let's Encrypt, Win-ACME, SNI |
| `docs/vm201-troubleshooting-backup-nfs.md` | Incident backup NFS (2025-10-08) |
| `docs/vm201-troubleshooting-pana-curent-2026-01-11.md` | Incident pană curent |
| `scripts/check-ssl-certificates.ps1` | Verificare/reînnoire certificate (Windows) |
| `scripts/monitor-ssl-certificates.sh` | Monitorizare certificate (Proxmox) |
**Quick Start:**
```bash
# Reînnoire certificate SSL (din Proxmox)
ssh root@10.0.20.201 "qm guest exec 201 -- powershell -Command 'cd C:\\Tools\\win-acme; .\\wacs.exe --renew --force'"
ssh root@10.0.20.201 "qm guest exec 201 -- cmd /c iisreset"
# Verificare certificate
echo | openssl s_client -connect roa.romfast.ro:443 -servername roa.romfast.ro 2>/dev/null | openssl x509 -noout -dates
```
---
## Hartă Rapidă Resurse
### Noduri Proxmox Cluster
| 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
| VMID | Nume | IP | Serviciu | Documentație |
|------|------|-----|----------|--------------|
| 100 | portainer | 10.0.20.170 | Docker Management | `cluster/README.md` |
| 103 | dokploy | 10.0.20.167 | Deployment Platform | `cluster/README.md` |
| 104 | flowise | 10.0.20.161 | Flowise AI + Ollama | `cluster/README.md` |
| 106 | gitea | 10.0.20.165 | Git Server | `cluster/README.md` |
| **108** | **central-oracle** | **10.0.20.121** | **Oracle XE 21c** | **`lxc108-oracle/`** |
### Virtual Machines
| VMID | Nume | OS | Documentație |
|------|------|----|--------------|
| **201** | **roacentral** | **Windows 11** | **`vm201-windows/`** |
| 300 | Win11-Template | Windows 11 | `cluster/README.md` |
---
## Navigare Rapidă - Am nevoie să...
### Infrastructură
- **Văd toate IP-urile și serviciile** → `cluster/README.md`
- **Configurez SSH** → `cluster/README.md` → "Configurare Inițială SSH"
- **Monitorizez HA cluster** → `cluster/cluster-ha-monitor.sh`
- **Gestionez UPS** → `cluster/ups/README.md`
### Oracle Database (LXC 108)
- **Conectez la Oracle** → `lxc108-oracle/README.md` → "Conexiuni Oracle"
- **Export/Import DMP** → `lxc108-oracle/README.md` → "Export și Import Data Pump"
- **Restart Oracle** → `lxc108-oracle/README.md` → "Restart Oracle"
### Windows VM 201
- **Reînnoiesc certificate SSL** → `vm201-windows/docs/vm201-certificat-letsencrypt-iis.md`
- **Rezolv probleme VM locked** → `vm201-windows/docs/vm201-troubleshooting-backup-nfs.md`
- **Informații generale** → `vm201-windows/README.md`
---
## Servicii Web
| Serviciu | URL |
|----------|-----|
| Proxmox pvemini | https://10.0.20.201:8006 |
| Oracle EM Express | http://10.0.20.121:5500/em |
| Portainer (Oracle) | http://10.0.20.121:9443 |
| 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 |
---
## Task-uri Automate Configurate
| Task | Locație | Frecvență | Scop |
|------|---------|-----------|------|
| SSL Certificate Check | VM 201 Task Scheduler | Zilnic 07:00 | Verifică/reînnoiește certificate |
| SSL Monitor | Proxmox cron | Zilnic 08:00 | Monitorizare externă certificate |
| Win-ACME Renew | VM 201 Task Scheduler | Zilnic 09:00 | Reînnoire automată Let's Encrypt |
| UPS Monthly Test | Proxmox cron | Lunar | Test baterie UPS |
| Backup Job | Proxmox | Zilnic 02:00 | Backup toate LXC/VM |
---
**Ultima actualizare:** 2026-01-27
**Autor:** Marius Mutu
**Proiect:** ROMFASTSQL - Infrastructure Documentation