asterisk安装调试文档

Asterisk安装:

安装命令: yum instll asterisk

这个命令安装的普通的release版本

如果需要调试:

到SVN下载asterisk-1.8.8.1上传到虚拟机上

执行./configure --配置makefile文件

Make --编译asterisk

Make install --安装asterisk

Asterisk一般配置

用户配置:用户是在数据库中配置的

相关配置文件:

1.extconfig.conf,配置用户数据来源

sipusers => mysql,global,soc_pbx_users;

sippeers => mysql,general,soc_pbx_users;

mysql:固定，是指用户加载方式

general:对接res_mysql.conf的数据库连接配置

soc_pbx_users：用户所在的表

2.res_mysql.conf配置数据库连接串

[general]

dbhost = 10.1.18.105数据库地址

dbname = asterisk 数据库表空间

dbuser = asterisk 数据库用户名

dbpass = asterisk 数据库密码

dbport = 3306 数据库端口

话单配置: 如不需要话单，可以不配置该项

配置文件:cdr_mysql.conf

配置项:

[general] 和extconfig.conf中配置对应

dbhost = 10.1.18.105数据库地址

dbname = asterisk 数据库表空间

dbuser = asterisk 数据库用户名

dbpass = asterisk 数据库密码

dbport = 3306 数据库端口

[produre] 标志调用存储过程配置项

produrename=p_insert_record存储过程名次

paraNum=7 存储过程参数

paraname1=src 下面是存储过程参数列表,值需要对应cdr的关键字paraname2=dst

paraname3=dcontext

paraname4=clid

paraname5=channel

paraname6=dstchannel

拨号方案配置:

[default-test] --对应USER表中的context字段

exten => _XXX.,1,Set(CALLFILENAME=${CALLERID(num)}_${EXTEN}_${UNIQUEID})

exten => _XXX.,n,Dial(SIP/${EXTEN},10,m)

exten => _XXX.,n,Hangup()

运行命令: service asterisk start 开始

Service asterisk stop 停止

Service asterisk restart 重启

调试步骤:

1.执行gdb asterisk

2.由于涉及到动态库调用，在asterisk主程序中可能没有涉及到所需要调试的代码，所以需要

先预先找到所涉及的代码路径,代码文件名称,需要断点的行数

执行 b chan_sip.c:20333 b 是break简称chan_sip.c文件名20333行号

可能会提示:No source file named chan_sip.c.

Make breakpoint pending on future shared library load? (y or [n])

选y

执行info break可以看到当前断点列表,如下

Num Type Disp Enb Address What

1 breakpoint keep y chan_sip.c:20333

3.运行程序

Run -vvvvvvvvg -vvvvvvg是程序运行阐述

4.使用软终端调用服务，确保调用流程可以走到所设立的断点处

Gdb命令

N单步执行

C 执行到下一个断点，如果只有一个断点，直接走完liuc

S 进入到函数中执行

Bt 查看进程调用堆栈，可以直观的看到程序调用路径

P变量名限制变量的值

一.ASTERISK各个模块功能介绍:

内核模块

内部核心由以下六个部分组成：PBX交换核心模块(PBX Switching Core)、调度和I/O管理模块(Scheduler and I/O Manager)、应用调用模块(Application Launcher)、编解码转换模块(Codec Translator)、动态模块加载器模块(Dynamic Module Loader)和CDR生成模块(CDR Core)。

pbx.c是asterisk的核心模块，每路呼叫都需要经过它调度。pbx实现了builtin applications，也就是内置的应用，比如最常见的Answer,Hangup, Background,Wait等等。

pbx_exec是Answer/BackGround/Busy/Goto/GotoIf/Hangup/Set等builtin applications的执行入口函数，它被pbx_extension_helper调用

Channel.c/channel.h定义了channel操作的结构体和接口函数。

struct ast_channel_tech结构体是所有channel都要用到的关键结构体，它定义channel操作的一系列回调函数指针，如call、hangup、answer等。每个channel模块都会定义ast_channel_tech的实体，并将各自的回调函数赋值给它

1.编码解释器CodecInterpreter

音频采样率、音频的输入格式

CODE_开头的

2.文件格式处理器File Format Handler

它能处理某种具有待定扩展名的文件，比如说".wav"。同时，

它还说明读取文件之后，将以编码X的形式提供音频。如果它还提供写文件的能力，那么它还必须说明用它写文件的音频编码要求

(即说明它能把什么编码格式的音频编码写成带什么扩展名的文件)。

format_开头的

3.CDR处理器话单处理

通话记录的功能。这些记录在呼叫处理过程中建立，并缓存在数据结构里。在通话结束时，这些数据结构将被释

放。在记录丢弃之前，这些数据会传给已注册的CDR处理器。而处理器则会把记录写入文件或存入DB

CDR_开头的

4.CEL处理器

Asterisk内核实现了一个通用的事件系统，这个系统允许Asterisk组件报告事件，订阅事件。呼叫事件记录(CEL)就是建立在事件系统之上的一个应用。

CEL和CDR有点类似，它们都跟踪通话历史记录。通常CDR记录和呼叫是一一对应的关系；而CEL事件和通话则是多对一的关系。CEL模块和

CDR模块看起来很相似

CEL_开头的

5.拨号计划应用(APP)

app实现Asterisk拨号方案中可以与呼叫交互的功能

APP_开头的

6.拨号计划功能(FUN)

FUN和APP相同，是提供给Asterisk拨号方案用的

FUN_开头的

二.ASTERISK的CDR功能流程:

挂机调用ast_hangup()

->ast_cdr_detach(chan->cdr); 将话单插入到batch单向列表中,向调度器中插入事件，回

调submit_scheduled_batch函数,唤醒cdr_pending_cond条件

--结束;

CDR.C编译进主函数中，启动后即启动线程do_cdr

do_cdr是一个死循环,阻塞等待调度事件,等待cdr_pending_cond条件

满足条件后运行调度事件的回调函数

submit_scheduled_batch()

->ast_cdr_submit_batch()

该函数从batch单向列表中取出所有话单,作为参数,单起一个线程,记录话单->do_batch_backend_process()

->post_cdr(struct ast_cdr *cdr)该函数循环所有的记录话单方法be_list记录话单

be_list:加载的所有话单记录模块都会向这个列表注册自己的话单记录回调函数

MYSQL话单记录方法解析:

该模块可以使用asterisk-addons-1.6.1.1中的cdr_addons_mysql.so模块,也可以使用Asterisk自带的cdr_mysql.so模块,两者逻辑都是相同的

该模块加载时候，读取cdr_mysql.conf的数据库配置

典型配置

[global]

hostname=10.1.18.105

dbname=asterisk

table=cdr

password=asterisk

user=asterisk

port=3306

连接数据库，保持一个静态的数据库连接,由于是多线程服务器，所以每次使用该连接,

都必须加锁

执行SQL语句:DESC TABLE;

得到配置文件中配置的表的所有列名,把所有的列配置放入columns列表中

线程调用MYSQL_LOG()记录话单

循环columns列表,根据名字去CDR话单中匹配该KEY值

根据列名和KEY值组合SQL语句,执行SQL语句，即可记录话单;

现在流程改为MYSQL_LOG()直接调用一个存储过程去记录话单

拨号方案调用CGI流程，CGI和数据库中间件交互流程:

三.SIP协议invite:

1.INVITE调用函数handle_request_invite(),

2.检查invite包的headers中是否有Require。最好是没有，如果有的话也必须是Replaces，

其它的不支持一律不予处理.

3.接下来检查headers中是否有Replaces，如果有则做相关处理。由于调试中很少涉及这种需求，则略过。

4.开始验证sip user的合法性，check_user()调用check_user_full()函数，该函数从heades 中的from中取出用户名并在sip user list 和sip peer list中匹配，如果没找着，再查看是否允许guest，如果不允许，则认证通不过。

5.检查sip包中是否有SDP信息，如: application/sdp，SIP包中使用它来描述语音流协议的细节，比如某端所支持的编码

if (find_sdp(req)) {

if (process_sdp(p, req)) {

6.检查该用户的并行拨打电话数有没有达到上限。

if ((res = update_call_counter(p, INC_CALL_LIMIT))) {

7.查找对应的extension,如果没有对应的extension，则从extension s开始执行（extension s是默认的extension，s表示start）

gotdest = get_destination(p, NULL); /* Get destination right away */

8.调用sip_new()创建channel,这时候是incoming call。当调用dial()发起outbound call时asterisk pbx根据注册的回调函数sip_request_call()同样进入到sip_new中创建channel

c = sip_new(p, AST_STATE_DOWN, S_OR(p->username, NULL));

9.在sip_new()中调用ast_pbx_start(),该函数启动一个独立线程负责这个channel,线程函数是pbx_thread(),pbx_thread()调用__ast_pbx_run()函数。

res = ast_pbx_start(c);

10.__ast_pbx_run()函数allocate 一个pbx结构和cdr结构，并把它们的指针保存到ast_channel结构的pbx域和cdr域。随后执行拨号方案.

11. handle_request_bye()函数，这个函数比较简单，它在收到BYE包时被触发，首先记录下rtp，vrtp的qos到channel内置变量，调用stop_media_flows(p)结束rtp流，调用ast_queue_hangup(p->owner)进行挂断操作，调用transmit_response(p, "200 OK", req)返回200 OK消息。其中ast_queue_hangup()调用ast_queue_frame()在ast_channel结构的ast_frame队列里插入一个HANGUP的帧。

四.SIP注册功能实现:

1.REGISTER调用handle_request_register();

2.调用if ((res = register_verify(p, addr, req, e)) < 0)

3.通过解析register请求的to头域解析出注册的用户名及注册域名，

ast_copy_string(tmp, get_header(req, "T o"), sizeof(tmp));

4.peer = find_peer(name, NULL, TRUE, FINDPEERS, FALSE, 0);

sip_find_peer首先在内存里找用户，peers 容器在内存中保存所有注册用户，找不到会查询数据库。对于在sip.conf 中添加的用户在系统启动时会自动加载到peers容器，所以不会查找数据库，如果sip.conf中没有配置用户，但realtime engine存在，则会查找数据库表

p = realtime_peer(peer, addr, devstate_only, which_objects);

加载的表在extconfig.conf中可以配置，现在配置如下

sipusers => mysql,global,soc_pbx_users;

表明该用户是通过mysql资源中的global标志的数据库连接查询soc_pbx_users用户res_config_mysql模块向内核注册如下结构体

static struct ast_conf ig_engin e mysq l_engin e = {

.name = "mysql",

.lo ad_func = conf ig_mysq l,

.realtim e_func = realtime_mysql,

.realtim e_mu lti_fu nc = r ealtime_mult i_mysq l,

.store_func = stor e_mysql,

.destroy_func = d estroy_mysql,

.upd ate_func = up date_mysql,

.upd ate2_f unc = upd ate2_mysql,

.requ ire_func = req uire_mysql,

.unload_f unc = unload_mysql,

};

配置中的资源名通过注册的.name = "mysql"，来查找，

res_config_mysql涉及的配置文件是res_config_mysql.conf或者res_mysql.conf，配置如下

[gen eral]--对应extconf ig.con f中的配置mysql,glob al,soc_p bx_us ers

dbhost = 10.1.18.105

dbn ame = asterisk

dbus er = asterisk

dbp ass = ast erisk

dbport = 3306

5.当找到用户后，验证用户：

check_auth

第一次注册包

REGI STER s ip:10.1.18.105 SIP/2.0

Via: SI P/2.0/UD P 10.1.16.112:1152;branch=z9h G4bK-d87543-9c1c197d822c3232-1--d87543-;rport

Max-Forwards: 70

Contact:

To: "8002"

From: "8002";tag=1c4a904b

Call-ID: YzI2OTcxMm E4N2JiODI1N2UwMTMwM WFh YjViY TQzMTc.

CSeq: 1 R EGISTER

Expires: 3600

Allow: INVITE, ACK, C ANCEL, OPTIONS, B YE, R EFER, NOTIFY, M ESSAGE, SUB SCRIB E, INFO

User-Ag ent: eyeBeam releas e 1004p stamp 31962

Content-L ength: 0

对于第一次注册，服务器会返回401,未验证响应：

SIP/2.0 401 Un authorized

Via: SI P/2.0/UD P 10.1.16.112:1152;branch=z9h G4bK-d87543-9c1c197d822c3232-1--d87543-;rec eiv ed=10.1.16.112;rport=1152

From: "8002";tag=1c4a904b

To: "8002";t ag=as0c8d3b26

Call-ID: YzI2OTcxMm E4N2JiODI1N2UwMTMwM WFh YjViY TQzMTc.

CSeq: 1 R EGISTER

Server: Asterisk P BX 1.8.8.1

Allow: INVITE, ACK, C ANCEL, OPTIONS, B YE, R EFER, SUBSCRIB E, NO TIFY, INFO, P UBLI SH

Supported: replaces, timer

WWW-Authentic ate: D igest algor ithm=M D5, realm="asterisk", no nce="4c3645d6"

Content-L ength: 0

服务器会在sip消息头添加WWW-Authenticate头，采用MD5验证，设置服务器所属realm及一个nonce值。nonce值用来给客户端产生验证串

WWW-Authentic ate: D igest algor ithm=M D5, realm="asterisk", no nce="4c3645d6"

客户端收到401 未认证后添加消息头Authorization: 相应字段。

REGI STER s ip:10.1.18.105 SIP/2.0

Via: SI P/2.0/UD P 10.1.16.112:1152;branch=z9h G4bK-d87543-427b4216f65d9b1a-1--d87543-;rport

Max-Forwards: 70

Contact:

To: "8002"

From: "8002";tag=1c4a904b

Call-ID: YzI2OTcxMm E4N2JiODI1N2UwMTMwM WFh YjViY TQzMTc.

CSeq: 2 R EGISTER

Expires: 3600

Allow: INVITE, ACK, C ANCEL, OPTIONS, B YE, R EFER, NOTIFY, M ESSAGE, SUB SCRIB E, INFO

User-Ag ent: eyeBeam releas e 1004p stamp 31962

Authoriz ation: D igest u sern ame="8002",realm="asterisk",no nce="4c3645d6",uri="sip:10.1.18.105",respon se="799d1c92e23af06e853cea2ac49d86bc",algor ithm=M D5 Content-L ength: 0

客户端需要复制服务器响应的nonce值，realm,并添加username,uri, responce字段。

Response是客户端根据服务端给的NONCE经过一系列MD5处理所生成的验证串Authoriz ation: D igest u sern ame="8002",realm="asterisk",no nce="4c3645d6",uri="sip:10.1.18.105",respon se="799d1c92e23af06e853cea2ac49d86bc",algor ithm=M D5

服务端根据找到的用户中所保存的密码，将此密码和用户，域等组合后MD5加密后与客户端传过来的认证串RESPONSE对比,

认证成功后服务器会给客户端返回200ok响应，其中contact头域标明服务器端保存的客户端地址，某一时刻如果有呼叫到此客户端服务器则根据此地址想此客户端发送请求。

SIP/2.0 200 OK

Via: SI P/2.0/UD P 10.1.16.112:1152;branch=z9h G4bK-d87543-427b4216f65d9b1a-1--d87543-;received=10.1.16.112;rport=1152

From: "8002";tag=1c4a904b

To: "8002";t ag=as0c8d3b26

Call-ID: YzI2OTcxMm E4N2JiODI1N2UwMTMwM WFh YjViY TQzMTc.

CSeq: 2 R EGISTER

Server: Asterisk P BX 1.8.8.1

Allow: INVITE, ACK, C ANCEL, OPTIONS, B YE, R EFER, SUBSCRIB E, NO TIFY, INFO, PUBLI SH

Supported: replaces, timer

Expires: 3600

Contact: ;expir es=3600

Date: Tu e, 18 Dec 2012 02:09:01 GM T

Content-L ength: 0

通常客户端注册成功后服务器在contact头域会添加expires 参数，或者添加Expire头，表明此注册的有效时间，

超过此时间服务器会销毁此注册的有效性，所以客户端在注册成功后要启动周期注册功能，每隔expires指定时间发起注册，这通常通过定时器来实现