Si estás utilizando una centralita telefónica basada en Asterisk, Issabel o Elastix, es importante conocer los comandos Asterisk CLI para poder gestionarla de manera efectiva. Algunos de estos comandos incluyen el comando Asterisk, el comando SIP Show Peers, el comando Show Channels y el comando Dialplan Reload.
La gestión de una centralita telefónica mediante CLI puede ser de gran ayuda en diversas situaciones, como cuando necesitas verificar si todas las extensiones están registradas correctamente, identificar la dirección IP de una extensión para gestionarla si no está en el inventario o determinar si la centralita está registrada con el troncal.
Para cambiar la dirección IP de Issabel por consola, es necesario utilizar el comando Putty. También es posible reiniciar Issabel desde la consola utilizando el comando Asterisk Core Restart o el comando SIP Reload.
Si la centralita se encuentra offline, es posible utilizar el modo debug de Asterisk para identificar y solucionar problemas. Además, se pueden utilizar los comandos de Asterisk para obtener información detallada sobre las extensiones registradas, los canales en uso y los registros SIP.
Se puede introducir los comandos CLI vía web, vía ssh o bien directamente en la máquina. Si quieres introducir los comandos vía web simplemente tienes que ir a al apartado PBX > Tools> Asterisk-Cli.
Por norma general la más usada es via SSH a través de la aplicación por excelencia PUTTY (si usas windows). Así que nos vamos a centrar en este tipo de entrada.
Es importante diferenciar entre la línea de comandos del propio sistema operativo y la interfaz de asterisk.
Comandos desde el sistema operativo linux
Las opciones que nos da el comando «asterisk» son:
En este caso, principalmente usaremos la función asterisk -rx «comando» o bien «asterisk -rvv».
Asterisk -rx
Se usa principalmente para poder ejecutar comandos del entorno asterisk desde la línea de comandos. Esto es muy útil para poder hacer scripts y automatizar funciones . Por ejemplo si quisiéramos ver las extensiones conectadas a la centralita pondríamos: asterisk -rx «sip show peers». De esta forma veríamos las extensiones sin entrar en el entorno asterisk.
Otros comandos usados
A veces una extensión puede tener activada la DND desde la propia consola y es algo que no podemos ver via web. Para localizar y eliminar esa DND usaremos los siguientes comandos:
Para ver que extensiones están en DND por consola
asterisk -rx "database show" | grep "/DND/"
Eliminar el DND de la base de datos si fuera la extensión 101 la afectada:
asterisk -rx ‘database del DND 101’
asterisk -rx 'database del DND 101'
Ver información de la extensión en cuestión
asterisk -rx 'database show' | grep /101
Comandos desde la interfaz de asterisk (Asterisk-Cli)
A partir del comando anterior vamos a ingresar a la interfaz asterisk introduciendo asterisk -rvvv
Comandos SIP
- sip show registry: Muestra el estado de registro del troncal SIP.
- sip show peers: Muestra las extensiones registradas o no, el estado, IPs etc.
- sip show channel: Muestra información del canal SIP.
- sip show channels: Muestra los canales activos SIP.
- sip set debug on: activa el modo debug.
- sip set debug off: desactiva el modo debug.
- sip show users: Muestra los usuarios y las contraseñas de los mismos
Comandos IAX2
- iax2 show channels: Muestra los canales iax activos (llamadas en curso)
- iax2 show peers: Muestra las extensiones iax configuradas
- iax2 show registry: Muestra el estado de los registros sobre iax2
- iax2 show users: Muestra los usuarios iax2 configurados
- iax set debug on/off: Habilita o deshabilita el debug sobre iax2
Comandos Core
- core show version: Versión de Asterisk.
- core show uptime: Cuanto tiempo ha estado activo Asterisk.
- core stop now: detiene Asterisk inmediatamente.
- core stop gracefully: Para Asterisk cuando cuelguen las llamadas en curso.
- core restart now: Reinicia Asterisk inmediatamente.
- core restart gracefully: Reinicia Asterisk cuando se acaben las llamadas activas y no permite más llamadas entrantes hasta reiniciar.
- core reload: recarga la configuración.
- core dialplan reload: recarga solo las extensiones.
- core show channels: muestra los canales de todo tipo.
- core show settings: Visualiza configuraciones básicas de Asterisk
- core show channels verbose: Lista información de canales de llamadas activos
- core show calls: Lista contador de llamadas activas y realizadas desde el último reinicio
- core show applications: Lista información de aplicaciones instaladas
- core show functions: Lista información de funciones instaladas
Comandos Console
- console dial: Llama a la extensión que pongas detrás.
- console answer: responde una llamada a la consola.
- console hangup: cuelga una llamada a la consola.
Otros Comandos de interés.
- module load: Carga los diferentes módulos de asterisk
- dialplan show: Visualiza todo el plan de marcación
- queue show: Visualiza información de Colas de Llamadas y sus Agentes (Miembros)
- features show: Visualizar información de marcaciones de características de llamada (como marcación para transferencias y captura de llamada)
La gestión eficiente de sistemas de telefonía IP como Asterisk e Issabel requiere un conocimiento profundo de sus comandos esenciales. Ya sea que busques reiniciar Asterisk, configurar un troncal SIP o simplemente entender el significado detrás de cada comando, esta guía está diseñada para ayudarte.
Comandos de Configuración en Asterisk e Issabel
Aprende a establecer y modificar configuraciones básicas con comandos como core show settings. Si alguna vez te has preguntado cómo visualizar las configuraciones de tu troncal SIP, el comando sip show registry es tu aliado. Además, para aquellos que trabajan con Issabel, es esencial conocer comandos específicos como issabel cli commands.
Diagnóstico y Monitorización
La monitorización en tiempo real es crucial. Con core show channels y sip show channels, puedes obtener una visión detallada de los canales activos, ya sean SIP o IAX2. Si alguna vez te encuentras en una situación donde Asterisk está offline en Issabel, comandos como asterisk offline issabel te proporcionarán información valiosa.
Gestión de Llamadas y Funcionalidades Avanzadas
Desde listar información de canales de llamadas activos con core show channels verbose hasta visualizar marcaciones específicas como features show, esta guía cubre todo. Además, para aquellos interesados en el dialplan, el comando dialplan show es esencial.
Ya sea que estés comenzando con Asterisk e Issabel o seas un experto buscando refrescar tu memoria sobre comandos específicos como core show version o sip set debug on, esta guía es tu recurso definitivo. No olvides revisar regularmente, ya que continuamente actualizamos con nuevos comandos y funcionalidades.
⬇️¡Sigue, comenta y comparte! ⬇️