Actions

Northbound interface:Configuration:H248: Difference between revisions

(Created page with "=H.248 Configuration= To add a H.248 to a new configuration, it might be helpful to get the default values first. This can be done with a ''GET'' with using '''new''' as eleme...")
 
No edit summary
Line 1: Line 1:
=H.248 Configuration=
=H.248 Configuration=
The simplest approach to configuring H.248 is to ''POST'' only attributes for which we want non-default values.
The structure of the H.248 JSON object can be queried by getting the default values, explained later on on this page.
== H.248 Stack addition ==
This example uses default values mostly, but for some attributes, we want specific values:
  POST /configurations/{NewCFG}/h248_stacks {
  "***meta***" : {
    "version" : "2.9.10"
  },
  "advanced_parameters" : {
    "serialize_null_context_commands" : true
  },
  "enabled" : true,
  "naps" : [
    "NAP_TDM",
    "RTP_NAP"
  ],
  "timers" : {
    "local_response_timer" : "4 seconds"
  },
  "transport_protocol" : {
    "ip_interface" : "TB0999999.SIG",
    "public_ip_address" : "212.162.61.24",
    "use_ip_interface" : true
  }
  }
Here it is assumed that the configuration '''NewCfg''' is already existing.
TB0999999.SIG is the IP interface name to use for the H.248 signalling trafic.  This name must be globally unique, and therefore the SerialNumber of the device must be prepended to the IP interface name.
For example:
[[File:IpInterfaceName.jpg]]
== Getting the default values ==
To add a H.248 to a new configuration, it might be helpful to get the default values first.
To add a H.248 to a new configuration, it might be helpful to get the default values first.
This can be done with a ''GET'' with using '''new''' as element name under the '''h248_stacks''' collection.
This can be done with a ''GET'' with using '''new''' as element name under the '''h248_stacks''' collection.
The attribute values from the returned JSON object can then be modified before submitting the new element using the ''POST'' method.
The attribute values from the returned JSON object can then be modified before submitting the new element using the ''POST'' method.
 
   GET http://host:port/configurations/NewCFG/h248_stacks/new
== Getting the default values ==
Let's start with getting the default values for a new element.
 
   GET host:port/configurations/NewCFG/h248_stacks/new
   <- Content: {
   <- Content: {
   "***meta***" : {
   "***meta***" : {

Revision as of 13:01, 27 November 2015

H.248 Configuration

The simplest approach to configuring H.248 is to POST only attributes for which we want non-default values. The structure of the H.248 JSON object can be queried by getting the default values, explained later on on this page.


H.248 Stack addition

This example uses default values mostly, but for some attributes, we want specific values:

 POST /configurations/{NewCFG}/h248_stacks {
 "***meta***" : {
   "version" : "2.9.10"
 },
 "advanced_parameters" : {
   "serialize_null_context_commands" : true
 },
 "enabled" : true,
 "naps" : [
   "NAP_TDM",
   "RTP_NAP"
 ],
 "timers" : {
   "local_response_timer" : "4 seconds"
 },
 "transport_protocol" : {
   "ip_interface" : "TB0999999.SIG",
   "public_ip_address" : "212.162.61.24",
   "use_ip_interface" : true
 }
 }

Here it is assumed that the configuration NewCfg is already existing. TB0999999.SIG is the IP interface name to use for the H.248 signalling trafic. This name must be globally unique, and therefore the SerialNumber of the device must be prepended to the IP interface name. For example: File:IpInterfaceName.jpg


Getting the default values

To add a H.248 to a new configuration, it might be helpful to get the default values first. This can be done with a GET with using new as element name under the h248_stacks collection. The attribute values from the returned JSON object can then be modified before submitting the new element using the POST method.

 GET http://host:port/configurations/NewCFG/h248_stacks/new
 <- Content: {
 "***meta***" : {
   "version" : "2.9.10"
 },
 "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" : "",
   "local_port_to_receive_for_text_encoding" : 2944,
   "public_ip_address" : "",
   "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
 },
 "h248_media_gateway_controllers" : {
 },
 "h248_tdm_terminations" : {
 }
}

Getting the default values