> For the complete documentation index, see [llms.txt](https://prosbcdocs.telcobridges.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://prosbcdocs.telcobridges.com/tmedia-documentation/configuration/creating-an-h-248-configuration.md).

# Creating an H.248 Configuration

> **Applies to:** Tmedia 3.0, 3.2, 3.3

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

1- Click **H248** in the navigation panel

![Create H248 0](https://docs.telcobridges.com/w/images/7/7e/Create_H248_0.png)

2- Create the new configuration:

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

![Create H248 1](https://docs.telcobridges.com/w/images/8/85/Create_H248_1.png)

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

![Create H248 2](https://docs.telcobridges.com/w/images/8/8c/Create_H248_2.png)

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](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/h-248-service-affecting-parameters/README.md)

Please reference the complete list of Paramters below before adding [Adding a media gateway controller (MGC)](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/adding-a-media-gateway-controller-mgc/README.md) and [Associating the NAPs with the H.248 configuration](https://github.com/telcobridges-main/tmedia-wiki/tree/main/tmedia/configuration/associating-naps-with-an-h-248-configuration/README.md)

![Edit H248 0](https://docs.telcobridges.com/w/images/9/94/Edit_H248_0.png)

### Full List of Parameters

* [Enabled](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/enabled/README.md) **Transport Protocol**
* [Transport Protocol Type](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/transport-protocol-type/README.md)
* [Public IP Address](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/public-ip-address/README.md)
* [Use IP interface](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/use-ip-interface/README.md)
* [Local IP Address](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/local-ip-address/README.md)
* [Local Port to Receive for Text Encoding](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/local-port-to-receive-for-text-encoding/README.md)
* [IP ToS value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/ip-tos-value/README.md)

**Advanced Parameters**

* Behavior
  * [Relay Unknown H248 Parameters](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/relay-unknown-h248-parameters/README.md)
  * [Compact H248 Descriptor Headers](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/compact-h248-descriptor-headers/README.md)
  * [Send Transaction Response Acks](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/send-transaction-response-acks/README.md)
  * [Send Transaction Response Acks Immediately](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/send-transaction-response-acks-immediately/README.md)
  * [Send Transaction Pending Automatically](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/send-transaction-pending-automatically/README.md)
  * [No Remote Response](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/no-remote-response/README.md)
  * [Null Terminating H248 Message](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/null-terminating-h248-message/README.md)
  * [No Only Ephemeral](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/no-only-ephemeral/README.md)
  * [Loose H248 Message Decoding](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/loose-h248-message-decoding/README.md)
  * [Transparent SDP](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/transparent-sdp/README.md)
  * [No SCTP Send Acknowledge](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/no-sctp-send-acknowledge/README.md)
  * [No failover service changes](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/no-failover-service-changes/README.md)
  * [Observe default CAS events](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/observe-default-cas-events/README.md)
* Analog display
  * [FSK Variant](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/fsk-variant/README.md)
  * [FSK Level](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/fsk-level/README.md)
  * [Mark Bytes sent before FSK message](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/mark-bytes-sent-before-fsk-message/README.md)
  * [Seizure Bytes Used before Mark Bytes](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/seizure-bytes-used-before-mark-bytes/README.md)
* [Maximum Number of Retransmissions](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/maximum-number-of-retransmissions/README.md)
* [Serialize null context commands](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/serialize-null-context-commands/README.md)
* [Allow wildcard in service change](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/allow-wildcard-in-service-change/README.md)
* [Switch to Passthrough on tdm/ec=OFF](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/switch-to-passthrough-on-tdm-ec-off/README.md)
* [IP Lawful Interception ToS value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/ip-lawful-interception-tos-value/README.md)
* [Maximum Number of TDM Terminations](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/maximum-number-of-tdm-terminations/README.md)
* [Maximum Number of Ephemeral Terminations](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/maximum-number-of-ephemeral-terminations/README.md)
* [Default MEGACO version](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/default-megaco-version/README.md)
* [Maximum Number of DNS Pending Requests](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/maximum-number-of-dns-pending-requests/README.md)
* [Ephemeral Termination Identifier Root](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/ephemeral-termination-identifier-root/README.md)
* [Ephemeral Termination Identifier Maximum Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/ephemeral-termination-identifier-maximum-value/README.md)
* [Number of Worker Threads](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/number-of-worker-threads/README.md)
* Profile
  * [Enabled](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/enabled/README.md)
  * [Profile Name](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/profile-name/README.md)
  * [Profile Version](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/profile-version/README.md)
* Timers
  * [Default Sent Transaction Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/default-sent-transaction-timer-value/README.md)
  * [Maximum Sent Transaction Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/maximum-sent-transaction-timer-value/README.md)
  * [Provisional Reply Transaction Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/provisional-reply-transaction-timer-value/README.md)
  * [Saved Replied Transaction Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/saved-replied-transaction-timer-value/README.md)
  * [Dialing Start Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/dialing-start-timer-value/README.md)
  * [Dialing Short Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/dialing-short-timer-value/README.md)
  * [Dialing Long Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/dialing-long-timer-value/README.md)
  * [Dialing Duration Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/dialing-duration-timer-value/README.md)
  * [Restart Timer Value to Retry Controller Association](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/restart-timer-value-to-retry-controller-association/README.md)
  * [Local Response Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/local-response-timer-value/README.md)
  * [Inactivity Timer Value](https://github.com/telcobridges-main/tmedia-wiki/tree/main/reference/parameters/inactivity-timer-value/README.md)

**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
  }
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://prosbcdocs.telcobridges.com/tmedia-documentation/configuration/creating-an-h-248-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
