Route
Routes define what Trunk Group to use when a certain Pattern is dialed.
Adding a Route
1) Enter the CLI's configuration mode
2) Enter a name for the new Route. You will then be prompted to enter the minimumsminimum options needed to create the new route.
ld11_reg local ld10 ld11 intl ld10_reg emergvbox-nathan(config)# route A_Route!! Notice: Editing new item: A_Route!! Notice: Minimum requirements needed for insert:!! pattern ### see next step!! trunk_group!! descvbox-nathan(config-route A_Route)# desc "Local and Long Distance Numbers +9"vbox-nathan(config-route A_Route)# trunk_group ### use tab to get a list of the trunks you have made
pbx-sip-t1 defaultvbox-nathan(config-route A_Route)# trunk_group pbx-sip-t1 |
3) Next enter a Pattern for the route. The Pattern represents the combination of numbers that the Trunk Group will use when making a call. In many casescases, there will be multiple routes to define multiple types of patterns. Below is an example of what default Routes look like on a freshly installed system.
| Route | Desc. | Trunk Group | Pattern | Replace | Remove | Prepend | Postpend |--------------------------------------------------------------------------------------------------------------------------------------
| ld11_reg | Long Distance 11 Digit without a 9 | pbx-sip-t1 | 1XXXXXXXXXX | | | | |
| intl | International | pbx-sip-t1 | 9011X. | | +1 | | |
| ld11 | Long Distance 11 Digit | pbx-sip-t1 | 91NXXXXXXXXX | | +1 | | |
| emerg | Emergency | pbx-sip-t1 | 9911 | | +1 | | |
| ld10 | Long Distance 10 Digit | pbx-sip-t1 | 9NXXXXXXXXX | | +1 | 1 | |
| local | Local 7 Digit | pbx-sip-t1 | 9XXXXXXX | | +1 | | |
| ld10_reg | Long Distance 11 Digit without a 9 | pbx-sip-t1 | XXXXXXXXXX | | | 1 | |
-------------------------------------------------------------------------------------------------------------------------------------- |
Pattern
As you can see above patterns are not limited to just numbers only, but rather can include specific characters to broaden or narrow down the range of types of calls that the routes will take. You are able to use the following characters to help further define a route that is to be taken:
Xmatches any digit from 0-9Zmatches any digit from 1-9Nmatches any digit from 2-9[1237-9]matches any digit or letter in the brackets (in this example, 1,2,3,7,8,9).wildcard, matches one or more characters!wildcard, matches zero or more characters immediately[a-z]matches anylower caselowercase letter (not frequently used/recommended)[A-Z]matches any UPPER case letter (not frequently used/recommended)
Replace (processed first)
The replace function will replace a pattern of numbers completely with the defined number included in the replace function.
- Example:
AThe numberof518-268-3769 matches the pattern of a route with a replace function set to 5000. Instead of using the 518 number it uses the 5000 number instead plus any of the other functions listed thereafter (such as remove, prepend or postpend)
Remove (processed second)
The remove function will remove numbers from the beginning or end of a pattern dependentdepending on how it is configured. For exampleexample, a +, will remove the first digit from a number pattern, whereas 1,1-3 would remove the last 3 from a pattern.
- Example 1:
AIf the numberof"518-268-37693769" matches the pattern of a Route with a remove of "+1,1", itwillwill remove the first numberof 5,("5") leaving "18-268-37693769" (just an example, obviously this is an invalidnumber,number unless it were an internal extension). - Example 2:
TheIf the same number as above matches the Pattern of a Route with a remove of "-3.3". It will remove the last numbers in the sequence leavingathe number5182683"5182683" to be dialed (again just an example).
Prepend (processed third)
Prepend will add a specific string of numbers depending on what numbers are defined. In the default routes aboveabove, many of the numbers are prepended with a 1 to make them valid long long-distance phone numbers that can be used on the PSTN (public switched telephone network).
- Example 1:
AThe numberof"518-268-37693769" matches a route with a prepend of 1, so it will add the number 1 infrontfront,of the string of number somaking the actual numberbeingused by the trunk handlerwould be"1-518-268-3769.3769". - Example 2:
AThe numberof"268-37693769" matches a route with a prepend of 518, so it will add the numbersof 518"518" in front of thestringoriginalof numbersnumber so the actual number being used by the trunk handler would be 518-268-37693769.
Postpend (processed last)
Postpend functionis the exact opposite of prependprepend,, instead of adding numbers to the beginning of a pattern, it will add numbers to an end of a pattern.
- Example:
AThe numberof"518-268268" matches a route with a postpend of3769,"3769", it will add thenumbersnumberof 3769"3769" to the end of the original number making the actualnumberednumber dialed out to the trunk handlerof"518-268-37693769".
By using a mix of the above settingssettings, you are able tocan dial in highly specific routes meant to send specific calls to certain places. In the example belowbelow, we are going to use this route as a means of calling a long long-distance number when someone is using a 9 dial dial-out number.
vbox-nathan(config-route A_Route)# pattern 9NXXXXXXXXX
vbox-nathan(config-route A_Route)# mangle_remove +1
vbox-nathan(config-route A_Route)# mangle_prepend 1 |
4) Lastly use the show command to ensure your settings have been saved.
! Generating running-config!!! -------------- Routes ----------------route A_Routecallerid passthroughdesc "Local and Long Distance Numbers +9"mangle_prepend 1mangle_remove +1pattern 9NXXXXXXXXXrecord inherittrunk_group pbx-sip-t1exit
exit |
Route Settings Description
You
| Comments | |
| callerid | Callerid option for when this route is utilized. |
| desc | (*) Non-functional description of this route. |
| do |
To run exec commands in config mode |
| exit |
Exit from this level (with notification of incomplete config) |
| mangle_postpend | Number Mangle: Add digits to the end of the dialed destination. This option is processed third. |
| mangle_prepend |
Number Mangle: Add digits to the beginning of the dialed destination. This option is processed second. |
| mangle_remove | Number Mangle: Remove digits from the dialed destination. This option is processed first. |
| mange_replace | Number Mangle: Replace the dialed destination with this. (Enabling this option will override all other |
| no |
Clear settings |
| override_callerid_name | Callerid name to force, if this route is utilized. |
| override_callerid_number |
Callerid number to force, if this route is utilized. |
| pattern | (*) Pattern to match dialed destination against that will activate this route. |
| record | Call recording option for when this route is utilized. |
| show |
Show the running-config for the current item |
| trunk_group | (*) The trunk group that this route will use to dial out. |