Introduction
The beroNet gateways Gateways and cards Cards can receive their configuration via tftp or http. This method can be used to automaticaly automatically provision the devices. The basic concept is, that the same configuration files that are provided via the backup function, can be used to provision the device. This gives the user the possibility to configure the device in the way he wants via the GUI and then simply download the backup of this configuration and use it to provision multiple devices at once and automatic.
...
- Firmware 1 and 2 had http/tftp provisioning which needed to be triggered by using the API
- Firmware Version 3 introduced DHCP auto-provisioning
- Firmware Version 16 introduced a new API, XML - style of backups and single file provisioning
This Document document provides a step by step guide on how to provision the beroNet gateways Gateways and cardsCards.
Prerequirements
In order to provision beroNet devices you will need control over at least a web- or tftp-server. This server provides the configuration files either as plain files or generated via a script. Starting from firmware version 3 you will need control over a dhcp DHCP server, only if you want to use auto-provisioning via dhcpDHCP.
Provisioning with Firmware 3.XX
...
- set a provisioning URL for one time configuration updates
- trigger the configuration fetch mechanism
- activates the new configurion configuration without reboot
| Code Block |
|---|
http://172.20.5.10/app/api/api.php?apiCommand=ProvisioningSetConfiguration&Mode=once&Url=http://172.20.5.16/{serial}/
ProvisioningSetConfiguration:success
http://172.20.5.10/app/api/api.php?apiCommand=ProvisioningTriggerConfig
updateConfig:info:config_provisioning_enabled_by_server updateConfig:info:updated:hardware.conf updateConfig:info:updated:isgw.analog updateConfig:info:updated:isgw.cas updateConfig:info:updated:isgw.causes updateConfig:info:updated:isgw.conf updateConfig:info:updated:isgw.cpt updateConfig:info:updated:isgw.dialplan updateConfig:info:updated:isgw.gsm updateConfig:info:updated:isgw.isdn updateConfig:info:updated:isgw.sip updateConfig:info:updated:isgw.tdm updateConfig:info:updated:misc.conf updateConfig:info:updated:network.acl updateConfig:success:config_provisioning:beronet-D8DF0D0035F4-3-04-0000016254.config.xml ProvisioningTriggerConfig:success
http://172.20.5.10/app/api/api.php?apiCommand=ConfigurationActivate&Option=1
ConfigurationActivate:success |
...
Automatic configuration via DHCP
The beroNet devices can be provisionened provisioned completely automatic via the DHCP Serverserver. This is called zerotouch provisioning and works in the following way:
- Default Network configuration is DHCP
- Device requests DHCP Settingssettings
- Device receive TFTP Option 66 AND 67
- Device starts provisioning of URL provided by option 67 on server provided by option 66
The URL has the same format as in the manual or API configuration, for example:
NOTE: Currently the microsoft Microsoft DHCP Server can not provision option 66, so DHCP Provisioning provisioning will not work with the MS DHCP Server.
...