Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: updated @ 2023-08-09T10:08:35.394230
HTML
headtrue
encodingUTF-8
<!DOCTYPE html
  SYSTEM "about:legacy-compat">
<html lang="en"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><meta charset="UTF-8"><meta name="copyright" content="(C) Copyright 2023"><meta name="DC.rights.owner" content="(C) Copyright 2023"><meta name="DC.type" content="topic"><meta name="prodname" content="Sentinel units"><meta name="version" content="DGW 49.12.28842941"><meta name="platform" content=""><meta name="DC.date.modified" content="2023-0308-2809"><meta name="DC.date.issued" content="2023-0308-2809"><meta name="DC.date.available" content="2023-0308-2809"><meta name="ChapterNumbering" content="yno"><meta name="DC.format" content="HTML5"><meta name="DC.identifier" content="topic_title_Basic_Concepts_d1e14"><link href="https://fonts.googleapis.com/css?family=Open+Sans" rel="stylesheet"><link rel="stylesheet" type="text/css" href="https://documentation.media5corp.com/download/attachments/45482024/commonltr.css"><link rel="stylesheet" type="text/css" href="https://documentation.media5corp.com/download/attachments/45482024/custom.css"><title>Registering a SIP Account to an ITSP with a Sentinel</title></head><body class="nobody"><header role="banner"><div class="topicmeta title">Registering a SIP Account to an ITSP with a Sentinel </div><div class="topicmeta date">2023-0308-28<09</div><div class="topicmeta product">Sentinel units</div><div class="topicmeta version">DGW 49.12.2884<2941</div><div class="topicmeta pdf"><a href="https://documentation.media5corp.com/download/attachments/45482024/Registering%20a%20SIP%20Account%20to%20an%20ITSP%20with%20a%20Sentinel.pdf" rel="nofollow">Download PDF Document</a></div><hr><span style="float: inline-end;"></span></header><nav role="toc"><ul><li><a href="#topic_title_Basic_Concepts_d1e14">Basic Concepts</a><ul><li><a href="#concept_ltc_rtq_sr">Registration Agent</a></li><li><a href="#concept_w5x_qxd_lr">registration_ca Call Agent</a></li></ul></li><li><a href="#topic_title_Configuration_Tasks_d1e17">Configuration Tasks</a><ul><li><a href="#task_ohs_4mh_zhb">Configuring the Registration Call Agent</a></li><li><a href="#task_lmn_cfm_hq">Configuring a Registration Agent</a></li><li><a href="#task_ass_11g_hq">Configuring the wan_ip_trunk_ca Call Agent </a></li><li><a href="#task_zdg_vlx_bq">Associating the registration_to_wan_ip_trunk Routing Ruleset to your Configuration </a></li></ul></li><li><a href="#reference_j4g_nbv_gfb">Online Help</a></li><li><a href="#concept_v4k_q3h_1r">DGW Documentation</a></li><li><a href="#concept_fqm_rv4_k4">Copyright Notice</a></li></ul></nav><main role="main"><article role="article" aria-labelledby="ariaid-title1"><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="nested0" aria-labelledby="ariaid-title1" id="topic_title_Basic_Concepts_d1e14">
   <h1 class="title topictitle1" id="ariaid-title1">Basic Concepts</h1>
<article class="topic concept nested1" aria-labelledby="ariaid-title2" id="concept_ltc_rtq_sr">
 <h2 class="title topictitle2" id="ariaid-title2">Registration Agent</h2>
 
 <div class="body conbody"><p class="shortdesc">The Registration Agent is a feature that performs REGISTERs on behalf of other
  users.</p>
  <div class="p">In some use cases, using the Registration Agent may be necessary to have a separate entity
   perform the REGISTERs on behalf of users. For example: <ul class="ul" id="concept_ltc_rtq_sr__ul_o5d_vgs_sr">
    <li class="li">When users cannot register themselves.</li>
    <li class="li">To separate internal and external networks in Demarcation Point scenarios </li>
   </ul>The Registration Agent is only involved with the registrations it initiates. If the
   Registration Agent is used, its REGISTERs are routed to the Mediatrix unit via the
   registration_ca Call Agent. </div>
 </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic concept nested1" aria-labelledby="ariaid-title3" id="concept_w5x_qxd_lr">
 <h2 class="title topictitle2" id="ariaid-title3"><span class="keyword wintitle">registration_ca</span> Call Agent</h2>
 
 <div class="body conbody"><p class="shortdesc">The <span class="keyword wintitle">registration_ca</span> Call Agent
  is used to route the registrations issued by the Registration Agent. </p>
  <p class="p">The <span class="keyword wintitle">registration_ca</span> Call Agent should
   not be used for other purposes. The registrations issued by the Registration Agent must be routed
   from the <span class="keyword wintitle">registration_ca</span> to the Call
   Agent facing the destination Sip registrar (typically <span class="keyword wintitle">wan_ip_trunk_ca</span>_ca or <span class="keyword wintitle">secondary_ip_trunk_ca</span>).</p>
  <p class="p">The registration is routed using the User Name, Password and Domain to build the AOR and the
   R-URI . The Contact is the contact header of the registration, it should contain the IP-address
   or FQDN of the Mediatrix unit.</p>
  <div class="p">
   <br><img class="image" id="concept_w5x_qxd_lr__image_jnw_2wr_qr" src="https://documentation.media5corp.com/download/attachments/45482024/registrationCAflow.jpg" width="600"><br>
  </div>
 </div>
</article></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic nested0 nobody" aria-labelledby="ariaid-title4" id="topic_title_Configuration_Tasks_d1e17">
   <h1 class="title topictitle1" id="ariaid-title4">Configuration Tasks</h1>
<article class="topic task nested1" aria-labelledby="ariaid-title5" id="task_ohs_4mh_zhb">
    <h2 class="title topictitle2" id="ariaid-title5">Configuring the Registration Call Agent</h2>
    
    <div class="body taskbody"><p class="shortdesc">Associate the registration_ca Call Agent to the Registration Agent to route the
        registrations issued by the Registration Agent.</p>
        <section id="task_ohs_4mh_zhb__steps_gs1_smh_zhb"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_ohs_4mh_zhb__steps_gs1_smh_zhb"><li class="li step">
                <span class="ph cmd">Go to <span class="keyword wintitle">SBC</span>/<span class="keyword wintitle">Configuration</span>.</span>
            </li><li class="li step">
                <span class="ph cmd">In the <span class="keyword wintitle">Call Agent Configuration</span>,
                    click <img class="image" id="task_ohs_4mh_zhb__image_x2l_xmh_zhb" src="https://documentation.media5corp.com/download/attachments/45482024/pencilbleu.jpg" width="15"> located on the same line as <span class="keyword wintitle">registration_ca</span>.</span>
            </li><li class="li step">
                <span class="ph cmd">In the <span class="keyword wintitle">Configure Call Agent</span> table,
                    make sure the <span class="keyword wintitle">Enable</span>
                    checkbox is selected.</span>
            </li><li class="li step">
                <span class="ph cmd">From the <span class="keyword wintitle">Signaling Interface</span> selection
                    list, choose <span class="ph uicontrol">loop_s</span>.</span>
            </li><li class="li step">
                <span class="ph cmd">From the <span class="keyword wintitle">Media Interface</span> selection list, choose <span class="ph uicontrol">loop_m</span>.</span>
            </li><li class="li step">
                <span class="ph cmd">In the <span class="keyword wintitle">Peer Host</span>
                    field, enter 127.0.0.1:5060.</span>
            </li><li class="li step">
                <span class="ph cmd">Click <span class="keyword wintitle">Save</span>.</span>
            </li><li class="li step">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>
            <br><img class="image" id="task_ohs_4mh_zhb__image_qpl_k4h_zhb" src="https://documentation.media5corp.com/download/attachments/45482024/Configure_Call_Agent_Registration_CA_ISTP.png" width="800"><br>
        </section>
    </div>
<nav role="navigation" class="related-links"><div class="linklist relinfo reltasks"><div class="linklistlabel"><strong class="sectiontitle linklistlabel">Next Step</strong></div><ul class="linklist"><li class="linklist"><a class="link" href="#task_lmn_cfm_hq" title="Configure the registration agent used to issue the registrations.">Configuring a Registration Agent</a></li></ul></div></nav></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title6" id="task_lmn_cfm_hq">
    <h2 class="title topictitle2" id="ariaid-title6">Configuring a Registration Agent</h2>
    
    <div class="body taskbody"><p class="shortdesc">Configure the registration agent used to issue the registrations.</p>
        <section><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">SBC</span>/<span class="keyword wintitle">Registration</span>.</span>
            </li><li class="li step stepexpand" id="task_lmn_cfm_hq__2">
                <span class="ph cmd">In the <span class="keyword wintitle">Registration Agent Configuration</span> table, click <img class="image" id="task_lmn_cfm_hq__image_lrd_g3w_wr" src="https://documentation.media5corp.com/download/attachments/45482024/Plusbleu.jpg" width="14">.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> A new line of fields is added.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Complete the <span class="keyword wintitle">User Name</span>, <span class="keyword wintitle">Friendly Name</span>, and
                    <span class="keyword wintitle">Domain parameters</span>
                    fields according to the service provider's requirements.</span>
            </li><li class="li step stepexpand" id="task_lmn_cfm_hq__4">
                <span class="ph cmd">In the <span class="keyword wintitle">Contact</span> field,
                    enter <span class="keyword wintitle">sip:myUSERNAME@%capubip(wan_ip_trunk_ca)%</span>.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> <span class="keyword parmname">myUSERNAME</span> must be replaced by the SIP account </div>
                    <div class="note note note_note"><span class="note__title">Note:</span> <span class="keyword parmname">%capubip(wan_ip_trunk_ca)%</span> is a macro, which will be
                        automatically replaced by the IP address and port and prefixed by
                        sip:.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Registration Type</span> selection,
                    make sure <span class="keyword wintitle">Normal</span> is
                    selected.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">If necessary, repeat <a class="xref" href="#task_lmn_cfm_hq__2">step 2
                </a> to <a class="xref" href="#task_lmn_cfm_hq__4">step 4 </a> if you
                    are using more than one service provider.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span>.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div><img class="image" id="task_lmn_cfm_hq__image_wky_sfg_v5" src="https://documentation.media5corp.com/download/attachments/45482024/RegistrationAgentConfiguration_edge.png"></section>
    </div>
<nav role="navigation" class="related-links"><div class="linklist relinfo reltasks"><div class="linklistlabel"><strong class="sectiontitle linklistlabel">Next Step</strong></div><ul class="linklist"><li class="linklist"><a class="link" href="#task_ass_11g_hq" title="Associate the Call Agent used to route VoIP Calls to the ITSP.">Configuring the wan_ip_trunk_ca Call Agent</a></li></ul></div></nav></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title7" id="task_ass_11g_hq">
    <h2 class="title topictitle2" id="ariaid-title7">Configuring the <span class="keyword wintitle">wan_ip_trunk_ca</span>
        Call Agent </h2>
    
    <div class="body taskbody"><p class="shortdesc">Associate the Call Agent used to route VoIP Calls to the ITSP.</p>
        
        <section id="task_ass_11g_hq__steps_k1k_fbx_gq"><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps" id="task_ass_11g_hq__steps_k1k_fbx_gq"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">SBC</span>/<span class="keyword wintitle">Configuration</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Select the <span class="keyword wintitle">Enable</span>
                    check box, located next to <span class="keyword wintitle">wan_ip_trunk_ca</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Call Agent Configuration</span>
                    table, click <img class="image" id="task_ass_11g_hq__image_kfn_5vq_lq" src="https://documentation.media5corp.com/download/attachments/45482024/pencilbleu.jpg" width="15"> next to <span class="keyword wintitle">wan_ip_trunk_ca</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Configure Call Agent</span> table,
                    complete the following fields: </span>
                <ol type="a" class="ol substeps" id="task_ass_11g_hq__substeps_khg_sht_cq">
                    <li class="li substep">
                        <span class="ph cmd">From the <span class="keyword wintitle">Signaling Interface</span>
                            selection list, select <span class="keyword wintitle">uplink_s</span>.</span>
                    </li>
                    <li class="li substep">
                        <span class="ph cmd">From the <span class="keyword wintitle">Media Interface</span>
                            selection list, select <span class="keyword wintitle">uplink_m</span>.</span>
                    </li>
                    <li class="li substep">
                        <span class="ph cmd">Set the <span class="keyword wintitle">Peer Host</span> to the IP
                            address of the service provider server or FQDN.</span>
                    </li>
                </ol>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Call Agent Rulesets</span> table,
                    click <img class="image" id="task_ass_11g_hq__image_rs4_xph_zhb" src="https://documentation.media5corp.com/download/attachments/45482024/Plusbleu.jpg" width="15">.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">From the <span class="keyword wintitle">Name</span>
                    selection list, choose <span class="keyword wintitle">uac_authentication_out</span>. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> If the ruleset is not in the selection list, it is because it was removed
                        and you will need to import the latest Ruleset package.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">In the <span class="keyword wintitle">Parameters</span>
                    field enter USERNAME=your_username PASSWORD=your_password corresponding to the
                    username and password used for authentication. </span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> The parameters are case sensitive and are separated by a space.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Save</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span> to apply
                    all changes to the configuration.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>Once the settings are applied, the <span class="keyword wintitle">Configuration Modified</span> field will
            change to <span class="keyword wintitle">No</span> indicating that
            the configuration that was modified is now applied to the system. When the Mediatrix SBC
            will use the selected Call Agent for a communication, the selected parameters will be
            applied. The <span class="keyword wintitle">uac_authentication_out</span>
            Call Agent Ruleset will handle the digest authentication, with the “USERNAME” and
            “PASSWORD” parameters.<br><img class="image" id="task_ass_11g_hq__image_lz5_dkt_w3b" src="https://documentation.media5corp.com/download/attachments/45482024/ConfiguraCallAgent_Wan_Ip_Trunk_for_ISTP.png" width="800"><br></section>
    </div>
<nav role="navigation" class="related-links"><div class="linklist relinfo reltasks"><div class="linklistlabel"><strong class="sectiontitle linklistlabel">Next Step</strong></div><ul class="linklist"><li class="linklist"><a class="link" href="#task_zdg_vlx_bq" title="Configure the route to send SIP registrations to the ITSP.">Associating the registration_to_wan_ip_trunk Routing Ruleset to your Configuration</a></li></ul></div></nav></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic task nested1" aria-labelledby="ariaid-title8" id="task_zdg_vlx_bq">
    <h2 class="title topictitle2" id="ariaid-title8">Associating the <span class="keyword wintitle">registration_to_wan_ip_trunk</span> Routing Ruleset to your Configuration </h2>
    
    <div class="body taskbody"><p class="shortdesc">Configure the route to send SIP registrations to the ITSP.</p>
        <section><div class="tasklabel"><strong class="sectiontitle tasklabel">Steps</strong></div><ol class="ol steps"><li class="li step stepexpand">
                <span class="ph cmd">Go to <span class="keyword wintitle">SBC</span>/<span class="keyword wintitle">Configuration</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <img class="image" id="task_zdg_vlx_bq__image_lnz_qxh_zhb" src="https://documentation.media5corp.com/download/attachments/45482024/Plusbleu.jpg" width="15">.</span>
            </li><li class="li step stepexpand" id="task_zdg_vlx_bq__Step2">
                <span class="ph cmd">In the <span class="keyword wintitle">Routing Rulesets</span> table, from the <span class="keyword wintitle">Name</span> selection list, select <span class="keyword wintitle">registration_to_wan_ip_trunk</span>.</span>
                <div class="itemgroup info">
                    <div class="note note note_note"><span class="note__title">Note:</span> If the ruleset is not in the selection list, it is because it was removed
                        and you will need to import the latest Ruleset package.</div>
                </div>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Save</span>.</span>
            </li><li class="li step stepexpand">
                <span class="ph cmd">Click <span class="keyword wintitle">Apply</span> to apply
                    all changes to the configuration.</span>
            </li></ol></section>
        <section class="section result"><div class="tasklabel"><strong class="sectiontitle tasklabel">Result</strong></div>
            <br><img class="image" id="task_zdg_vlx_bq__image_pgp_fyh_zhb" src="https://documentation.media5corp.com/download/attachments/45482024/RoutingRulesetRegistrationtoWanIPtrunk.png" width="800"><br>
        </section>
    </div>
</article></article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic reference nested0" aria-labelledby="ariaid-title9" id="reference_j4g_nbv_gfb">
  <h1 class="title topictitle1" id="ariaid-title9">Online Help</h1>
  <p class="shortdesc"><span class="ph">If you are not familiar with the meaning of the fields and
                buttons, click <span class="keyword wintitle">Show Help</span>, located at the upper right corner of
                the Web page. When activated, the fields and buttons that offer online help will
                change to green and if you hover over them, the description will bedisplayed.</span></p>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic concept nested0" aria-labelledby="ariaid-title10" id="concept_v4k_q3h_1r">
 <h1 class="title topictitle1" id="ariaid-title10">DGW Documentation</h1>
 
 <div class="body conbody"><p class="shortdesc">Mediatrix devices are supplied with an exhaustive set of documentation. </p>
  <p class="p">Mediatrix user documentation is available on the <a class="xref" href="http://documentation.media5corp.com" target="_blank">Media5 Documentation
    Portal</a>.</p>
  <div class="p">Several types of documents were created to clearly present the information you are looking for.
   Our documentation includes:<ul class="ul" id="concept_v4k_q3h_1r__ul_bqy_cjh_1r">
    <li class="li"><strong class="ph b">Release notes</strong>: Generated at each GA release, this document includes the known and
     solved issues of the software. It also outlines the changes and the new features the release
     includes.</li>
    <li class="li"><strong class="ph b">Configuration notes</strong>: These documents are created to facilitate the configuration of a
     specific use case. They address a configuration aspect we consider that most users will need to
     perform. However, in some cases, a configuration note is created after receiving a question
     from a customer. They provide standard step-by-step procedures detailing the values of the
     parameters to use. They provide a means of validation and present some conceptual information.
     The configuration notes are specifically created to guide the user through an aspect of the
     configuration. </li>
    <li class="li"><strong class="ph b">Technical bulletins</strong>: These documents are created to facilitate the configuration of a
     specific technical action, such as performing a firmware upgrade.</li>
    <li class="li"><strong class="ph b">Hardware installation guide</strong>: They provide the detailed procedure on how to safely and
     adequately install the unit. It provides information on card installation, cable connections,
     and how to access for the first time the Management interface.</li>
    <li class="li"><strong class="ph b">User guide</strong>: The user guide explains how to customise to your needs the configuration
     of the unit. Although this document is task oriented, it provides conceptual information to
     help the user understand the purpose and impact of each task. The User Guide will provide
     information such as where and how TR-069 can be configured in the Management Interface, how to
     set firewalls, or how to use the CLI to configure parameters that are not available in the
     Management Interface.</li>
    <li class="li"><strong class="ph b">Reference guide</strong>: This exhaustive document has been created for advanced users. It
     includes a description of all the parameters used by all the services of the Mediatrix units.
     You will find, for example, scripts to configure a specific parameter, notification messages
     sent by a service, or an action description used to create Rulesets. This document includes
     reference information such as a dictionary, and it does not include any step-by-step
     procedures. </li>
   </ul></div>
 </div>
</article><hr><span style="float: inline-end;"><a href="#">Top</a></span><article class="topic concept nested0" aria-labelledby="ariaid-title11" id="concept_fqm_rv4_k4">
 <h1 class="title topictitle1" id="ariaid-title11">Copyright Notice</h1>
 

 <div class="body conbody"><p class="shortdesc">Copyright © 2023 Media5 Corporation.</p>
  <p class="p">This document contains information that is proprietary to Media5 Corporation.</p>
  <p class="p">Media5 Corporation reserves all rights to this document as well as to the Intellectual Property
   of the document and the technology and know-how that it includes and represents.</p>
  <p class="p">This publication cannot be reproduced, neither in whole nor in part, in any form whatsoever,
   without written prior approval by Media5 Corporation.</p>
  <p class="p">Media5 Corporation reserves the right to revise this publication and make changes at any time
   and without the obligation to notify any person and/or entity of such revisions and/or
   changes.</p>
 </div>
</article></article></main></body></html>