ReSIProcate之编译、安装、配置、运行、测试proxy

我使用了vs2008编译器，下载的最新版本ReSIProcate 1.51，在windows 7下编译

编译

 

Build->Configuration Manager钩掉basicCall,basicMessage,basicRegister,还有resip_test，接着Build Solution.

我用vs2008编译，有一处错误，AresDns Line 158，WarningLog之间使用条件编译不认识#字符

 

由

WarningLog (<< "Ignoring non-IPv4 additional name server " #if defined(USE_CARES) "(not yet supported with c-ares)" #elif defined(USE_ARES) "(IPv6 support was not enabled)" #endif );

 

改为

#if defined(USE_CARES) WarningLog (<< "Ignoring non-IPv4 additional name server " "(not yet supported with c-ares)"); #elif defined(USE_ARES) WarningLog (<< "Ignoring non-IPv4 additional name server " "(IPv6 support was not enabled)"); #endif

 

注意：在Linux下编译，需要预先安装些外部库，在Ubuntu下运行参考文章中的命令：

 

sudo aptitude update; sudo aptitude install subversion g++ gperf libssl-dev libpopt-dev libpcre3-dev libdb4.2++-dev libboost-dev

 

安装运行resiprocate的proxy

运行 /repro/WinSetup/Debug/Setup.msi，默认安装到文件夹C:/Program Files/ReSiprocate

vs 2008 的repro project 属性修改：

Debugging Command 定位到repro可执行文件安装路径，默认设置为C:/Program Files/ReSiprocate/repro.exe

Build Events->Post-Build Event->Command Line设置为copy "$(TargetPath)" "C:/Program Files/ReproSIPProxy"

至此编译resiprocate，copy至安装文件夹，即可运行repro了

运行repro,在浏览器中输入http://localhost:5080，点击login并输入用户名admin和密码admin登录。

 

配置resiprocate的proxy

这里仅仅谈谈windows下的配置

 

两种方式：一、配置文件，二、命令行参数

配置文件方式需要代码做些稍许变动，这里仅仅谈谈比较原装的命令行参数，主要是那些影响proxy运行的关键参数。

 

先谈谈命令行参数几种比较简单的实现方式

一、vs2008中repro项目属性，参数填写在Debugging->command Arguments

二、新建快捷方式，在Targets一栏中的可执行文件后面空一格在"-"之后填写参数

三、新建cmd文件，同二可执行文件后面空一个在"-"之后填写参数

 

具体参数解析可参考CommandLineParser类中，采用了popt外部库解析命令行参数

struct poptOption table[] = { {"log-type", 'l', POPT_ARG_STRING| POPT_ARGFLAG_SHOW_DEFAULT, &logType, 0, "where to send logging messages", "syslog|cerr|cout"}, {"log-level", 'v', POPT_ARG_STRING| POPT_ARGFLAG_SHOW_DEFAULT, &logLevel, 0, "specify the default log level", "STACK|DEBUG|INFO|WARNING|ALERT"}, {"db-path", 0, POPT_ARG_STRING, &dbPath, 0, "path to databases", 0}, {"record-route", 'r', POPT_ARG_STRING, &recordRouteUri, 0, "specify uri to use as Record-Route", "sip:example.com"}, {"force-record-route", 0, POPT_ARG_NONE, &forceRecordRoute, 0, "force record-routing", 0}, #if defined(USE_MYSQL) {"mysqlServer", 'x', POPT_ARG_STRING| POPT_ARGFLAG_SHOW_DEFAULT, &mySqlServer, 0, "enable MySQL and provide name of server", "localhost"}, #endif {"udp", 0, POPT_ARG_INT| POPT_ARGFLAG_SHOW_DEFAULT, &udpPort, 0, "listen on UDP port", "5060"}, {"tcp", 0, POPT_ARG_INT | POPT_ARGFLAG_SHOW_DEFAULT, &tcpPort, 0, "listen on TCP port", "5060"}, #if defined(USE_SSL) {"tls-domain", 't', POPT_ARG_STRING, &tlsDomain, 0, "act as a TLS server for specified domain", "example.com"}, {"tls", 0, POPT_ARG_INT | POPT_ARGFLAG_SHOW_DEFAULT, &tlsPort, 0, "add TLS transport on specified port", "5061"}, {"dtls", 0, POPT_ARG_INT | POPT_ARGFLAG_SHOW_DEFAULT, &dtlsPort, 0, "add DTLS transport on specified port", "0"}, {"enable-cert-server", 0, POPT_ARG_NONE, &certServer, 0, "run a cert server", 0}, #ifdef WIN32 {"cert-path", 'c', POPT_ARG_STRING| POPT_ARGFLAG_SHOW_DEFAULT, &certPath, 0, "path to certificates (default: c://sipCerts)", 0}, #else {"cert-path", 'c', POPT_ARG_STRING| POPT_ARGFLAG_SHOW_DEFAULT, &certPath, 0, "path to certificates (default: ~/.sipCerts)", 0}, #endif #endif {"enable-v6", 0, POPT_ARG_NONE, &enableV6, 0, "enable IPV6", 0}, {"disable-v4", 0, POPT_ARG_NONE, &disableV4, 0, "disable IPV4", 0}, {"disable-auth", 0, POPT_ARG_NONE, &noChallenge, 0, "disable DIGEST challenges", 0}, {"disable-auth-int", 0, POPT_ARG_NONE, &noAuthIntChallenge,0, "disable auth-int DIGEST challenges", 0}, {"reject-bad-nonces", 0, POPT_ARG_NONE, &rejectBadNonces,0, "Send 403 if a client sends a bad nonce in their credentials (will send a new challenge otherwise)", 0}, {"disable-web-auth", 0, POPT_ARG_NONE, &noWebChallenge, 0, "disable HTTP challenges", 0}, {"disable-reg", 0, POPT_ARG_NONE, &noRegistrar, 0, "disable registrar", 0}, {"disable-identity", 0, POPT_ARG_NONE, &noIdentityHeaders, 0, "disable adding identity headers", 0}, {"interfaces", 'i', POPT_ARG_STRING, &interfaces, 0, "specify interfaces to add transports to", "sip:10.1.1.1:5065;transport=tls;tls=tlsdomain.com"}, {"domains", 'd', POPT_ARG_STRING, &domains, 0, "specify domains that this proxy is authorative", "example.com,foo.com"}, {"route", 'R', POPT_ARG_STRING, &routeSet, 0, "specify where to route requests that are in this proxy's domain", "sip:p1.example.com,sip:p2.example.com"}, {"reqChainName", 0, POPT_ARG_STRING, &reqChainName, 0, "name of request chain (default: default)", 0}, {"http", 0, POPT_ARG_INT | POPT_ARGFLAG_SHOW_DEFAULT, &httpPort, 0, "run HTTP server on specified port", "5080"}, {"http-hostname", 0, POPT_ARG_STRING, &httpHostname, 0, "http hostname for this server (used in Identity headers)", 0}, {"recursive-redirect",0, POPT_ARG_NONE, &recursiveRedirect, 0, "Handle 3xx responses in the proxy", 0}, {"q-value", 0, POPT_ARG_NONE, &doQValue, 0, "Enable sequential q-value processing", 0}, {"q-value-behavior", 0, POPT_ARG_STRING, &forkBehavior, 0, "Specify forking behavior for q-value targets: FULL_SEQUENTIAL, EQUAL_Q_PARALLEL, or FULL_PARALLEL", 0}, {"q-value-cancel-btw-fork-groups",0,POPT_ARG_NONE, &cancelBetweenForkGroups, 0, "Whether to cancel groups of parallel forks after the period specified by the --q-value-ms-before-cancel parameter.", 0}, {"q-value-wait-for-terminate-btw-fork-groups",0,POPT_ARG_NONE, &waitForTerminate, 0, "Whether to wait for parallel fork groups to terminate before starting new fork-groups.", 0}, {"q-value-ms-between-fork-groups",0,POPT_ARG_INT, &msBetweenForkGroups, 0, "msec to wait before starting new groups of parallel forks", 0}, {"q-value-ms-before-cancel",0, POPT_ARG_INT, &msBeforeCancel, 0, "msec to wait before cancelling parallel fork groups", 0}, {"enum-suffix", 'e', POPT_ARG_STRING, &enumSuffix, 0, "specify enum suffix to search", "e164.arpa"}, {"allow-bad-reg", 'b', POPT_ARG_NONE, &allowBadReg, 0, "allow To tag in registrations", 0}, {"parallel-fork-static-routes",'p',POPT_ARG_NONE, &parallelForkStaticRoutes, 0, "paralled fork to all matching static routes and (first batch) registrations", 0}, {"timer-C", 0, POPT_ARG_INT, &timerC, 0, "specify length of timer C in sec (0 or negative will disable timer C)", "180"}, {"admin-password", 'a', POPT_ARG_STRING, &adminPassword, 0, "set web administrator password", ""}, {"disable-outbound",0, POPT_ARG_NONE, &outboundDisabled,0, "disable outbound support (draft-ietf-sip-outbound)", 0}, {"outbound-version",0, POPT_ARG_INT | POPT_ARGFLAG_SHOW_DEFAULT, &outboundVersion, 0, "set the version of outbound to support", "11"}, {"enable-flow-tokens",0, POPT_ARG_NONE, &rrTokenHackEnabled,0, "enable use of flow-tokens in non-outbound cases (This is a workaround, and it is broken. Only use it if you have to.)", 0}, {"version", 'V', POPT_ARG_NONE, &showVersion, 0, "show the version number and exit", 0}, POPT_AUTOHELP { NULL, 0, 0, NULL, 0 } };

 

[-parameter value] [-parameter value] ...

parameter为table每行第二个参数，而value参考每行最后一个参数,参数解释参考每行倒数第二个参数

如果某值第二个参数为0的话，需要直接在代码中设置值了

比如要设置log-type为vsdebugwindow，log-level为STACK的话，命令行参数就是

-l vsdebugwindow -v STACK

 

注意：ReSIProcate1.5版本，代码需要稍作修改才可以支持vsdebugwindow

Log::Type Log::toType(const Data& arg) { /* if (arg == "cout" || arg == "COUT") { return Log::Cout; } else if (arg == "cerr" || arg == "CERR") { return Log::Cerr; } else if (arg == "file" || arg == "FILE") { return Log::File; } else { return Log::Syslog; }*/ if (arg == "cout" || arg == "COUT") { return Log::Cout; } else if (arg == "cerr" || arg == "CERR") { return Log::Cerr; } else if (arg == "file" || arg == "FILE") { return Log::File; } else if (isEqualNoCase(arg , "VSDebugWindow") ) { return Log::VSDebugWindow; } else { return Log::Syslog; } }

 

void Log::initialize(const Data& typed, const Data& leveld, const Data& appName, const char *logFileName, ExternalLogger* externalLogger) { /*Type type = Log::Cout; if (isEqualNoCase(typed, "cout")) type = Log::Cout; else if (isEqualNoCase(typed, "cerr")) type = Log::Cerr; else if (isEqualNoCase(typed, "file")) type = Log::File; else type = Log::Syslog;*/ Type type = Log::Cout; type = toType(typed); Level level = Log::Info; level = toLevel(leveld); Log::initialize(type, level, appName, logFileName, externalLogger); }

 

一些参数的简单介绍

disable-auth  设置为true的话，电话注册可无需验证

record-route  设置的话，会话建立之后的sip信令依然从proxy走,当然要强制启用的话，得设置forceRecordRoute为true

 

测试resiprocate的proxy

如果手边比较方便的话，可以直接使用网关连接两个电话分机，或者用软电话，注册到proxy上，互相拨打。

也可以依照参考文章中的测试方法使用ReSIProcate自带的测试程序进行测试。

 

 

参考文章

http://www.resiprocate.org/Quick_Subversion_Checkout_and_Compilation_HOWTO#Unix_Systems_.28Including_OS_X.29

 

 

简单写了个纲要，还没有具体的测试