Preparar el servidor FreePBX
Obelisk se instala en un servidor FreePBX existente. Antes de empezar, prepara el acceso SSH, los datos de la base de datos y la dirección con la que abres FreePBX. Los pasos siguientes explican qué necesitas.
Comprueba el entorno
El entorno de referencia es FreePBX 17 sobre Debian 12, Asterisk 22 y PHP 8.2. El instalador también admite Debian 13 y versiones posteriores de PHP, pero superar la comprobación de versiones no certifica todas las combinaciones de módulos FreePBX. Necesitas acceso SSH como root, Python 3, unzip y un cliente MariaDB o MySQL. El instalador comprueba las dependencias PHP necesarias; no instala FreePBX ni actualiza el sistema operativo. Reserva una ventana de mantenimiento y realiza antes una copia reciente de FreePBX. Una instalación estándar de FreePBX suele incluir estas dependencias. El instalador de Obelisk comprueba el servidor y señala los requisitos que faltan o las anomalías antes de continuar.
Prepara la base de datos y la dirección FreePBX
Identifica el origen
Identifica la base de datos existente que contiene los registros de llamadas CDR y los eventos de colas queuelog. Normalmente se llama asteriskcdrdb. Si no la has trasladado a un servidor MariaDB o MySQL remoto, elige local cuando el instalador pregunte dónde está. Local significa que la base de datos está en el mismo equipo donde has instalado FreePBX.
Prepara el almacenamiento de Obelisk
El instalador crea una base de datos independiente para Obelisk, en el mismo servidor y puerto que asteriskcdrdb. Se necesita MariaDB 10.11 o MySQL 8.0.16 o posterior. Si la base de datos es remota, pide a tu administrador la cuenta de la aplicación y la cuenta administrativa antes de empezar. Si tienes dudas, abre FreePBX → Configuración → Ajustes avanzados. Comprueba si CDR utiliza una base de datos remota y anota la conexión y el nombre de la base. Revisa también cualquier nombre personalizado para la base de datos o la tabla del registro de colas: introduce el nombre de la base y el de la tabla queuelog en los campos correspondientes del instalador.
Prepara la dirección web de FreePBX
Utiliza la dirección que introduces en el navegador para abrir FreePBX, sin /obelisk. Puede ser HTTPS o HTTP, también con una IP privada. Con HTTP o un certificado HTTPS no válido, el instalador muestra un aviso y pregunta si quieres continuar. El PBX también necesita Internet para la primera activación de la licencia.
Comprueba PHP y las dependencias del navegador
Comprueba ambos entornos PHP: el comando utilizado en SSH y PHP servido por Apache o FPM pueden cargar configuraciones y extensiones distintas. Las actualizaciones requieren ZIP en ambos. La autenticación de dos factores y las copias de configuración necesitan Sodium y PHP de 64 bits; las copias también requieren zlib. El número de versión de consola no confirma estas dependencias en el entorno web.
El servidor web debe aplicar las reglas .htaccess suministradas. Los navegadores también necesitan acceso a www.gstatic.com para Google Charts y al proveedor de mapas configurado, normalmente tile.openstreetmap.org. Si funciona la tabla pero no aparece un gráfico o mapa, revisa esas solicitudes del navegador antes de cambiar la base de datos o reinstalar. Un proxy o filtro corporativo puede afectar de forma distinta al navegador y al PBX.
Comprueba que puedes continuar
Puedes continuar cuando tengas una copia reciente de FreePBX, las credenciales necesarias y una dirección FreePBX accesible desde el propio PBX. Esta guía es para una instalación nueva. Si Obelisk ya existe en /var/www/html/obelisk, utiliza la guía de actualización enlazada debajo.