TYPO3 v12 mit Solr 9.8.0

🚀 Solr 9.8.0 & TYPO3 v12: Dein Upgrade-Guide für mehr Performance & Sicherheit
So migrierst du Apache Solr 8.9.0 auf 9.8.0 – ohne DevOps-Burnout!

Intro:
Ihr wollt TYPO3 v12 mit Solr 9.8.0 auf der Höhe der Zeit halten? 🔍 Kein Problem! In diesem Guide zeigen wir euch, wie ihr das Solr-Upgrade sauber, sicher und mit minimalem Downtime durchzieht. Spoiler: Es geht um Backups, Java 11 und ein paar Tricks für die Konfig-Migration. Let’s go!

Warum Upgrade?

• TYPO3 v12 Kompatibilität: Solr 9.x ist Pflicht für die neuesten Features.
• Sicherheit & Performance: Neue Versionen = weniger Lücken + schnellere Indexing-Prozesse.
• Modernes Schema Handling: Solr 9 setzt auf Managed Schema, was die Konfiguration vereinfacht.

Step 1: Vorbereitung – Backups, Backups, Backups!

Bevor ihr loslegt: Sichert alles! Ein falscher Befehl, und der Index ist Geschichte.

# Solr stoppen
sudo systemctl stop solr

# Backup des Solr-Installationsverzeichnisses
sudo tar -czvf /opt/solr-8.9.0-backup-$(date +%F).tar.gz -C /opt/solr-8.9.0 .

# Backup der Solr-Cores (wo eure wertvollen Daten leben!)
sudo tar -czvf /opt/solr-data-backup-$(date +%F).tar.gz -C /var/solr/data .

Pro-Tipp: Lagert die Backups auf einem anderen Server oder Cloud-Speicher. 💾

Step 2: Java 11 – Der heimliche Star des Upgrades

Solr 9.x braucht Java 11 oder höher. Checkt eure Version:

java -version

Falls Output: openjdk version "1.8.0_352" → Nope, das reicht nicht.

Lösung:

sudo apt install openjdk-11-jdk
# Danach Default-Java setzen (falls mehrere Versionen installiert sind):
sudo update-alternatives --config java

Step 3: Solr 9.8.0 installieren

Hier kommt der entscheidende Cut – die neue Solr-Version:

cd /tmp
wget https://archive.apache.org/dist/solr/solr/9.8.0/solr-9.8.0.tgz
sudo tar -xzf solr-9.8.0.tgz -C /opt/
sudo mv /opt/solr-9.8.0 /opt/solr-9.8.0  # Klar, konsistente Namensgebung!

Step 4: Konfiguration migrieren – Der feine Unterschied

A) TYPO3-Konfiguration anpassen
Die alte Solr-8-Konfig ist nicht 1:1 kompatibel. Holt euch die neuesten Configs aus:

• Der TYPO3 Extension solr (Version ≥ 12.0.0)
• Oder direkt von TYPO3-Solr GitHub.

Kopieren der Configs:

# Beispiel (Pfad anpassen!)
sudo cp -r /path/to/typo3-solr-configsets/* /opt/solr-9.8.0/server/solr/configsets/

B) Core-Daten übertragen
Eure Indizes dürfen nicht verloren gehen:

sudo rsync -av /var/solr/data/mein_typo3_core/ /opt/solr-9.8.0/server/solr/mein_typo3_core/
sudo chown -R solr:solr /opt/solr-9.8.0/server/solr/  # Rechte anpassen!

Step 5: Systemd-Service anpassen – Neustart mit Stil

Erstellt oder updated eure Service-Datei /etc/systemd/system/solr.service:

[Unit]
Description=Apache Solr für TYPO3 v12
After=network.target

[Service]
User=solr
ExecStart=/opt/solr-9.8.0/bin/solr start -f -p 8983
ExecStop=/opt/solr-9.8.0/bin/solr stop
Restart=on-failure

[Install]
WantedBy=multi-user.target

Service neu laden:

sudo systemctl daemon-reload
sudo systemctl enable solr
sudo systemctl start solr

Step 6: Checks & TYPO3-Tuning

A) Solr-Dashboard prüfen:
Ob alles läuft, seht ihr unter http://[eure-ip]:8983/solr/.
Kritisch: Sind alle Cores geladen? 🔄 Falls nicht: Logs unter /opt/solr-9.8.0/server/logs/solr.log checken.

B) TYPO3-Seite anpassen:

• Aktualisiert die ext-solr-Extension auf Version 12.x.
• Im TYPO3-Backend: Solr-Dashboard → Verbindungstest durchführen.

Re-Indexing starten:

./typo3/sysext/core/bin/typo3 solr:indexqueue:queue

Fallback-Szenario: Wenn’s brennt

• Backup einspielen: Im Zweifel zurück zur Solr-8.9.0-Version.
• Firewall & Ports: Ist Port 8983 freigegeben?
• Heap-Space-Fehler: In /opt/solr-9.8.0/bin/solr.in.sh den Wert SOLR_HEAP erhöhen (z. B. SOLR_HEAP="4g").

Finale: Aufräumen & Feiern!

Wenn alles läuft:

# Alte Solr-8.9.0-Installation löschen (optional)
sudo rm -rf /opt/solr-8.9.0

🎉 Grats! Ihr habt jetzt Solr 9.8.0 am Start – performant, sicher und fit für TYPO3 v12.

Warum das alles?

• Schnellere Searches: Solr 9 optimiert die Index-Verarbeitung.
• Future-Proof: Bereit für kommende TYPO3-Updates.
• Community-Bonus: Ihr bleibt Teil der Innovations-Welle! 🌊

🔥 Euer Move, DevOps!
Testet das Upgrade in einer Staging-Umgebung, dreht euren eigenen Solr-Turbo auf und teilt eure Erfahrungen in der recode.at Community. Fragen? Her damit in die Kommentare!

Autor: DevOps @ recode.at | #SolrUpgrade #TYPO3 #DevOps

💡 Lust auf mehr Guides? Abonniert unseren Newsletter.

Sharing is Caring: Teilt diesen Artikel mit euren DevOps-Crews!