Updates mit der xe-CLI anwenden

Wenden Sie mit der xe-CLI Updates auf Ihre XenServer 8-Hosts und -Pools an.

Um Updates zu erhalten, benötigen Ihre XenServer-Hosts einen Internetzugang. Wenn sich Ihre Hosts hinter einer Firewall befinden, stellen Sie sicher, dass sie Zugriff auf Subdomains von ops.xenserver.com haben. Weitere Informationen finden Sie unter Konnektivitätsanforderungen.

Gehen Sie wie folgt vor, um Ihre XenServer-Pools aktualisieren zu können:

1. Installieren oder führen Sie ein Upgrade auf XenServer 8 durch.

2. Konfigurieren Sie Updates für Ihren Pool.

3. Synchronisieren Sie neue Updates für Ihren Pool.

4. Machen Sie sich mit den Kategorien der Anleitungen und den Updateaufgaben vertraut.

5. Sehen Sie sich die verfügbaren Updates für Ihren Pool an.

6. Wenden Sie Updates auf Ihren Pool an.

Updates für Ihren Pool konfigurieren

Bevor Sie Updates auf Ihre XenServer-Hosts und -Pools anwenden können, müssen Sie Hostupdates konfigurieren, indem Sie Ihren Pool oder Host für einen Update-Channel abonnieren. Diese Kanäle steuern, wie schnell Sie auf Updates zugreifen können, die im Content Delivery Network (CDN) verfügbar sind.

Die beiden Updatekanäle sind:

• Early Access — perfekt für Testumgebungen
• Normal — empfohlen für Produktionsumgebungen

Nachdem Sie Ihren Pool bei einem des Updatesskanäle abonniert haben, synchronisiert sich Ihr Pool regelmäßig und automatisch mit dem Updatekanal. Synchronisieren Sie Ihren Pool alternativ manuell mit dem Updatekanal. Diese Synchronisierungsaktion lädt alle verfügbaren Updates auf den Poolkoordinator herunter. Anschließend können Sie die heruntergeladenen Updates mithilfe der xe-CLI anwenden.

1. Erstellen und aktivieren Sie den Early-Access-Updatekanal für Ihren Pool:

   pool_uuid=$(xe pool-list --minimal)
   
   base_binary_url="https://repo.ops.xenserver.com/xs8/base"
   base_source_url="https://repo-src.ops.xenserver.com/xs8/base"
   base_repo_uuid=$(xe repository-introduce name-label=base_repo name-description=Base binary-url=<base_binary_url> source-url=<base_source_url> update=false)
   
   update_binary_url="https://repo.ops.xenserver.com/xs8/earlyaccess"
   update_source_url="https://repo-src.ops.xenserver.com/xs8/earlyaccess"
   update_repo_uuid=$(xe repository-introduce name-label=early_access_repo name-description="Early Access" binary-url=<update_binary_url> source-url=<update_source_url> update=true)
   
   xe pool-param-set uuid=<pool_uuid> repositories=<base_repo_uuid>,<update_repo_uuid>
   <!--NeedCopy-->
   

   Alternativ können Sie den normalen Updatekanal für Ihren Pool erstellen und aktivieren:

   pool_uuid=$(xe pool-list --minimal)
   
   base_binary_url="https://repo.ops.xenserver.com/xs8/base"
   base_source_url="https://repo-src.ops.xenserver.com/xs8/base"
   base_repo_uuid=$(xe repository-introduce name-label=base_repo name-description=Base binary-url=<base_binary_url> source-url=<base_source_url> update=false)
   
   update_binary_url="https://repo.ops.xenserver.com/xs8/normal"
   update_source_url="https://repo-src.ops.xenserver.com/xs8/normal"
   update_repo_uuid=$(xe repository-introduce name-label=normal name-description="Normal" binary-url=<update_binary_url> source-url=<update_source_url> update=true)
   
   xe pool-param-set uuid=<pool_uuid> repositories=<base_repo_uuid>,<update_repo_uuid>
   <!--NeedCopy-->
   

2. Ruft eine Liste der aktuell aktivierten Repository-UUIDs ab:

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-get uuid=<pool_uuid> param-name=repositories
   <!--NeedCopy-->
   

3. Mit der Repository-UUID können Sie weitere Details zu einem bestimmten Repository anzeigen:

   xe repository-param-list uuid=<UUID>
   <!--NeedCopy-->
   

4. (Optional) Konfigurieren und aktivieren Sie einen HTTP-Connect-Proxyserver, der für die Kommunikation zwischen dem Host und dem öffentlichen CDN verwendet wird, das die Repositorys hostet:

   xe pool-configure-repository-proxy proxy-url=<http://proxy.example.com> proxy-username=<proxy-user> proxy-password=<proxy-password>
   <!--NeedCopy-->
   

   Deaktivieren Sie die Proxy-Server-Konfiguration:

   xe pool-disable-repository-proxy
   <!--NeedCopy-->
   

   Sehen Sie sich die Proxy-Server-Konfiguration an:

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-get uuid=<pool_uuid> param-name=repository-proxy-url
   xe pool-param-get uuid=<pool_uuid> param-name=repository-proxy-username
   <!--NeedCopy-->
   

Synchronisieren Sie neue Updates für Ihren Pool

Ermöglichen Sie Ihrem Pool die automatische Synchronisierung mit dem Updatekanal, indem Sie einen Synchronisierungszeitplan konfigurieren. Sie können eine Synchronisierung so planen, dass sie täglich oder wöchentlich an einem bestimmten Wochentag stattfindet. Wenn Sie Ihren Pool mit dem Updatekanal synchronisieren, werden alle verfügbaren Updates auf den Poolkoordinator heruntergeladen. Anschließend können Sie alle heruntergeladenen Updates auf Ihren Pool anwenden.

1. Stellen Sie Ihren Pool so ein, dass er täglich synchronisiert wird:

   xe pool-configure-update-sync update-sync-frequency=daily update-sync-day=0
   xe pool-set-update-sync-enabled value=true
   <!--NeedCopy-->
   

   Stellen Sie Ihren Pool alternativ so ein, dass er wöchentlich synchronisiert wird:

   xe pool-configure-update-sync update-sync-frequency=weekly update-sync-day=1 (# 0 is Sunday, 1 is Monday, etc)
   xe pool-set-update-sync-enabled value=true
   <!--NeedCopy-->
   

2. Sehen Sie sich Ihre Synchronisierungskonfiguration an:

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-get uuid=<pool_uuid> param-name=update-sync-frequency
   xe pool-param-get uuid=<pool_uuid> param-name=update-sync-day
   xe pool-param-get uuid=<pool_uuid> param-name=update-sync-enabled
   <!--NeedCopy-->
   

3. Rufen Sie den Zeitstempel der letzten erfolgreichen Synchronisierung Ihres Pools mit dem Updatekanal ab:

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-get param-name=last-update-sync uuid=<pool_uuid>
   <!--NeedCopy-->
   

Alternativ können Sie Ihren XenServer-Pool manuell mit dem Update-Channel synchronisieren:

pool_uuid=$(xe pool-list --minimal)
update_checksum=$(xe pool-sync-updates uuid=<pool_uuid> --minimal)
<!--NeedCopy-->

update_checksum ist eine eindeutige Kennung, die den Stand der installierten Updates angibt. Es ändert sich, wenn neue Updates im öffentlichen CDN verfügbar gemacht werden, und wird später verwendet, wenn Updates auf Ihren Pool angewendet werden, um sicherzustellen, dass Sie immer die neuesten verfügbaren Updates anwenden. update_checksum kann Ihnen auch nützliche Informationen geben, wenn Sie den technischen Support kontaktieren müssen.

Hinweis:

Wenden Sie die Updates nach der Synchronisierung so schnell wie möglich auf Ihren Pool an, um von den neuesten Updates zu profitieren.

Wenn Sie nach der Synchronisierung, aber bevor Sie Updates auf die Hosts im Pool anwenden, einen neuen Poolkoordinator benennen, müssen Sie erneut mit dem neuen Poolkoordinator synchronisieren, bevor Sie den Pool aktualisieren können.

Synchronisieren Sie Ihren XenServer-Pool nicht, während der Pool gerade aktualisiert wird.

Machen Sie sich mit den Leitfäden und Updateaufgaben vertraut

Einige Aufgaben (wie das Evakuieren oder Neustarten Ihrer Hosts) sind möglicherweise vor und nach der Installation von Updates für Ihren Pool erforderlich. Manchmal sind kein Updateaufgaben erforderlich.

Kategorien von Leitlinien

XenServer versucht, die Störung Ihrer virtuellen Maschinen, die durch diese Aufgaben verursacht werden könnten, zu minimieren, indem die Aufgaben in die Kategorien Erforderlich, Empfohlen, Volle Wirksamkeit und Live-Patch unterteilt werden. Anhand dieser Kategorisierungen können Sie beurteilen, ob ein Updateaufgabe, die zu Ausfallzeiten oder geringfügigen Unterbrechungen für Ihre Hosts oder VMs führen könnte, für Ihre Umgebung und Ihr Risikoprofil erforderlich ist.

Bei Updates können Aufgaben in mehr als einer dieser Kategorien aufgeführt sein. Für ein Update kann es beispielsweise erforderlich sein, dass Sie den Host neu starten, um die volle Wirksamkeit der aktualisierten Features zu nutzen. Es wird jedoch empfohlen, den Toolstack neu zu starten, um die Vorteile des Updates optimal nutzen zu können und den Pool weniger zu stören.

Während des Updatevorgangs können Sie wählen, ob Sie eine der folgenden drei Aufgabenstufen ausführen möchten:

1. Erforderlich
2. Obligatorisch + Empfohlen
3. Erforderlich + Empfohlen + Volle Wirksamkeit

Erforderlich

Obligatorische Aufgaben müssen nach einem Update ausgeführt werden, da das System sonst zur Laufzeit ausfallen kann. Diese Maßnahmen sind erforderlich, um wichtige Korrekturen zu ermöglichen und sicherzustellen, dass Ihre Umgebung sicher und stabil ist. Sie können erforderliche Aufgaben nicht überspringen.

Empfohlen

Empfohlene Aufgaben sind die Aufgaben, die Sie ausführen sollten, um die meisten Funktionen und Fehlerbehebungen der Updates nutzen zu können. Wenn Sie diese Aufgaben jetzt nicht ausführen möchten, werden sie in den ausstehenden Updateaufgaben für den entsprechenden Pool, Host oder virtuelle Maschine aufgeführt.

Warum die empfohlenen Aufgaben ausgeführt werden sollten:

• Diese Aufgaben gewährleisten eine sichere, stabile XenServer-Umgebung.

Warum empfohlene Aufgaben übersprungen werden können:

• Nachdem Sie die detaillierten Informationen für die Updates überprüft haben, sind Sie der Meinung, dass das Risiko, dass diese Updates jetzt nicht vollständig angewendet werden, akzeptabel ist.
• Die empfohlenen Aufgaben führen jetzt zu unerwünschten Unterbrechungen Ihrer VMs.

Volle Wirksamkeit

Um die Vorteile der entsprechenden Updates nutzen zu können, sind Aufgaben im vollen Umfang erforderlich. Die Updates, denen Aufgaben zur vollen Wirksamkeit zugeordnet sind, sind in der Regel nur für Benutzer relevant, die bestimmte Geräte verwenden oder bestimmte Funktionen verwenden.

Lesen Sie die Updateinformationen, um zu erfahren, ob diese Aufgaben für Ihre Umgebung erforderlich sind. Wenn Sie diese Aufgaben jetzt nicht ausführen möchten, werden sie in den ausstehenden Aufgaben für den entsprechenden Pool, Host oder die virtuelle Maschine aufgeführt.

Warum die Aufgaben mit voller Wirksamkeit ausgeführt werden sollten:

• Die Updates mit Aufgaben zur vollen Wirksamkeit sind für Ihre Hardware, Umgebung oder Konfiguration relevant.

Warum sollten Sie sich von den Aufgaben mit voller Effektivität abmelden:

• Die Updates mit einer Anleitung zur vollen Wirksamkeit sind für Ihre Hardware, Umgebung oder Konfiguration nicht relevant.
• Die Aufgaben mit voller Wirksamkeit führen jetzt zu unerwünschten Unterbrechungen Ihrer virtuellen Maschinen.
• Sie benötigen die Vorteile dieser Updates derzeit nicht.

Wenn die Aufgaben mit voller Wirksamkeit für Ihre Umgebung gelten, Sie sich aber dafür entschieden haben, sie zu verschieben, planen Sie, diese Aufgaben während eines geeigneten Wartungsfensters abzuschließen, um die Stabilität Ihrer Umgebung aufrechtzuerhalten.

Live-Patches

Updates für bestimmte Komponenten können einen Live-Patch beinhalten. Ob ein Live-Patch auf Ihre Hosts angewendet werden kann, hängt von der Version der Komponente ab, die beim letzten Neustart der Hosts installiert wurde. Wenn ein Update als Live-Patch auf Ihre Hosts angewendet werden kann, ersetzt die Live-Patch-Anleitung die empfohlene Anleitung.

Beispiel:

Sie haben zwei Pools. Pool A wurde auf ein aktuelles Niveau aktualisiert. Pool B wurde seit einiger Zeit nicht aktualisiert. Wir veröffentlichen ein Update, die die empfohlene Updateaufgabe “Host neu starten” und die Live-Patch-Updateaufgabe “Toolstack neu starten” enthält.

In Pool A kann der Live-Patch auf diese aktuelleren Hosts angewendet werden. Die empfohlene Anleitung zeigt “Toolstack neu starten”. Die weniger störende Aufgabe aus der Live-Patch-Anleitung hat Vorrang vor den empfohlenen Empfehlungen.

In Pool B kann der Live-Patch nicht auf die Hosts angewendet werden, da sie sich auf einem älteren Level befinden. Die empfohlene Anleitung zeigt “Host neu starten”. Die empfohlenen Leitlinien gelten weiterhin. Die Live-Patch-Anleitung ist in diesem Fall irrelevant.

Manchmal werden nur einige der Fixes in einem Update aktiviert, wenn das Update als Live-Patch angewendet wird. Sehen Sie sich die Details zum Update an, um herauszufinden, ob Sie alle Fixes des Updates benötigen oder nur die Fixes, die durch den Live-Patch aktiviert wurden. Anhand dieser Informationen können Sie dann entscheiden, ob Sie die empfohlenen Aufgaben ausführen möchten. Weitere Informationen finden Sie unter Verfügbare Updates für Ihren Pool anzeigen.

Aufgaben für das Update

Bei der Installation einer Aktualisierung ist möglicherweise mindestens eine der folgenden Aufgaben erforderlich. Jede Art von Updateaufgabe kann in jeder Leitfadenkategorie aufgeführt werden.

Updateaufgaben für Ihren Host

Sie führen diese Aufgabe immer nur aus, bevor Sie Updates installieren, und manchmal führen Sie sie im Rahmen der Aufgabe “Host neu starten” aus:

Die folgenden Aufgaben erfordern Aktionen auf dem aktualisierten Host:

Sehen Sie sich die für Ihren Host erforderlichen Updateaufgaben an

Sehen Sie sich die Aufgaben an, die für Ihren Host vor und nach der Installation von Updates erforderlich sind, indem Sie die folgenden Befehle verwenden.

Holen Sie sich eine Liste der obligatorischen Aufgaben für Ihren Host:

xe host-param-get param-name=pending-guidances uuid=<host UUID>
<!--NeedCopy-->

Holen Sie sich eine Liste der empfohlenen Aufgaben für Ihren Host:

xe host-param-get param-name=pending-guidances-recommended uuid=<host UUID>
<!--NeedCopy-->

Holen Sie sich eine Liste der Aufgaben, die Ihr Host mit voller Effektivität erledigen muss:

xe host-param-get param-name=pending-guidances-full uuid=<host UUID>
<!--NeedCopy-->

Updateaufgaben für Ihre VM

Einige Updates bieten neue Features für Ihre VMs. Für diese Updates sind möglicherweise die folgenden Aufgaben auf Ihren VMs erforderlich:

Sehen Sie sich die für Ihre VM erforderlichen Updateaufgaben an

Holen Sie sich eine Liste der obligatorischen Aufgaben für Ihre VM:

xe vm-param-get param-name=pending-guidances uuid=<VM UUID>
<!--NeedCopy-->

Holen Sie sich eine Liste der empfohlenen Aufgaben für Ihre VM:

xe vm-param-get param-name=pending-guidances-recommended uuid=<VM UUID>
<!--NeedCopy-->

Holen Sie sich eine Liste der Aufgaben mit voller Effektivität für Ihre VM:

xe vm-param-get param-name=pending-guidances-full uuid=<VM UUID>
<!--NeedCopy-->

Verfügbare Updates für Ihren Pool anzeigen

Bevor Sie Updates installieren, sehen Sie sich die verfügbaren Updates für Ihren Pool an und überprüfen Sie die erforderlichen Updateaufgaben. Weitere Informationen zu den verschiedenen Updateaufgaben, die möglicherweise für ein Update erforderlich sind, finden Sie unter Grundlegendes zu den Leitfadenkategorien und Updateaufgaben.

Suchen Sie nach verfügbaren Updates für einen bestimmten Host

Prüfen Sie, ob Updates für einen bestimmten Host verfügbar sind:

xe host-param-get param-name=latest-synced-updates-applied uuid=<host UUID>
<!--NeedCopy-->

Dieser Befehl gibt yes zurück, wenn Updates für einen bestimmten Host verfügbar sind, und no, wenn keine verfügbar sind.

Suchen Sie nach verfügbaren Updates für alle Hosts

Suchen Sie nach verfügbaren Updates für alle Hosts, indem Sie eine GET-Anfrage am HTTP-Endpunkt /updates stellen.

Holen Sie sich Updates für alle Hosts mit dem Hilfsprogramm wget:

wget -O - --no-check-certificate https://<user name>:<password>@<coordinator IP address>/updates
<!--NeedCopy-->

Alternativ können Sie die HTTP-Clientbibliothek verwenden:

HTTP GET
session_id: <XAPI session ID returned from login>
host_refs: <host XAPI reference>
<!--NeedCopy-->

Die zurückgegebene Ausgabe ist im JSON-Format und enthält die folgenden Objekte:

• hosts: Listet die verfügbaren Updates für einzelne Hosts auf.

• updates: Listet die Details der verfügbaren Updates auf.

• hash: Die update_checksum (wird verwendet, um sicherzustellen, dass Sie immer die neuesten verfügbaren Updates anwenden).

Die Objekte hosts und updates enthalten auch das Objekt guidance, das aus den folgenden Schlüsseln besteht:

• mandatory
• recommended
• full
• livepatch

Diese Tasten beziehen sich auf die verschiedenen Leitfäden für Updateaufgaben. Sie listen die Updateaufgaben auf, die für Ihre Hosts und VMs erforderlich sind. Weitere Informationen zu den verschiedenen Aufgaben, die möglicherweise für ein Update erforderlich sind, finden Sie unter Grundlegendes zu den Leitfadenkategorien und Updateaufgaben.

Wenden Sie Updates auf Ihren Pool an

Vorbereitung

• Stellen Sie sicher, dass alle Hosts in Ihrem Pool online sind, bevor Sie das Pool-Update durchführen.

• Stellen Sie sicher, dass auf keinem Host oder einer VM anstehende obligatorische Updateaufgaben anstehen. Alle obligatorischen Updateaufgaben, die für frühere Updates ausstehen, müssen ausgeführt werden, bevor ein neues Pool-Update gestartet wird. Weitere Informationen finden Sie unter Für Ihren Host erforderliche Updateaufgaben anzeigen und Für Ihre VM erforderliche Updateaufgaben anzeigen.

• Deaktivieren Sie High Availability (HA), falls sie aktiviert ist:

   pool_uuid=$(xe pool-list --minimal)
   xe pool-ha-disable uuid=<pool_uuid>
   <!--NeedCopy-->
  

• Deaktivieren Sie Workload Balancing (WLB), falls es aktiviert ist:

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-set wlb-enabled=false uuid=<pool_uuid>
   <!--NeedCopy-->
  

Updates installieren

Um ein Update an Ihrem Pool durchzuführen, müssen Sie Updates auf jeden Host im Pool anwenden, wobei Sie zuerst mit dem Poolkoordinator beginnen. Folgen Sie diesen Schritten, beginnend mit dem Poolkoordinator:

1. Deaktivieren Sie den Host:

   xe host-disable uuid=<host UUID>
   <!--NeedCopy-->
   

2. Wenn eine der für das Update erforderlichen Updateaufgaben “Host evakuieren” oder “Host neu starten” ist, evakuieren Sie den Host:

   xe host-evacuate uuid=<host UUID>
   <!--NeedCopy-->
   

   Wenn Sie eine VM während der Host-Evakuierung nicht auf andere Hosts migrieren können, fahren Sie die VM herunter oder setzen Sie sie aus.

3. Updates auf den Host anwenden:

   xe host-apply-updates uuid=<host UUID> hash=<update_checksum>
   <!--NeedCopy-->
   

4. Rufen Sie eine Liste der erforderlichen Hostupdateaufgaben ab. Weitere Informationen finden Sie unter Aufgaben für Ihren Host aktualisieren.

   Führen Sie die Updateaufgaben des Hosts in der Liste in der folgenden Reihenfolge aus:

   1. Toolstack neu starten (kann übersprungen werden, wenn ein ‘Host Neustart’ ausgeführt werden muss)
   2. Host neu starten

5. Rufen Sie für jede laufende VM auf dem Host eine Liste der erforderlichen VM-Updateaufgaben ab. Weitere Informationen finden Sie unter Updateaufgaben für Ihre VM.

   Führen Sie die Updateaufgaben der VM in der Liste in der folgenden Reihenfolge aus:

   1. Gerätemodell neu starten (kann übersprungen werden, wenn ein ‘VM neu starten’ ausgeführt werden muss)
   2. Starten Sie die VM neu

6. Aktivieren Sie den Host, wenn er sich immer noch in einem deaktivierten Zustand befindet:

   xe host-enable uuid=<host UUID>
   <!--NeedCopy-->
   

7. Rufen Sie für jede VM, die Sie mit host-evacuate vor dem Hostupdate auf einen anderen Host migriert haben, eine Liste der Updateaufgaben ab. Weitere Informationen finden Sie unter Updateaufgaben für Ihre VM.

   Wenn “VM neu starten” in der Liste der Updateaufgaben steht, fahren Sie die VM herunter und starten Sie sie auf dem aktuell aktualisierten Host. Andernfalls migrieren Sie die VM zurück auf den aktuell aktualisierten Host.

8. Setzen Sie die VMs fort oder starten Sie sie, die Sie heruntergefahren oder angehalten haben, bevor Sie Updates installiert haben.

9. Sehen Sie sich den Status des Hostupdates an:

   xe host-param-get param-name=last-software-update uuid=<host UUID>
   xe host-param-get param-name=latest-synced-updates-applied uuid=<host UUID>
   xe host-param-get param-name=last-update-hash uuid=<host UUID>
   <!--NeedCopy-->
   

Wiederholen Sie die obigen Schritte, um jeden Host in Ihrem Pool zu aktualisieren.

Nach dem Update Ihrer Hosts

Nachdem Sie jeden Host in Ihrem Pool aktualisiert haben, führen Sie alle verbleibenden Updateaufgaben aus.

1. Rufen Sie für jede VM in Ihrem Pool eine Liste der Updateaufgaben ab. Weitere Informationen finden Sie unter Updateaufgaben für Ihre VM.

   Wenn “VM neu starten” in der Liste der Updateaufgaben steht, führen Sie ihn aus.

2. Aktivieren Sie HA, wenn Sie es vor der Installation von Updates deaktiviert haben:

   pool_uuid=$(xe pool-list --minimal)
   xe pool-ha-disable uuid=<pool_uuid>
   <!--NeedCopy-->
   

3. Aktivieren Sie WLB, wenn Sie es vor dem Anwenden von Updates deaktiviert haben:

   pool_uuid=$(xe pool-list --minimal)
   xe pool-param-set wlb-enabled=true uuid=<pool_uuid>
   <!--NeedCopy-->
   

4. Wenn Sie nur die obligatorischen Updateaufgaben ausführen möchten, die für ein Pool-Update erforderlich sind, werden die nicht ausgeführten Updateaufgaben an die Liste der ausstehenden Updateaufgaben angehängt, die für Ihre Hosts erforderlich sind. Informationen zum Anzeigen dieser Liste und zum Ausführen dieser Aufgaben finden Sie unter Aktualisierungsaufgaben für Ihren Host.