Actions

Toolpack:Creating an H.248 Configuration D: Difference between revisions

No edit summary
(Add new options, Improve layout, add slight narrative.)
Line 36: Line 36:




<div class="mw-collapsible mw-collapsed" data-collapsetext="Northbound Interface" data-expandtext="Northbound Interface" style="width: 400px;">
NOTE: After creating the H.248 Configuration the Advanced Parameters will split into two sections to indicate which parameters will cause active calls to drop. These are labled as [[Toolpack: H248 Service Affecting Parameters|H.248 Service Affecting Parameters]]
 
Please reference the complete list of Paramters below before adding [[Toolpack:Adding_a_Media_Gateway_Controller_(MGC) C|Adding a media gateway controller (MGC)]] and [[Toolpack:Associating_NAPs_with_an_H.248_Configuration D|Associating the NAPs with the H.248 configuration]]
 
[[Image:Edit_H248_0.png]]
 
 
==Full List of Parameters==
*[[Parameter: Enabled|Enabled]]
'''Transport Protocol'''<br>
*[[Parameter: Transport Protocol Type|Transport Protocol Type]]
*[[Parameter: Public IP Address|Public IP Address]]
*[[Parameter: Use IP interface|Use IP interface]]
*[[Parameter: Local IP Address|Local IP Address]]
*[[Parameter: Local Port to Receive for Text Encoding|Local Port to Receive for Text Encoding]]
*[[Parameter: IP ToS value|IP ToS value]]<br><br>
'''Advanced Parameters'''<br>
*Behavior
**[[Parameter: Relay Unknown H248 Parameters|Relay Unknown H248 Parameters]]
**[[Parameter: Compact H248 Descriptor Headers|Compact H248 Descriptor Headers]]
**[[Parameter: Send Transaction Response Acks|Send Transaction Response Acks]]
**[[Parameter: Send Transaction Response Acks Immediately|Send Transaction Response Acks Immediately]]
**[[Parameter: Send Transaction Pending Automatically|Send Transaction Pending Automatically]]
**[[Parameter: No Remote Response|No Remote Response]]
**[[Parameter: Null Terminating H248 Message|Null Terminating H248 Message]]
**[[Parameter: No Only Ephemeral|No Only Ephemeral]]
**[[Parameter: Loose H248 Message Decoding|Loose H248 Message Decoding]]
**[[Parameter: Transparent SDP|Transparent SDP]]
**[[Parameter: No SCTP Send Acknowledge|No SCTP Send Acknowledge]]
**[[Parameter: No failover service changes|No failover service changes]]
**[[Parameter: Observe default CAS events|Observe default CAS events]]<br><br>
*Analog display
**[[Parameter: FSK Variant|FSK Variant]]
**[[Parameter: FSK Level|FSK Level]]
**[[Parameter: Mark Bytes sent before FSK message|Mark Bytes sent before FSK message]]
**[[Parameter: Seizure Bytes Used before Mark Bytes|Seizure Bytes Used before Mark Bytes]]<br><br>
*[[Parameter: Maximum Number of Retransmissions|Maximum Number of Retransmissions]]
*[[Parameter: Serialize null context commands|Serialize null context commands]]
*[[Parameter: Allow wildcard in service change|Allow wildcard in service change]]
*[[Parameter: Switch to Passthrough on tdm/ec=OFF|Switch to Passthrough on tdm/ec=OFF]]
*[[Parameter: IP Lawful Interception ToS value|IP Lawful Interception ToS value]]
*[[Parameter: Maximum Number of TDM Terminations|Maximum Number of TDM Terminations]]
*[[Parameter: Maximum Number of Ephemeral Terminations|Maximum Number of Ephemeral Terminations]]
*[[Parameter: Default MEGACO version|Default MEGACO version]]
*[[Parameter: Maximum Number of DNS Pending Requests|Maximum Number of DNS Pending Requests]]
*[[Parameter: Ephemeral Termination Identifier Root|Ephemeral Termination Identifier Root]]
*[[Parameter: Ephemeral Termination Identifier Maximum Value|Ephemeral Termination Identifier Maximum Value]]
*[[Parameter: Number of Worker Threads|Number of Worker Threads]]<br><br>
*Profile
**[[Parameter: Enabled|Enabled]]
**[[Parameter: Profile Name|Profile Name]]
**[[Parameter: Profile Version|Profile Version]]<br><br>
*Timers
**[[Parameter: Default Sent Transaction Timer Value|Default Sent Transaction Timer Value]]
**[[Parameter: Maximum Sent Transaction Timer Value|Maximum Sent Transaction Timer Value]]
**[[Parameter: Provisional Reply Transaction Timer Value|Provisional Reply Transaction Timer Value]]
**[[Parameter: Saved Replied Transaction Timer Value|Saved Replied Transaction Timer Value]]
**[[Parameter: Dialing Start Timer Value|Dialing Start Timer Value]]
**[[Parameter: Dialing Short Timer Value|Dialing Short Timer Value]]
**[[Parameter: Dialing Long Timer Value|Dialing Long Timer Value]]
**[[Parameter: Dialing Duration Timer Value|Dialing Duration Timer Value]]
**[[Parameter: Restart Timer Value to Retry Controller Association|Restart Timer Value to Retry Controller Association]]
**[[Parameter: Local Response Timer Value|Local Response Timer Value]]
**[[Parameter: Inactivity Timer Value|Inactivity Timer Value]]<br><br>
 
<div class="mw-collapsible mw-collapsed" data-collapsetext="Click to Collapse H248 API and Northbound Interface Configuration" data-expandtext="Click to Expand H248 API and Northbound Interface Configuration">
 


'''Path'''
'''Path'''
Line 195: Line 261:
</pre>
</pre>
</div>
</div>
==List of Parameters==
*[[Parameter: Enabled|Enabled]]
*Transport Protocol
**[[Parameter: Transport Protocol Type|Transport Protocol Type]]
**[[Parameter: Public IP Address|Public IP Address]]
**[[Parameter: Use IP interface|Use IP interface]]
**[[Parameter: Local IP Address|Local IP Address]]
**[[Parameter: Local Port to Receive for Text Encoding|Local Port to Receive for Text Encoding]]
**[[Parameter: IP ToS value|IP ToS value]]
'''Advanced Parameters'''
*Behavior
**[[Parameter: Relay Unknown H248 Parameters|Relay Unknown H248 Parameters]]
**[[Parameter: Compact H248 Descriptor Headers|Compact H248 Descriptor Headers]]
**[[Parameter: Send Transaction Response Acks|Send Transaction Response Acks]]
**[[Parameter: Send Transaction Response Acks Immediately|Send Transaction Response Acks Immediately]]
**[[Parameter: Send Transaction Pending Automatically|Send Transaction Pending Automatically]]
**[[Parameter: No Remote Response|No Remote Response]]
**[[Parameter: Null Terminating H248 Message|Null Terminating H248 Message]]
**[[Parameter: No Only Ephemeral|No Only Ephemeral]]
**[[Parameter: Loose H248 Message Decoding|Loose H248 Message Decoding]]
**[[Parameter: Transparent SDP|Transparent SDP]]
**[[Parameter: No SCTP Send Acknowledge|No SCTP Send Acknowledge]]
**[[Parameter: No failover service changes|No failover service changes]]
*[[Parameter: Maximum Number of Retransmissions|Maximum Number of Retransmissions]]
*[[Parameter: Serialize null context commands|Serialize null context commands]]
*[[Parameter: Allow wildcard in service change|Allow wildcard in service change]]
*[[Parameter: Switch to Passthrough on tdm/ec=OFF|Switch to Passthrough on tdm/ec=OFF]]
*[[Parameter: IP Lawful Interception ToS value|IP Lawful Interception ToS value]]
*[[Parameter: Maximum Number of TDM Terminations|Maximum Number of TDM Terminations]]
*[[Parameter: Maximum Number of Ephemeral Terminations|Maximum Number of Ephemeral Terminations]]
*[[Parameter: Default MEGACO version|Default MEGACO version]]
*[[Parameter: Maximum Number of DNS Pending Requests|Maximum Number of DNS Pending Requests]]
*[[Parameter: Ephemeral Termination Identifier Root|Ephemeral Termination Identifier Root]]
*[[Parameter: Ephemeral Termination Identifier Maximum Value|Ephemeral Termination Identifier Maximum Value]]
*Profile
**[[Parameter: Enabled|Enabled]]
**[[Parameter: Profile Name|Profile Name]]
**[[Parameter: Profile Version|Profile Version]]
*Timers
**[[Parameter: Default Sent Transaction Timer Value|Default Sent Transaction Timer Value]]
**[[Parameter: Maximum Sent Transaction Timer Value|Maximum Sent Transaction Timer Value]]
**[[Parameter: Provisional Reply Transaction Timer Value|Provisional Reply Transaction Timer Value]]
**[[Parameter: Saved Replied Transaction Timer Value|Saved Replied Transaction Timer Value]]
**[[Parameter: Dialing Start Timer Value|Dialing Start Timer Value]]
**[[Parameter: Dialing Short Timer Value|Dialing Short Timer Value]]
**[[Parameter: Dialing Long Timer Value|Dialing Long Timer Value]]
**[[Parameter: Dialing Duration Timer Value|Dialing Duration Timer Value]]
**[[Parameter: Restart Timer Value to Retry Controller Association|Restart Timer Value to Retry Controller Association]]
**[[Parameter: Local Response Timer Value|Local Response Timer Value]]
**[[Parameter: Inactivity Timer Value|Inactivity Timer Value]]

Revision as of 03:35, 28 March 2024

This article applies to: Product Version
Tmedia 2.9, 2.10, 3.0, 3.2

After you create the necessary VoIP and TDM NAPs, you can create an H.248 configuration.


1- Click H248 in the navigation panel


2- Create the new configuration:

  • Select a transport protocol type
  • Enter a public IP address
  • Enter a private IP address
  • Click Create

3- For 1+1 systems, open the "Advanced Parameters" and then "Behavior" section and make sure this option is checked:

 No failover service changes


4- Verify that the "TbgwH248Cfg was successfully created" message appears


NOTE: After creating the H.248 Configuration the Advanced Parameters will split into two sections to indicate which parameters will cause active calls to drop. These are labled as H.248 Service Affecting Parameters

Please reference the complete list of Paramters below before adding Adding a media gateway controller (MGC) and Associating the NAPs with the H.248 configuration


Full List of Parameters

Transport Protocol

Advanced Parameters


Path

/configurations/@[configuration_name]/h248_stacks/@[h248_stack]

Parameters (text)

/configurations/@[configuration_name]/h248_stacks/@[h248_stack]
enabled             = true
naps                = [  ]

/configurations/@[configuration_name]/h248_stacks/@[h248_stack]/advanced_parameters
allow_wildcard_in_service_change               = true
default_megaco_version                         = 2
ephemeral_termination_identifier_maximum_value = 4294967295
ephemeral_termination_identifier_root          = "IP/"
maximum_number_of_dns_pending_requests         = 5
maximum_number_of_ephemeral_terminations       = 2048
maximum_number_of_retransmissions              = 11
maximum_number_of_tdm_terminations             = 2048
serialize_null_context_commands                = false
switch_to_passthrough_on_tdm_ec_off            = true

/configurations/@[configuration_name]/h248_stacks/@[h248_stack]/advanced_parameters/behavior
compact_h248_descriptor_headers            = false
loose_h248_message_decoding                = false
no_only_ephemeral                          = false
no_remote_response                         = false
no_sctp_send_acknowledge                   = false
no_warm_service_change                     = false
null_terminating_h248_message              = false
relay_unknown_h248_parameters              = false
send_transaction_pending_automatically     = false
send_transaction_response_acks             = false
send_transaction_response_acks_immediately = true
transparent_sdp                            = true

/configurations/@[configuration_name]/h248_stacks/@[h248_stack]/advanced_parameters/profile
profile_enabled = false
profile_name    = ""
profile_version = ""

/configurations/@[configuration_name]/h248_stacks/@[h248_stack]/timers
default_sent_transaction_timer                      = "500 milliseconds"
dialing_duration_timer                              = "5 seconds"
dialing_long_timer                                  = "15 seconds"
dialing_short_timer                                 = "5 seconds"
dialing_start_timer                                 = "30 seconds"
inactivity_timer                                    = "30 seconds"
local_response_timer                                = "10 seconds"
maximum_sent_transaction_timer                      = "4 seconds"
provisional_reply_transaction_timer                 = "6 seconds"
restart_timer_value_to_retry_controller_association = "30 seconds"
saved_replied_transaction_timer                     = "30 seconds"

/configurations/@[configuration_name]/h248_stacks/@[h248_stack]/transport_protocol
ip_interface                            = ""
ip_tos_value                            = 0
local_ip_address                        = "@[address_number]"
local_port_to_receive_for_text_encoding = 2944
public_ip_address                       = "@[address_number]"
transport_protocol_type                 = "UDP"
use_ip_interface                        = false

/configurations/@[configuration_name]/h248_stacks/@[h248_stack]/transport_protocol/sctp_parameters
checksum_type                                                    = "AUTODETECT"
maximum_number_of_association_per_instance                       = 5
maximum_number_of_init_cookie_echo_chunk_retransmission          = 8
maximum_number_of_input_sctp_streams                             = 32
maximum_number_of_instance_sapi                                  = 2
maximum_number_of_ip_address_per_instance                        = 2
maximum_number_of_output_sctp_streams                            = 5
maximum_number_of_packets_sent_when_transmitting_new_data_chunks = 4
maximum_number_of_retransmission_per_association                 = 10
maximum_number_of_retransmission_per_path                        = 5
maximum_number_of_sctp_responses_waiting_for_acknowledge         = 5
maximum_number_of_streams_per_association                        = 4
number_of_network_interface_card                                 = 2

Parameters (json)

{
  "advanced_parameters" : {
    "allow_wildcard_in_service_change" : true,
    "behavior" : {
      "compact_h248_descriptor_headers" : false,
      "loose_h248_message_decoding" : false,
      "no_only_ephemeral" : false,
      "no_remote_response" : false,
      "no_sctp_send_acknowledge" : false,
      "no_warm_service_change" : false,
      "null_terminating_h248_message" : false,
      "relay_unknown_h248_parameters" : false,
      "send_transaction_pending_automatically" : false,
      "send_transaction_response_acks" : false,
      "send_transaction_response_acks_immediately" : true,
      "transparent_sdp" : true
    },
    "default_megaco_version" : 2,
    "ephemeral_termination_identifier_maximum_value" : 4294967295,
    "ephemeral_termination_identifier_root" : "IP/",
    "maximum_number_of_dns_pending_requests" : 5,
    "maximum_number_of_ephemeral_terminations" : 2048,
    "maximum_number_of_retransmissions" : 11,
    "maximum_number_of_tdm_terminations" : 2048,
    "profile" : {
      "profile_enabled" : false,
      "profile_name" : "",
      "profile_version" : ""
    },
    "serialize_null_context_commands" : false,
    "switch_to_passthrough_on_tdm_ec_off" : true
  },
  "enabled" : true,
  "naps" : [
  ],
  "timers" : {
    "default_sent_transaction_timer" : "500 milliseconds",
    "dialing_duration_timer" : "5 seconds",
    "dialing_long_timer" : "15 seconds",
    "dialing_short_timer" : "5 seconds",
    "dialing_start_timer" : "30 seconds",
    "inactivity_timer" : "30 seconds",
    "local_response_timer" : "10 seconds",
    "maximum_sent_transaction_timer" : "4 seconds",
    "provisional_reply_transaction_timer" : "6 seconds",
    "restart_timer_value_to_retry_controller_association" : "30 seconds",
    "saved_replied_transaction_timer" : "30 seconds"
  },
  "transport_protocol" : {
    "ip_interface" : "",
    "ip_tos_value" : 0,
    "local_ip_address" : "@[address_number]",
    "local_port_to_receive_for_text_encoding" : 2944,
    "public_ip_address" : "@[address_number]",
    "sctp_parameters" : {
      "checksum_type" : "AUTODETECT",
      "maximum_number_of_association_per_instance" : 5,
      "maximum_number_of_init_cookie_echo_chunk_retransmission" : 8,
      "maximum_number_of_input_sctp_streams" : 32,
      "maximum_number_of_instance_sapi" : 2,
      "maximum_number_of_ip_address_per_instance" : 2,
      "maximum_number_of_output_sctp_streams" : 5,
      "maximum_number_of_packets_sent_when_transmitting_new_data_chunks" : 4,
      "maximum_number_of_retransmission_per_association" : 10,
      "maximum_number_of_retransmission_per_path" : 5,
      "maximum_number_of_sctp_responses_waiting_for_acknowledge" : 5,
      "maximum_number_of_streams_per_association" : 4,
      "number_of_network_interface_card" : 2
    },
    "transport_protocol_type" : "UDP",
    "use_ip_interface" : false
  }
}