Von Kunden gehostete Looker-Instanz aktualisieren

Wenn Sie auf die neuesten Fehlerkorrekturen und neuen Funktionen zugreifen möchten, aktualisieren Sie Ihre vom Kunden gehostete Looker-Instanz, indem Sie die folgenden manuellen Schritte ausführen.

Beachten Sie, dass ein Rollback auf eine frühere Version zu schwerwiegenden Problemen führen kann. Stellen Sie stattdessen immer eine Sicherung wieder her, wenn Sie ein Rollback durchführen müssen. Wenn Sie einen Looker-Cluster betreiben, aktualisieren Sie jeden Knoten nacheinander vollständig. Bei diesem Vorgang wird außerdem davon ausgegangen, dass Ihre Instanz das Startskript enthält, das bei der Ersteinrichtung installiert wurde.

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

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

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

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

3. Sichern Sie Ihr gesamtes Looker-Verzeichnis, einschließlich ausgeblendeter Verzeichnisse. Weitere Informationen finden Sie auf der Dokumentationsseite Back-ups wiederherstellen.

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

5. Prüfen Sie vor dem Aktualisieren von Looker auch, ob Ihre MySQL-Serverparameter und die Standardsortierung der Backend-Datenbank auf utf8mb4_general_ci festgelegt sind. Andernfalls werden nach dem Update möglicherweise Fehler aufgrund von Sortierungsabweichungen angezeigt.

6. 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.

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

   Wenn Sie einen Looker-Cluster aktualisieren, starten Sie den Looker-Prozess nur auf einem Knoten. Starten Sie Looker erst auf den anderen Knoten, wenn der erste Knoten den Aktualisierungsvorgang abgeschlossen hat.

   ./looker start
   

   Sie können Looker auch mit dem Befehl java -jar starten. Die Core-JAR-Datei findet die Abhängigkeits-JAR-Datei, solange sie sich zusammen mit der Core-JAR-Datei 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 Looker auch seine interne Datenbank aktualisieren. Die Datenbankaktualisierung dauert in der Regel weniger als fünf Minuten, kann aber manchmal länger dauern als der Looker-Startvorgang. Wenn Sie versuchen, Looker zu starten, während die interne Datenbank noch aktualisiert wird, wird der Daemon-Prozess nach sechs Minuten mit der Meldung „Zeitüberschreitung beim Warten auf den Start von Looker“ abgebrochen.

   Während eines Updates können die erforderlichen Migrationen 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 Aktualisierungsvorgang noch läuft:

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

   Wenn Sie den Looker-Prozess während der Aktualisierung der internen Datenbank stoppen und neu starten, kann die interne Datenbank beschädigt werden. In diesem Fall müssen Sie Looker aus einem vorhandenen Backup wiederherstellen und das Update noch einmal ausführen.

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