Prepara il server FreePBX
Obelisk si installa su un server FreePBX già funzionante. Prima di iniziare prepara l’accesso SSH, i dati del database e l’indirizzo con cui apri FreePBX. Nei passaggi seguenti trovi cosa serve.
Controlla l’ambiente
L’ambiente di riferimento è FreePBX 17 su Debian 12, Asterisk 22 e PHP 8.2. L’installer ammette anche Debian 13 e versioni PHP successive, ma superare il controllo delle versioni non certifica tutte le combinazioni di moduli FreePBX. Servono accesso SSH come root, Python 3, unzip e un client MariaDB o MySQL. L’installer controlla le dipendenze PHP richieste; non installa FreePBX e non aggiorna il sistema operativo. Prevedi una finestra di manutenzione e un backup recente di FreePBX prima di procedere. In genere l’installazione standard di FreePBX soddisfa già queste dipendenze. L’installer di Obelisk controlla il server e segnala eventuali requisiti mancanti o anomalie prima di procedere.
Prepara il database e l’indirizzo di FreePBX
Identifica la sorgente
Individua il database esistente che contiene i dati CDR delle chiamate e queuelog delle code. Normalmente si chiama asteriskcdrdb. Se non lo hai spostato su un server MariaDB o MySQL remoto, alla domanda sulla posizione del database scegli local. Local significa che il database risiede sulla stessa macchina dove hai installato FreePBX.
Prepara lo spazio di Obelisk
L’installer crea un database separato per Obelisk, sullo stesso server e sulla stessa porta di asteriskcdrdb. Servono MariaDB 10.11 o MySQL 8.0.16, oppure versioni successive. Se il database è remoto, chiedi prima al tuo amministratore le credenziali dell’account applicativo e di quello amministrativo. Se hai dubbi, apri FreePBX → Impostazioni → Impostazioni avanzate. Controlla se usi un database CDR remoto e annota i relativi dati di connessione e il nome del database. Verifica anche eventuali nomi personalizzati per il database o la tabella del log delle code: nell’installer inserisci il nome del database e quello della tabella queuelog nei rispettivi campi.
Prepara l’indirizzo web di FreePBX
Usa l’indirizzo che inserisci nel browser per aprire FreePBX, senza /obelisk. Può essere HTTPS oppure HTTP, anche su un IP privato. Con HTTP o un certificato HTTPS non valido, l’installer mostra un avviso e chiede se vuoi proseguire. Il PBX deve inoltre accedere a Internet per la prima attivazione della licenza.
Controlla PHP e le dipendenze del browser
Controlla entrambi gli ambienti PHP: il comando usato in SSH e il PHP servito da Apache o FPM possono caricare configurazioni ed estensioni diverse. ZIP serve su entrambi per gli aggiornamenti. Autenticazione a due fattori e backup delle configurazioni richiedono Sodium e PHP a 64 bit; i backup richiedono anche zlib. Il numero di versione nella console da solo non conferma queste dipendenze nell’ambiente web.
Il server web deve applicare le regole .htaccess distribuite. I browser devono inoltre raggiungere www.gstatic.com per Google Charts e il provider delle mappe configurato, normalmente tile.openstreetmap.org. Se la tabella funziona ma un grafico o una mappa non compare, controlla queste richieste del browser prima di modificare il database o reinstallare. Un proxy o filtro aziendale può incidere diversamente sul browser e sul PBX.
Verifica quando proseguire
Puoi proseguire quando hai un backup recente di FreePBX, le credenziali necessarie e un indirizzo FreePBX raggiungibile anche dal PBX stesso. Questa guida riguarda una nuova installazione. Se Obelisk è già presente in /var/www/html/obelisk, segui la guida all’aggiornamento collegata qui sotto.