Snom Autoprovisioning

Aus STARFACE Wiki

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

snom Autoprovisioning

STARFACE PBX (ab v4.0) kann snom Telefone per der von snom vorgesehenen XML Provisionierungsschnittstelle mit Einstellungsdaten versehen. Jede STARFACE PBX enthält hierfür einen snom Provisioning Server. Der Provisioning Server basiert auf dem HTTP bzw. HTTPS Protokoll.

Normalerweise werden die Details zum Provisioning Server in die Telefone per SIP Multicast Verfahren (Zero-Touch-Provisioning) automatisiert und ohne manuellen Eingriff beim Startup des Telefons übertragen. In manchen Szenarien ist das SIP Multicast Verfahren jedoch nicht möglich, z.B. wenn ein Telefon ausserhalb des LAN der Starface betrieben wird (VPN, Home-Office o.ä.).

Der Administator hat die Möglichkeit, den Provisioning Server manuell in die Telefone zu konfigurieren (One-Touch-Provisioning) und so trotzdem alle Vorteile des Provisioningunssystems zu nutzen.

Icon-attention.png Achtung: snom Telefone mit Firmware Version kleiner v7.3.23 können Autoprovisioning nicht per HTTPS ausführen. Die Option Umleitung auf HTTPS erzwingen muss in STARFACE PBX < v4.0.3.0 deaktivert werden, bis alle Telefone mindestens diesem Softwarestand entsprechen!

Manuelle Provisioning Server Konfiguration

snom Provisioning Einstellungen

Der Settings Server wird im Web Interface des snom Telefons konfiguriert:

Setup -> Advanced -> Update -> Setting URL

  • Update Policy: Update automatically
  • Setting URL: siehe unten
  • PnP Config: Off

Setting URL - Generisch (ab STARFACE v5.0) 

http://<STARFACE-IP>:50080/ap/snom/{mac}.xml

Setting URL - Generisch (ab STARFACE v4.1 bis STARFACE v4.6) 

http://<STARFACE-IP>:50080/snomAutoConfiguration/{mac}.xml

Der Platzhalter {mac} wird zur Laufzeit vom Telefon automatisch durch die eindeutige MAC Adresse des Telefons ersetzt.

Setting URL - Beispiel 

http://192.168.1.1:50080/ap/snom/{mac}.xml

Hinweis zu HTTPS / SSL (bis STARFACE v4.1)

Bei der Nutzung der STARFACE PBX Funktion "Umleitung auf HTTPS erzwingen" muss in der Setting URL zwingend das HTTPS Protokoll referenziert werden.

Desweiteren sind snom Telefone erst ab Firmware v7.3.23 in der Lage, Updates der Firmware per HTTPS durchzuführen. Es empfiehlt sich also bei älteren Telefonfirmwares die Erstkonfiguration per HTTP durchzuführen und erst danach die STARFACE PBX Option "Umleitung auf HTTPS erzwingen" zu aktivieren!

Setting URL - Generisch für HTTPS 

https://<STARFACE-IP>/snomAutoConfiguration/{mac}.xml

Bekannte Einschränkungen

Icon-attention.png Die folgenden bekannten Einschränkungen wurden absichtlich in den Updatenprozess eingeplant. Hintergrund ist, dass die im folgenden genannten Updates nach Hinweisen von snom nicht mit PoE, sondern ausschließlich mit separater Stromversorgung via 230V Netzadapter durchgeführt werden sollten! Der interne Ethernet Switch im Telefonen wird während des Updates reprogrammiert.

Wrong Linux Version

  • Betrifft: snom 320, snom 360
  • Kernel Version kleiner linux 3.38

Beim Auto-Update des Telefons erscheint im Laufe des Update Prozesses die Fehlermeldung: 

Wrong Linux version
Update Linux first!
Press any key

snom 320: Manuelles Linux Update

snom 360: Manuelles Linux Update

Wrong Rootfs Version

  • Betrifft: snom 320, snom 360
  • Rootfs-Version ungleich jffs2 v3.36 (z.B. ramdisk v3.31)

Beim Auto-Update des Telefons erscheint im Laufe des Update Prozesses die Fehlermeldung: 

Wrong Rootfs version
Update Rootfs first!
Press any key

snom 320: Manuelles Rootfs Update

snom 360: Manuelles Rootfs Update


Überprüfung der Provisionierung

Multicast des Snoms

Um zu Überprüfen, ob der Multicast des Snoms, die STARFACE erreicht hat, kann die SIP Protokollierung des Snom Endgerätes verwendet werden. Einfach das Webinterface des Telefons nach einem neustart öffnen und den Punkt "SIP Protokollierung" anklicken. Danach sollten ungefähr die folgenden drei Pakete erscheinen.

Multicast des Snom-Gerätes

Dieses Paket wird an die Multicast-IP 224.0.1.75 auf Port 5060 gesendet. 

SUBSCRIBE sip:MAC%3a000413400A03@localhost SIP/2.0
Via: SIP/2.0/UDP 192.168.2.239:5060;rport
From: <sip:MAC%3a000413400A03@localhost>;tag=781837023 
To: <sip:MAC%3a000413400A03@localhost> 
Call-ID: 1223981497@192.168.2.239
CSeq: 1 SUBSCRIBE
Event: ua-profile;profile-type="device";vendor="snom";model="snom820";version="8.3.2"
Expires: 0 
Accept: application/url
Contact: <sip:192.168.2.239:5060>
Content-Length: 0

Antwort des STARFACE-VoIP Dienstes

Unser VoIP-Dienst ist nicht für den Multicast zuständig und antwortet deshalb mit 404, was keinen Fehler darstellt. 

SIP/2.0 404 Not Found 
Via: SIP/2.0/UDP 192.168.2.239:5060;received=192.168.2.239;rport=5060
From: <sip:MAC%3a000413400A03@localhost>;tag=781837023
To: <sip:MAC%3a000413400A03@localhost>;tag=as7c455de7
Call-ID: 1223981497@192.168.2.239
CSeq: 1 SUBSCRIBE
User-Agent: STARFACE PBX
Allow: INVITE, ACK, CANCEL, OPTIONS, BYE, REFER, SUBSCRIBE, NOTIFY
Content-Length: 0

Antwort der STARFACE-AutoProvisionierung

NOTIFY sip:192.168.2.239:5060 SIP/2.0
Via: SIP/2.0/UDP 192.168.2.5:5060;
From: <sip:MAC%000413400A03@192.168.2.5>
To: <sip:MAC%000413400A03@192.168.2.239>
Contact: <sip:STARFACE@192.168.2.5>
Call-ID: egal@192.168.2.239
CSeq: 3 NOTIFY
Max-Forwards: 20
Event: ua-profile;profile-type="device";vendor="OEM";model="OEM";version="7.3.14"
Content-Type: application/url
Subscription-State: terminated;reason=timeout
Content-Length: 63
http://192.168.2.5:50080/snomAutoConfiguration/00XXXXXXXXX.xml

Erreichbarkeit der Setting-URL

Um die Funktion der Provisionierung zu testen, kann die URL in einem Browser eingegeben werden, falls ein HTTP Status 404 von Apache Tomcat/5.5.27 zurückgeliefert wird, ist die Erreichbarkeit des Dienstes sichergestellt. Da die Kennung des Geräts überprüft wird, werden hier keine Provisionierungsdaten zurückgeliefert.

Von „http://wiki.starface.de/index.php/Snom_Autoprovisioning“
Meine Werkzeuge