Migration auf WEEASY 1.3.0.47

Für die Migration auf die Version 1.3.0.47 sind die folgende Schritte notwendig.

 

Diese Anleitung beschreibt die Migration von WEEASY 1.3.0.46 Appliances auf WEEASY 1.3.0.47.


Bitte beachten Sie die folgenden Hinweise:

  • Bitte erstellen Sie vor dem Upgrade unbedingt ein Backup des WEEASY Appliance z.B. indem Sie einen Snapshot der VM per VMware erstellen.

  • Die Office Web Apps erfordern entweder eine Office 365 Account oder einen Microsoft Office Online Server 2016. Beim Einsatz eines Office Online Servers empfehlen wir die Verwendung des Release vom November 2016 (https://blogs.office.com/2016/11/18/office-online-server-november-release/)

  • Das Upgrade erfordert zwingend die WEEASY Version 1.3.0.46. Sollten Sie noch die Version 1.3.0.45 oder früher im Einsatz haben, so wenden Sie sich bitte an unseren Support. Das direkte Update auf die Version 1.3.0.47 ist in diesem Fall nicht möglich.
     
  • Der File Synchronization Client muss ebenfalls aktualisiert werden. Vorgängerversionen sind mit der Version 1.3.0.47 nicht kompatibel.

 

Sicherung der bestehenden Installation erstellen

  • Zum Erstellen einer Sicherung vor dem Einspiel des Updates wird das Erstellen eines Snapshot mit Hilfe von VMware empfohlen. Im Falle von Problemen kann so ohne Datenverslust wieder am einfachsten auf die vorherige Version zurück gewechselt werden.
     
  • Folgende Konfigurationsdatei werden beim Update überschrieben. Eventuell darin vorgenommene manuelle Änderungen müssen daher nach Durchführung des Updates erneut vorgenommen werden:
    • /usr/share/jboss-as/standalone/configuration/standalone.xml
    • /etc/httpd/conf/httpd.conf

 

Update einspielen

Zum besseren Überblick was während des Updates passiert, ist es hilfreich in einer zweiten Konsole die JBoss Logs anzuzeigen:

tail -f /usr/share/jboss-as/standalone/log/boot.log /usr/share/jboss-as/standalone/log/server.log

# Im Zuge des Updates wird auch die Linux Installation auf den aktuellen Stand aktualisiert. Sollte im Zuge dieser Updates ein neuer Linux 
# Kernel eingespielt werden, so ist nach der Installation ein Reboot des Appliance notwendig. Alternativ können Sie mit Hilfe von yum die 
# Aktualisierung des Betriebssystems und den eventuell notwendigen Reboot im Voraus durchführen (Befehl: yum uppgrade)
 
# Achtung: 
# - Im Zuge der Migration auf die neue Version sind auch Verbesserungen im Security eingeflossen. Diese führen dazu, dass bei der Migration 
#   pro Benutzer ca. 5 Sekunden benötigt werden. Entsprechende Ausgaben können dem Logfile entnommen werden
 
# Update durchführen
/var/weeasy/scripts/update_weeasy.sh 2>&1 | tee weeasy_install.log

Achtung:

  • In der Version 1.3.0.47 besteht noch ein Problem bei der Vergabe der Berechtigungen. Dies führt dazu, dass Teammitglieder z.B. kein Mails mit Download-Links versenden können. Wir empfehlen daher den Workaround der im Issue https://development.anaptecs.de/jira/browse/WSY-168 beschrieben ist, unbedingt anzuwenden

  • In der Version 1.3.0.47 ist ein Fehler im Zusammenspiel mit dem Office Online Server bekannt. Daher ist der folgende Workaround einzurichten, damit das Bearbeiten von Microsoft Office Dateien möglich ist: Microsoft Office Web Apps#WorkaroundfürWEEASY1.3.0.47

  • Mittlerweile existiert für die Version 1.3.0.47 ein Hotfix 2. Dieser muss nach der Installation ebenfalls noch angewendet werden. Weitere Details finden Sie unter:
    Hotfix 2 für WEEASY 1.3.0.47

Manuelle Nacharbeiten

  • Beim Update auf die Version 1.3.0.47 wird ein Appliance-spezifischer Master-Key generiert. Aus Sicheheitsgründen ist dieser nach der Installation zu sichern. Weitere Details zu Master-Key können folgender Seite entnommen werden: Handling des Master-Keys
     
  • Im Zuge des Updates wird auch eine neue Version der Datei /etc/httpd/conf/httpd.conf eingespielt. Sollten Sie darin manuelle Änderungen vorgenommen haben, so müssen diese nach der Installation wieder durchgeführt werden
  • Im Zuge des Updates wird auch die JBoss Konfigurationsdatei /usr/share/jboss-as/standalone/configuration/standalone.xml angepasst. Daher müssen darin eventuell vorgenommene manuelle Änderungen nach der Installation erneut durchgeführt werden

  • Der File Synchronization Client muss auf allen Rechnern neu installiert werden. Die vorherigen Versionen sind nicht mehr kompatibel. Eine Anleitung zur Deinstallation der veralteten Versionen finden Sie hier: File Synchronization Client (Deprecated Version 1.3.0.45)#Deinstallation

  • Ab der Version 1.3.0.47 werden mit Hilfe von yum-cron automatisch kritische Linux-Updates auf dem Appliance eingespielt. Für weitere Details prüfen Sie bitte, ob die Standardeinstellungen für Sie passend sind: Automatische Updates

Probleme beim Update

Sollten Probleme beim Update auftreten, so schauen Sie doch bitte einmal in unserem FAQ zur Installation und Update, ob dort das Problem bereits beschrieben ist. Gerne können Sie sich auch an unseren Support wenden weeasy@anaptecs.de