Contents
Introduction to Roaming Numbers
Roaming numbers can be set using YateMMI interface(starting with release 6005) together with the option to automatically Generate routing for roaming numbers with an easy to use configuration.
For setting up a new network we have the following options:
- defining ranges in Network Settings (setting general rules for all YateUCN machines)
or
- define roaming ranges individually for each YateUCN/YateUCN5G equipment
In case of need to modify an existing network:
-
Edit from Network Setting(delete or edit ranges)
-
Add/Edit on each Equipment(disassociate & associate new Roaming numbers)
and depending on the circumstances:
- Equipment reconfig on all YateUCN
New network - Roaming numbers set-up
Defining ranges in Network Settings (fist method)
Go to Network setting→ set Roaming numbers per server (YateUCN) → Add range of the pool(s) → When Adding equipment type YateUCN →go to step VLR\CSCF → Choose from checking the suggested range or manually input the range you want to use on the selected Equipment.
- From My Network, go to Network Setting
- Go to Roaming numbers step
- Set Roaming numbers per server (count of Roaming Numbers to suggest for each YateUCN)
- Ranges of Roaming numbers can be manually inserted in this step by pressing on [Add range]
- To save the changes click [Finish].
- Then, go to Equipment and press [Add Core equipment] to add an YateUCN equipment.
- Go to the VLR\CSCF step and associate the roaming numbers with the YateUCN equipment.
- You can choose to check and use the suggested ranges.
- To save the changes press [Next] until you finish setting up YateUCN and then press [Finish].
Notes:
You can set multiple Roaming numbers ranges from the Roaming numbers step in Network Settings.
Based on the number set per server, ranges of that specified amount of roaming numbers will be suggested on each YateUCN/YateUCN5G equipment. You can add multiple ranges.
There is a limit of a maximum of 100 Roaming numbers to be set for each YateUCN/YateUCN5G.
- When the Suggested range is displayed per Equipment, the range reflects the number per server set in Network Settings, and the interval cannot be modified. It can only be accepted as it is, or add a new custom range manually.
If Free Roaming numbers ranges are set in Network Setting, roaming number range will automatically be suggested in Add Equipment based on the number per server set.
If no Roaming numbers ranges are set in Network Settings, then no suggestion will be displayed in Equipment; user can add roaming number range manually.
Ranges can be deleted only from Network Settings.
- Ranges can be dissociated only from Equipment.
Define custom ranges directly from "Add equipment" (second method)
Even without going to Network Settings, Roaming numbers can be set when adding a new equipment (or editing it).
From “Add Equipment” →Node type YateUCN → VLR/CSCF module → in the VLR section you can set “Roaming numbers” range.
- To define Roaming ranges in new Equipment:
- To add an equipment go to Equipment context (menu entry) and click [Add core equipment] and a software wizard will help you with the configuration steps.
- As a Node type select YateUCN and complete with your information
- Navigate to the VLR/CSCF step to modify roaming numbers settings
- In the Roaming numbers section press on [Add range]
- You can manually create a Roaming numbers ranges that will be associated with this YateUCN.
- To save the changes press [Next] until you finish setting up YateUCN and then press [Finish].
Notes:
Roaming numbers range can be added manually.
After setting them up, the used range will appear as “In use” in Network settings → Roaming.
If you disassociate Roaming numbers from Equipment, they may appear as “Free” in Network settings → Roaming.
Roaming numbers can be deleted only from Network Settings, from Equipment they can only be disassociated, as in moved to the “Free” status pool, and can be associated on other equipment.
Values are preserved when using [Next] or [Previous] buttons, so you can navigate through the equipment steps freely without loosing the inserted data. The changes are made to the database on Finishing wizard (not before!).
Example
If in our network we introduced the following ranges:
- 4000000001 – 4000000050
- 5000000001 – 5000000050
Allocating 10 roaming numbers per server (per YateUCN)
On each YateUCN equipment the first 10 free roaming numbers from Network Settings will be suggested
– for the first YateUCN equipment, the suggested roaming number range will be 4000000001- 4000000010;
– for the second YateUCN equipment, if the first 10 roaming numbers were already allocated, the suggested interval will be 4000000011 – 4000000020;)

Notes:
You do not have the option to choose from which range defined in Network Settings to allocate the 10 roaming numbers on equipment.
Only when all the roaming numbers from the first Network Settings roaming numbers range will be allocated, the suggestions on equipment will start using the second defined roaming number range from Network Settings.
If in our network we introduced the following ranges:
- 4000000001 – 4000000050
- 5000000001 – 5000000050
Allocating 100 roaming numbers per server (YateUCN)
On each YateUCN equipment the first 100 free roaming numbers from Network Settings will be suggested.
- Suggestion on equipment will display both ranges from Network Settings, as the number per server is higher than the first range defined of roaming numbers so the second range defined of roaming numbers is also used to display a total suggested of 100 roaming numbers

Notes:
- When the Suggested range is displayed per Equipment, the range reflects the number per server set in Network Settings, and the interval cannot be modified. It can only be accepted it as it is, or add a new custom range manually.
There is the option to delete ranges from Network Settings.
Enable generation of routing for roaming numbers
- Enable on all equipment
In order to automatically generate routing for roaming numbers on all YateUCN equipment this item has to be checked:
- From Network Settings, go to Node params
- Select Equipment Type YateUCN
- In the VLR section check “Generate routing for roaming numbers“
- Enable on individual equipment
In order to automatically generate routing for roaming numbers on a single YateUCN equipment the checkbox next to it has to be checked. For caution reasons, this setting can be activated only after pressing the button “Modify” next to it.
- From Equipment, go to VLR/CSCF
- In the VLR section press [Modify]
- Now you can check “Generate routing for roaming numbers“
Already existing network - Roaming numbers set-up
In case we need to update or modify an existing network, which already has YateUCN/YateUCN5G equipment set-up, then we can edit the Equipment and depending on the circumstances, reconfiguring all the equipment might be required.
Editing ranges in Network Settings
- Previous settings:
- If there were Roaming numbers set previously for current YateUCN/YateUCN5G equipment using an older YateMMI version (First Roaming Number, Count of Roaming Numbers)
- they will be ported and displayed as a range in the new implemented table.
- If nothing was set previously you can
- add Roaming numbers range manually,
- or if there are free roaming numbers ranges already set in Network Settings you can press the [Suggest Range] button and you can choose to accept the suggested range or not.
- When adding roaming numbers range in Network Settings (without associating it to an equipment), no equipment should be reconfigured.
When removing dissociated roaming numbers from Network Settings, no equipment should be reconfigured.
When removing roaming numbers associated with an equipment from Network Settings, all the YateUCN/YateUCN5G should be reconfigured.
- To edit Roaming ranges in Network Settings
Go to Network setting→ go to Roaming numbers where you can edit: Roaming numbers per server, Adding or Removing ranges → Then go to Equipment → YateUCN → VLR\CSCF → and verify the changes corresponds to your needs or change them manually.
- From My Network, go to Network Setting
- Go to Roaming numbers step
- And you can edit:
- Roaming numbers per server (count of Roaming Numbers to suggest for each YateUCN)
- Ranges of Roaming numbers can be manually inserted in this step by pressing on [Add range] or
- Ranges of Roaming numbers can be deleted by pressing on [Remove]. The entire range can be deleted or just a certain interval of the range.
- To save the changes click [Finish].
- Then, go to Equipment and select the desired YateUCN equipment to edit.
- Go to the VLR\CSCF and verify the changes corresponds to your needs, then Accept the suggest range (or change them manually).
- To save the changes press [Next] then [Skip] to the end of YateUCN set-up and then press [Finish].
Edit equipment - on each YateUCN
- Previous settings:
- If there were Roaming numbers set previously for current YateUCN/YateUCN5G equipment using an older YateMMI version (First Roaming Number, Count of Roaming Numbers)
- they will be ported and displayed as a range in the new implemented table.
- If nothing was set previously you can
- add Roaming numbers range manually,
- or if there are free roaming numbers ranges already set in Network Settings you can press the [Suggest Range] button and you can choose to accept the suggested range or not.
- When adding or disassociating roaming numbers to equipment, all the YateUCN/YateUCN5G should be reconfigured.
- To edit Roaming ranges on an equipment:
- Use right button [Edit] or click on a YateUCN equipment and press [Edit] button.
- Navigate to the VLR/CSCF step to modify roaming numbers settings
- In the Roaming numbers section you can:
- press [Suggest range] to have another range suggested from the roaming number range that is not in use at the moment.
- press on [Add range] to add another range
- press [Disassociate] to remove the associated roaming numbers from this YateUCN
- To save the changes press [Next] then [Skip] to the end of YateUCN set-up and then press [Finish].
Notes:
Once the [Suggest Range] button is used, it disappears, since there are no more options to be suggested
If there are no free roaming numbers in Network Settings -> [Suggest Range] button is not displayed.
Values are preserved when using [Next] or [Previous] buttons, so you can navigate through the equipment steps freely without loosing the inserted data. The changes are made to the database on Finishing wizard (not before!)
Enable generation of routing for roaming numbers
With the new YateMMI update, this option can be checked from the YateMMI interface, in order to generate routing for roaming numbers.
To work as expected from the interface, the set-up in Scripts/Routing about Roaming numbers has to be removed.
Routing still works accordingly from Scripts/Routing and it can be kept if this is the preferred method. The files written in Scripts/Routing will have priority and even if the section “Generate routing for roaming numbers” is checked in the interface, it won’t overwrite the custom files.
- Generate routing for roaming numbers automatically
In order to automatically generate routing for roaming numbers on all YateUCN equipment this item has to be checked:
- From Network Settings, go to Node params
- Select Equipment Type YateUCN
- In the VLR section check “Generate routing for roaming numbers“
- Generate routing for roaming numbers automatically
In order to automatically generate routing for roaming number only on a specific YateUCN equipment:
- From Equipment, go to VLR/CSCF
- In the VLR step check “Generate routing for roaming numbers“
How to delete Roaming numbers ranges
Roaming numbers can be deleted only from Network Settings, from Equipment they can only be disassociated and free to use on other equipment.
-
You can delete
- the entire range (default suggested option), or
- a specific part of the range by specifying the interval of the values you want to delete
-
ExampleIn order to delete the first 20 numbers of the 5000000001 – 5000000050 roaming numbers range, we will specify for 5000000001 – 5000000020 interval to be deleted
JSON
-> under VLR section, roaming numbers will be displayed as array
-> additionally, for YateUCN/YateUCN5G equipment, “call_handle” section was added, containing info about all the YateUCNs/YateUCN5Gs from within the network, such as node type, roaming numbers, SIP listeners (listeners from both VLR and Account steps).