Howto:NL - oneCentral - SIP Trunk TLS SIP-Provider (2020): Difference between revisions

From innovaphone wiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 1: Line 1:
== Summary ==
WARNING: WIKI Hints required (in Howto:NL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_(2020))!!
{{Template:SIP_TEST_STATUS_ongoing|update=March 30th, 2020|url=https://onecentral.nl/on-premise-stabiliteit/|productname=SIP_Trunk_TLS|providername=oneCentral}}
You must note the following issues in the wiki article!
=== Remarks ===
- If you intend to use SIPS (SIP/TLS) registration, you need to add the ' sip.onecentral.net' certificate to the trust list of your SBC


- Dialling of subscriber numbers not possible, 'Dialing Location' must be configured without 'Area Code'
  do not forget to mention the following specials:
  - If you intend to use SIPS (SIP/TLS) registration, you need to add the ' sip.onecentral.net' certificate to the trust list of your SBC
  - Dialling of subscriber numbers not possible, 'Dialing Location' must be configured without 'Area Code'


<internal>Provider SBC: Hermes SNS</internal>
Various manual steps are required.  So now...


- from the 9.00 repository, get the latest version of $/13r1/ip6010 (best using your vault client)


=== {{SIP_TEST_ISSUES_MR_TITLE}} ===
- with Visual Studio (currently 2013) open ip6010.sln
{{SIP_TEST_ISSUES_MR_INTRO}}
; CLNS ONNET : {{SIP_TEST_FACT_CLNS ONNET}}
: {{SIP_TEST_FACT__unreliable}}
; CLNS : {{SIP_TEST_FACT_CLNS}}
: {{SIP_TEST_FACT__unreliable}}
; EARLY MEDIA INBOUND : {{SIP_TEST_FACT_EARLY MEDIA INBOUND}}
: {{SIP_TEST_FACT__unreliable}}
; RALERT DISC : {{SIP_TEST_FACT_RALERT DISC}}
; REDIR 302 : {{SIP_TEST_FACT_REDIR 302}}
: {{SIP_TEST_FACT__unreliable}}
; REVERSE MEDIA : {{SIP_TEST_FACT_REVERSE MEDIA}}
: {{SIP_TEST_FACT__unreliable}}
; SIP INFO : {{SIP_TEST_FACT_SIP INFO}}
: {{SIP_TEST_FACT__unreliable}}
; XFER CONS EXT : {{SIP_TEST_FACT_XFER CONS EXT}}
: {{SIP_TEST_FACT__unreliable}}
; XFER CONS : {{SIP_TEST_FACT_XFER CONS}}
: {{SIP_TEST_FACT__unreliable}}


<small>{{SIP_TEST_FACTS_LIST}} [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_180_RINGING_FAILS|180_RINGING]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_BASIC_CALL_FAILS|BASIC_CALL]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_CLIR_FAILS|CLIR]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_CLNS_ONNET_FAILS|CLNS_ONNET]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_CLNS_FAILS|CLNS]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_CONN_NR_DIFF_FAILS|CONN_NR_DIFF]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_CONN_NR_INCOMING_FAILS|CONN_NR_INCOMING]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_CONN_NR_FAILS|CONN_NR]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_DTMF_FAILS|DTMF]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_EARLY_MEDIA_INBOUND_FAILS|EARLY_MEDIA_INBOUND]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_FAX_AUDIO_FAILS|FAX_AUDIO]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_FAX_T38_ONNET_FAILS|FAX_T38_ONNET]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_FAX_T38_FAILS|FAX_T38]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_FAX_T38ANDAUDIO_FAILS|FAX_T38ANDAUDIO]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_G711A_ONNET_FAILS|G711A_ONNET]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_G711A_FAILS|G711A]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_G711U_ONNET_FAILS|G711U_ONNET]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_G711U_FAILS|G711U]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_G722_ONNET_FAILS|G722_ONNET]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_G722_FAILS|G722]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_G729_ONNET_FAILS|G729_ONNET]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_G729_FAILS|G729]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_HOLD_RETRIEVE_FAILS|HOLD_RETRIEVE]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_IP_FRAGMENTATION_FAILS|IP_FRAGMENTATION]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_LARGE_SIP_MESSAGES_FAILS|LARGE_SIP_MESSAGES]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_MOBILITY_FAILS|MOBILITY]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_OPUS_NB_FAILS|OPUS_NB]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_OPUS_WB_FAILS|OPUS_WB]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_RALERT_DISC_FAILS|RALERT_DISC]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_REDIR_302_FAILS|REDIR_302]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_REDIR_DIVHDR_FAILS|REDIR_DIVHDR]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_REDIR_HISTHDR_FAILS|REDIR_HISTHDR]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_REVERSE_MEDIA_FAILS|REVERSE_MEDIA]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_SDP_VIDEO_FAILS|SDP_VIDEO]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_SIP_INFO_FAILS|SIP_INFO]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_SRTP_INCOMING_FAILS|SRTP_INCOMING]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_SRTP_INTERNAL_FAILS|SRTP_INTERNAL]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_SRTP_OUTGOING_FAILS|SRTP_OUTGOING]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_SUBSCRIBER_NR_FAILS|SUBSCRIBER_NR]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_XFER_BLIND_FAILS|XFER_BLIND]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_XFER_CONS_ALERT_FAILS|XFER_CONS_ALERT]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_XFER_CONS_EXT_FAILS|XFER_CONS_EXT]], [[Template:SIP_TEST_FACT_DESCRIPTION_TEST_XFER_CONS_FAILS|XFER_CONS]]</small>


== Firmware V12r2 Vault todos ==
- add/checkin NL-oneCentral-SIP_Trunk_TCP.xsl to $/12r2/ip6010/relay/products/


== Test Results ==
- checkout/edit $/12r2/ip6010/relay/relay.mak
{{SIP_TEST_TESTRESULT_ONLYMR_INTRO}}
  - add the following line to the rule for obj/relay_httpdata.h:
=== {{SIP_TEST_RESULTS_MR_TITLE}} ===
    '' products/NL-oneCentral-SIP_Trunk_TCP.xsl \'' (note that the line MUST start with a tab and end with a backslash!)
; Registration : {{Template:SIP_Profile_Test_Registration_UDP_TCP_TLS}}


; NAT Traversal : {{Template:SIP_Profile_Test_NAT_a_no_c}}
- checkout/edit $/12r2/ip6010/relay/relay_ifs.xsl
  - locate the '<select name="profile">' line
  - add the following line to the list of providers
    ''<option value="NL-oneCentral-SIP_Trunk_TCP">NL-oneCentral-SIP_Trunk_TCP</option>''
  - make sure the line is inserted in the correct alphabetic order!
- proceed with "final steps" below


; DTMF (RFC2833) : {{Template:SIP_Profile_Test_DTMF_RFC2833_yes}}


; Session Timer : {{Template:SIP_Profile_Test_EXPIRES_yes}}
== Firmware 13r1 Vault todos ==
- add/checkin NL-oneCentral-SIP_Trunk_TCP.xsl to $/13r1/ip6010/relay/products/
- add/checkin sip_product_NL-oneCentral-SIP_Trunk_TCP.js to $/13r1/ip6010/relay/products/


; Redundancy : {{Template:SIP_Profile_Test_REDUNDANCY_yes_FAILOVER_yes}}|timeout=2 minutes}}
- checkout/edit $/13r1/ip6010/relay/products/sip_products.js
  - add the following line to the correct country property "NL":  
    ''{ name: "oneCentral-SIP Trunk TCP", js: "NL-oneCentral-SIP_Trunk_TCP" },'' (note that the line MUST ends with a comma!)
  - make sure the line is inserted in the correct alphabetic order!


; Correct signalling of Ringing-state : {{Template:SIP_Profile_Test_RINGING_yes}}
- checkout/edit $/13r1/ip6010/relay/relay.mak
:{{Template:SIP_Profile_Test_RALERT_DISC_no}}
  - add the following lines to the rule for obj/relay_httpdata.h:  
    '' products/NL-oneCentral-SIP_Trunk_TCP.xsl \'' (note that the line MUST start with a tab and end with a backslash!)
    '' products/sip_product_NL-oneCentral-SIP_Trunk_TCP.js,SERVLET_STATIC,HTTP_CACHE+HTTP_NOPWD \'' (note that the line MUST start with a tab and end with a backslash!)


; CLIR : {{Template:SIP_Profile_Test_CLIR_yes}}
- checkout/edit $/13r1/ip6010/relay/relay_ifs.xsl
  - locate the '<select name="profile">' line
  - add the following line to the list of providers
    ''<option value="NL-oneCentral-SIP_Trunk_TCP">NL-oneCentral-SIP_Trunk_TCP</option>''
  - make sure the line is inserted in the correct alphabetic order!
- proceed with "final steps" below


; Clip No Screening (CLNS) : {{Template:SIP_Profile_Test_CLNS_no}} {{Template:SIP_Profile_Test_CLNS_REDIRECT_no_clns_history_or_diversion}}


; COLP : {{Template:SIP_Profile_Test_COLP_out_yes_in_yes}} {{Template:SIP_Profile_Test_COLP_diff_no}}
=Final steps=
- create a project task and add it to suggested fixes
  - Fix: [Add/Update] oneCentral-SIP Trunk TCP
  - Bereich: Fixes
  - Release: _Fixes - Suggested Fixes
  - Status: Beendet


; Early-Media : {{Template:SIP_Profile_Test_EARLY_MEDIA_INBOUND_no}}
- save all changes you have done so far


; Fax : {{Template:SIP_Profile_Test_AUDIOFAX_PSTN_yes}}
- create an IP6010 build (either locally [preferred, call ''make Firmware_Build''] or using the builder [do not forget to check-in before in this case])
: {{Template:SIP_Profile_Test_T38_PSTN_yes_MR_Ex}}
- DRAM this build to Ohm (from C:/sources/builder/src/13r1/ip6010/bin) and test the provider profile (V12 AND V13!)
- if the build is good, check-in all files to vault


; Codecs : supported to/from PSTN: G711A
- from the test repository, get the latest version of $/test/13r1/relay/sip-profiles/Makefile (best using your vault client)
: supported onnet (VoIP to VoIP): G711A


; IP-Fragmentation : {{Template:SIP_Profile_Test_FRAGMENTATION_yes}}
- checkout/edit Makefile in $/test/13r1/relay/sip-profiles/
  - locate the 'TESTEDPROVIDER=line' line
  - add the following line to the list of tested providers:
    '' NL-oneCentral-SIP_Trunk_TCP \'' (note that the line MUST start with a tab!)


; Large SIP messages : {{Template:SIP_Profile_Test_LARGE_MESSAGES_yes}}
- make sure all your changes are checked in if satisfied


; Reverse Media Negotiation : {{Template:SIP_Profile_Test_REV_MEDIA_NEG_no}}
- create the service release documentation
  see http://wiki-intern.innovaphone.com/index.php?title=Entwicklung#Service_Release_Dokumentation for details on the development process for service release documentation
  - login to the project tool (use myApps for that)
  - select 'Area' 'Fixes'
  - in the left pane ('Releases') select and open 'Current Releases'
  - select the current Firmware Version (currently this is 'Firmware 13r1')
    you should now be in  "Fixes" Releases/Current Releases/Firmware 13r1
  - navigate to the next Service Release (e.g. '13r1 Service Release 2')
  - Check if there already is a fix 'SIP-Provider Profile NL-oneCentral-SIP_Trunk_TCP'
  - if so, open it.  if not, create a new fix by clicking on the '+ Fix' button
    in the form, fill in:  
    - Fix: 'SIP-Provider Profile NL-oneCentral-SIP_Trunk_TCP'
    - Release: select the next 13r1 service release
    - Status: 'Aktuell'
    - Beschreibung:
      if this is a new profile, then add the words 'New SIP Provider Profile'
      if this is an updated profile, then add the words 'Updated SIP Provider Profile' plus an explanation why it has been updated (in English)
    - Add 2 Document Links:
      - http://mantis.innovaphone.com/view.php?id=237667
      - http://wiki.innovaphone.com/index.php?title=Howto%3ANL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_%282020%29
  - Save the new fix
  - navigate to the 'Aktuelle Fixe' section and click on the symbol for 'Fix in Communote posten'
      in the communote-form, add 'Techserv/Sip-Provider' in 'Themen'
  - navigate to 'Aktuelle Fixes' section of your fix and click on the symbol for 'Fix erledigt'


; Mobility Calls {{Template:SIP_Profile_Test_MobilityCall_no_with_MediaRelay}}
- create/update the wiki article (Howto:NL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_(2020)) in http://wiki.innovaphone.com/index.php?title=Howto:NL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_(2020)&action=edit
  use content of '<profilename>.wiki.txt' to start with
  do not forget to mention the wiki specials mentioned above
  - send email to the provider from Mantis and summarize all the test findings
  do not forget to attach ProviderProfile.png and all relevant traces!
  Here is an email template:  


; SRTP : {{Template:SIP_Profile_Test_SRTP_yes}}
------------------------------ Provider Email ------------------------------
We have concluded our tests. Outcome so far is documented in http://wiki.innovaphone.com/index.php?title=Howto:NL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_(2020):


; Dialing of Subscriber Numbers : {{Template:SIP_Profile_Test_SUBSCRIBER_NR_no}}
Issues you may want to look into (we refer to the traces found in attached zip):  


; Call Transfer :
  - <explain issues here, mention traces if any>
: {{Template:SIP_Profile_Test_CALL_TRANSFER_consconn}}
: {{Template:SIP_Profile_Test_CALL_TRANSFER_consext}}


We have created a special configuration form four your product (screenshot ProviderProfile.png attached).
Would you please have a look at it and especially review and check the terms we are using in the form?
We can change all the terms used in this form to reflect the terms you are using in your communication between you and your customers.


Hope to hear from you soon so we can finish the process.
------------------------------ Provider Email ------------------------------


==Configuration==
*** Do not forget to attach ProviderProfile.png as well es all relevant traces.
Use profile ''NL-oneCentral-SIP_Trunk_TLS'' in ''Gateway/Interfaces/SIP'' to configure this SIP provider.
 
Please note the following configuration hints:
* <nowiki>If you intend to use SIPS (SIP/TLS) registration, you need to add the ' sip.onecentral.net' certificate to the trust list of your SBC</nowiki>
* <nowiki>Dialling of subscriber numbers not possible, 'Dialing Location' must be configured without 'Area Code'</nowiki>
 
: {{SIP_TEST_V13_HINT}}
 
== Disclaimer ==
{{SIP_TEST_PREFACE}}
 
[[Category:Compat|{{PAGENAME}}]]
[[Category:3rdParty SIP Provider|{{PAGENAME}}]]

Revision as of 16:36, 30 March 2020

WARNING: WIKI Hints required (in Howto:NL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_(2020))!! You must note the following issues in the wiki article!

  do not forget to mention the following specials:
  - If you intend to use SIPS (SIP/TLS) registration, you need to add the ' sip.onecentral.net' certificate to the trust list of your SBC
  - Dialling of subscriber numbers not possible, 'Dialing Location' must be configured without 'Area Code'

Various manual steps are required. So now...

- from the 9.00 repository, get the latest version of $/13r1/ip6010 (best using your vault client)
- with Visual Studio (currently 2013) open ip6010.sln


Firmware V12r2 Vault todos

- add/checkin NL-oneCentral-SIP_Trunk_TCP.xsl to $/12r2/ip6010/relay/products/
- checkout/edit $/12r2/ip6010/relay/relay.mak
  - add the following line to the rule for obj/relay_httpdata.h: 
    	products/NL-oneCentral-SIP_Trunk_TCP.xsl \ (note that the line MUST start with a tab and end with a backslash!)
- checkout/edit $/12r2/ip6010/relay/relay_ifs.xsl
  - locate the '<select name="profile">' line
  - add the following line to the list of providers
    <option value="NL-oneCentral-SIP_Trunk_TCP">NL-oneCentral-SIP_Trunk_TCP</option>
  - make sure the line is inserted in the correct alphabetic order!
- proceed with "final steps" below


Firmware 13r1 Vault todos

- add/checkin NL-oneCentral-SIP_Trunk_TCP.xsl to $/13r1/ip6010/relay/products/
- add/checkin sip_product_NL-oneCentral-SIP_Trunk_TCP.js to $/13r1/ip6010/relay/products/
- checkout/edit $/13r1/ip6010/relay/products/sip_products.js
  - add the following line to the correct country property "NL": 
    { name: "oneCentral-SIP Trunk TCP", js: "NL-oneCentral-SIP_Trunk_TCP" }, (note that the line MUST ends with a comma!)
  - make sure the line is inserted in the correct alphabetic order!
- checkout/edit $/13r1/ip6010/relay/relay.mak
  - add the following lines to the rule for obj/relay_httpdata.h: 
    	products/NL-oneCentral-SIP_Trunk_TCP.xsl \ (note that the line MUST start with a tab and end with a backslash!)
    	products/sip_product_NL-oneCentral-SIP_Trunk_TCP.js,SERVLET_STATIC,HTTP_CACHE+HTTP_NOPWD \ (note that the line MUST start with a tab and end with a backslash!)
- checkout/edit $/13r1/ip6010/relay/relay_ifs.xsl
  - locate the '<select name="profile">' line
  - add the following line to the list of providers
    <option value="NL-oneCentral-SIP_Trunk_TCP">NL-oneCentral-SIP_Trunk_TCP</option>
  - make sure the line is inserted in the correct alphabetic order!
- proceed with "final steps" below


=Final steps=
- create a project task and add it to suggested fixes
 - Fix: [Add/Update] oneCentral-SIP Trunk TCP
 - Bereich: Fixes
 - Release: _Fixes - Suggested Fixes
 - Status: Beendet
- save all changes you have done so far
- create an IP6010 build (either locally [preferred, call make Firmware_Build] or using the builder [do not forget to check-in before in this case])
- DRAM this build to Ohm (from C:/sources/builder/src/13r1/ip6010/bin) and test the provider profile (V12 AND V13!)
- if the build is good, check-in all files to vault
- from the test repository, get the latest version of $/test/13r1/relay/sip-profiles/Makefile (best using your vault client)
- checkout/edit Makefile in $/test/13r1/relay/sip-profiles/
  - locate the 'TESTEDPROVIDER=line' line 
  - add the following line to the list of tested providers:
    	NL-oneCentral-SIP_Trunk_TCP \ (note that the line MUST start with a tab!)
- make sure all your changes are checked in if satisfied
- create the service release documentation
  see http://wiki-intern.innovaphone.com/index.php?title=Entwicklung#Service_Release_Dokumentation for details on the development process for service release documentation
  - login to the project tool (use myApps for that)
  - select 'Area' 'Fixes'
  - in the left pane ('Releases') select and open 'Current Releases'
  - select the current Firmware Version (currently this is 'Firmware 13r1')
    you should now be in  "Fixes" Releases/Current Releases/Firmware 13r1
  - navigate to the next Service Release (e.g. '13r1 Service Release 2')
  - Check if there already is a fix 'SIP-Provider Profile NL-oneCentral-SIP_Trunk_TCP'
  - if so, open it.  if not, create a new fix by clicking on the '+ Fix' button
    in the form, fill in: 
    - Fix: 'SIP-Provider Profile NL-oneCentral-SIP_Trunk_TCP'
    - Release: select the next 13r1 service release
    - Status: 'Aktuell'
    - Beschreibung: 
      if this is a new profile, then add the words 'New SIP Provider Profile'
      if this is an updated profile, then add the words 'Updated SIP Provider Profile' plus an explanation why it has been updated (in English)
    - Add 2 Document Links: 
      - http://mantis.innovaphone.com/view.php?id=237667
      - http://wiki.innovaphone.com/index.php?title=Howto%3ANL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_%282020%29
  - Save the new fix
  - navigate to the 'Aktuelle Fixe' section and click on the symbol for 'Fix in Communote posten' 
     in the communote-form, add 'Techserv/Sip-Provider' in 'Themen' 
  - navigate to 'Aktuelle Fixes' section of your fix and click on the symbol for 'Fix erledigt' 
- create/update the wiki article (Howto:NL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_(2020)) in http://wiki.innovaphone.com/index.php?title=Howto:NL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_(2020)&action=edit
  use content of '<profilename>.wiki.txt' to start with
  do not forget to mention the wiki specials mentioned above
- send email to the provider from Mantis and summarize all the test findings
  do not forget to attach ProviderProfile.png and all relevant traces!
  Here is an email template: 

Provider Email ------------------------------

We have concluded our tests. Outcome so far is documented in http://wiki.innovaphone.com/index.php?title=Howto:NL_-_oneCentral_-_SIP_Trunk_TCP_SIP-Provider_(2020):

Issues you may want to look into (we refer to the traces found in attached zip):

 - <explain issues here, mention traces if any>

We have created a special configuration form four your product (screenshot ProviderProfile.png attached). Would you please have a look at it and especially review and check the terms we are using in the form? We can change all the terms used in this form to reflect the terms you are using in your communication between you and your customers.

Hope to hear from you soon so we can finish the process.


Provider Email ------------------------------

      • Do not forget to attach ProviderProfile.png as well es all relevant traces.