Manuelles aktualisieren der Apache Solr
Dieser Artikel beschreibt, wie die Apache Solr unter Windows-Installationen manuell aktualisiert werden kann.
Dieser Artikel betrifft nur Kunden mit Windows-Systemen, welche die Apache Solr unterhalb von Windows betreiben. Kunden, die Apache Solr unterhalb von Docker betreiben, müssen lediglich ein Docker re-pull machen und/oder das Image mit dem Tag 8.11 oder latest versehen.
Um die Apache Solr auf Windows Systemen zu aktualisieren, wird das Vorgehen in der folgenden Schritt-für-Schritt Anleitung erklärt.
Voraussetzung für das Update
Um diesen Artikel anzuwenden, setzen wir Folgendes voraus:
Eine bereits getätigte Installation des Backend Setups in Version 1.0.4 oder älter, alternativ eine manuell installierte Apache Solr auf eine Windows-System
Vertrautheit mit der Bearbeitung von ZIP-Archiven
Sicherung der bisherigen Cores (Daten von Solr)
Erfahrung mit dem Umgang der Service-Verwaltung unterhalb von Windows
Erfahrung im Umgang mit der Befehlszeile
Beziehen der Apache Solr ab Version 8.11.1: Apache Solr Downloads
Vorbereitung für das Update
Bevor wir mit dem Update des Systems beginnen, müssen wir zuvor die Apache Solr auf dem Windows-System beenden. Dazu starten wir die Service-Verwaltung von Windows:
Und suchen den jeweiligen Search Service aus.
Hier kann je nach installierter Version die Bezeichnung des Suchdienstes anders sein und von der in der Abbildung gezeigten Bezeichnung abweichen.
Nach der Auswahl beenden wir den Dienst. Anschließend wechseln wir in das Installationsverzeichnis der Apache Solr.
Wenn die Apache Solr nicht mit dem Backend Setup installiert wurde, kann der Installationspfad entsprechend von den hier aufgeführten Beispielen abweichen.
Es können alle Verzeichnisse entfernt werden bis auf folgende Verzeichnisse und Dateien:
<INSTALLDIR>/bin/solr-service.exe (Nur bei Installation via Backend Setups)
<INSTALLDIR>/bin/solr-30004.port (Nur bei Installation via Backend Setups)
<INSTALLDIR>/bin/solr.in.cmd (sofern Anpassungen an der Standardkonfiguration vorgenommen wurden)
<INSTALLDIR>/server/solr (hier sind alle Cores mit dessen Daten hinterlegt)
Nach dem die Verzeichnisse entfernt wurden, sollte das Installationsverzeichnis wie folgt aussehen:
Aktualisieren der Apache Solr
Wie in der Voraussetzung beschrieben, sollten wir auf unserem Zielsystem die Apache Solr in der neuen Version bereits heruntergeladen haben.
Um die Apache Solr zu aktualisieren, öffnen wir die ZIP-Datei und entpacken die Daten in unserem Installationsverzeichnis.
Nachdem wir alle Dateien entpackt und aktualisiert haben, können wir in die Apache Solr wieder unterhalb der Service-Verwaltung in Windows starten.
Kontrolle, ob das Update erfolgreich war
Um zu kontrollieren, ob das Update erfolgreich war, können wir nach dem Start des Dienstes die Verwaltungsseite von Apache Solr öffnen. Hierzu starten wir unseren Browser des Vertrauens und wechseln auf die Seite: http://localhost:30004/solr/#/
Wenn sich jetzt die Verwaltungsseite öffnet und wir keine Fehler angezeigt bekommen haben, war das Update erfolgreich.
Im dem rot markierten Bereich in der obigen Abbildung können wir dann die aktuelle Version des Systems sehen. Hier sollte die jeweilige Version angezeigt werden, die für das Update verwendet wurde.
Zusätzlich kontrollieren wir jetzt noch, ob auch alle unsere Cores wieder verfügbar sind und unsere Daten vorhanden sind. Hierzu wählen wir auf der Seite im linken Bereich den jeweiligen Core aus:
Daraufhin öffnet sich die Übersicht des ausgewählten Cores, in der wir direkt entnehmen können, ob noch alle Einträge vorhanden sind.