OBELISK R82 FIX9 — INSTALLAZIONE

Questa guida serve per installare Obelisk su un FreePBX già funzionante.
Se Obelisk è già presente, usa lo ZIP di aggiornamento dal pannello amministrativo.

1. PREPARA

- Un backup recente di FreePBX e un accesso SSH con privilegi root.
- Ambiente di riferimento: FreePBX 17, Debian 12, Asterisk 22 e PHP 8.2.
  Servono Python 3, unzip e un client MariaDB/MySQL. Il controllo iniziale
  verifica le dipendenze; non installa FreePBX e non aggiorna il sistema.
- MariaDB >= 10.11 oppure MySQL >= 8.0.16, con CDR e queuelog già alimentati.
  Obelisk e le sorgenti FreePBX devono usare lo stesso server SQL e la stessa porta.
- Indirizzo web del PBX e credenziali SQL amministrative. Per SQL remoto
  serve anche un account applicativo esistente, autorizzato ad accedere dal PBX.

La cartella /var/www/html/obelisk deve essere assente. Scegli una finestra di
manutenzione: il reload FreePBX applica anche le altre modifiche in attesa.

2. ESTRAI E VERIFICA

Trasferisci questo ZIP in /root con il tuo client SFTP. In SSH esegui le righe
seguenti una alla volta. Se sei già root, ometti la prima riga.

  sudo -i
  mkdir /root/obelisk-installazione
  unzip -n /root/obelisk-installazione-guidata-20261013-r82-fix9.zip -d /root/obelisk-installazione
  cd /root/obelisk-installazione
  bash install.sh --check

La cartella di estrazione deve essere nuova: se esiste già, scegli un altro
nome nei tre comandi. Non mescolare kit diversi e non aggiungere file al kit.
Il controllo non installa Obelisk. Risolvi gli errori segnalati prima di continuare.
Direttive attive #include, #tryinclude o #exec nei file di /etc/asterisk/
queues_custom_general.conf, extensions_custom.conf o manager_custom.conf
bloccano --check e installazione, anche con AMI existing/manual.
Fai esaminare direttive e dipendenze dall'amministratore PBX: non eliminarle
o commentarle alla cieca. I file custom esistenti restano conservati.
Prima di riprovare, consulta ADMINISTRATION_IT.txt, punto 1.

3. INSTALLA

Dalla stessa cartella esegui:

  bash install.sh

Rispondi alle domande e conferma il riepilogo. Il controllo precedente non
salva le risposte. I valori principali sono:

- Database: local se è sul PBX, remote se è su un altro server.
- Sorgente telefonica: normalmente asteriskcdrdb; tabella code: queuelog.
- Database Obelisk: normalmente obelisk, distinto da quello FreePBX.
- AMI: create per creare l'account locale; existing per usarne uno già pronto;
  manual per configurarlo dopo (il monitoraggio live attenderà la configurazione).
- Indirizzo web: per esempio http://192.168.1.10 o https://pbx.example.com,
  senza /obelisk; aggiungi la porta se personalizzata.
- Account amministratore Obelisk: conserva le credenziali indicate.

Con SQL remoto sono richiesti sia l'account applicativo sia l'amministratore SQL:
servono a usi distinti. Permessi e casi particolari: ADMINISTRATION_IT.txt, punto 2.
HTTP e certificati non riconosciuti sono ammessi dopo un avviso e la tua conferma.
Il sito deve comunque essere raggiungibile e proteggere i file riservati.

Attendi il riepilogo finale e risolvi eventuali avvisi. Se rinvii il reload,
esegui Apply Config in FreePBX prima delle prove. Non serve riavviare il PBX.

4. APRI OBELISK

Apri l'indirizzo mostrato, ad esempio http://192.168.1.10/obelisk/activate.php.
Scegli la demo di 7 giorni o inserisci il codice ricevuto. Per l'attivazione online
serve Internet. Il browser può chiedere conferma per un certificato non riconosciuto.

Accedi come amministratore ed esegui Verifica installazione in Sistema e utility.
Controlla code, interni, registrazioni, fuso orario e numeri telefonici; prova una
chiamata e una registrazione. La prima elaborazione dello storico può richiedere tempo.
Configura SMTP e AI se ti servono. La cancellazione audio resta disabilitata
finché non la abiliti. Mantieni un backup completo: il backup delle configurazioni
del pannello non comprende lo storico SQL e gli audio.

SE SI INTERROMPE

Leggi l'errore. Se viene indicato uno stato salvato, correggi la causa e riprendi
dalla stessa cartella con: bash install.sh --resume
Non cancellare lo stato né cambiare kit. Conserva il percorso del log indicato.
Per recupero, URL errato, database remoto o percorsi diversi: ADMINISTRATION_IT.txt.

Documentazione: https://obsk.io/it/manuals/
Attribuzioni: assets/vendor/notices/THIRD_PARTY_NOTICES.txt nel sito installato.
