Introduction
The beroNet gateways and cards can receive their configuration via tftp or http. This method can be used to automaticaly 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.
...
This Document provides a step by step guide on how to provision the beroNet gateways and cards.
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 server, only if you want to use auto-provisioning via dhcp.
Provisioning with Firmware 3.XX
The backup and provisioning uses the backup file package which can be downloaded in the WebGUI of the device.
...
- manual configuration via the GUI
- automatic configuration via the API
- automatic configuration via DHCP
Provisioning URL
In any case the location of the configuration files is an URL including the server and the directory where the files reside. The beroNet devices support special variables that can be used in the URL:
...
this enables the webserver to provide different config files to different devices, even though the same provisioning URL is set in each device.
manual configuration via the GUI
This method is very simple, you can manually configure the provisioning URL under Preferences→Provisioning. You need to enable "Manual configuration" and then you need to define If the Provisioning should happen:
...
After save & activate the device will attempt the provisioning after the next reboot.
configuration via the API
The beroNet API is described here: Using the beroNet Gateway & Card API. For Provisioning just a few API commands are required:
...
| 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 completely automatic via the DHCP Server. This is called zerotouch provisioning and works in the following way:
...