Einleitung

Mit dem Device Connection Framework (DCF) definiert Swyx einen Standard, der es jedem Telefonhersteller ermöglicht seine SIP Telefone in die SwyxWare zu integrieren. Das DCF lehnt sich, wo möglich, an die RFC Standards an und definiert klare Schnittstellen für die Bereiche, die in den RFCs nicht spezifiziert sind.

DCF beschränkt sich nicht auf die üblichen Anrufszenarien, sondern deckt auch die CTI- / Fernsteuerfunktionen für SIP Telefone gemäß uaCSTA Spezifikation ab.

Installation

Für die Installation und Konfiguration der neuen DCF/Yealink Telefone, ist das Swyx Control Center (SCC) zwingend erforderlich. Die Konfiguration ist nicht über die bisherige, MMC basierte SwyxWare Administration möglich.

Für SwyxON werden alle notwendigen Installationen bzgl. SCC automatisch für Sie erledigt.

Im SwyxWare on premises Fall gehen Sie wie folgt vor:
Das SCC installieren Sie separat über das SwyxControlCenter.msi Installationspaket auf dem SwyxServer. Das SCC basiert auf dem IIS, der im Bedarfsfall mitinstalliert wird. Anschliessend rufen Sie das SCC im Browser Ihrer Wahl über https://ServerName:9443/SwyxControlCenter auf. Während der SwyxWare Installation selber wurden Sie aufgefordert ein administratives Account anzulegen. Mit diesem loggen Sie sich am SCC ein.

Provisionierung der Telefone

Für die Provisionierung der Telefone muß zwischen dem Betrieb an der Cloudlösung SwyxON und der SwyxWare on premises unterschieden werden. In beiden Fällen muß jedoch vorab mit Hilfe des neuen Swyx Control Center (SCC), der webbasierte Administration der SwyxWare, das Telefon in der SwyxWare angelegt werden und über seine MAC Adresse einem SwyxWare Benutzer zugeordnet werden. Die einzelnen Schritte dazu entnehmen Sie bitte der Swyx Control Center Onlinehilfe.

Provisionierung für SwyxON

Nachdem das Telefon inkl. seiner MAC Adresse im SCC angelegt wurde, wird von der SwyxWare die MAC Adresse des Telefons beim Yealink Provisionierungsserver hinterlegt. Zusätzlich wird neben der MAC Adresse des Telefons auch die IP Adresse des diesem Telefon zugeordneten SwyxServers gespeichert. Sobald das Yealink Telefon mit dem Netzwerk verbunden ist und erstmalig startet, wird es sich an den Yealink Provisionierungsserver wenden und von dort die initialen Konfigurationsdaten, wie zB die IP Adresse des zuständigen SwyxServer, erhalten.

Provisionierung für SwyxWare on premises

Auch im on premises Fall wird das Telefon inkl. seiner MAC Adresse im SCC angelegt. In diesem Fall ist jedoch keine Kommunikation mit dem Yealink Provisionierungsserver notwendig.
Das Yealink Telefon sendet bei Inbetriebnahme einen Multicast ins Netzwerk (SIP SUBSCRIBE). Der SwyxServer wird diese Multicast-Nachricht mit einem SIP 200 OK beantworten und ein SIP NOTIFY an das Telefon senden. Diese NOTIFY Nachricht enthält in ihrem Content eine Provisionierungs-URL für das Telefon. Diese ruft das Telefon anschliessend auf. Die URL ist so aufgebaut:

http://SwyxServerName.company.com:9200/ippbx/client/v1.0/device/provision/

(!) Wichtig hierbei ist, dass der DNS Server im Netzwerk korrekt konfiguriert ist und den in der URL kommunizierten DNS Namen des SwyxServers auflösen kann (im Beispiel also SwyxServerName.company.com).

Tipp: Sollte es nicht möglich sein einen DNS Server entspr. zu konfigurieren, oder die Übertragung von Multicasts zwischen Telefon und SwyxServer zu sicherzustellen, können Sie am SwyxServer in der Registry unter HKLM\Software\Wow6432Node\Swyx\General\CurrentVersion\Options den String REG_SZ LocalIpAddress anlegen und dort die IP Adresse des SwyxServers eintragen, sowie den SwyxServer Dienst neu starten.
Folgend wird in der oben genannten Provisionierungs-URL nicht mehr der DNS Name des SwyxServers, sondern seine IP Adresse eingetragen.

Beispiel:
HKLM\Software\Wow6432Node\Swyx\General\CurrentVersion\Options
(REG_SZ) LocalIPAddress=172.20.1.1

(!) Da das Telefon einen Multicast sendet, ist sicherzustellen, dass Telefon und der SwyxServer sich im selben Netzwerksegment befinden, oder zumindest die Multicast-Nachricht weitergeleitet wird, sofern sich Router zwischen Telefon und SwyxServer befinden.

Tipp: Wenn es nicht möglich ist sicherzustellen, dass die Multicast Nachrichten des Telefons am SwyxServer ankommen, können Sie das Telefon manuell mit der Provisionierungs-URL konfigurieren. Dafür rufen Sie das Webinterface des Telefons auf: http://IpAdresseDesTelefons. Anschliessend loggen Sie sich mit den Defaultcredentials Benutzernamen "admin" und Passwort "admin" ein. Im Menü "Settings/Auto Provision" tragen Sie in der Zeile "Server URL" die oben aufgeführte Provisionierungs-URL ein (zB "http://172.20.1.1:9200/ippbx/client/v1.0/device/provision/"  die 172.20.1.1 ist durch die SwyxServer IP Adresse zu ersetzen). In den folgenden Zeilen "User Name" bitte die MAC Adresse des Telefons (ohne Trennzeichen, also wie "805e0c10fd78") und in der Zeile "Password" die im Swyx Control Center angezeigte PIN des Telefons eintragen. Anschließend klicken Sie ganz unten "Confirm" an um die Einträge zu speichern, und danach "Autoprovision Now". 

Alternative: Wenn Sie mehrere Telefone einsetzen wollen, bei denen Multicast Nachrichten aufgrund der Netzwerkinfrastruktur nicht genutzt werden können, dann können Sie die obige Provisionierungs-URL auch per DHCP Option 66 verteilen.

Technische Infos

Die Yealink Telefone werden an der SwyxWare über ihre MAC Adresse und die einmalig vom SwyxWare Benutzer einzugebende PIN authentifiziert. Es ist nicht notwendig für die Yealink Telefone SIP Credentials oder SwyxWare Benutzername/Passwort-Kombinationen per SwyxWare Administration zu konfigurieren.

Die CTI Steuerung wird vom Windows Client SwyxIt! und vom MAC Client Swyx Desktop unterstützt.

Damit im Softclient (SwyxIt! oder Swyx Desktop für MAC) zu jedem beliebigen Zeitpunkt die CTI Steuerung für die Yealink Telefone aktiviert werden kann, melden sich die Telefone nicht nur am SwyxServer Dienst, sondern auch an dem neuen SwyxUaCSTA Dienst per SIP REGISTER an. Dieser Dienst ist für die CTI Steuerung der DCF Telefone per uaCSTA Protokoll zwingend erforderlich. Wenn diese 2. Anmeldung nicht erwünscht ist, kann beim SwyWare Benutzer unter Einstellungen/Administration/SIP die Funktion "SIP Endgeräte als Systemtelefon nutzen" aktiviert werden. Diese Einstellung muss ebenfalls aktiviert werden, wenn ein SIP Telefon (zB DECT Telefon) per CTI+ gesteuert werden soll.

Die Yealink Telefone verwenden LDAP, um das globale Telefonbuch der SwyxWare anzuzeigen. Die SwyxWare stellt dieses per Port 389 zur Verfügung.

Aktuell werden die Rufweiterleitungskonfiguration und der DND Status immer für alle Geräte eines SwyxWare Benutzers synchronisiert.

Zusätzlich werden das BusyLampField (BLF) und Rufübernahme mit den Yealink Telefonen unterstützt.

(!) Nur die Yealink Telefone der S-Serie (T41S, T42S, T46S, T48S) sowie die Konferenztelefone CP920, CP960 & CP960 WIMI, werden mit SwyxWare unterstützt. Es gibt keinen Support für die G-Serie!

(!) Das Yealink Telefon sollte ausschließlich über das Swyx Control Center (SCC) konfiguriert werden, niemals direkt über das Webinterface des Telefons. Begründung: Konfigurationen, die direkt per Webinterface des Telefons vorgenommen wurde (zB Namenstastenbelegungen), werden nicht bei Konfiguration über das SCC überschrieben. D.h. in diesem Fall hilft nur ein Factory Reset des Yealink Telefons, um es wieder vollumfänglich mit dem SCC konfigurieren zu können. Das Telefon läßt sich im Grundzustand am einfachsten per langem Drücken auf den OK Knopf resetten, alternativ aber auch über das Menü/Webinterface.

(!) Das DCF/die Yealink Telefone können ab SwyxWare Version 11.25 genutzt werden und benötigen für jedes Telefon die neue Lizenz "Feature Pack for certified SIP phones".

Firmwareupdates

Per Voreinstellung wenden sich die Yealink Telefone für Firmwareupdates an den Yealink Server. Es ist aber auch möglich einen lokalen Server für Firmwareupdates bereitzustellen. Sowohl ftp, also auch http werden für das Firmwareupdate unterstützt. In der Onlinehilfe des SCC finden Sie die entspr. Details.
Die Firmware selber kann über die Support-Seiten von Yealink bezogen werden.

Analysemöglichkeiten

Die SwyxWare bietet über die gewohnten Tracemöglichkeiten, auch für die neue Funktion des DCF entsprechende Möglichkeiten.

Alle das DCF betreffenden Informationen werden in die Tracefiles des CDS (ConfigDataStore-Service) geschrieben. Das Tracing für DCF wird über das neue Modul "DCF" in der Datei IpPbxCDSService.exe.config aktiviert. Setzen Sie hier den Wert 4. Neben den Informationen im Tracefile des CDS werden durch Setzen des Wertes 4 pro Telefon 2 Dateien im Traceverzeichnis der SwyxWare abgelegt, die alle Parameter enthalten mit denen das Telefon provisioniert wird. Die Dateinamen folgen diesem Schema:

Provisioning<MAC Adresse Phone>-<Zeitstempel>-common.cfg
Provisioning<MAC Adresse Phone>-<Zeitstempel>-mac.cfg

Bsp: Provisioning805ec02a4d5c-20180919-152257-mac.cfg

In der mit common endenden Datei sind allgemeine Parameter, wie zB Netzwerk-Einstellungen zu finden, in der mit mac endenden Datei sind zB Accountkonfigurationen aufgeführt.

Die zwischen dem Telefon und dem SwyxServer ausgetauschten SIP Nachrichten können über das gewohnte Tracesetting in der Registry des SwyxServers mitprotokolliert werden. Hierfür ist das Modul "SIP" auf den Wert 5 oder höher zu setzen. 

Gleiches gilt für den Mitschnitt der SIP Nachrichten des neuen SwyxUaCSTA Dienstes.

Die Tracesetting sind unter dem Registry-Key [HKLM\software\Wow6432Node\Swyx] zu finden. Dort sind die Werte in den entspr. Subkey für den IpPbxSrv und IpPbx.uaCSTA zu setzen.

Herstellerinformationen

Weitere Informationen, auch technische Details, können direkt beim Hersteller Yealink über dessen Website abgerufen werden (User Guides, Administrator Guides, etc.):

Yealink SIP-T4X Infos