OpenStage Autoprovisioning

Aus STARFACE Wiki

Wechseln zu: Navigation, Suche

Inhaltsverzeichnis

OpenStage Autoprovisioning

STARFACE PBX (ab v4.1) kann Siemens OpenStage Telefone per der von Siemens Enterprise vorgesehenen XML Provisionierungsschnittstelle mit Konfigurationsdaten betanken. Jede STARFACE PBX enthält hierfür einen DLS (DepLoyment Service) Server . Der DLS Server basiert auf dem HTTP bzw. HTTPS Protokoll.

Zero-Touch-Provisioning benötigt zwingend einen DHCP-Server mit Unterstützung für Vendor Specific Attributes, ein Konfigurationsbeispiel für den Standard Linux DHCP Server gibt es weiter unten. Alternativ kann die Autoprovisionierung über die STARFACE Telefonsuche angestoßen werden.

Folgende Einstellungen werden per Autoprovisionierung betankt:

  • Basiseinstellungen im Telefon (SIP Zugangsdaten, Zeiteinstellungen, Spracheinstellungen, ...)
  • Firmware
  • Logo
  • Besetztlampenfunktion (falls im Telefon verfügbar)

Unterstützte OpenStage Telefone

Volle Unterstütztung (getestet):

Eingeschränkte Unterstützung (ungetestet):

  • OpenStage 20 E
  • OpenStage 20 G
  • OpenStage 40 G
  • OpenStage 60 G
  • OpenStage 80 G

Keine Unterstützung:

  • Sämtliche OpenStage T Modelle - es handelt sich hierbei um ISDN Telefone!

Weitere Vorraussetzungen

  • Autoprovisionierung neuer Endgeräte muss in der STARFACE PBX aktiv sein, das Telefon muss bei Bedarf in der MAC-Adressen-Beschränkung freigeschalten werden
  • OpenStage SIP Firmware muss im Telefon zwingend geladen sein. OpenStage Telefone mit HFA Firmware müssen zuerst auf eine OpenStage SIP Firmware gebracht werden (siehe Manuelles Firmware Update von OpenStage).
  • OpenStage SIP Firmware muss mindestens V1 R3.13.0 SIP oder größer sein. Frühere Firmware Versionen können aufgrund eines Softwarefehlers nur eingeschränkt in Ihrer Firmware aktualisiert werden (siehe OpenStage Firmware Reset). Dies betrifft vor allem Geräte, welche vor Februar 2008 produziert wurden.

One Touch Provisioning

STARFACE Telefonsuche

Über die klassiche Telefonsuche werden in den korrekt erkannten Openstage Telefone die DLS Einstellungen automatisch konfiguriert.


manuelle Konfiguration


Die DLS Einstellung kann auch manuell gesetzt werden, die Konfiguration wird dann über das Webinterface des Openstage Telefons vorgenommen. Der Zugriff erfolgt per HTTPS: 

https://<TELEFON-IP>

Rufen Sie den Bereich Administratorseiten > Network > Update Service (DLS) auf und nehmen Sie die Einstellungen wie im Screenshot abgebildet vor:

Update Service (DLS)
DLS address: <STARFACE IP-ADRESSE>
DLS port: 50081
Contact gap: 300

Nach dem Abspeichern ist ein Neustart des Engeräts erforderlich.

Siemens-openstage-dls web.jpg

Zero Touch Provisioning mit DHCP

Zero Touch Provisioning ist möglich, sofern im Kunden-LAN ein kompatibler DHCP Server betrieben wird. Der DHCP Server muss hierfür einen Vendor Specific Option Space unterstützen und den OpenStage Telefonen hierüber beim Startup den DLS Server mitteilen.

Weiterführende Informationen auch zum Windows DHCP Server bietet Siemens:

Beispiel dhcpd.conf (Linux) 

# General configuration for all clients in the subnet
ddns-update-style none;

##### vendor specific options for Siemens OpenStage
option space OptiIpPhone;
option OptiIpPhone.magic   code 1 = string;
option OptiIpPhone.vlanid  code 2 = unsigned integer 32;
option OptiIpPhone.dls     code 3 = string;

class "SiemensPhone" {
        match if (
                (substring(hardware, 1, 3) = 00:01:E3) or
                (substring(hardware, 1, 3) = 00:1A:E8)
        );

        vendor-option-space        OptiIpPhone;
        option OptiIpPhone.magic   53:69:65:6D:65:6E:73:00:00:00;  # "SIEMENS\0\0\0"
        # Optional: OpenStage VLAN Konfiguration per DHCP
        # option OptiIpPhone.vlanid  0;
        option OptiIpPhone.dls     "sdlp://<STARFACE-IP>:50081";
}

subnet 172.16.202.0 netmask 255.255.255.0 {
        option domain-name-servers 172.16.202.200;
        option broadcast-address 172.16.202.255;
        option routers 172.16.202.200;
        option subnet-mask 255.255.255.0;
#       option domain-name "phones.intranet";
#       option ntp-servers 172.16.202.1;
        option time-offset 3600;
        default-lease-time 864000;
        max-lease-time 8640000;

	# Pool Siemens
	pool {
		allow members of "SiemensPhone";
		range 172.16.202.10 172.16.202.199;
		default-lease-time 2764800;  # 32 days
		max-lease-time     3024000;  # 35 days
	}


	# Pool Rest
	pool {
		range 172.16.202.4 172.16.202.8;
		deny members of "SiemensPhone";
	}
}

Technischer Überblick zum Provisionierungsinterface

Das DLS Provisionierungsinterface ist ein bidirektionales Protokoll. Das Telefon kommuniziert hierbei bei bestimmten Ereignissen (Startup, Konfigurationsänderung, Anforderung vom DLS per ContactMe, ...) mit dem DLS Server. Die Kommunikation ist TLS verschlüsselt.

Desweiteren hat der DLS Server die Möglichkeit, per sogenanntem ContactMe Request eine sofortige Kontaktaufnahme des Telefons mit dem DLS Server anzufragen. Dies wird z.B. für die Übertragung von Besetztlampenfeldern benötigt.


Icon-attention.png Das Provisionierungsprotokoll benötigt direkte IP-Konnektivität zwischen STARFACE DLS und Telefon ohne zwischengeschaltetes NAT. Endgeräte z.B. in Home Offices benötigen also eine VPN Verbindung zwischen Home Office LAN bzw. Telefon und STARFACE PBX.


ContactMe Anfrage vom DLS

OpenStage Telefon Kommunikation STARFACE Deployment Server
TCP Port 8085 <------------------- ContactMe Anfrage (HTTP)
204 OK ------------------->


Konfigurationsdaten Anfrage vom Telefon

OpenStage Telefon Kommunikation STARFACE Deployment Server
DLS Anfrage (TLS/HTTPS) -------------------> TCP Port 50081
Nutzdaten <-------------------
DLS Anfrage 2 (TLS/HTTPS) -------------------> TCP Port 50081
Nutzdaten <-------------------
DLS Anfrage Firmware (TLS/HTTPS) -------------------> TCP Port 50081
Nutzdaten Firmware <-------------------
(......)


Manuelle Firmware Updates

Ab STARFACE 5

  1. Das gewünschte Firmware-Image per SSH/SFTP auf die STARFACE-Anlage in das Verzeichnis /var/fw/siemens-ec kopieren
  2. Die Weboberfläche des Openstage aufrufen: https://<IP-Adresse des OpenStage>
  3. Administrator Pages → File transfer → Phone application
    • Download method: HTTPS
    • HTTPS base URL: https://<IP-Adresse der Anlage>:50081/ap/fw/siemens-ec/
    • Filename: Dateiname des Firmware-Images
    • After submit: start download
  4. Submit zur Ausführung klicken

Auf STARFACE 4 Anlagen

Das Update wird im OpenStage Telefon Web Interface unter Admin > File transfer > Phone application ausgelöst. Folgende Werte müssen im Formular gesetzt werden:

  • Download method: HTTPS
  • HTTPS base URL: Telefonmodellspezifische URL, siehe unten!
  • After submit: start download

Submit klicken

OpenStage 15 
https://<STARFACE-IP>:50081/download/OS_15_SIP_V2_R0_30_0.img?key=vv3ImGigbG61xS9yayzwuxLo37i2cp
OpenStage 20/20E/20G 
https://<STARFACE-IP>:50081/download/OS_20_SIP_V2_R0_30_0.img?key=2LkCsbG52nn7ypeXxdCA9gjBLM8qQg
OpenStage 40/40G 
https://<STARFACE-IP>:50081/download/OS_40_SIP_V2_R0_30_0.img?key=fvSrIhRiz3SOyMKZ9jkGCbkXuwH1TE
OpenStage 60/60G 
https://<STARFACE-IP>:50081/download/OS_60_SIP_V2_R0_30_0.img?key=PaxdRpOQUwT9nMgA9eaPHJqERu58TY
OpenStage 80/80G 
https://<STARFACE-IP>:50081/download/OS_80_SIP_V2_R0_30_0.img?key=dodQoxrDLpl4ZYrqimtl5UZ5IyXZek

Sonstige Informationen

Passwörter

Für den Login am Telefon als auch am Web-Interface gibt es jeweils ein User- und ein Admin-Passwort. Diese sind wie folgt:

  • Admin: 123456
  • User: 111111




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