Wechseln zu:Navigation, Suche
Wiki

UTM/EXTRAS/Firmware Update-CLI: Unterschied zwischen den Versionen

Aus Securepoint Wiki
KKeine Bearbeitungszusammenfassung
KKeine Bearbeitungszusammenfassung
 
(3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Set_lang}}
{{Set_lang}}


{{#vardefine:headerIcon|spicon-utm}}
{{:UTM/EXTRAS/Firmware Update-CLI.lang}}


</div>{{DISPLAYTITLE:Securepoint UTM Firmware-Update CLI}}{{TOC2}}
{{var | neu--system upgrade updatelatest
<p>'''Securepoint UTM Firmware-Update mit CLI'''</p>
| Befehl: [[#Prüfen_auf_Update_und_downloaden|''system upgrade updatelatest'']]
<p>Letzte Anpassung zur Version: '''11.8'''</p>
|  }}
<p>{{ cl | Bemerkung: |  
 
* Änderung im Updateprozess:  
</div><div class="new_design"></div>{{Select_lang}} {{TOC2}}
** Lizenzvereinbarung ( EndUserLicenceAgreement, Eula) und
{{Header|12.6.1|
**  Datenschutzerklärung müssen bestätigt werden, bevor das Update aktiviert werden kann. | w=80px}} </p>
* {{#var:neu--rwi}}
<p>Vorherige Version: [[UTM/EXTRAS/Firmware_Update-CLI_v11.4 | '''11.4''']]</p>
* {{#var:neu--system upgrade updatelatest}}
|[[UTM/EXTRAS/Firmware_Update-CLI_v11.8 | 11.8]]
[[UTM/EXTRAS/Firmware_Update-CLI_v11.4 | 11.4]]
|{{Menu-UTM|Extras|CLI}}
}}
----
----


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


<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>
=== {{#var:Allgemein}} ===
<p>Die UTM lädt immer ein komplettes Firmware Image für die entsprechende Version herunter.</p>
{{#var:Allgemein--desc}} </p>
 
{{mobil|<hr>}}
{{mobil|<hr>}}
=== Prüfen auf Update und download ===
{| class="sptable2 pd5"
{{ cl | <code>'''system upgrade info'''</code> | gibt an welche Versionen auf dem System verfügbar sind.
! {{#var:Befehl}} !! {{#var:Beschreibung}}
<p>{{Hinweis| !|gelb}}Systemintern wird der Befehl <code>'''update'''</code> für die Aktualisierung nach der Eingabe neuer Parameter verwendet (z.B.: <code>system interface update</code> nach der Eingabe einer neuen IP Adresse). Eine neue Softwareversion stellt eine neue Betriebsystem-Version dar (Firmware) und ist systemintern ein <code>'''upgrade'''</code>.}}</p>
|-
| class="Leerzeile" colspan="2"  |
=== {{#var:Prüfen auf Update und download}} ===
|-
| style="min-width: 245px;" | {{code|'''system upgrade info'''}} || {{#var:system upgrade info--desc}}
<p>{{Alert|g}} {{#var:system upgrade info-Hinweis}}</p>


{{ cl | |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
{{#var:system upgrade info-Rückgabe}}
<p></p>
<p></p>
<pre>
<pre>
Zeile 28: Zeile 38:
name|version
name|version
----+-------
----+-------
old |11.7.14
old |12.6.0
cur |11.7.15
cur |12.6.0.1
new |11.8.0
new |12.6.1
firewall.foo.local>  
firewall.foo.local>  
</pre>
</pre>
<p></p>
<p></p>
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.  
{{#var:Dieses System wurde von der 12.6.0}}
}}
|-
 
| {{code|'''system upgrade update'''}} || {{#var:system upgrade update--desc}}
{{mobil|<hr>}}
<p></p>
{{ cl | <code>'''system upgrade update'''</code> | Steht keine neue Version auf der UTM bereit <code><nowiki>new | none</nowiki></code> kann mit diesem Befehl  ein Download, falls vorhanden, erzwungen werden. <p></p>
<pre>firewall.foo.local>system upgrade update
<pre>firewall.foo.local>system upgrade update
-- empty answer from 'spupdater'
-- empty answer from 'spupdater'
firewall.foo.local>
firewall.foo.local>
</pre>
</pre>
Wurde eine neue Version erfolgreich geladen, gibt es keine Fehlermeldung ('empty answer'). Auch bei einem 'parse error' wurde aber eine Version geladen.<br>
{{#var:Wurde eine neue Version erfolgreich geladen}}
Ein erneutes <code>'''system upgrade info'''</code> sollte nun auch bei <code><nowiki>new | </nowiki></code> eine Verisonsnummer anzeigen.
|-
}}
| {{code|'''system upgrade updatelatest'''}} || {{#var:system upgrade updatelatest--desc}}<li class="list--element__alert list--element__hint">{{#var:system upgrade updatelatest--Hinweis}}</li>
 
|-
{{mobil|<hr>}}
| {{code|'''system upgrade forceupdate'''}} || {{#var:system upgrade forceupdate--desc}}
<p>
|-
{{ cl | <code>'''system upgrade forceupdate'''</code> | löscht das Verzeichnis ''new'' und führt einen Download durch, sofern es eine aktuellere Software gibt.}}
| {{code| '''system upgrade hint'''}} || {{#var:system upgrade hint--desc}}
</p>
<p></p>
 
 
{{mobil|<hr>}}
{{ cl | <code>'''system upgrade hint'''</code> | 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
Zeile 62: Zeile 67:
firewall.foo.local>
firewall.foo.local>
</pre>
</pre>
}}
|-
 
| class="Leerzeile" colspan="2"  |
{{mobil|<hr>}}
=== Rollback ===
=== Rollback ===
{{ cl | <code>'''system upgrade rollback'''</code> | 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}} }}
| {{code| '''system upgrade rollback'''}} || {{#var:system upgrade rollback--desc}}<br>  
 
{{Hinweis-box|{{#var:system upgrade rollback-Hinweis-Konfigurationsänderungen}} | g}}<br>
{{mobil|<hr>}}
{{Hinweis-box|{{#var:system upgrade rollback-Hinweis-neustart}} }}
|-
| class="Leerzeile" colspan="2"  |
=== Update ===
=== Update ===
{{ cl | <code>'''system upgrade dryrun'''</code> | Führt ein Update auf die in der Zeile <code>new</code> aufgeführte Version durch. <br>
|-
{{ Hinweis | ! Das UTM-System startet automatisch neu!}}<p></p>
| {{code| '''system upgrade dryrun'''}} || {{#var:system upgrade dryrun--desc}} <br>
{{Hinweis-box|{{#var:system upgrade rollback-Hinweis-neustart}} }}  
<p></p>
<pre>
<pre>
firewall.foo.local> system upgrade dryrun
firewall.foo.local> system upgrade dryrun
Zeile 86: Zeile 94:
going down for reboot
going down for reboot
</pre>
</pre>
<p>Ist das System wieder gestartet, ist eine '''erneute Anmeldung''' erforderlich. </p>
<p> {{#var:Ist das System wieder gestartet}} </p>
<pre>
<pre>
firewall.foo.local> system upgrade hint
firewall.foo.local> system upgrade hint
Zeile 94: Zeile 102:
firewall.foo.local>
firewall.foo.local>
</pre>
</pre>
}}
{{Hinweis-box}} {{#var:system upgrade dryrun-Hinweis}}
 
|-
{{mobil|<hr>}}
| class="Leerzeile" colspan="2"  |
==== Annahme Eula ====
==== {{#var:Annahme Eula}} ====
{{ cl | <code>'''system upgrade confirm eula'''</code> | 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>
| {{code| '''system upgrade confirm eula'''}} || {{#var:system upgrade confirm eula--desc}}
<p></p>
<pre>
<pre>
firewall.foo.local> system upgrade hint
firewall.foo.local> system upgrade hint
Zeile 107: Zeile 116:
firewall.foo.local>
firewall.foo.local>
</pre>
</pre>
}}
|-
 
| class="Leerzeile" colspan="2"  |
{{mobil|<hr>}}
==== {{#var:Annahme Datenschutzerklärung}} ====
==== Annahme Datenschutzerklärung ====
|-
{{ cl | <code>'''system upgrade confirm privacy'''</code> | Annahme der Datenschutzerklärung.
| class=mw17 | {{code| '''system upgrade confirm privacy'''}} || {{#var:system upgrade confirm privacy--desc}}
{{ Hinweis | Neu in 11.8 | 11.8}} DIe Datenschutzerklärung muss angenommen werden.<p></p>
<p></p>
<pre>
<pre>
firewall.foo.local> system upgrade hint
firewall.foo.local> system upgrade hint
Zeile 120: Zeile 129:
firewall.foo.local>
firewall.foo.local>
</pre>
</pre>
| w=210px }}


{{mobil|<hr>}}
|-
==== Ablehnung Eula und Datenschutzerklärung ====
| class="Leerzeile" colspan="2"  |
{{ cl | <code>'''system upgrade decline'''</code> | Ablehnung der  Eula und der Datenschutzerklärung. Das Update kann dann nicht installiert werden. }}
==== {{#var:Ablehnung Eula und Datenschutzerklärung}} ====
 
|-
{{mobil|<hr>}}
| {{code| '''system upgrade decline'''}} || {{#var:system upgrade decline--desc}}
=== Startversion festlegen ===
|-
 
| class="Leerzeile" colspan="2"  |
{{ cl |<code>'''system upgrade finalize'''</code> | 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>
=== {{#var:Startversion festlegen}} ===
|-
| {{code| '''system upgrade finalize'''}} || {{#var:system upgrade finalize--desc}}
<p></p>
<pre>firewall.foo.local> system upgrade finalize
<pre>firewall.foo.local> system upgrade finalize
firewall.foo.local>
firewall.foo.local>
</pre>
</pre>
Überprüfung, ob die neue Version nun auch als aktuell laufenden Version angezeigt wird:
{{#var:Überprüfung, ob die neue Version nun auch als aktuell}}
<pre>
<pre>
firewall.foo.local> system upgrade info
firewall.foo.local> system upgrade info
name|version
name|version
----+-------
----+-------
old |11.7.15
old |12.6.0.1
cur |11.8
cur |12.6.1
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>
{{#var:system upgrade finalize-old}}
Der Befehl  <code>'''system upgrade hint'''</code> liefert jetzt:
<pre>
<pre>
firewall.foo.local> system upgrade hint
firewall.foo.local> system upgrade hint
Zeile 150: Zeile 160:
rollback
rollback
</pre>
</pre>
 
{{#var:system upgrade finalize-rollback}}
Hier sollte nur "rollback" zurückgegeben werden.
|}
 
Ist dies der Fall ist das Update erfolgreich abgeschlossen.
}}

Aktuelle Version vom 20. Februar 2024, 16:40 Uhr


















































De.png
En.png
Fr.png








Securepoint UTM Firmware-Update mit CLI
Letzte Anpassung zur Version: 12.6.1
Neu:
notempty
Dieser Artikel bezieht sich auf eine Resellerpreview

11.8 11.4

Aufruf: UTM-IP:Port oder UTM-URL:Port
Port wie unter Netzwerk / Servereinstellungen / Webserver konfiguriert
Default-Port: 11115
z.B.: https://utm.ttt-point.de:11115
Default: https://192.168.175.1:11115 Extras CLI


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
  • Die UTM lädt immer ein komplettes Firmware Image für die entsprechende Version herunter

Befehl Beschreibung

Prüfen auf Update und downloaden

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 Betriebssystem-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 |12.6.0
cur |12.6.0.1
new |12.6.1 
firewall.foo.local>

Dieses System wurde von der 12.6.0 auf die jetzt aktive Version 12.6.0.1 aktualisiert und es steht ein Update auf die Version 12.6.1 bereit.

system upgrade update Steht keine neue Version auf der UTM bereit new | none kann mit diesem Befehl die Prüfung, ob ein Update zur Verfügung steht durchgeführt 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 updatelatest Manueller Download der neuesten Firmware, auch wenn diese UTM noch nicht in der normalen Verteilung vorgesehen ist.
  • Dieser Befehl kann nur alle 10 Minuten ausgeführt werden.
    • system upgrade forceupdate Löscht das Verzeichnis new und führt einen Download durch, sofern eine aktuellere Software zur Verfügung steht.
    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.
    notempty
    Konfigurationsänderungen in der neuen Version werden dabei zurückgesetzt.

    notempty
    Das UTM-System startet automatisch neu

    Update

    system upgrade dryrun Führt ein Update auf die in der Zeile new aufgeführte Version durch.
    notempty
    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>
    Zum dauerhaften Abschluss des Updates ist noch der Befehl system upgrade finalize erforderlich.

    Vorher darf keinesfalls ein Werksreset durchgeführt werden!

    Annahme Eula

    system upgrade confirm eula Annahme des EndUserLicenceAgreement. 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. 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 |12.6.0.1
cur |12.6.1
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.

    Abgerufen von „https://wiki.securepoint.de/index.php?title=UTM/EXTRAS/Firmware_Update-CLI&oldid=90328“