Introduction
Starting from Firmware 16.XX the beroNet Gateways and Cards have a single XML file for the functions:
- Backup
- Restore
- Provisioning
In older firmwares the backup consisted of a .tar.gz package of several configuration files. These files are still the same, but encoded into a simple XML file.
This method allows it to handle provisioning more easy, because a single request provides the whole gateway configuration.
File Format
The file is structured as follows:
<?xml version="1.0"?>
<beroNetProvisioning>
<Config>
<Update>[yes|no]</Update>
<File>
<Name>FILENAME</Name>
<Contents>
FILE-CONTENTS
</Contents>
</File>
</Config>
<Firmware>
<Install>[yes|no]</Install>
<Filename>FIRMWARE.[tar.gz|fw]</Filename>
<Url>https://second-provisioning-server.url/ANOTHER-FIRMWARE.[tar.gz|fw]</Url>
</Firmware>
</beroNetProvisioning>
As you can see the XML-Format is simply mostly a container for configuration files with a <name> and a <content> tag. There are some special tags:
- <update> - defines if the file should be used in a device that receives it via provisioning.
- <Firmware> - defines a firmware that can be installed and if this firmware should be installed
Please Note:
The <Url> flag in the <Firmware> section is optional and only available since the 21.03 firmware. It offers the possibility to download the firmware to a second webserver using https://second-provisioning-server.url/ANOTHER-FIRMWARE.[tar.gz|fw] as Provisioning-URL. (HTTP of HTTPS protocol can be used). When used, it replaces the <Filename> flag.
All current config-files for the 16.XX firmware are:
| file | description | mandatory? |
|---|---|---|
| hardware.conf | hardware and module related settings, like TE/NT and Synchronization Port for ISDN Ports | always mandatory |
| isgw.analog | contains the port groups and the group configuration for analog ports (FXS/FXO) | only if analog module present, otherwise emtpy |
| isgw.cas | contains CAS groups and their configurations (T1 module) | only if T1 module is present and set into CAS mode |
| isgw.causes | contains the ISDN causes to SIP response code map | always mandatory |
| isgw.conf | contains general configuration settings like logging and pcm bridging | always mandatory |
| isgw.cpt | call progress table for mapping SIP STATUS responses to ISDN STATUS Messages | mandatory but can be empty most times |
| isgw.dialplan | Dialplan which connects the technologies and contains number rewriting rules | always mandatory |
| isgw.gsm | contains GSM groups and their settings (GSM Module) | only if gsm module present, otherwise empty |
| isgw.isdn | contains the ISDN BRI and PRI groups and their settings | only if ISDN module present, otherwise empty |
| isgw.sip | contains the SIP Accounts and their configurations | only if SIP is used, general part should be provided always |
| isgw.tdm | contains the tdm timeslot configuration | always mandatory and depending on module combination, should be configured manually and then stored for each combination |
| misc.conf | contains several system related settings like network, snmp and cloud | always mandatory |
| network.acl | contains the firewall rules | always mandatory |