Versions Compared

Old Version 3

changes.mady.by.user Baremans, Eric

Saved on

compared with

New Version Current

changes.mady.by.user Baremans, Eric

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

   

Parameter list.

Here you can find the complete auto provisioning parameter list for the N870

 

Hierarchy of XML files for the provisioning.

Let’s assume that the structure of directory containing all the provisioning files on the provisioning server has a next hierarchy and the further .xml files are presenting the case marked with a red arrow:

 Image Removed

                                                                                                                                                               

Examplarery hierarchy

Section

Introduction

The Provisioning Server URL can be found in the web-interface under: Settings - System - Provisioning and Configuration

How to configure the provisioning URL:

The provisioning server URL can be provided via the following Methods:

  1. DHCP option 114
  2. SIP Multicast
  3. Gigaset Redirect server
  4. Manually via web-interface
Columnalign
widthalign70%
Column
width30%

Table of Contents

Section
Warning
titleImportant note!

Usage of empty or inappropriate values in value=” ” (see configuration.xml example below) can
lead to unpredictable behavior. Please, fulfill this field carefully according to the standards. 

1) provisioning.xml
Code Block
languagexml
titleprovisioning.xml
<?xml version="1.0" encoding="UTF-8"?>
	<provisioning version="1.0" productID="e2">
 			<category type="nvm"url="http://172.29.17.156/specific_path/nvm/updates.xml"/>
 	</provisioning>
2) updates.xml
Code Block
languagexml
titleupdates.xml
<?xml version="1.0" encoding="UTF-8"?>
	<nvm version="1.0" productID="e2">
		<file version="2015-10-10_10:10:10" url="http://172.29.17.156/specific_path/nvm/configuration.xml"/>
 	</nvm>

3) configuration.xml

With 2016 software, the version value in this step 3 is changed from "date and time" to "1.0"

The "macAddress" is optional, see wiki article.

Code Block
languagexml
titleconfiguration.xml
<?xml version="1.0" encoding="UTF-8"?>
	<settings version="1.0" productID="e2" macAddress= "7c:2f:80:00:00:00">  
		<!-- SIP -->
		
		
	</settings>
 
right

Valid for:

N610

N670

N870

N870E

Embedded Integrator

Virtual Integrator

Panel
titleBGColor#F0F0F0
titleValid for N610 / N670 / N870 / N870E.

The auto provisioning flow is described below. 

Preferred Method, all settings are in one XML file

draw.io Diagram
bordertrue
diagramNameEIN2Provisioning
simpleViewerfalse
width
linksauto
tbstyletop
lboxtrue
diagramWidth883
revision1

FAQ - Auto provisioning: MAC.xml example



2e Method, usage of multiple XML files
Expand
titleMultiple XML files
1

Provisioning URL = URL to a server.

N870 tries to download the file "provisioning.xml"

If the file "provisioning.xml" is not on the server, the N870

will try to download the file "<MAC>.xml", see the above method.

The "provisioning.xml" file contains information about the

location and naming of the next files to be downloaded.

draw.io Diagram
diagramNameN870ProvisioningFlow.drawio
diagramWidth523
revision2

2

Via the "provisioning.xml" settings, the device will try to

download information about the available firmware and will

provide information where the firmware file can be downloaded

(Step 4). This step is optional and could be skipped if needed.

3

The "firmware/update.xml" provides the URL of the firmware

file. This step is optional and could be skipped if needed.

4

Via the "provisioning.xml" settings, the device will try to

download information about the configuration file and will

provide the URL where this file can be downloaded.

(Step 6). This step is optional, but always used as configuration

is always needed.

5

The "nvm/update.xml" provides the URL of the

configuration file. This file contains all configuration parameters.

This step is optional and could be skipped if needed.

6

Via the "provisioning.xml" settings, the device will try to

download information about the custom settings file and will

provide the URL where this file can be downloaded.

(Step 8). This step is optional and could be skipped if needed.

7

The "custom/update.xml" provides the URL of the custom

settings, certificates, ...

This step is optional and could be skipped if needed.

Section

Example1:

  • Provisioning is done via an own local server with IP address: 192.168.178.101
  • All the provisioning files are in the directory maxwell
  • The URL to the provisioning server is: http://192.168.178.101/maxwell

When the device comes online after reboot, it will try to search in the above directory for the file "provisioning.xml".

In this file, the information about the other files is stored. Like, where to find the file "updates.xml" that contains the link to the file containing all the settings.

<MAC>.xml, the settings of the device can be found.

Info
titleInfo
When you use this provisioning, the version value (version="2017-01-18_11:37:14") in the updates.xml must be increased every-time a new file must be downloaded. If the value is the same or older, then the device will not download the <MAC.xml>