Taller 3: Comandos Básicos de Asterisk

Taller 3: Comandos Básicos de Asterisk

⏱️ Información del Taller

Duración: 60 minutos | Dificultad: Básico | Modalidad: Práctica

🎯 Objetivo del Taller

Dominar los comandos esenciales del CLI de Asterisk 22 para administración cotidiana, diagnóstico y solución de problemas, con foco en PJSIP.

Para ejecutar los comandos en Asterisk debemos primeramente ingresar en la consola directo o vía SSH en modo súper usuario (root), luego debemos ingresar al CLI (Command Line Interface) ingresamos a la consola con: asterisk -r (recordemos que si deseamos verificar los logs del sistema para diagnósticos debemos colocar “v” (verbose), cada v es un nivel más de detalles.

Ingresar a Asterisk:

asterisk -rv

3.1.- Comandos para PJSIP (Asterisk 22)

En Asterisk 22, chan_sip ya no existe. Todo el manejo SIP se realiza a través de PJSIP. Estos son los comandos esenciales:

Muestra una lista de todos los puntos finales (endpoints)

pjsip show endpoints

Muestra información detallada de un endpoint específico

pjsip show endpoint 1001

Muestra una lista de todos los registros configurados en pjsip

pjsip show registrations

Muestra todos los AORs (Address of Record) configurados

pjsip show aors

Muestra información detallada de un AOR específico

pjsip show aor 1001

Muestra todas las configuraciones de autenticación

pjsip show auths

Muestra los transportes configurados

pjsip show transports

Muestra una lista de todas las suscripciones

pjsip show subscriptions inbound
pjsip show subscriptions outbound

Recarga la configuración PJSIP

pjsip reload

Habilita la captura de paquetes SIP en formato PCAP

pjsip set logger pcap /tmp/packets.cap

Deshabilita la captura de paquetes

pjsip set logger pcap off

3.2.- Comandos Básicos del Core

Muestra la versión de Asterisk

core show version

Muestra todos los canales activos

core show channels

Muestra información detallada de un canal específico

core show channel <nombre_del_canal>

Muestra todos los códecs disponibles

core show codecs

Muestra el estado del sistema

core show uptime

Reinicia Asterisk con precaución (espera a que no haya llamadas)

core restart gracefully

Detiene Asterisk con precaución

core stop gracefully

Detiene Asterisk inmediatamente

core stop now

Reinicia Asterisk inmediatamente

core restart now

3.3.- Comandos del Dialplan

Muestra todo el plan de marcación

dialplan show

Muestra un contexto específico

dialplan show internal

Muestra una extensión específica

dialplan show 1001@internal

Recarga solo las extensiones del dialplan

dialplan reload

3.4.- Comandos de Monitoreo y Debugging

Aumenta el nivel de verbose (detalle) temporalmente

core set verbose 5

Habilita debugging para PJSIP

pjsip set logger on

Deshabilita debugging para PJSIP

pjsip set logger off

Muestra estadísticas de llamadas

core show calls

Muestra aplicaciones disponibles

core show applications

Muestra funciones disponibles

core show functions

3.5.- Comandos para IAX2

Si tienes IAX2 habilitado para interconectar servidores Asterisk:

# Recarga la configuración IAX2
iax2 reload

# Muestra los canales IAX2 activos
iax2 show channels

# Muestra los peers IAX2
iax2 show peers

3.6.- Comandos del Manager (AMI)

Muestra los comandos disponibles del Manager

manager show commands

Muestra usuarios conectados al Manager

manager show connected

3.7.- Opciones de Línea de Comandos

Propiedades que pueden pasarse al comando “asterisk”:

-h : Muestra todas las opciones posibles
-V : Muestra la versión de Asterisk
-c : Lanza Asterisk en primer plano como aplicación
-d : Un nivel de debug. Puedes usar múltiples 'd' para más detalle
-v : Un nivel de verbose. Puedes usar múltiples 'v' para más detalle
-r : Conecta al CLI de un demonio Asterisk en ejecución
-x 'cmd' : Ejecuta un comando específico y sale
-T : Añade marcas de tiempo a cada registro en la CLI

Estas propiedades pueden combinarse. Por ejemplo, para tener 5 niveles de detalle (verbose), 3 niveles de debug, marcas de tiempo, y acceder al proceso en curso:

asterisk -rvvvvvdddT

3.8.- Comandos Útiles para Troubleshooting

Ejecutar un comando específico desde la shell de Linux:

asterisk -rx "pjsip show endpoints"

Ver logs en tiempo real:

tail -f /var/log/asterisk/messages

Verificar si Asterisk está corriendo:

systemctl status asterisk

Reiniciar el servicio de Asterisk:

systemctl restart asterisk

3.9.- Comandos Específicos para el Proyecto de IA

Para nuestro proyecto de análisis de sentimiento, estos comandos serán especialmente útiles:

Verificar grabaciones activas:

core show calls

Mostrar información de MixMonitor:

mixmonitor list

Verificar el estado de los archivos de audio:

core show file formats

Nota Importante: En Asterisk 22, todos los comandos relacionados con chan_sip (como sip show peers) ya no existen. Todo el manejo SIP se realiza a través de los comandos pjsip.

Recursos Adicionales

Para una lista completa de comandos, puedes consultar:

• Documentación oficial de Asterisk
• Asterisk CLI Commands

---

✅ Checklist Final del Taller

• Acceso al CLI de Asterisk con niveles de verbose (asterisk -rvvv)
• Listado y verificación de endpoints PJSIP (pjsip show endpoints)
• Revisión de canales activos (core show channels)
• Recarga de dialplan sin reinicio (dialplan reload)
• Activación y desactivación de logger PJSIP (pjsip set logger on/off)

Tip de validación rápida

Usa asterisk -rx "core show version" y systemctl status asterisk para validar versión y estado del servicio.

---

🧰 Resumen de Comandos Clave

Tarea	Comando
Entrar al CLI con verbose	asterisk -rvvv
Ver endpoints PJSIP	pjsip show endpoints
Ver detalle de un endpoint	pjsip show endpoint <ext>
Ver AORs / Auth / Transports	pjsip show aors / pjsip show auths / pjsip show transports
Recargar PJSIP	pjsip reload
Logger PJSIP	pjsip set logger on / off
Canales activos	core show channels
Uptime del sistema Asterisk	core show uptime
Reinicio/Detención seguros	core restart gracefully / core stop gracefully
Ejecutar comando desde shell	asterisk -rx "<comando>"

---

🚀 Próximo Paso

Continúa con el siguiente taller para construir tu PBX Básica con PJSIP:

👉 Ir al Taller 4: PBX Básica con PJSIP