Upgrade auf STARFACE 10

Beim Sprung von STARFACE 9 auf 10 braucht die Anlage neben der neuen Firmware auch das Management-Modul für STARFACE 10. STARcontrol führt das Update wie jedes andere aus: erst die Anlage, danach das Modul.

Oft braucht STARcontrol dafür nach dem Update noch einen Schritt von dir: STARFACE 10 lässt das Management-Modul je nach Anlage nur noch über den REST-Zugang herein. Fehlt er, fragt STARcontrol danach und macht anschließend von selbst weiter.

Vorher bereitlegen

• Einen aktuellen, verwertbaren Sicherungsstand der Anlage (siehe Backups und Updates).
• Eine Anlage, die in STARcontrol online ist und sauber synchronisiert. Der Module-Key muss funktionieren.
• Einen gültigen STARFACE-Updatevertrag, sonst bietet die Anlage STARFACE 10 nicht als Ziel-Version an.
• Ein mit dem Kunden abgestimmtes Wartungsfenster.
• Zugriff auf die STARFACE-Administration, um nach dem Update ein Benutzerrecht zu setzen und das Client Secret von rest-client-headless abzulesen.

Update planen

1. Öffne Updates & Rollouts und plane ein Update für die Anlage.
2. Wähle unter Ziel-Version die gewünschte STARFACE-10-Version. Fehlt der Anlage der REST-Zugang, weist der Dialog darauf hin.
3. Lege den Startzeitpunkt in das Wartungsfenster.
4. Stelle unter Wartungsmodus ein, wie lange Warnungen unterdrückt werden sollen.
5. Lass das Management-Modul in der Modul-Auswahl angehakt und speichere.

Das funktioniert für eine einzelne Anlage genauso wie für einen Rollout über mehrere Anlagen.

Nach dem Update: REST-Zugang hinterlegen

Kann STARcontrol die Anlage nach dem Update nicht mehr auslesen, steht das Update unter Updates & Rollouts auf Wartet auf REST-Zugang. Die Anlage zeigt ganz oben eine Karte mit denselben Schritten, und unter Meldungen erscheint ein Eintrag.

1. In der STARFACE: Gib dem Benutzer, mit dem sich STARcontrol anmeldet, das Recht API-Zugriff mit OAuth Password Grant. Seine Login-ID steht auf der Karte.
2. In STARcontrol: Klicke REST-Zugang hinterlegen. Aktiviere STARFACE 10 (REST) und trage das Client Secret von rest-client-headless ein (Headless-API-Token). Prüfe es mit dem Verbindungstest und speichere.
3. Fertig. STARcontrol installiert sofort das Management-Modul für STARFACE 10 über den REST-Zugang. Sobald die Anlage damit wieder Daten liefert, schließt STARcontrol das Update ab. Du musst nichts neu planen.

Ist die Modul-Installation schon einmal gescheitert, installiert STARcontrol das Modul nach dem Speichern ebenfalls automatisch erneut.

STARcontrol versucht die Installation bis zu dreimal. Bleibt die Karte danach auf REST-Zugang hinterlegt, zeigt sie den letzten Fehler. Meist fehlt das Recht aus Schritt 1 oder das Client Secret ist falsch. Speicherst du den Zugang neu, beginnen die Versuche von vorn.

Kannst du den Zugang nicht hinterlegen, beende das Warten über Warten beenden in der Update-Liste. Das Management-Modul installiert STARcontrol dann nicht automatisch.

Ergebnis prüfen

• Die Anlage ist online und zeigt die neue STARFACE-Version.
• Unter Wartung → Module steht das Management-Modul auf der Version für STARFACE 10.
• Die letzte Synchronisierung liegt nach dem Update.

Danach: STARFACE-10-Funktionen nutzen

Mit dem REST-Zugang stehen auch die erweiterten STARFACE-10-Bereiche zur Verfügung, etwa Gruppen und iQueues, Funktionstasten oder Rufumleitungen, siehe Funktionsumfang nach STARFACE-Version.

Modul vor dem Update installieren

Für einzelne Workspaces kann der STARcontrol-Betrieb die umgekehrte Reihenfolge freischalten: Dann installiert STARcontrol zum Startzeitpunkt zuerst das Management-Modul für STARFACE 10 und löst das Update aus, sobald das Modul antwortet. Der Update-Dialog zeigt in diesem Fall den Hinweis Upgrade von STARFACE 9 auf 10, und ein gewählter Wartungsmodus beginnt schon mit der Modul-Installation. Nimmt das neue Modul das Update nicht innerhalb von 30 Minuten an, markiert STARcontrol das Update als fehlgeschlagen.

Bei jedem anderen Update, auch bei früheren Hauptversionen wie 7 auf 8 oder 8 auf 9, aktualisiert STARcontrol immer zuerst die Anlage und danach das Modul.