Wechseln zu:Navigation, Suche
Wiki
(Die Seite wurde neu angelegt: „{{DISPLAYTITLE:Securepoint UTM Firmware-Update CLI}} <p>'''Securepoint UTM Firmware-Update mit CLI'''</p> <p>Letzte Anpassung zur Version: '''11.8''' Bemerkun…“)
 
KKeine Bearbeitungszusammenfassung
(23 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{DISPLAYTITLE:Securepoint UTM Firmware-Update CLI}}
{{Set_lang}}


{{#vardefine:headerIcon| spicon-utm }}
</div>{{DISPLAYTITLE:Securepoint UTM Firmware-Update CLI}}{{TOC2}}
<p>'''Securepoint UTM Firmware-Update mit CLI'''</p>
<p>'''Securepoint UTM Firmware-Update mit CLI'''</p>
<p>Letzte Anpassung zur Version: '''11.8'''
<p>Letzte Anpassung zur Version: '''11.8'''</p>
Bemerkung: Änderung im Updateprozess: Datenschutzerklärung und Eula müssen bestätigt werden, bevor das Update aktiviert werden kann.
<p>{{ cl | Bemerkung: |
 
* Änderung im Updateprozess:  
 
** Lizenzvereinbarung ( EndUserLicenceAgreement, Eula) und
== Allgemein ==
**  Datenschutzerklärung müssen bestätigt werden, bevor das Update aktiviert werden kann. | w=80px}} </p>
 
<p>Vorherige Version: [[UTM/EXTRAS/Firmware_Update-CLI_v11.4 | '''11.4''']]</p>
Die neue Firmware wird automatisch von der UTM vollkommen selbständig heruntergeladen, aber das neue Update wird nicht ohne Ihre Zustimmung aktiviert. <br>
----
 
Es wird einmal in der Stunde auf ein mögliches Update geprüft. Durch das System der Update-Verteilung kann es möglich sein, das Sie nicht sofort das Update beziehen können. Diese Verteilung wird auf Seiten des Update-Servers vorgenommen und kann aus diesem Grund nicht umgangen werden. <br>
 
Ihr UTM-System wird immer ein komplettes Firmware Image für die entsprechende Version herunterladen.


== Aktivierung einer neuen Version ==
=== Allgemein ===
<p>Die neue Firmware wird von der UTM vollkommen selbständig heruntergeladen, aber das neue Update wird nicht ohne Zustimmung aktiviert. </p>


1. Zunächst wird geprüft ob bereits ein Update verfügbar ist.  
<p>Die UTM prüft einmal in der Stunde auf ein mögliches Update. Durch das System der Update-Verteilung kann es möglich sein, dass das Update nicht sofort bezogen wird.</p>
Der Befehl "system upgrade info" gibt uns an welche Versionen auf dem System verfügbar sind.  
<p>Die UTM lädt immer ein komplettes Firmware Image für die entsprechende Version herunter.</p>
 
{{mobil|<hr>}}
Als Rückgabe erhalten wir eine Auflistung von max. 3 Versionen.
{| class="sptable2 pd5"
 
! Befehl !! Beschreibung
'''old''' Die vorherige Version<br>
|-
'''cur''' Die aktuell laufende Version<br>
| class="Leerzeile" colspan="2"  |
'''new''' Die verfügbare neue Version<br>
=== Prüfen auf Update und download ===
|-
| style="min-width: 245px;" | {{code|'''system upgrade info'''}} || gibt an welche Versionen auf dem System verfügbar sind.  
<p>{{Hinweis| !|gelb}}Systemintern wird der Befehl {{code|'''update'''}} für die Aktualisierung nach der Eingabe neuer Parameter verwendet (z.B.:  {{code|system interface update}} nach der Eingabe einer neuen IP Adresse). Eine neue Softwareversion stellt eine neue Betriebsystem-Version dar (Firmware) und ist systemintern ein {{code|'''upgrade'''}}.</p>


Als Rückgabe gibt es eine Auflistung von max. 3 Versionen. <br>'''old''' Die vorherige Version<br>'''cur''' Die aktuell laufende Version<br>'''new''' Die verfügbare neue Version
<p></p>
<pre>
<pre>
firewall.foo.local>system upgrade info
firewall.foo.local>system upgrade info
name|version
name|version
----+-------
----+-------
old |none
old |11.7.14
cur |11.04.001.1
cur |11.7.15
new |11.04.001.2
new |11.8.0
firewall.foo.local>
</pre>
</pre>
 
<p></p>
Hier sehen wir, das auf dem System aktuell die Version 11.4.1.1 läuft und ein Update auf die Version 11.4.1.2 bereitsteht.  
Dieses System wurde von der 11.7.14 auf die jetzt aktive Version 11.7.15 aktualisiert und es steht ein Update auf die Version 11.8 bereit.  
 
|-
<br>
| {{code|'''system upgrade update'''}} || Steht keine neue Version auf der UTM bereit {{code|<nowiki>new | none</nowiki>}} kann mit diesem Befehl  ein Download, falls vorhanden, erzwungen werden. <p></p>
 
<pre>firewall.foo.local>system upgrade update
2. Anschließend prüfen wir mit dem Befehl "system upgrade hint" welche Möglichkeiten wir zum aktuellen Zeitpunkt haben.  
-- empty answer from 'spupdater'
firewall.foo.local>
</pre>
Wurde eine neue Version erfolgreich geladen, gibt es keine Fehlermeldung ('empty answer'). Auch bei einem 'parse error' wurde aber eine Version geladen.<br>
Ein erneutes {{code| '''system upgrade info'''}} sollte nun auch bei {{code| <nowiki>new | </nowiki>}} eine Verisonsnummer anzeigen.
|-
| {{code|'''system upgrade forceupdate'''}} || löscht das Verzeichnis ''new'' und führt einen Download durch, sofern es eine aktuellere Software gibt.
|-
| {{code| '''system upgrade hint'''}} || gibt aus, welche Möglichkeiten es zum aktuellen Zeitpunkt gibt.
<p></p>
<pre>
<pre>
firewall.foo.local> system upgrade hint
firewall.foo.local>system upgrade hint
message
message
-------
-------
dryrun
dryrun, rollback
firewall.foo.local>
</pre>
</pre>
 
|-
Hier wird als Möglichkeit der "Dryrun" zurückgegeben.  
| class="Leerzeile" colspan="2" |
Wenn auf dem System noch eine ältere Version verfügbar ist, wird Ihnen zusätzlich die Option "rollback" ausgegeben.
=== Rollback ===
 
|-
<br>
| {{code| '''system upgrade rollback'''}} || Führt ein Rollback aus. Die vorherige Version wird wieder aktiviert. <br>{{ Hinweis | ! Konfigurationsänderungen in der neuen Version werden dabei zurückgesetzt. | gelb}}<br>
 
{{ Hinweis | ! Das UTM-System startet automatisch neu! | rot}}
3. Wurde in Punkt 2 die Option dryrun zurückgegeben, können wir nun die Version starten.  
|-
Dies erfolgt mit dem Befehl "system upgrade dryrun". Beachten Sie, das nachdem ausführen dieses Befehls das UTM-System automatisch neustartet.
| class="Leerzeile" colspan="2" |
 
=== Update ===
|-
| {{code| '''system upgrade dryrun'''}} || Führt ein Update auf die in der Zeile {{code| new}} aufgeführte Version durch. <br>
{{ Hinweis | ! Das UTM-System startet automatisch neu!}}<p></p>
<pre>
<pre>
firewall.foo.local> system upgrade dryrun
firewall.foo.local> system upgrade dryrun
Zeile 67: Zeile 86:
going down for reboot
going down for reboot
</pre>
</pre>
 
<p>Ist das System wieder gestartet, ist eine '''erneute Anmeldung''' erforderlich. </p>
<br>
 
4. Ist das System wieder gestartet, melden Sie sich bitte erneut an. Damit das System dauerhaft diese Version verwendet, müssen wir noch den sogenannten finalize durchführen. Ansonsten würde das System bei einem erneuten Reboot wieder mit der vorherigen Version starten.
 
Zunächst prüfen Sie aber bitte erneut die Möglichkeiten, die zu diesem Zeitpunkt zur Verfügung stehen.
 
<pre>
<pre>
firewall.foo.local> system upgrade hint
firewall.foo.local> system upgrade hint
Zeile 79: Zeile 92:
-------
-------
finalize
finalize
firewall.foo.local>
</pre>
</pre>
 
|-
5. Wurde Ihnen bei Punkt 4 "finalize" zurückgeben, können wir nun den "finalize" durchführen.  
| class="Leerzeile" colspan="2"  |
==== Annahme Eula ====
|-
| {{code| '''system upgrade confirm eula'''}} || Annahme des '''E'''nd'''U'''ser'''L'''icence'''A'''greement.
{{ Hinweis | Neu in 11.8 | 11.8}} Die Eula muss bestätigt werden.<p></p>
<pre>
firewall.foo.local> system upgrade hint
message
-------
confirm eula finalize, decline
firewall.foo.local>
</pre>
|-
| class="Leerzeile" colspan="2" |
==== Annahme Datenschutzerklärung ====
|-
| {{code| '''system upgrade confirm privacy'''}} || Annahme der Datenschutzerklärung.
{{ Hinweis | Neu in 11.8 | 11.8}} DIe Datenschutzerklärung muss angenommen werden.<p></p>
<pre>
<pre>
system upgrade finalize  
firewall.foo.local> system upgrade hint
message
-------
confirm privacy finalize, decline
firewall.foo.local>
</pre>
</pre>


Hier sollte Ihnen keine Meldung zurückgegeben werden.  
|-
 
| class="Leerzeile" colspan="2"  |
6. Prüfen Sie bitte Abschließend, ob die neue Version nun auch als aktuell laufenden Version angezeigt wird.
==== Ablehnung Eula und Datenschutzerklärung ====
Führen Sie dazu den Befehl "system upgrade info" aus.
|-
 
| {{code| '''system upgrade decline'''}} || Ablehnung der  Eula und der Datenschutzerklärung. Das Update kann dann nicht installiert werden.
|-
| class="Leerzeile" colspan="2"  |
=== Startversion festlegen ===
|-
| {{code| '''system upgrade finalize'''}} || Mit diesem Befehl wird diese Version dauerhaft  verwendet.  Ansonsten würde das System bei einem erneuten Reboot wieder mit der vorherigen Version starten.<p></p>
<pre>firewall.foo.local> system upgrade finalize
firewall.foo.local>
</pre>
Überprüfung, ob die neue Version nun auch als aktuell laufenden Version angezeigt wird:
<pre>
<pre>
firewall.foo.local> system upgrade info
firewall.foo.local> system upgrade info
name|version
name|version
----+-------
----+-------
old |11.04.001.1
old |11.7.15
cur |11.04.001.2
cur |11.8
new |none  
new |none  
</pre>
</pre>
 
Hier sollte nun die vor dem Update laufende Version unter '''old''' gelistet sein und die neue Version entsprechend als '''cur'''. <br>
Hier sollte nun die vor dem Update laufende Version unter "old" gelistet sein und die neue Version entsprechend als "cur".  
Der Befehl  {{code| '''system upgrade hint'''}} liefert jetzt:
Zusätzlich prüfen wir noch einmal die Ausgabe von "system upgrade hint".
 
<pre>
<pre>
firewall.foo.local> system upgrade hint
firewall.foo.local> system upgrade hint
Zeile 110: Zeile 152:
</pre>
</pre>


Hier sollte Ihnen "rollback" zurückgegeben werden.  
Hier sollte nur "rollback" zurückgegeben werden.  
 
Ist dies der Fall ist das Update erfolgreichen abgeschlossen.
 
== Problembehandlung ==


Für die Problembehandlung lesen Sie bitte den entsprechenden Artikel für das [[Update_UTMV11#Problembehandlung | Update über das Administrations-Interface ]]
Ist dies der Fall ist das Update erfolgreich abgeschlossen.
|}

Version vom 5. Mai 2020, 09:32 Uhr





























Securepoint UTM Firmware-Update mit CLI

Letzte Anpassung zur Version: 11.8

Bemerkung:

  • Änderung im Updateprozess:
    • Lizenzvereinbarung ( EndUserLicenceAgreement, Eula) und
    • Datenschutzerklärung müssen bestätigt werden, bevor das Update aktiviert werden kann.

Vorherige Version: 11.4


Allgemein

Die neue Firmware wird von der UTM vollkommen selbständig heruntergeladen, aber das neue Update wird nicht ohne Zustimmung aktiviert.

Die UTM prüft einmal in der Stunde auf ein mögliches Update. Durch das System der Update-Verteilung kann es möglich sein, dass das Update nicht sofort bezogen wird.

Die UTM lädt immer ein komplettes Firmware Image für die entsprechende Version herunter.


Befehl Beschreibung

Prüfen auf Update und download

system upgrade info gibt an welche Versionen auf dem System verfügbar sind.

Systemintern wird der Befehl update für die Aktualisierung nach der Eingabe neuer Parameter verwendet (z.B.: system interface update nach der Eingabe einer neuen IP Adresse). Eine neue Softwareversion stellt eine neue Betriebsystem-Version dar (Firmware) und ist systemintern ein upgrade.

Als Rückgabe gibt es eine Auflistung von max. 3 Versionen.
old Die vorherige Version
cur Die aktuell laufende Version
new Die verfügbare neue Version

firewall.foo.local>system upgrade info
name|version
----+-------
old |11.7.14
cur |11.7.15
new |11.8.0 
firewall.foo.local> 

Dieses System wurde von der 11.7.14 auf die jetzt aktive Version 11.7.15 aktualisiert und es steht ein Update auf die Version 11.8 bereit.

system upgrade update Steht keine neue Version auf der UTM bereit new | none kann mit diesem Befehl ein Download, falls vorhanden, erzwungen werden.

firewall.foo.local>system upgrade update
-- empty answer from 'spupdater'
firewall.foo.local>

Wurde eine neue Version erfolgreich geladen, gibt es keine Fehlermeldung ('empty answer'). Auch bei einem 'parse error' wurde aber eine Version geladen.
Ein erneutes system upgrade info sollte nun auch bei new | eine Verisonsnummer anzeigen.

system upgrade forceupdate löscht das Verzeichnis new und führt einen Download durch, sofern es eine aktuellere Software gibt.
system upgrade hint gibt aus, welche Möglichkeiten es zum aktuellen Zeitpunkt gibt.

firewall.foo.local>system upgrade hint
message
-------
dryrun, rollback
firewall.foo.local>

Rollback

system upgrade rollback Führt ein Rollback aus. Die vorherige Version wird wieder aktiviert.
Konfigurationsänderungen in der neuen Version werden dabei zurückgesetzt.

Das UTM-System startet automatisch neu!

Update

system upgrade dryrun Führt ein Update auf die in der Zeile new aufgeführte Version durch.
Das UTM-System startet automatisch neu!

firewall.foo.local> system upgrade dryrun

Broadcast Message from root@firewall.foo.local
        (somewhere) at 14:12 ...

the system is going down for reboot soon


message
-------
going down for reboot

Ist das System wieder gestartet, ist eine erneute Anmeldung erforderlich.

firewall.foo.local> system upgrade hint
message
-------
finalize
firewall.foo.local>

Annahme Eula

system upgrade confirm eula Annahme des EndUserLicenceAgreement. Neu in 11.8 Die Eula muss bestätigt werden.

firewall.foo.local> system upgrade hint
message
-------
confirm eula finalize, decline
firewall.foo.local>

Annahme Datenschutzerklärung

system upgrade confirm privacy Annahme der Datenschutzerklärung. Neu in 11.8 DIe Datenschutzerklärung muss angenommen werden.

firewall.foo.local> system upgrade hint
message
-------
confirm privacy finalize, decline
firewall.foo.local>

Ablehnung Eula und Datenschutzerklärung

system upgrade decline Ablehnung der Eula und der Datenschutzerklärung. Das Update kann dann nicht installiert werden.

Startversion festlegen

system upgrade finalize Mit diesem Befehl wird diese Version dauerhaft verwendet. Ansonsten würde das System bei einem erneuten Reboot wieder mit der vorherigen Version starten.

firewall.foo.local> system upgrade finalize
firewall.foo.local>

Überprüfung, ob die neue Version nun auch als aktuell laufenden Version angezeigt wird:

firewall.foo.local> system upgrade info
name|version
----+-------
old |11.7.15
cur |11.8
new |none 

Hier sollte nun die vor dem Update laufende Version unter old gelistet sein und die neue Version entsprechend als cur.
Der Befehl system upgrade hint liefert jetzt:

firewall.foo.local> system upgrade hint
message
-------
rollback

Hier sollte nur "rollback" zurückgegeben werden.

Ist dies der Fall ist das Update erfolgreich abgeschlossen.