Responder a cada pregunta de instalación

Cómo responder

Los nombres coinciden con el texto inglés del terminal. Pulsa Intro para aceptar el valor entre corchetes. Escribe y para sí o n para no: Y/n propone sí; y/N propone no. Las contraseñas no muestran caracteres al escribir. Responde una pregunta cada vez.

La comprobación --check solo pregunta por las bases, AMI y el acceso del administrador SQL. Los comprueba sin instalar. No guarda las respuestas: al ejecutar install.sh para instalar, vuelve a introducirlas y responde a las demás preguntas.

1. Elegir base de datos local o remota

1. Database location (local/remote) [local]

   Elige local si asteriskcdrdb, la base con las tablas cdr y queuelog, sigue en el servidor FreePBX. Es la instalación habitual. Elige remote solo si se ha trasladado a un servidor MariaDB o MySQL remoto, normalmente desde los ajustes avanzados de FreePBX. Obelisk y su base telefónica deben usar el mismo servidor SQL y puerto.

2. Database server hostname or IP address

   Solo aparece después de remote. Introduce el nombre o IP del servidor remoto, por ejemplo 192.168.1.20, sin http:// ni puerto. Pide la dirección al administrador y confirma que admite conexiones desde el PBX.

3. Database TCP port [3306]

   Pulsa Intro para usar 3306, el puerto habitual de MariaDB/MySQL. Escribe otro número solo si tu base utiliza un puerto distinto. También aparece en instalaciones locales.

2. Identificar las bases de datos

1. Existing database containing CDR and queue log [asteriskcdrdb]

   Normalmente pulsa Intro para aceptar asteriskcdrdb: la base existente de FreePBX con cdr y queuelog. Si tiene otro nombre, introdúcelo. Si usaste --database en el comando, se propone ese valor. No crees una base vacía para esta respuesta.

2. Dedicated Obelisk database [obelisk]

   Pulsa Intro para usar obelisk o elige otro nombre para su nueva base. El instalador crea las tablas y procedimientos tras confirmar. Esta base debe estar separada de asteriskcdrdb. Si Obelisk ya está instalado, sigue la guía de actualización.

3a. Crear un usuario de base de datos local

Este paso solo aparece si elegiste local. Si elegiste remote, sáltalo y sigue el paso 3b.

1. New dedicated local SQL username [obelisk-app]

   En una instalación local, pulsa Intro para crear obelisk-app o elige otro nombre libre. Usa de 1 a 32 letras, cifras, guiones o guiones bajos. Esta cuenta conecta Obelisk con la base; no es tu usuario del sitio. El instalador genera su contraseña. Si el nombre ya existe, se detiene sin sustituir la cuenta.

3b. Indicar la cuenta de la base remota

Estas preguntas solo aparecen si elegiste remote. Para una base local, sigue el paso 3a anterior: el instalador crea la cuenta y su contraseña.

1. Existing runtime database username

   Introduce el usuario SQL ya preparado para Obelisk. Pídelo, con la contraseña, a quien administra la base. Debe admitir conexiones desde el PBX. El instalador comprueba los permisos e indica los que falten.

2. Runtime database password

   Introduce la contraseña de esa cuenta. No puede quedar vacía y se oculta al escribir. Es la de la base, no la de tu acceso a Obelisk. Si el control indica permisos insuficientes, muestra el mensaje al administrador.

4. Indicar la tabla queuelog

1. Source queue log table name [queuelog]

   Normalmente pulsa Intro para usar queuelog, la tabla con los eventos de llamadas en cola. Si los ajustes avanzados de FreePBX indican otro nombre, introdúcelo. La tabla debe recibir eventos de FreePBX. Tras instalar, usa la comprobación de primera llamada enlazada abajo.

5. Crear tu administrador de Obelisk

1. Initial administrator username [asterisk]

   Elige el usuario con el que accederás a Obelisk. Pulsa Intro para conservar asterisk o escribe otro nombre de hasta 80 caracteres. Es una cuenta nueva, separada de Linux y FreePBX. Después podrás gestionarla en Administración → Usuarios y perfiles de acceso.

2. Administrator password (leave empty to generate a unique password)

   Escribe tu contraseña o pulsa Intro para generar una. Con letras sin acento, cifras y símbolos normales del teclado, usa de 12 a 72 caracteres. Los acentos y emoji ocupan más: el límite técnico es de 12 a 72 bytes UTF-8. Debes copiar y guardar la contraseña generada en cuanto aparezca, antes de cerrar el terminal. Si la pierdes, necesitarás el procedimiento de restablecimiento de abajo para acceder. La contraseña que escribas tú no se imprime.

3. Confirm administrator password

   Si elegiste una contraseña, vuelve a escribirla. Si no coincide, se solicita otra vez. Tras tres intentos distintos, vuelve a la elección. Esta pregunta no aparece si la contraseña es generada.

6. Indicar el formato de los números entrantes

El trunk SIP del operador puede entregar números sin prefijo de país o sin seguir E.164, el formato telefónico internacional. Estos ajustes indican a Obelisk cómo interpretarlos para asociar las llamadas a un país o zona mediante sus prefijos. Revisa algunos números entrantes reales en FreePBX antes de elegir. Las reglas se aplican a los informes de Obelisk: no cambian el dialplan de FreePBX ni los números originales de queuelog. El origen telefónico se estima a partir del número; no es la ubicación física del llamante.

1. Reference country calling code (Italy: 39, France: 33, UK: 44) [39]

   Introduce el prefijo de tu país sin + ni 00: Italia 39, Francia 33, Reino Unido 44, Alemania 49, España 34, Estados Unidos 1, y así para tu país. El 1 también lo comparten Canadá y otros destinos del plan de numeración norteamericano. Si tienes dudas, busca tu país en la lista oficial de la UIT enlazada abajo. Intro conserva 39: cámbialo si tu país de referencia es otro.

2. Unprefixed number format (national/international/preserve) [national]

   Mira el número tal como lo entrega el operador. Si no lleva prefijo de país, elige national: Obelisk añade el prefijo de referencia. Si ya lleva el prefijo pero falta +, elige international: lo reconoce sin añadir otro. Si no puedes identificar el formato con seguridad, elige preserve: mantiene el número, aunque puede no asignarle un origen geográfico. La tabla muestra los tres casos usando Italia como ejemplo. Los números que ya empiezan por + siguen su prefijo explícito.

3. Recognize 00 as an international prefix (0033... means +33...) [Y/n]

   Normalmente pulsa Intro para sí. Un número que empieza por 0033 se reconocerá como +33. Elige no solo si tus números usan 00 de otra forma.

4. Remove the national leading zero when adding the country code [y/N]

   Solo aparece después de national. Para fijos italianos conserva no: 06... pasa a +3906..., manteniendo el cero. Para países que eliminan el cero nacional, como Francia o Reino Unido, elige sí. Responde según los números recibidos.

5. Maximum length to preserve as a short number (0 disables this rule; 0-10) [5]

   Pulsa Intro para conservar números de hasta 5 cifras, como extensiones, sin añadir prefijo. Elige otro límite de 1 a 10 o 0 para desactivar la regla. Los números con + o un prefijo internacional reconocido siguen las reglas internacionales. Después revisa los ajustes en Administración → Base de datos y procedimientos → Numeración E.164.

7. Elige el idioma de los informes automáticos

1. Language for automatic reports (it/en/es) [it]

   Escribe it para italiano, en para inglés o es para español. Intro conserva italiano. Es el idioma de los informes automáticos. Para cambiarlo, abre Administración → Sistema y utilidades → Identidad de empresa e idioma. El idioma de tu interfaz se elige en Preferencias.

8. Conecta la supervisión en vivo mediante AMI

1. AMI account (create/existing/manual) [create]

   AMI conecta Obelisk con Asterisk para ver colas y extensiones en vivo. Elige create para crear una cuenta dedicada en /etc/asterisk/manager_custom.conf de FreePBX. Al terminar, aplica la configuración de FreePBX mediante la recarga propuesta para que Asterisk cargue la cuenta. Elige existing si ya tienes una cuenta AMI, o manual para configurarla después. Puedes modificarla o eliminarla en FreePBX más adelante; si cambian sus credenciales, actualízalas en Obelisk en Administración → Sistema y utilidades → Asterisk y bases de datos. Sin una cuenta AMI operativa, la supervisión en vivo no puede conectarse.

2. New dedicated local AMI username [obelisk]

   Aparece después de create. Pulsa Intro para usar obelisk o escribe un nombre de hasta 80 letras, cifras, guiones o guiones bajos. El instalador genera la contraseña. Si reconoce su propia cuenta existente, conserva contraseña y permisos. Si corresponde a otra cuenta, consulta al administrador del PBX.

3. Existing local AMI username / AMI password

   Después de existing, introduce el usuario AMI y luego su contraseña. Pide ambos al administrador del PBX. El instalador usa la cuenta sin cambiarla. Después puedes actualizar los datos en Administración → Sistema y utilidades → Asterisk y bases de datos.

9. Indicar la dirección web de FreePBX

Antes de crear las bases, el instalador comprueba esa dirección desde el PBX. Con HTTP o un certificado HTTPS no válido o autofirmado, explica la situación y pregunta si quieres continuar. Tú decides; Intro equivale a no. Las confirmaciones se explican más abajo.

1. FreePBX web base URL (e.g. http://192.168.1.10 or https://pbx.example.com)

   Introduce la dirección con la que abres FreePBX, sin /obelisk: por ejemplo https://pbx.example.com, https://192.168.1.10 o http://192.168.1.10. Sustituye los ejemplos por tu dirección real. Se admiten HTTP e IP privadas. Si indicaste --base-url en el comando, no aparece esta pregunta.

10. Facilitar el acceso del administrador SQL

Son las credenciales del administrador de MariaDB o MySQL, no el acceso a Obelisk. La conexión verificada se guarda en un archivo privado bajo /etc/obelisk, fuera del sitio y legible solo por root de Linux. Se utiliza en actualizaciones posteriores. Inclúyelo en la copia completa del servidor descrita abajo.

1. Database administrator [root] / Database administrator password

   Primero se prueba el acceso habitual de root a SQL local. Si funciona, no aparecen estas dos preguntas. En caso contrario, indica el administrador SQL y su contraseña. Son credenciales de la base; root de Linux puede tener otra contraseña.

2. Remote database administrator / Remote administrator password

   Introduce el usuario y contraseña administrativos de la base remota. Deben corresponder al servidor y puerto elegidos. Se usan para crear y comprobar la base de Obelisk. Son distintos de la cuenta de aplicación indicada en el paso 3b.

11. Revisa el plan antes de confirmar

Obelisk lee las llamadas originales de las tablas cdr y queuelog de FreePBX y prepara sus propias tablas de informes. El planificador de eventos de MariaDB/MySQL ejecuta el procesamiento periódicamente mediante min_queue y min_out. Déjalo activo para mantener los informes actualizados. Si está apagado, hay que iniciar el procesamiento manualmente en Administración → Base de datos y procedimientos → Procedimientos; no se recomienda para el uso diario. El procesamiento no reescribe los datos originales de las llamadas. La posible incorporación de cdr.id durante la instalación se explica aparte abajo.

1. Enabling the scheduler also runs ... other enabled database event(s). Allow this [y/N]

   Aparece si el planificador de MariaDB/MySQL local está apagado y otras aplicaciones ya tienen eventos habilitados. Responder y lo inicia: Obelisk podrá actualizar sus informes automáticamente, y también podrán ejecutarse los demás eventos. Consúltalo con el administrador antes de aceptar. Intro o n lo deja apagado; los informes no se actualizarán automáticamente mediante eventos SQL hasta activarlo.

2. Allow the required CDR id schema change during this maintenance window [y/N]

   La tabla cdr de FreePBX puede no tener una columna id que identifique cada fila. Si falta, Obelisk pide permiso para añadirla y procesar de forma fiable las llamadas nuevas. Si ya existe un id válido, lo conserva. Con millones de registros, añadir la columna puede tardar y bloquear temporalmente las escrituras CDR: programa una ventana de mantenimiento con el administrador del PBX y realiza antes una copia. Responde y solo durante esa ventana; Intro o n detiene la instalación antes del cambio.

3. Proceed with this first installation [y/N]

   Lee el resumen: carpeta, bases, cuentas y cambios. Responde y para empezar o Intro para cancelar. Antes de crear las bases se comprueban la dirección web y los archivos privados. Al final se programan seis tareas Linux y se solicita activar dos eventos SQL. El borrado de grabaciones sigue apagado hasta habilitar su ajuste específico.

12. Decidir si aceptar HTTP o el aviso de certificado

Estas preguntas aparecen durante el control web, tras confirmar la instalación. Con HTTPS y un certificado válido no aparece ninguna.

1. Continue using this HTTP site for the installation [y/N]

   Aparece con una dirección http://. El instalador explica que HTTP no cifra las credenciales ni los datos. Escribe y si decides continuar con HTTP o n para detenerte y configurar HTTPS. Intro equivale a no.

2. Continue with this HTTPS site without validating its certificate for the installation protection check [y/N]

   Aparece si HTTPS funciona pero no puede validarse el certificado: por ejemplo, autofirmado, caducado o con un nombre distinto de la IP privada. Escribe y para aceptarlo en el control de instalación o n para detenerte y corregirlo. Intro equivale a no. HTTPS sigue cifrado. No cambia las verificaciones de las demás conexiones de Obelisk.

13. Aplicar la configuración FreePBX

Lee el resumen. Si falló la recarga, corrige FreePBX y continúa con --resume. Si el procesamiento MySQL no está activo, sigue la guía de tareas. Si faltan nombres de colas o líneas, actualízalos desde Administración → Vistas operativas o Base de datos y procedimientos → Líneas → Actualizar lista desde PBX.

Después activa la licencia, accede y comprueba una llamada real a cola. Las siguientes guías explican estos pasos.

1. Reload FreePBX configuration automatically now [Y/n]

   Pulsa Intro para sí y ejecutar fwconsole reload, equivalente a Apply Config de FreePBX. Aplica los cambios pendientes, incluidos los de otros administradores, sin reiniciar el PBX. Elige n si aplicarás la configuración después. Hasta entonces, los nuevos ajustes AMI y de colas pueden no estar activos.

Si se interrumpe la instalación

Corrige el error y ejecuta --resume desde el mismo paquete, con las opciones originales. Se reutilizan las respuestas y se continúa desde el paso guardado. Conserva el paquete y sus archivos de estado. Una vez instalado, cambia los ajustes desde Obelisk como se explica a continuación.

1. Contraseña administrativa solicitada de nuevo

   Si se detuvo antes de crear al administrador, puede pedir otra contraseña y confirmarla. El usuario sigue siendo el elegido. Si la cuenta ya estaba creada, conserva la contraseña. Si no puedes acceder, usa la guía de recuperación.

2. Replace the administrative credentials in this private updater profile [y/N]

   Puede aparecer al recuperar si proporcionas otras credenciales SQL administrativas para la misma base. Responde y para guardarlas en el perfil privado de actualización. Responde n para conservar el perfil anterior y detener ese paso. No cambia el servidor ni la cuenta SQL de la aplicación.

Cambiar ajustes después de instalar

Los ajustes introducidos al instalar pueden cambiarse desde el panel de administración de Obelisk. Por ejemplo, si elegiste un idioma incorrecto para los informes, cámbialo y guarda: no hay que reinstalar. Accede como administrador, abre Administración y sigue la tabla. Incluye todas las preguntas, agrupando las relacionadas. Cuando una opción corresponde a FreePBX, al servidor de base de datos o solo a la instalación, se indica con el enlace adecuado.

Pausar o reactivar las tareas

Usa --disable-jobs desde el paquete original para pausar el procesamiento automático de Obelisk. Detiene nuevas ejecuciones de las seis tareas Linux y los dos eventos SQL de abajo. Se suspenden el muestreo histórico, la actualización de informes de llamadas, el análisis automático de grabaciones, los informes por correo y la limpieza programada. FreePBX sigue atendiendo llamadas y escribiendo sus CDR/queuelog originales. Los trabajos ya iniciados terminan. Usa --activate-jobs para reactivar las planificaciones, con los comandos completos del resumen de instalación.

1. Enabling the global scheduler also runs ... other enabled database event(s). Continue [y/N]

   El planificador de MariaDB/MySQL es el servicio que inicia las tareas programadas de la base. Obelisk lo usa para actualizar los informes mediante min_queue y min_out. La pregunta puede aparecer al reactivar tareas si el planificador local está apagado y otras aplicaciones tienen eventos habilitados: y puede iniciarlos también. Consúltalo antes con el administrador. Intro o n lo deja apagado y los informes SQL siguen sin actualizarse. En un servidor remoto, pide a su administrador que lo active.