Comandos principales para centralitas Asterisk

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:

Ver salida del comando

asterisk -h

-V    Display version number and exit
-C Use an alternate configuration file
-G Run as a group other than the caller
-U Run as a user other than the caller
-c Provide console CLI
-d Enable extra debugging
-f Do not fork
-F Always fork
-g Dump core in case of a crash
-h This help screen
-i Initialize crypto keys at startup
-L Limit the maximum load average before rejecting new calls
-M Limit the maximum number of calls to the specified value
-m Mute debugging and console output on the console
-n Disable console colorization
-p Run as pseudo-realtime thread
-q Quiet mode (suppress output)
-r Connect to Asterisk on this machine
-R Same as -r, except attempt to reconnect if disconnected
-s Connect to Asterisk via socket (only valid with -r)
-t Record soundfiles in /var/tmp and move them where they
belong after they are done
-T Display the time in [Mmm dd hh:mm:ss] format for each line
of output to the CLI
-v Increase verbosity (multiple v’s = more verbose)
-x Execute command (implies -r)
-X Execute includes by default (allows #exec in asterisk.conf)
-W Adjust terminal colors to compensate for a light background

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.