Von Kunden gehostete Looker-Instanz aktualisieren

Wir raten dringend davon ab, diese Anleitung zu verwenden, um zu einer früheren Version von Looker zurückzukehren. Das kann zu schwerwiegenden Problemen führen, die mühsam und schwierig zu beheben sind. Stattdessen empfehlen wir, eine Sicherung wiederherzustellen, wenn Sie zu einer früheren Version von Looker zurückkehren möchten.

Sie werden über neue Looker-Releases informiert, sobald sie verfügbar sind. Wir empfehlen, Looker regelmäßig zu aktualisieren, um auf dem neuesten Stand zu bleiben und von Fehlerkorrekturen und neuen Funktionen zu profitieren.

Wenn Sie einen Cluster von Looker-Instanzen haben, müssen Sie einen einzelnen Knoten vollständig aktualisieren, bevor Sie die anderen Instanzen aktualisieren.

Bei diesem Aktualisierungsprozess wird davon ausgegangen, dass Ihre Looker-Instanz das Startskript enthält, das im Rahmen der ersten Looker-Installation installiert worden sein sollte.

1. Laden Sie die neueste Version der Looker-JAR-Dateien wie auf der Dokumentationsseite Looker-JAR-Dateien herunterladen beschrieben herunter.

2. So beenden Sie den Looker-Prozess über die Shell als Nutzer looker:

   sudo su - looker
   cd /home/looker/looker
   ./looker stop
   

   Wenn Sie einen Looker-Cluster aktualisieren, wiederholen Sie diesen Vorgang, damit Looker auf jedem Knoten angehalten wird.

3. Sichern Sie das gesamte Looker-Verzeichnis, einschließlich ausgeblendeter Verzeichnisse. Weitere Informationen finden Sie auf der Dokumentationsseite Sicherungen wiederherstellen.

4. Wenn Sie die Standard-In-Memory-Datenbank von Looker zu einer externen MySQL-Datenbank migriert haben oder einen Looker-Cluster aktualisieren, sichern Sie die MySQL-Datenbank.

5. Benennen Sie looker-x.x.x.jar zu looker.jar und looker-dependencies-x.x.x.jar zu looker-dependencies.jar um. Kopieren Sie looker.jar und looker-dependencies.jar in das Serververzeichnis (/home/looker/looker/looker.jar). Beide Dateien müssen sich im selben Verzeichnis befinden.

6. Starten Sie den Looker-Prozess über die Shell als Nutzer looker:

   Wenn Sie einen Looker-Cluster aktualisieren, starten Sie den Looker-Prozess nur auf einem Knoten. Starten Sie Looker auf den anderen Knoten erst, wenn der Aktualisierungsprozess auf dem ersten Knoten abgeschlossen ist.

   ./looker start
   

   Sie können Looker auch mit dem Befehl java -jar starten. Die JAR-Datei des Hauptprogramms findet die JAR-Datei der Abhängigkeit, sofern sie sich zusammen mit der JAR-Datei des Hauptprogramms im Verzeichnis ./looker befindet.

   Wenn Sie lieber ein von Looker bereitgestelltes Startskript verwenden möchten, finden Sie ein solches unter https://github.com/looker/customer-scripts.

   Wenn Sie Ihre Looker-Version aktualisieren, muss auch die interne Datenbank von Looker aktualisiert werden. Die Datenbankaktualisierung dauert in der Regel weniger als fünf Minuten, kann aber manchmal länger dauern als der Startvorgang von Looker. Wenn Sie versuchen, Looker zu starten, während die interne Datenbank noch aktualisiert wird, tritt nach sechs Minuten eine Zeitüberschreitung auf und die Meldung „Zeitüberschreitung beim Warten auf den Start von Looker“ wird angezeigt.

   Die erforderlichen Migrationen können während eines Updates bis zu einer Stunde dauern, insbesondere wenn Sie mehrere Releases überspringen. Wenn Sie diese Fehlermeldung erhalten, warten Sie, bis das Update abgeschlossen ist und Looker gestartet wird. Mit dem folgenden Befehl können Sie prüfen, ob der Aktualisierungsprozess noch läuft:

   ps -f $(pgrep -f -- '-jar looker.jar')
   

   Wenn Sie den Looker-Prozess beenden und neu starten, während die interne Datenbank aktualisiert wird, kann dies zu einer Beschädigung der internen Datenbank führen. In diesem Fall müssen Sie Looker aus einer vorhandenen Sicherung wiederherstellen und das Update noch einmal ausführen.

7. Wenn Sie einen Looker-Cluster aktualisieren, warten Sie, bis der erste Knoten den Aktualisierungsprozess abgeschlossen hat, bevor Sie Looker auf den anderen Knoten starten.