# Trunk Groups

Defines a list of [Trunks](https://public.intellasoft.net/books/cli/page/trunk) to consider when making a call. The system will attempt to call out to trunks in the order they are defined, and if each one fails, the call will not be completed. It is important to have your **Trunks** defined before creating a **Trunk Group**.

# Adding a Trunk Group

1\) Enter the CLI's configuration mode.

2\) Enter the name of the Trunk Group you wish to create. You will be prompted with the minimum required settings.

```
vbox-markm(config)# trunk_group main_office
!! Notice: Editing new item: main_office
!! Notice: Minimum requirements needed for insert:
!!   desc
!!   capacity
vbox-markm(config-trunk-group main_office)# desc "Main Office Trunk Grou"
vbox-markm(config-trunk-group main_office)# capacity 20
vbox-markm(config-trunk-group main_office)#
```

<div class="columnLayout single" data-layout="single" id="bkmrk-"><div class="cell normal" data-type="normal"><div class="innerCell"><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-confluence nogutter  java" id="bkmrk-vbox-markm%28config%29%23--1"></div></div></div></div></div></div></div>3\) Next define the **Trunks** that the **Trunk Group** will call out to. We will assume we are using 3 **Trunks** in this example.

```
vbox-markm(config-trunk-group main_office)# trunk_pos 1
vbox-markm(config-trunk-group main_office pos-1)# trunk_name          ### Use Tab to get a list of available trunks
AudioCodesFXO1    branch-iax        isoft-sr-in-2     pbx-sip-t1-gw2    building_a        isoft             pbx-sip-t1-gw1    isoft-sr-out-1    Nathan_Test_Trunk isoft-vit-out-1   isoft-sr-in-1
trunk-bob
vbox-markm(config-trunk-group main_office pos-1)# trunk_name building_a
vbox-markm(config-trunk-group main_office pos-1)# exit                ### Returns to main config options for the trunk group
vbox-markm(config-trunk-group main_office pos-1)# exit force
vbox-markm(config-trunk-group main_office)# show
! Generating running-config
!!!
 
! -------------- Trunk Groups ----------------
trunk_group main_office
  callerid passthrough
  capacity 20
  desc "Main Office Trunk Grou"
  record inherit
  trunk_pos 1                       ### This trunk group has been successfully added as position 1
    trunk_name building_a
    exit
  exit
 
exit
 
vbox-markm(config-trunk-group main_office)#
```

<div class="columnLayout single" data-layout="single" id="bkmrk--1"><div class="cell normal" data-type="normal"><div class="innerCell"><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-confluence nogutter  java" id="bkmrk-vbox-markm%28config-tr-1"></div></div></div></div></div></div></div>4\) Next as needed, add additional **Trunks** to the **Trunk Group.**

```
vbox-markm(config-trunk-group main_office)# trunk_pos 2
vbox-markm(config-trunk-group main_office pos-2)# trunk_name
AudioCodesFXO1    branch-iax        isoft-sr-in-2     pbx-sip-t1-gw2    building_a        isoft             pbx-sip-t1-gw1    isoft-sr-out-1    Nathan_Test_Trunk isoft-vit-out-1   isoft-sr-in-1
trunk-bob
vbox-markm(config-trunk-group main_office pos-2)# trunk_name isoft
vbox-markm(config-trunk-group main_office pos-2)# exit
vbox-markm(config-trunk-group main_office pos-2)# exit force
vbox-markm(config-trunk-group main_office)# trunk_pos 3
vbox-markm(config-trunk-group main_office pos-3)# trunk_name
AudioCodesFXO1    branch-iax        isoft-sr-in-2     pbx-sip-t1-gw2    building_a        isoft             pbx-sip-t1-gw1    isoft-sr-out-1    Nathan_Test_Trunk isoft-vit-out-1   isoft-sr-in-1
trunk-bob
vbox-markm(config-trunk-group main_office pos-3)# trunk_name Nathan_Test_Trunk
vbox-markm(config-trunk-group main_office pos-3)# exit
vbox-markm(config-trunk-group main_office pos-3)# exit force
vbox-markm(config-trunk-group main_office)#
```

<div class="columnLayout single" data-layout="single" id="bkmrk--2"><div class="cell normal" data-type="normal"><div class="innerCell"><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-confluence nogutter  java" id="bkmrk-vbox-markm%28config-tr-3"></div></div></div></div></div></div></div>5\) Lastly use the **show** command to ensure your settings have been saved.

```
vbox-markm(config-trunk-group main_office)# show
! Generating running-config
!!!
 
! -------------- Trunk Groups ----------------
trunk_group main_office
  callerid passthrough
  capacity 20
  desc "Main Office Trunk Grou"
  record inherit
  trunk_pos 1                     
    trunk_name building_a
    exit
  trunk_pos 2
    trunk_name isoft
    exit
  trunk_pos 3
    trunk_name Nathan_Test_Trunk
    exit
  exit
 
exit
 
vbox-markm(config-trunk-group main_office)#
```

<div class="columnLayout single" data-layout="single" id="bkmrk--3"><div class="cell normal" data-type="normal"><div class="innerCell"><div class="code panel pdl conf-macro output-block" data-hasbody="true" data-macro-name="code" style="border-width: 1px;"><div class="codeContent panelContent pdl"><div><div class="syntaxhighlighter sh-confluence nogutter  java" id="bkmrk-vbox-markm%28config-tr-5"></div></div></div></div></div></div></div># Trunk Groups Settings Description

You can also use the "**?**" key to view the option descriptions while in CLI. **\*** indicates a required setting.

<table border="1" class="relative-table confluenceTable tablesorter tablesorter-default" id="bkmrk-callerid-callerid-op" role="grid" style="width: 93.2099%; border-collapse: collapse; border-style: solid;"><thead><tr><td style="width: 28.7823%;">Option  
</td><td style="width: 71.2177%;">Description  
</td></tr></thead><tbody><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">callerid</td><td class="confluenceTd" style="width: 71.2177%;">Callerid option for when this trunk group is utilized.</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">callerid\_number\_postpend </td><td class="confluenceTd" style="width: 71.2177%;">Append these digits to the callerid when making an outbound call on this trunk group</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">callerid\_number\_prepend </td><td class="confluenceTd" style="width: 71.2177%;">Prepend these digits to the callerid on outbound calls after processing removal</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">callerid\_number\_remove </td><td class="confluenceTd" style="width: 71.2177%;">Force remove digits from callerid for outbound calls</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">callerid\_number\_replace</td><td class="confluenceTd" style="width: 71.2177%;">Force replace callerid with this number for outbound calls on this trunk group</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">capacity</td><td class="confluenceTd" style="width: 71.2177%;">(\*) Maximum number of concurrent calls to/from this trunk group</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">desc</td><td class="confluenceTd" style="width: 71.2177%;">(\*) Non-functional description of this trunk group</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">do</td><td class="confluenceTd" style="width: 71.2177%;">To run exec commands in config mode</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">exit</td><td class="confluenceTd" style="width: 71.2177%;">Exit from this level (with notification of incomplete config)</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">no</td><td class="confluenceTd" style="width: 71.2177%;">Clear settings</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">record</td><td class="confluenceTd" style="width: 71.2177%;">Whether to record all calls to/from this trunk group</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">reorder</td><td class="confluenceTd" style="width: 71.2177%;">Change the order of trunk group includes</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">show</td><td class="confluenceTd" style="width: 71.2177%;"> Show the running-config for the current item</td></tr><tr role="row"><td class="confluenceTd" style="width: 28.7823%;">trunk\_pos</td><td class="confluenceTd" style="width: 71.2177%;">Create or change an include in this trunk group</td></tr></tbody></table>