Changelog IES-2

Aus SiteparkWiki
Version vom 6. April 2022, 13:01 Uhr von Veltrup (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „==Release Notes== ====Anmerkungen==== <div class="note"> '''Update der Version 3.0'''<br> Es wird empfohlen, das Major-Update in Abstimmung mit Sitepark dur…“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)
Zur Navigation springen Zur Suche springen

Release Notes

Anmerkungen

Update der Version 3.0

Es wird empfohlen, das Major-Update in Abstimmung mit Sitepark durchzuführen.

Der IES-3 ist nahezu komplett kompatibel zum IES-2. Bei einem Update auf den IES-3 sollte aber auf folgendes geachtet werden

  • Vor dem Update für alle Webnodes die letzte Update-Datei löschen
    rm /srv/sitepark/ies-webnode/update/*
    
  • Die Log-Dateien liegen jetzt in einem eigenen Verzeichnis (in SITEPARK_HOME/logs)
  • Das Webdav-Modul wird nicht mehr unterstützt. Es sollte nach dem Update geprüft werden ob das Module vollständig gelöscht wurde. Wenn nicht, sollte
    rm -rf /srv/sitepark/ies/modules/webdav.war
    
    ausgeführt werden.
  • Der SPML-Compiler ist etwas strenger als bisher. Bei Systemen die Templates aus der Template-Verwaltung in Infosite5 nutzen müssen nach dem Update alle Templates neu kompiliert werden. In der ies.log-Datei sollte dann auf ERROR-Einträge von ies.services.generator.Generator geachtet werden. Beim generieren von Seiten mit fehlerhaften Templates werden org.apache.jasper.JasperException Einträge erzeugt. Es können zwei verschiedene Fehler auftreten.
    • Zwei gleiche Attribute in einem Tag z.B. <sp:print name="a" name="b"/>
    • Leerzeichen zwischen Attribut-Name und Attribut Wert. Z.B. <sp:print name ="a"/> oder <sp:print name= "a"/>
  • Die Angaben IES_INIT_OUTPUT und IES_LOG_ROTATE in der /etc/sitepark/sitepark.conf werden nicht mehr ausgewertet und können entfernt werden.

Die Haupt-Neuerungen im IES-3 sind:

  • Der IES-3 wird nicht mehr für Windows angeboten.
  • Update auf Java 17. Wird jetzt vom IES mitgeliefert und aktuell gehalten.
  • Umstellung von JBoss auf Jetty als Server-Basis
  • Docker-Support (z.Z. für Entwicklungssysteme)
  • Neues Module-System mit Erweiterung für eigenständige Frontend- und Frontent-Delivery-System-Module
  • Aktualisierung aller Abhängigkeiten

Update der Version 2.66

Windows wird nicht mehr unterstützt. Relevant ist das nur für Entwicklungs-Systeme, da kein Produtiv-System unter Windows läuft. Alternativ kann der IES unter Windows in einer virtuellen Umgebung (z.B. VBOX) betrieben werden. Ab Version 3 ist auch der Betrieb in Docker möglich.

Die Bildbearbeitung wurde überarbeitet. Speziell der SVG-Support. Damit SVG-Bilder wie gewünscht verarbeitet werden können sollte dem Update folgendes geprüft werden:

Ist der Interne SVG-Support von ImageMagick verfügbar:

 convert -list format | grep SVG

Die Ausgabe sollte in etwas so aussehen:

     MSVG  SVG       rw+   ImageMagick's own SVG internal renderer
      SVG  SVG       rw+   Scalable Vector Graphics (XML 2.9.4)
     SVGZ  SVG       rw+   Compressed Scalable Vector Graphics (XML 2.9.4)

Ist das nicht der Fall muss noch libmagickcore-*-extra installiert werden. Die genaue Version läßt Mit Debian/Ubuntu wie folgt ermitteln

apt search libmagickcore

Zusätzlich ist noch rsvg-convert notwendig. Die wird wie folgt installiert

# Debian/Ubuntu
apt-get install librsvg2-bin
# CentOS
yum install librsvg2-tools
# openSUSE
zypper install rsvg-convert # bzw. zypper install rsvg-view

Soll oder kann rsvg nicht installiert werden, muss der Delegator per

-Dcom.sitepark.imgfile.imagemagick.scale.svgDelegator=svg

zurück gesetzt werden. Dies erfolgt über die Konfiguration in "sitepark.conf"

IES_OPTS="-Dcom.sitepark.imgfile.imagemagick.scale.svgDelegator=svg"

Update Apache
Aktuelle Projekte basieren i.d.R. auf Macros von Sitepark zur einfachen Konfiguration der Webserver. Für diese Macros ist in Zukunft ein Apache Version 2.4.34 oder größer empfohlen. Dieser wird in aktuellen Distributionen (Debian 10, Ubuntu 20.04) bereits ausgeliefert. Ubuntu 18-Systeme sollten die Paketquellen von Ondrej einbinden um das Update des Apache zu erhalten:

https://launchpad.net/~ondrej/+archive/ubuntu/apache2

Sollten Sie hierzu Fragen haben, sprechen Sie uns gerne an. Sollten Sie keine Macros von Sitepark eingebunden haben, können Sie diesen Hinweis ignorieren.

Update der Version 2.65
Der IES wurde erweitert um Video- und Audio-Datein zu erkennen und dessen Metadaten auszulesen. Dazu wird das Werkzeugt mediainfo verwendet und muss mit dem Update nachinstalliert werden.
Sollte der IES zum Zeitpunkt der Installation bereits laufen, muss dieser nach der Installation neu gestartet werden.

Beispiel für Ubuntu/Debian:

apt-get install mediainfo

Beispiel für CenOS/Redhat:

yum install mediainfo

Update der Version 2.63
Diese Version verfügt über eine ältere Definition der Schnittstelle zu dem Modul-Repository. Die Aktualisierung des Systems über den iesadmin ist deshalb u.U. nicht möglich. Vor dem Update auf eine höhere IES-Version ist es notwendig die entsprechende jar-Datei zu aktualisieren. Dazu muss die Datei /srv/sitepark/jboss/server/default/ies-lib/com.sitepark.nexus-1.17.jar durch die Version 1.22 ersetzt werden.

https://ies.sitepark.com/downloads/com.sitepark.nexus-1.22.jar

Es steht ebenfalls ein Skript zur Verfügung das diesen Schritt vereinfachen. Für weitere Informationen wenden Sie sich bitte an den Support.

Update zu Version 2.61
Mit dieser Version wurde der Algorithmus für die Verschlüsselung des Admin-Passwortes geändert. Das Update muss interaktiv ausgeführt und das alte Passwort erneut bestätigt werden. Weitere, optionale Zugänge sind anschließend manuell neu zu setzen. Zusammen mit diesem Updates sind mind. auch folgende Modul-Versionen zu installieren:

  • IES-Admin 1.46
  • IES-API 1.51
  • IES-Base 1.11

Sollten die Module beim Update nicht mit installiert worden sein, kann man das manuell noch per

iesadmin module update

nachholen.

Update zu Version 2.52
Wir planen ein Update der MySQL-Bibliothek, bei der es u.U. bei der Anbindung der Datenbank zu Problemen kommen kann, da die Default-Timezone (in Zusammenhang mit der Default-Setzung des Betriebssystems) nicht gültig ist. Zu lösen ist dies Problem durch folgende Anpassung in der MySQL-Konfiguration, die bereits jetzt vorgenommen bzw. eingeplant werden sollte:

[mysqld]
default-time-zone='+01:00'

Update zu Version 2.26
Ab dieser Version wird Java 9 experimentell unterstützt.

Unter Windows ist eine manuelle Änderung notwendig. In der Datei

SITEPARK_HOME\ies.ini

muss der Parameter

Virtual Machine Parameters

um den Wert

--add-modules java.se.ee

ergänzt werden. Der Wert

-Djava.endorsed.dirs=...

muss entfernt werden.

Update zu Version 2.25
Bei einem Update zu Version 2.25 oder höher, kann es zu folgender Fehlermeldung kommen:

 com.sitepark.ies.license.LicenseException: JCE cannot authenticate the provider BC

In diesem Fall konnte eine Datenbank-Update-Routine nicht ausgeführt werden. Dann sollte noch einmal folgendes Kommando ausgeführt werden.

 iesadmin dbupdate -c com.sitepark.ies.setup.database.v2.v25.CleanupMailPublisherDependencies -a

Änderungen in Version 2.22
In dieser Version wurde die Bildverarbeitung überarbeitet. Interne Abläufe in der Bildskalierung wurden umgestellt, um viele Bilder die zum Generierungs-Vorgang berechnet werden müssen, in einem akzeptablen Zeitraum verarbeiten zu können. Zusätzlich wurde der Funktionsumfang der Bildverwaltung erweitert. Zu diesem Thema gibt es einen eigenen Artikel der die Funktionalitäten erläutert IES Bildverarbeitung.

Durch das Update ist eine Reindizierung der BinDB notwendig. Da dies einige Zeit in Anspruch nimmt, erfolgt die Reindizierung nicht automatisch durch die Update-Routine, sondern kann bei laufendem Betrieb über das Kommando

iesadmin bindb reindex -a

nachträglich ausgeführt werden.


Die Dateinamen der skalierten Bilder im Webbereich haben sich geändert und sind jetzt Hash-Werte aus dem Original-Hash und den Parametern für die Skalierung. Dies hat den Vorteil, dass sich das Cache-Verhalten des Browsers über ergänzende Apache-Konfigurationen optimieren lässt. Aufgrund dieser Änderung werden bei der ersten Generierung eines Artikels nach dem Update alle Bilder, die der Artikel verwendet, neu skaliert.

Die skalierten Dateien mit dem alten Dateinamen liegen weiterhin im Webbereich. Um diese aufzuräumen können folgende Schritte ausgeführt werden:

  • Gesamten Mandanten generieren
  • Bilder mit altem Format ermitteln
# Größe der Dateien berechnen, die die alte Bild-Signature verwenden
find . -regex '.*\.scaled\/[0-9]*x[0-9]*\.pm[0-9]\.bg[0-9A-F]*\(\.fp[0-9]*x[0-9]*\)?\.[a-z][a-z][a-z]' -ls | awk  '{total += $7} END {print total/1024/1024 " MiB"}'
# Größe der Dateien berechnen, die die neue Bild-Signature verwenden
find . -regex '.*\.scaled\/[0-9a-z]*\.[a-z][a-z][a-z]' -ls | awk  '{total += $7} END {print total/1024/1024 " MiB"}'
# Finde alle Dateien, die noch die alte Bild-Signatur verwenden
find . -name \*.php -exec egrep -nH -m 1 '\.scaled\/[0-9]*x[0-9]*\.pm[0-9]\.bg[0-9A-F]*(\.fp[0-9]*x[0-9]*)?\.[a-z][a-z][a-z]' {} \;
  • Bilder mit altem Format löschen
# Dateien mit alter Bild-Signature löschen
find . -regex '.*\.scaled\/[0-9]*x[0-9]*\.pm[0-9]\.bg[0-9A-F]*\(\.fp[0-9]*x[0-9]*\)?\.[a-z][a-z][a-z]' -exec rm {} \;


Eine Erweiterung des Generators bietet jetzt die Möglichkeit auch unveränderte Bilder neu zu skalieren. Hier gibt es in der Infosite 5 Administrations-Umgebung im Generator-Step die Option "alle Bilder neu berechnen"

Aufgrund der Überarbeitung der Bildverarbeitung ergeben sich folgende Änderungen und Neuerungen:

Java 8 erforderlich!
Mit der IES-Version 2.17 werden Java-Biblotheken benötigt die mindestens Java 8 erfordern. Daher ist für den IES ab der Version 2.17 mindestens Java 8 notwendig. Java 8 kann entweder durch das Package-Management der Distribution erfolgen oder manuell in das Verzeichnis SITEPARK_HOME/jvm installiert werden.

Mit der IES-Version 2.16 werden neue Funktionen von ImageMagick verwendet, die ein Update von ImageMagick auf die Version >= 6.7.5-1 erfordern. Ist ein Update nicht möglich kann der IES im Legacy-Modus betrieben werden. Hierzu muss in der sitepark.conf z.B. folgender Eintrag

IMAGEMAGICK_VERSION="6.7.2-7"

ergänzt werden.

Abwärtsinkompatibilität ab IES-Version 2.12.11. Bei Update auf diese Version oder höher ist ebenfalls ein Update folgender Module zwingend notwendig (wenn sie installiert sind):

  • Infosite6 - Version 6.4.5
  • CityGov - Version 3.9.8
  • Infoticket - Version 1.14
  • Solr - Version 1.6.3
  • Formular Service - Version 1.2
  • IES XIP Manager - Version 2.7.1
  • IES Webnode Module - Version 1.3

Mit der IES-Version 2.12 wurde der Standard-Algorithmus für Verschlüsselung der Passwörter verstärkt Bitte prüfen Sie, ob die aktuellen Setzungen Auswirkungen auf die Performance beim Login (auch Live-Seiten) haben und passen Sie diese ggf an: Passwort-Steuerung

Mit der IES-Version 2.11 wurde eine neue Variable system.modules eingeführt. Eventuelle vorhandene IF-Abfragen in Template auf die InfoSite6-Umgebung mit

 <sp:if name="system.modules.infosite6">.....</sp:if>

müssen angpasst werden:

 <sp:if name="system.module" contains="InfoSite 6">.....</sp:if>

Mit der IES-Version 2.10 wurde ein Update des TinyMCE-Editors auf die Version 4 durchgeführt. Damit gehen entsprechende Neuerungen einher.

Mit der Version 2.9 ist die Prüfung der Datenbanktabellen verfeinert worden. Dieses kann unter Umständen dafür sorgen, dass die Datenbank nicht akzeptiert und der jeweilige Mandant nicht aktiviert wird.
Mit dem folgenden Statements können die Tabellen überprüft und ggf korrigiert werden:

 -- Prüfung:
 SHOW TABLE STATUS WHERE Collation != "utf8_general_ci";

 -- Korrektur:
 ALTER TABLE <<table_name>> convert TO character SET utf8 collate utf8_general_ci;

Mit der IES-Version 2.7 wird die Papierkorb-Funktion eingeführt. Alle Artikel werden beim Löschen zunächst nur in einen Papierkorb verschoben und können dort vom entsprechenden Redakteur wieder hergestellt werden. Der Papierkorb selber wird über einen eigenen Dienst "RecycleBin Cleaner" regelmäßig aufgeräumt. Ohne weitere Konfiguration werden alle Elemente, die über 10 Jahre alt sind gelöscht. Bitte passen Sie die Konfiguration auf einen für Sie sinnvollen Wert (z.B. 2 Jahre) an.

Das endgültige Entfernen gelöschter Elemente durch die IES-Admin-Funktion "clean" wurde durch diesen Service abgelöst.

Mit der IES-Version 2.5 werden auch sog. IES Webnodes eingeführt, die Dienste auf den Webservern bereitstellen.

Mit der IES-Version 2.5 findet eine logische Umstellung bzw. Optimierung der Personalisierung statt. Bisher galten Artikel, die in einem Pool mit Personlisierung angelegt wurden erst als geschützt, wenn diese explizit die Angaben des Parent übernommen haben. Wurden die Artikel anschließend verschoben galt die alte Beziehung weiter.

Das ist nun geändert worden. Alle Artikel, die in einem Pool mit Personlisierung liegen, sind automatisch über diesen geschützt. Soll ein Artikel global freigegeben werden, so muss dies explizit vom Redakteur eingestellt werden. Wird ein Artikel in einen geschützten Pool verschoben, ist dieser automatisch entsprechend personalisiert. Wird ein Artikel ohne eigene Angaben von einem geschützten Pool in einen anderen verschoben gelten die Angaben des Zielpools. Hat ein Artikel individuelle Angaben gespeichert, so gelten stets diese.

Diese Neu-Definition ist für die Redakteure wesentlich klarer. Missverständnisse werden vermieden. Um mögliche Effekte auf einzelne Artikel beim Update zu ermitteln, stellt Sitepark gerne entsprechende SQL-Statements bereit.

Mit der Version 1.4 des IES Generators ist für die Nutzung des Ilinks eine Generierung aller Artikel notwendig, da es funktionale Anpassungen im entsprechenden Tag gab, die nur auf diese Weise in alle Artikel einfließen können. Verzichtet man auf die komplette Generierung aller Artikel, so wird der Ilink nur in den Seiten dargestellt, die nach dem Update über redaktionelle Arbeiten neu generiert wurden. In allen übrigen Artikeln ist der Link zum CMS nicht mehr sichtbar.