14. Administration Système
Procédures de Restauration
Questa guida fornisce istruzioni dettagliate su come ripristinare il sistema da un backup in caso di problemi o perdita di dati.
⚠️ Importante
Prima di procedere con un ripristino, assicurati di avere:
- ✓ Accesso SSH al server
- ✓ Permessi di amministratore
- ✓ Un backup valido da ripristinare
- ✓ Tempo sufficiente per completare l'operazione
Passo 1: Identificare il Backup da Ripristinare
# Elencare tutti i backup disponibili
ls -lah /home/achille616/backups/cnc-ecommerce/
# Output esempio:
# CNC-Simulator-Italia_2025-12-18-02-00-00.zip (backup completo)
# CNC-Simulator-Italia_2025-12-18-06-00-00.zip (backup solo DB)
# CNC-Simulator-Italia_2025-12-18-12-00-00.zip (backup solo DB)
Passo 2: Estrarre il Backup
# Creare una cartella temporanea
mkdir -p /tmp/backup-restore
# Estrarre il backup
cd /tmp/backup-restore
unzip /home/achille616/backups/cnc-ecommerce/NOME_BACKUP.zip
Passo 3A: Ripristino Database
# Il database è nel file db-dumps/*.sql o *.sql.gz
# Se è compresso:
gunzip db-dumps/mysql-*.sql.gz
# Ripristinare il database con credenziali da .env:
cd /var/www/cnc-ecommerce
mysql -u $(grep DB_USERNAME .env | cut -d '=' -f2) \
-p$(grep DB_PASSWORD .env | cut -d '=' -f2) \
$(grep DB_DATABASE .env | cut -d '=' -f2) < /tmp/backup-restore/db-dumps/mysql-*.sql
Passo 3B: Ripristino File
# Ripristinare storage (uploads, file utente)
cp -r /tmp/backup-restore/storage/app/public/* /var/www/cnc-ecommerce/storage/app/public/
# Ripristinare file .env (se necessario)
# ATTENZIONE: Verificare prima le differenze!
diff /tmp/backup-restore/.env /var/www/cnc-ecommerce/.env
# Se OK:
# cp /tmp/backup-restore/.env /var/www/cnc-ecommerce/.env
Passo 4: Verificare i Permessi
cd /var/www/cnc-ecommerce
# Ripristinare proprietà
chown -R achille616:www-data storage
chown -R achille616:www-data bootstrap/cache
# Ripristinare permessi
chmod -R 775 storage
chmod -R 775 bootstrap/cache
Passo 5: Pulire le Cache
cd /var/www/cnc-ecommerce
php artisan config:clear
php artisan cache:clear
php artisan view:clear
php artisan route:clear
Passo 6: Pulire File Temporanei
rm -rf /tmp/backup-restore
✅ Verifica Finale
Dopo il ripristino, verifica che:
- ✓ Il sito sia accessibile e funzionante
- ✓ Il database contenga i dati corretti
- ✓ I file caricati siano visibili
- ✓ Le funzionalità principali funzionino correttamente
Script di Ripristino Automatico
Per automatizzare il processo di ripristino, puoi creare uno script bash:
#!/bin/bash
# save as: /home/achille616/restore-backup.sh
if [ -z "$1" ]; then
echo "Uso: ./restore-backup.sh NOME_FILE_BACKUP.zip"
echo "Esempio: ./restore-backup.sh CNC-Simulator-Italia_2025-12-18-02-00-00.zip"
exit 1
fi
BACKUP_FILE="/home/achille616/backups/cnc-ecommerce/$1"
TMP_DIR="/tmp/backup-restore-$(date +%s)"
WEB_DIR="/var/www/cnc-ecommerce"
echo "🔄 Ripristino da: $BACKUP_FILE"
# Verifica esistenza backup
if [ ! -f "$BACKUP_FILE" ]; then
echo "❌ Backup non trovato: $BACKUP_FILE"
exit 1
fi
# Estrazione
echo "📦 Estrazione backup..."
mkdir -p $TMP_DIR
cd $TMP_DIR
unzip -q $BACKUP_FILE
# Ripristino database
echo "💾 Ripristino database..."
cd $WEB_DIR
DB_USER=$(grep DB_USERNAME .env | cut -d '=' -f2)
DB_PASS=$(grep DB_PASSWORD .env | cut -d '=' -f2)
DB_NAME=$(grep DB_DATABASE .env | cut -d '=' -f2)
SQL_FILE=$(find $TMP_DIR/db-dumps -name "*.sql" -o -name "*.sql.gz" | head -1)
if [[ $SQL_FILE == *.gz ]]; then
gunzip $SQL_FILE
SQL_FILE="${SQL_FILE%.gz}"
fi
mysql -u $DB_USER -p$DB_PASS $DB_NAME < $SQL_FILE
# Ripristino file storage
if [ -d "$TMP_DIR/storage/app/public" ]; then
echo "📁 Ripristino file storage..."
cp -r $TMP_DIR/storage/app/public/* $WEB_DIR/storage/app/public/
fi
# Permessi
echo "🔐 Aggiornamento permessi..."
chown -R achille616:www-data $WEB_DIR/storage
chmod -R 775 $WEB_DIR/storage
# Cache
echo "🧹 Pulizia cache..."
cd $WEB_DIR
php artisan config:clear
php artisan cache:clear
php artisan view:clear
# Cleanup
echo "🗑️ Pulizia file temporanei..."
rm -rf $TMP_DIR
echo "✅ Ripristino completato!"
Per utilizzare lo script:
# Rendilo eseguibile
chmod +x /home/achille616/restore-backup.sh
# Esegui il ripristino
./restore-backup.sh CNC-Simulator-Italia_2025-12-18-02-00-00.zip
Ripristino Parziale (Solo Alcune Tabelle)
Se necessiti di ripristinare solo specifiche tabelle del database:
# Estrarre solo alcune tabelle
mysql -u USER -p DB_NAME -e "SELECT * FROM table_name" > table_backup.sql
# Usare mysqldump per tabelle specifiche
mysqldump -u USER -p DB_NAME table1 table2 > partial_backup.sql
💡 Suggerimento
Testa regolarmente la procedura di ripristino su un ambiente di test per assicurarti che tutto funzioni correttamente quando ne avrai bisogno.
