{"id":625,"date":"2014-06-30T14:39:05","date_gmt":"2014-06-30T12:39:05","guid":{"rendered":""},"modified":"2018-10-31T22:36:32","modified_gmt":"2018-10-31T21:36:32","slug":"installing-webrtc2sip-gateway-tutorial","status":"publish","type":"post","link":"https:\/\/nil.uniza.sk\/en\/installing-webrtc2sip-gateway-tutorial\/","title":{"rendered":"Installing WebRTC2SIP gateway – tutorial"},"content":{"rendered":"

\n\tSystem preparation <\/strong><\/h1>\n
\r\napt-get update<\/em>\r\napt-get upgrade<\/em><\/pre>\n
\n\tAs the first step we need to install packages necessary to build the main webrtc2sip gateway:<\/p>\n
\r\napt-get install build essential libtool<\/em> automake<\/em> subversion<\/em> git<\/em> pkg-config<\/em> screen<\/em> libxml2-dev<\/em> \/ \r\nlibssl-dev<\/em> libsrtp0-dev<\/em><\/pre>\n
\n\tto support for libspeex (audio codec) and libspeexdsp (audio processing and jitter buffer) add<\/p>\n
\r\napt-get install libspeexdsp-dev<\/em><\/pre>\n
\n\tadding support for VP8<\/p>\n
\r\napt-get install libvpx-dev<\/em><\/pre>\n
\n\tadds support for H.264 video codec (requires FFmpeg)<\/p>\n
\r\napt-get install libx264-dev<\/em><\/pre>\n
\n\tadding support for GSM audio codec<\/p>\n
\r\napt-get install libgsm1-dev<\/em><\/pre>\n
\n\tOther software components<\/h1>\n
\n\tOpenSSL<\/strong><\/h2>\n
\n\tIf we are planning to support for DTLS, we need at least 1.0.1 version of OpenSSL, which supports for DTLS.<\/p>\n
\n\tWe can check our installed version with:<\/p>\n
\r\n                openssl version<\/em><\/pre>\n
\n\t <\/p>\n
\n\tYASM<\/strong><\/h2>\n
\n\tYASM <\/strong>is required if we are planning to support VP8 or H.264 codecs. To do that we need:<\/p>\n
\r\nwget http:\/\/www.tortall.net\/projects\/yasm\/releases\/yasm-1.2.0.tar.gz<\/em>\r\ntar -xvzf yasm-1.2.0.tar.gz<\/em>\r\ncd yasm-1.2.0<\/em>\r\n.\/configure && make && make install<\/em><\/pre>\n
\n\tOpus<\/h2>\n
\n\tOpus<\/strong> is MTI codec for WebRTC. It adds support for Opus audio codec.<\/p>\n
\r\nwget http:\/\/downloads.xiph.org\/releases\/opus\/opus-1.1.tar.gz<\/em>\r\ntar -xvzf opus-1.1.tar.gz<\/em>\r\ncd opus-1.1<\/em>\r\n.\/configure --with-pic --enable-float-approx && make && make install<\/em><\/pre>\n
\n\tffmpeg<\/strong><\/h2>\n
\n\tDoubango needs the original development headers and libraries. Some distributions of Linux have library named libav<\/em>. It is something like ffmpeg but Doubango won’t build against this library therefore we need unninstall it:<\/p>\n
\r\n                apt-get remove libavutil51<\/em><\/pre>\n
\n\tThen we should continue with installing ffmpeg. We recommend to install the version of 1.0.2, because using a newer version (march 2014) there are some errors during the building of Doubango.<\/p>\n
\r\ncd \/usr\/local\/src<\/em>\r\nwget -c http:\/\/ffmpeg.org\/releases\/ffmpeg-1.0.2.tar.gz<\/em>\r\ntar zxvf ffmpeg-1.0.2.tar.gz<\/em>\r\ncd ffmpeg<\/em>\r\n.\/configure --extra-cflags="-fPIC" --extra-ldflags="-lpthread" --enable-pic \\<\/em>\r\n--enable-memalign-hack --enable-shared --disable-static --disable-network \\<\/em>\r\n--disable-protocols --disable-pthreads --disable-devices --disable-filters \\<\/em>\r\n--disable-bsfs --disable-muxers --disable-demuxers --disable-parsers \\<\/em>\r\n--disable-hwaccels --disable-ffmpeg --disable-ffplay --disable-ffserver \\<\/em>\r\n--disable-encoders --disable-decoders --disable-zlib --enable-gpl --disable-debug \\<\/em>\r\n--enable-encoder=h263 --enable-encoder=h263p --enable-decoder=h263 \\<\/em>\r\n--enable-encoder=mpeg4 --enable-decoder=mpeg4 --enable-libx264 \\<\/em>\r\n--enable-encoder=libx264 --enable-decoder=h264<\/em>\r\nmake <\/em>\r\nmake install<\/em>\r\nldconfig<\/em><\/pre>\n
\n\t <\/p>\n
\n\tDoubango<\/strong><\/h2>\n
\n\tWe use svn to pull in a recent checkout and then install.<\/p>\n
\r\ncd \/usr\/local\/src<\/em>\r\nsvn co http:\/\/doubango.googlecode.com\/svn\/branches\/2.0\/doubango doubango<\/em>\r\ncd doubango<\/em>\r\nsed -i '1,\/==\/s\/==\/=\/' autogen.sh<\/em>\r\n.\/autogen.sh<\/em>\r\n.\/configure --with-ssl --with-srtp --with-vpx --with-speex --with-speexdsp \\<\/em>\r\n--enable-speexresampler --enable-speexjb --enable-speexdenoiser --with-gsm \\<\/em>\r\n--with-ffmpeg --with-opus --with-h264 --prefix=\/usr\/local<\/em>\r\nmake <\/em>\r\nmake install<\/em>\r\nldconfig<\/em><\/pre>\n
\n\t <\/p>\n
\n\tWebrtc2sip<\/strong><\/h2>\n
\n\tIf we have successfully installed doubango then we can build an install webrtc2sip.<\/p>\n
\r\ncd \/usr\/local\/src<\/em>\r\nsvn co http:\/\/webrtc2sip.googlecode.com\/svn\/trunk\/ webrtc2sip<\/em>\r\ncd webrtc2sip<\/em>\r\nsed -i '1,\/==\/s\/==\/=\/' autogen.sh<\/em>\r\n.\/autogen.sh<\/em>\r\n.\/configure --with-doubango=\/usr\/local --prefix=\/usr\/local<\/em>\r\nmake<\/em>\r\nmake install<\/em>\r\nmkdir -p \/usr\/local\/etc\/webrtc2sip<\/em>\r\ncp config.xml \/usr\/local\/etc\/webrtc2sip\/<\/em><\/pre>\n
\n\tThen we have to customize confug file. It is located within directory \/usr\/local\/etc\/webrtc2sip\/<\/em><\/p>\n
\n\tFor better understanding of all options we recommend to read technical guide, which is available on link:<\/p>\n
\n\thttp:\/\/webrtc2sip.org\/technical-guide-1.0.pdf<\/a><\/p>\n
\n\tOnce we have finished with editing of the config file we may start webrtc2sip as daemon using the command:<\/p>\n
\r\nscreen -dmS webrtc2sip webrtc2sip --config=\/usr\/local\/etc\/webrtc2sip\/config.xml<\/em><\/pre>\n
\n\tIf we want see terminal of webrtc2sip:<\/p>\n
\r\nscreen -r webrtc2sip<\/em><\/pre>\n
\n\tTo be sure that webrtc2sip is listening on defined port we can check it with command:<\/p>\n
\r\nnetstat –tupln<\/em><\/pre>\n
\n\t <\/p>\n
\n\tTo add support webrtc2sip for DTLS we need SSL certificates. To get needed self signed certs you can follow this guides:<\/p>\n
\n\thttp:\/\/codeghar.wordpress.com\/2013\/04\/16\/create-private-certificate-authority-on-linux\/<\/a><\/p>\n
\n\thttp:\/\/codeghar.wordpress.com\/2013\/04\/16\/generate-certificate-signing-request-on-linux\/<\/a><\/p>\n
\n\thttp:\/\/codeghar.wordpress.com\/2013\/04\/16\/use-private-certificate-authority-to-sign-certificate-signing-request-on-linux\/<\/a><\/p>\n
\n\t <\/p>\n
\n\tFrom things which you created in previous steps, configuration for the ssl-certificates in config.xml can look like this:<\/p>\n
\r\n<ssl-certificates><\/em>\r\n                              \/home\/user\/mycert\/private\/key.csr.server1.pem; <!-- private key --><\/em>\r\n                               \/home\/user\/myca\/certs\/crt.server1.pem; <!-- self signed certificate --><\/em>\r\n                               *; <!--or  \/home\/user\/myca\/certs\/crt.ca.cg.pem; --><\/em>\r\n                               no                 <\/em>\r\n<\/ssl-certificates><\/em><\/pre>\n
\n\t <\/p>\n
\n\tAuthor: Patrik Formanek 2014<\/p>\n
\n\t <\/p>","protected":false},"excerpt":{"rendered":"
\n\tSystem preparation <\/strong><\/h1>\n
\r\napt-get update<\/em>\r\napt-get upgrade<\/em><\/pre>\n
\n\tAs the first step we need to install packages necessary to build the main webrtc2sip gateway:<\/p>\n
\r\napt-get install build essential libtool<\/em> automake<\/em> subversion<\/em> git<\/em> pkg-config<\/em> screen<\/em> libxml2-dev<\/em> \/ \r\nlibssl-dev<\/em> libsrtp0-dev<\/em><\/pre>\n
\n\tto support for libspeex (audio codec) and libspeexdsp (audio processing and jitter buffer) add<\/p>","protected":false},"author":7,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","_kad_blocks_custom_css":"","_kad_blocks_head_custom_js":"","_kad_blocks_body_custom_js":"","_kad_blocks_footer_custom_js":"","_kad_post_transparent":"","_kad_post_title":"","_kad_post_layout":"","_kad_post_sidebar_id":"","_kad_post_content_style":"","_kad_post_vertical_padding":"","_kad_post_feature":"","_kad_post_feature_position":"","_kad_post_header":false,"_kad_post_footer":false,"footnotes":""},"categories":[771],"tags":[],"class_list":["post-625","post","type-post","status-publish","format-standard","hentry","category-sip-en"],"taxonomy_info":{"category":[{"value":771,"label":"SIP"}]},"featured_image_src_large":false,"author_info":{"display_name":"admin","author_link":"https:\/\/nil.uniza.sk\/en\/author\/admin\/"},"comment_info":8,"category_info":[{"term_id":771,"name":"SIP","slug":"sip-en","term_group":0,"term_taxonomy_id":769,"taxonomy":"category","description":"","parent":0,"count":23,"filter":"raw","cat_ID":771,"category_count":23,"category_description":"","cat_name":"SIP","category_nicename":"sip-en","category_parent":0}],"tag_info":false,"_links":{"self":[{"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/posts\/625","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/users\/7"}],"replies":[{"embeddable":true,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/comments?post=625"}],"version-history":[{"count":0,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/posts\/625\/revisions"}],"wp:attachment":[{"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/media?parent=625"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/categories?post=625"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/nil.uniza.sk\/en\/wp-json\/wp\/v2\/tags?post=625"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}