FAQ

Dieser Wert wird direkt aus der Klassifizierung der Leistung gezogen, aus dem Feld „Bearbeitungsstand“.

Weitere Informationen zur Inhaltsherkunft im Auslagerungsregister aus der Anwendung ForumOSM erhalten Sie in unserem Handbuch.

Dieses Feld wird befüllt, wenn ein Geschäftsprozess mit der entsprechenden Leistung verknüpft ist, der seinerseits mit (mindestens) einer Datenklasse mit dem Merkmal "personenbezogene Daten" verknüpft ist. Alternativ auch dann, wenn eine Anwendung mit dem Merkmal "personenbezogene Daten" verknüpft ist. Diese Informationen werden aus den verknüpften Anwendungen bzw. Geschäftsprozessen gezogen.

Weitere Informationen zur Inhaltsherkunft im Auslagerungsregister aus der Anwendung ForumOSM erhalten Sie in unserem Handbuch.

Grundsätzlich verbieten moderne Browser aus Sicherheitsgründen den Zugriff das lokale Dateisystem mittels des File-Protokolls (URI: file://).

Unternehmensintern ist ein Zugriff aber unter Umständen erwünscht. Nachfolgend wird die Aktivierung bzw. Realisierung des lokalen Dateisystemzugriffs für die Browser Mozilla Firefox und Internet Explorer beschrieben.

Mozilla Firefox

Für Firefox benötigen Sie die Erweiterung (AddOn) LocalFileSystemLinks, welches aufgerufene Seiten nach lokalen Dateisystem-Verknüpfungen durchsucht.

Internet Explorer

Für den Internet Explorer ist eine Anpassung der Sicherheitseinstellungen erforderlich.

Öffnen die dazu die Internetoptionen in der Systemsteuerung und konfigurieren Sie im Reichter Sicherheit die Zone Vertrauenswürdige Sites durch Hinzufügen der Adresse der ForumBCM-Anwendung. Entfernen Sie zusätzlich das Häkchen bei „geschützten Modus aktivieren“.

Abbildungen: Internetoptionen anpassen

1. Es sind noch nicht alle Vorschläge des aktuellen Vorschlagsupdates bearbeitet.

2. Das Löschen in Katalogen ist in den Einstellungen erlaubt und Mitarbeiter haben die betreffenden Katalogteile (übergeordnete Kapitel) gelöscht. Die Einstellung Löschen in Katalogen sollte generell auf inaktiv sein.

3. Bitte deaktivieren Sie in den Einstellungen Löschen in Katalogen erlauben. 
   
   

   

   Abbildung: Ansicht Einstellungen

Lösung: 

• Bearbeiten Sie das eingespielte Vorschlagsupdate vollständig.
• Falls die Kapitel weiterhin nicht richtig dargestellt sind, gehen Sie bitte wie nachfolgend beschrieben vor, um den Katalog richtig sortiert abgebildet zu bekommen.
  • Gehen Sie über den Menüpunkt Standards, Kataloge und wechseln über die die Schaltfläche Vorschläge anzeigen in den Vorschlagsbereich.
  • Nun wählen sie den Standard SOIT und öffnen diesen in der Einzelansicht.

  • Anschließend übernehmen Sie den Katalog erneut und eventuell fehlende Kapitel ordnen sich wieder richtig ein und fehlende Teile werden wieder angezeigt.

    

    Die bestehende Bearbeitung des Standards wird hierbei nicht verändert.

    Voraussetzung für die erneute Übernahme des Standards ist mindestens die Version 2020-09 der ForumSuite.

Wird ein Objekt Freigegeben, wird im Dialog der Hinweis Der Status der Wiedervorlage wird automatisch gesetzt angezeigt. Dieser Hinweis sagt uns, dass der Status in der automatisch angelegten Aufgabe zur Wiedervorlage auf offen gesetzt wird.

Abbildung: Hinweis beim Freigeben am Beispiel in ForumNSR

Ist ein Objekt in der ForumSuite mit Wiedervorlage freigegeben, kann der Status der automatisch angelegten Aufgabe nur durch eine Überarbeitung des freigegebenen Objektes geändert werden.

Der Status einer automatischen angelegten Aufgabe durch Wiedervorlage kann nur durch erneutes Bearbeiten des freigegebenen Objektes geändert werden.

Über die Schaltfläche Bearbeiten können nur der Bearbeiter, das Fälligkeitsdatum sowie die Beschreibung der Aufgabe geändert werden.

Abbildung: Ansicht einer automatisch angelegten Aufgabe in ForumNSR

Wird ein freigegebenes Objekt mit Wiedervorlage überarbeitet und erneut durch Wiedervorlage ohne Freigabe freigegeben, wird die automatisch angelegte Aufgabe in den Status erledigt gesetzt.

Wenn Sie ein Stammdaten-Objekt in der ForumSuite löschen wollen, ist es unabdingbar, dass dieses Objekt in keiner der anderen Produkte der ForumSuite verwendet wird (aktiv verknüpft ist).

Es ist möglich, dass das betreffende Objekt an einer Leistung in ForumOSM, einem Notfallplan in ForumBCM oder einer Verabeitungstätigkeit in ForumDSM verwendet wird und somit vor dem Löschen in ForumISM„geschützt“ ist. Wenn die bestehenden Verknüpfungen gelöst sind, sollte das Löschen des Stammdaten_Objektes möglich sein.

Die Unterstützung für den Internet Explorer 11 wird zukünftig eingestellt.
Gründe hierfür sind:

• Offiziell wird der Browser von Microsoft in Windows 10 noch bis 15.06.2022 unterstützt
• für den Zugriff auf Microsoft 365 online endete der Support bereits am 17.08.2021
• die Bereitstellung einiger Frontend Funktionen ist unter IE11 nicht mehr möglich
• die im IE11 zum Einsatz kommende veraltete Java Script Engine verursacht spürbare Performanceprobleme

Bitte nutzen Sie einen modernen Browser, wie z.B. Microsoft Edge, Mozilla Firefox, Google Chrome oder Apple Safari.

Öffnen Sie die Kopiervorlage bitte einmal im Frontend, danach werden die Felder wieder geladen.

Öffnen Sie das Einstellungsdokument von ForumNSR und deaktivieren Sie Löschen von Katalogen erlauben.

Diese Meldungen tauchen auf, wenn der auf dem Server zur Verfügung stehende Hauptspeicher zu gering für den Betrieb der Anwendung ist.

Abbildung: Speicherwarnung

Domino Plattform

Über den Parameter HTTPJVMMaxHeapSize legen Sie fest, wieviel Speicher die Java Virtual Machine (JVM) innerhalb des Domino HTTP Dienstes maximal beanspruchen darf.

Prüfen Sie mittels des Domino Administrator Clients, wie viel RAM Ihrem Dominoserver physisch zur Verfügung stehen.

sh statistic mem.PhysicalRAM

Fragen Sie am Domino Server über die Serverconsole den Wert des Parameters HTTPJVMMaxHeapSize ab

sh config HTTPJVMMaxHeapSize

Unter Beachtung des zur Verfügung stehenden Arbeitspeichers setzen Sie bitte die gewünschte Größe.

Bei Einsatz eines 64bit Betriebssystems und einer 64bit Domino Server Installation gilt als Faustregel: mindestens ein Viertel des verfügbaren Arbeitsspeichers sollte reserviert werden (beispielweise sollte bei 8GB Ram der Wert auf 2048M eingestellt werden).

Empfohlen sind mindestens 4GB (4096M).

Erhöhen Sie diesen Wert über die Serverkonsole mit Hilfe des nachfolgenden Befehls. Die Änderung dieses Wertes erfordert einen anschließenden Neustart des HTTP-Dienstes.

set config HTTPJVMMaxHeapSize=4096M update
restart task http

Java Plattform

Gehen Sie zur Anpassung des Heap-Speichers wie folgt vor:

Bearbeiten Sie die Datei start_suite.cmd und ändern Sie den hinter dem Parameter -Xmx hinterlegten Wert.

java -Xmx8G -jar FORUM_Suite_X.Y.Z.jar

Bitte beachten Sie, dass auch dem Betriebssystem nach der Erhöhung des maximal verfügbaren Java Heap-Speichers noch ausreichend Speicher zur Verfügung steht (Empfehlung: mindestens 2 GB).

Für einen Server mit 16 GB RAM sollte die Java Heap Size entsprechend höchstens 14 GB (Empfehlung: 12 GB) betragen.

Domino Plattform

Die Anhangsgröße basiert auf zwei Parametern, die standardmäßig eine Begrenzung von 10.000 KB (10 MB) vorgeben.

Geben Sie im Server- oder Websitedokument für folgende Einstellungen höhere Werte als im Lotus iNotes Feld „Maximalgröße von Anhängen (KB)“ ein:

• Serverdokument: „Internetprotokolle > HTTP > Maximale Größe von Anforderungsinhalt“ (engl.: „Maximum size of request content“)
• Server- oder Websitedokument: „Internetprotokolle > Domino-Web-Server > Maximale Größe von POST-Daten“ (engl.: „Maximum POST data (in kilobytes)“)

Quelle: Domino Hilfe

Abbildung: Serverdokument - Internetprotokolle - HTTP

Abbildung: Serverdokumente - Internetprotokolle - Domino Web Server

Java Plattform

Sofern die ForumSuite hinter einem Reverse Proxy (z.B. NGiNX oder Apache Webserver) betrieben wird, stellen Sie sicher, dass die maximal zulässige Upload-Größe einen ausreichenden Wert aufweist. Dieser Wert sollte auf 100 MB oder höher eingestellt werden, um eine problemlose Installation der Vorschläge für die einzelnen Produkte zu ermöglichen.

Bei NGiNX ist die Standardgröße für die Client Max Body Size auf den äußerst geringen Wert von 1 MB eingestellt, siehe:

https://nginx.org/en/docs/http/ngx_http_core_module.html#client_max_body_size

Bei Nutzung des Apache Webservers gibt es standardmäßig keine Einschränkung. Diese kann jedoch über den Parameter LimitRequestBody beeinflusst werden, siehe:

https://httpd.apache.org/docs/2.2/mod/core.html#limitrequestbody

Die Upload-Größe wird weiterhin durch folgende Parameter in den application.properties der ForumSuite bestimmt:

spring.servlet.multipart.max-file-size=512MB
spring.servlet.multipart.max-request-size=512MB

Der Standardwert liegt bei 512 MB.

Beim Hochladen eines Anhanges erscheint die Meldung Es ist ein Fehler aufgetreten. Das Argument clientFileName fehlt in der Kommandoanfrage. Fehlercode: QUERY-0040.
Die Meldung sagt aus, dass der Dominoserver Dienst bzw. der Nutzer unter welchem der Dienst ausgeführt wird, keine Schreibrechte im temporären Verzeichnis des Dominodienstes hat.
Um das Problem zu beheben, müssen die Rechte auf dem temporären Verzeichnis angepasst werden. Der Dominoserver Dienst bzw. der Nutzer unter welchem der Dienst ausgeführt wird benötigt Schreib- und Löschrechte auf dem Verzeichnis.

Führen Sie bitte in der Konfiguration der Anwendung einen Reset im Bereich Wartung durch. Bitte beachten Sie, dass während eines Resets der Anwendung und der anschließenden erneuten Initialisierung ggf. Änderungen durch andere aktive Nutzer nicht korrekt gespeichert werden können.

Wird Ihnen bei der Prüfung eine Fehlerdiagnose als Datei angeboten, welche auf dem Server gespeichert wird, leiten Sie diese bitte an den Support weiter. Wir setzen uns in diesem Fall zeitnah mit Ihnen in Verbindung.

In diesem Fall wird am jeweiligen Objekt der Anhang im Richtextfeld nicht gefunden. Durch einen älteren Notesfehler wird im Richtextfeld nur ein Vorschaubild des Anhanges angezeigt, welcher aber nicht vorhanden ist.

Das herkömmliche Anmeldeformular des Domino Servers löscht im Auslieferungszustand bei einer vorab erforderlichen Anmeldung sämtliche in der URL mitgelieferten Parameter. Somit erfolgt immer eine Umleitung auf die jeweilig in der Anwendung definierten Startseite.

Dieses Verhalten kann durch den Benutzer nicht beeinflusst werden.

Sofern beim Aufruf des Links noch keine Anmeldung erfolgt ist, melden Sie sich an, lassen den Browser geöffnet und rufen den Link bitte nach der Anmeldung ein zweites Mal auf.

Administratoren bzw. Entwickler haben die Möglichkeit, die Anmeldemaske anzupassen, so dass der Benutzer sofort das im Link hinterlegte Dokument erreicht. Wenden Sie sich für Unterstützung hierbei bitte an unseren technischen Support .

Abbildung: Fehlermeldung

Diese Fehlermeldung resultiert aus einer Eigenart des Internet Explorers. Der IE summiert die Anzahl der Anweisungen welche durch die JScript Engine auf der Seite ausgeführt wurden und zeigt nach 5.000.000 Operationen die gezeigte Meldung. Setzen Sie an dieser Stelle bitte den Haken bei Dialog nicht mehr anzeigen und betätigen Sie die Schaltfläche Weiter ausführen.

Falls gewünscht kann der Wert für den InternetExplorer über einen Registry Eintrag angepasst werten. (Quelle des Links: Microsoft)

Firefox reagiert an dieser Stelle anders. Hier erfolgt eine Meldung nach einer vordefinierten Scriptlaufzeit (Standard: 10 Sekunden). Eine Anpassung dieses Wertes ist durch Anpassung des Parameters dom.max_script_run_time auf der Einstellungsseite about:config möglich. (Quelles des Links: MozillaZine)

Dieser Artikel betrifft ausschließlich die Domino Plattform.

Abbildung: Dojo Authentifizierung

Sie nutzen wahrscheinlich die Basic Authentication Methode zur Anmeldung am Domino Server via HTTP. Stellen Sie das Anmeldeverfahren auf Session based Authentication um, wie in der nachfolgenden Anleitung beschrieben.

Aktivierung Session based Authentication

Für die Nutzung von browserbasierten Anwendungen über die Domino HTTP-Task wird die Aktivierung der sog. „HTTP-Sitzungs-Authentifizierung“ (engl. „Session based Authentication“) empfohlen. Hierdurch besteht u.a. die Möglichkeit, einen Inaktivitätszeitraum festzulegen, nach welchem der Nutzer automatisch abgemeldet wird. Diese Maßnahme dient somit der Erhöhung der Sicherheit.

Vorgehensweise

1. Erstellen Sie eine neue Anwendung domcfg.nsf im Notes Datenverzeichnis Ihres Servers.

   

   Abbildung: neue Anwendung erstellen

2. Passen Sie die Zugriffskontrollliste (ACL) der neuen Anwendung an:

   Benutzer(typ)	Zugriff	Erläuterung
   Default	Leser
   Anonymous	Leser
   Person oder Personengruppe	Manager	Administratoren mit voller Berechtigung
   Server oder Servergruppe	Manager

3. Öffnen Sie die Anwendung.

4. Erstellen Sie ein neues Login Mapping Dokument (in diesem Fall Standard für alle Webseiten).

   

   Abbildung: Login Mapping Doc

5. (optional) Öffnen Sie die Anwendung im Domino Designer und passen Sie die Maske $LoginUserForm entsprechend Ihren Wünschen an

6. Passen Sie das Konfigurationsdokument des Servers an:

   

   Prüfen Sie bitte die Einstellungen in Ihrem Serverdokument.

   Falls bereits ein Eintrag Multiple Servers (SSO)hinterlegt wurde (meist durch das Rechenzentrum), müssen Sie keine weiteren Maßnahmen ergreifen.

   

   Abbildung: aktiviertes SSO Auth Verfahren

   Ansonsten aktivieren Sie bitte die Sitzungsbasierte Authentifikation.

   

   Abbildung: Einstellung Sitzungsart

   Deaktivieren Sie beständige HTTP Verbindungen

   

   

   

   

   Setzen Sie den Parameter Web agent an web services timeout: bitte auf einen sinvollen Wert (z.Bsp. 180). 0 = kein Timeout (nicht sinnvoll)

   Abbildung: beständige Verbindungen deaktivieren

Dieser Artikel betrifft ausschließlich die Domino Plattform.

Hierbei handelt es sich um ein bei IBM bekanntes Problem mit persistenten Verbindungen. Laut Empfehlung von IBM sollten die persistenten Verbindungen deaktiviert werden.

Setzen Sie den Parameter Web agent an web services timeout: bitte auf einen sinnvollen Wert (z.Bsp. 180). 0 = kein Timeout (nicht sinnvoll)

Abbildung: beständige Verbindungen deaktivieren

Dieser Artikel betrifft ausschließlich die Domino Plattform.

Eine Umbenennung des Backends ist jederzeit möglich. In diesem Fall gilt es zu beachten, dass die Konfiguration des Frontends anzupassen ist.

Die Änderung des Dateinamens im Frontend ist auch möglich, allerdings werden versendete oder abgelegte Links vor der Umbenennung ungültig (Mails mit Verweisen auf Dokumente oder gesetzte Links aus dem Orga Handbuch in die Anwendung etc.).

Die Umbenennung des Dateinamens vom Backend bietet sich beim nächsten Versionsupdate an.

Damit die Mitarbeiter direkt in einer Anwendung der ForumSuite nach der Anmeldung gelangen, sollte der Link für die jeweilige „Zielseite“ vor der Weitergabe an Mitarbeiter entsprechend manuell angepasst werden. Tauschen Sie dazu im Link das "#" in "?p=" um.

Abbildung: Anpassung des Ziellinks für ForumBCM (z.B. Ansicht LESER Startseite)

Hintergrund: Im Gegensatz zum "#" bleibt der Query-String auch nach der Anmeldung über das Login-Formular erhalten.

Dieser Artikel betrifft ausschließlich die Domino Plattform.

Falls Sie die Datenbanken zum neuen Server replizieren:

Achten Sie bitte darauf, dass der neue Server in der ACL der Datenbank mit den Rechten Manager + Dokumente löschen + Rolle ADMIN  hinterlegt ist (nur Rolle ADMIN).
Server, Servergruppen, Admins, Admingruppen und Freigabe/Signierer müssen ebenfalls mit den Rechten Manager + Dokumente löschen + Rolle ADMIN (nur Rolle ADMIN) hinterlegt werden.

Zu übertragende Anwendungen:

• ForumSuite (Frontend- und Backend Datenbank)
• ForumLog (fislog.nsf)
• Vorschläge/Kataloge
• ggfls. ForumISM
• ggfls. ForumBCM 1.3.x

Nachdem die Datenbanken von Server A nach Server B kopiert/repliziert wurden ist folgendes zu prüfen:

• Wurde am neuen Domino Server die HTTPJVMHeapSize angepasst?

  Prüfen Sie mittels des Domino Administrator Clients, wie viel RAM Ihrem Dominoserver physisch zur Verfügung stehen.

  Abfrage RAM

  BASH

  sh statistic mem.PhysicalRAM

  Fragen Sie am Domino Server über die Serverconsole den Wert des Parameters HTTPJVMMaxHeapSize ab

  Abfrage HeapSize

  BASH

  sh config HTTPJVMMaxHeapSize

  Unter Beachtung des zur Verfügung stehenden Arbeitspeichers setzen Sie bitte die gewünschte Größe.

  Bei Einsatz eines 64bit Betriebssystems und einer 64bit Domino Server Installation gilt als Faustregel: mindestens ein Viertel des verfügbaren Arbeitsspeichers sollte reserviert werden (beispielweise sollte bei 8GB Ram der Wert auf 2048M eingestellt werden).

  

  Empfohlen sind mindestens 4GB (4096M).

  
  

  Erhöhen Sie diesen Wert über die Serverkonsole mit Hilfe des nachfolgenden Befehls. Die Änderung dieses Wertes erfordert einen anschließenden Neustart des HTTP-Dienstes.

  Anpassung HeapSize

  BASH

  set config HTTPJVMMaxHeapSize=4096M update
  restart task http

• Falls die Datenbanken in ein vom Quellserver abweichendes Verzeichnis übertragen wurden, ist der Pfad zur Backend-Datenbank zu korrigieren. Öffnen Sie hierzu die Frontend-Datenbank im NotesClient
  
  

  

  

  

  Abbildung: Prüfung Serverdokument

  

  Abbildung: Pfad zur Backend-Datenbank

• Falls in Ihrem Domino Serverdokument die Option mit Hostnamen verknüpfen (engl: Bind to host name) aktiv ist, müssen Sie den berechneten Wert <DOMINO_SERVER> durch den im Serverdokumente hinterlegten Wert Host Names ersetzen
  
  

  

  Passen Sie die URL ggfls. auch im Anwendungsstarter an.

Für die fehlende Benachrichtigung zu offenen Aufgaben in der  ForumSuite kann es verschiedene Ursachen geben, die es zu überprüfen gilt.

Ist die "Zeitgesteuerte Bearbeitung von Aufgaben" in der Konfiguration des Frontends entsprechend der Beschreibung im Handbuch unter Umgang mit Benachrichtigung eingestellt? Dieser Bereich ist nur durch einen Nutzer mit technischen Administratorrechten bearbeitbar.

1. Ist in der betreffenden Anwendung der ForumSuite die Benachrichtigung zu Aufgaben und/oder Workflows in der Konfiguration entsprechend der Beschreibung im Handbuch unter Umgang mit Benachrichtigung aktiv? Dieser Bereich ist nur durch einen Nutzer mit technischen Administratorrechten bearbeitbar.

2. Der Versand von Keine Einzelnachrichten versenden ist aktiv - in diesem Fall bekommen nur die in der Zusammenfassung hinterlegten Nutzer eine Benachrichtigung in Form einer Zusammenfassung aller Aufgaben in der betreffenden Anwendung der ForumSuite.

   

   Abbildung: In dieser Einstellung erhalten nur die Empfänger der Zusammenfassung eine Benachrichtigung

Die Aktualisierung kann direkt auf jeder beliebigen Version der ForumSuite ohne weitere Zwischenschritte ausgeführt werden.

Problem:

Beim Start der ForumSuite wird folgende Fehlermeldung ausgegeben:

Fehler: Beim Laden der Klasse org.springframework.boot.loader.JarLauncher ist ein LinkageError aufgetreten java.lang.UnsupportedClassVersionError: JVMCFRE003 Ungültige übergeordnete Version; Klasse=org/springframework/boot/loader/JarLauncher, Offset=6

Lösung:

Die genutzte Java Runtime ist veraltet.
Bitte installieren Sie die Runtime Version 17 oder höher wie nachfolgend beschrieben.

Die folgenden Tätigkeiten müssen alle auf dem Server der ForumSuite ausgeführt werden.

Betriebssystem Windows

Prüfung IST Zustand

1. Öffnen Sie bitte im Windows Explorer  den Installationspfad der ForumSuite

2. Bearbeiten Sie bitte die Datei start_suite.cmd

   

   Abbildung: Edit start_suite.cmd

3. Prüfen Sie bitte nun den Pfad für den Aufruf der Laufzeitumgebung

   

   Abbildung 1: in ForumSuite Ordner eingebettete Java Runtime

   

   Abbildung 2: Java Runtime des Betriebssystems

   In diesem Fall fragen Sie die eingesetzte Version bitte über die Eingabeaufforderung mittels des Befehls java -version  ab.

   

   Abbildung 2.1: Abfrage Version der installierten Java Runtime

Sollten Sie mit einer installierten Java Runtime arbeiten (Abbildung 2), prüfen Sie bitte, ob noch andere Anwendungen diese Runtime nutzen/voraussetzen.
Falls ja, erfragen Sie bitte beim Hersteller, ob die Anwendung mit einer Java Runtime 17*  betrieben werden kann.

Update Java Runtime - Abbildung 1 (eingebettete Java Runtime)

1. Laden Sie die portable Version 17 der Java Runtime von ADOPTIUM herunter (

   

   )
2. Entpacken Sie den Inhalt des Archivs
3. Kopieren Sie den Ordner jdk-17*-jre in den Ordner der ForumSuite
4. Stoppen Sie den Dienst der ForumSuite

5. Bearbeiten Sie bitte die Datei start_suite.cmd

   

   Abbildung: Edit start_suite.cmd

6. start_suite.cmd - vorher

   BASH

   FOR %%f IN (FORUM_Suite_*.jar) DO .\jdk-11.0.17+8-jre\bin\java -Djavax.net.ssl.trustStoreType=WINDOWS-ROOT -Xmx8G -jar %%f

   start_suite.cmd - nachher (Beispiel)

   BASH

   #Bitte den String jdk-17... entsprechend anpassen
   FOR %%f IN (FORUM_Suite_*.jar) DO .\jdk-17.N.N.N+N-jre\bin\java -Djavax.net.ssl.trustStoreType=WINDOWS-ROOT -Xmx8G -jar %%f

7. Speichern und schließen Sie die Datei start_suite.cmd 
8. Starten Sie den Dienst der ForumSuite

Update Java Runtime - Abbildung 2 (Java Runtime des Betriebssystems)

1. Laden Sie die installierbare Version 17 der Java Runtime von ADOPTIUM herunter (

   

   )
2. Stoppen Sie den Dienst der ForumSuite
3. Deinstallieren Sie die Java 11 Runtime via Systemsteuerung\Alle Systemsteuerungselemente\Programme und Features 

4. Installieren Sie das Paket inkl. der Optionen JAVA_HOME  und JavaSoft (Oracle) 

   

   Abbildung: Installationsparamter
5. Prüfung der Version über die Eingabeaufforderung mittels des Befehls java -version .
   Ergebnis sollte nun Version 17* sein.
6. Starten Sie den Dienst der ForumSuite

Betriebssystem Linux

Nachfolgend wir die Aktualisierung unter Linux (hier: Debian Bullseye ) beschrieben.
Es wird davon ausgegangen, das die ForumSuite im systemd eingebunden ist

1. ForumSuite stoppen

   BASH

   systemctl stop forumsuite.service

2. Java 11 deinstallieren

   BASH

   apt remove openjdk-11-jre
   apt update;apt upgrade;apt autoremove;apt autoclean

3. Java 17 installieren

   BASH

   apt install openjdk-17-jre

4. ForumSuite starten

   BASH

   systemctl start forumsuite.service

Dieser Artikel betrifft ausschließlich die Java Plattform.

Um die ForumSuite auf Basis der Java Plattform unter einem Windows Betriebssystem als Dienst (Service) zu starten, empfehlen wir den Einsatz eines Wrappers.

Unter https://github.com/kohsuke/winsw/releases können Sie sich – in Abhängigkeit des auf Ihrem Server installierten .NET-Frameworks – das entsprechende Hilfsprogramm in der aktuellsten Version herunterladen.

• Kopieren Sie die im Archiv enthaltene WinSW.NET2.exe oder WinSW.NET4.exe in das Installationsverzeichnis Ihrer ForumSuite
• Kopieren Sie die im Archiv enthaltene Datei sample-minimal.xml  ebenfalls in das Installationsverzeichnis Ihrer ForumSuite und benennen Sie die Datei um in WinSW.NET2.xml oder WinSW.NET4.xml

• Passen Sie die Datei WinSW.NET2.xml oder WinSW.NET4.xml  entsprechend Ihren Bedürfnissen an

  Beispiel Konfiguration

  XML

  <configuration>
    
    <!-- ID of the service. It should be unique across the Windows system-->
    <id>ForumSuite</id>
    <!-- Display name of the service -->
    <name>ForumSuite Service (powered by WinSW)</name>
    <!-- Service description -->
    <description>This service is a service created from a minimal configuration for ForumSuite</description>
    
    <!-- Path to the executable, which should be started -->
    <executable>C:\<VERZEICHNIS>\start_suite.cmd</executable>
  
  </configuration>

• Öffnen Sie die Eingabeaufforderung als Administrator

• begeben Sie sich innerhalb des Eingabefensters in den Installationsordner der ForumSuite

• Starten Sie die Datei WinSW.NET2.exe oder WinSW.NET4.exe mit dem Zusatzparameter install

  Beispiel Eingabeaufforderung

  POWERSHELL

  C:\WINDOWS\system32>cd C:\APPS\FORUMSuite
  
  C:\APPS\FORUMSuite>WinSW.NET4.exe install
  2019-10-17 16:47:18,717 INFO  - Installing the service with id 'ForumSuite'
  
  C:\APPS\FORUMSuite>WinSW.NET4.exe start
  2019-10-17 16:49:49,261 INFO  - Starting the service with id 'ForumSuite'

Dieser Artikel betrifft ausschließlich die Java Plattform.

Grundsätzlich gibt es verschiedene anpassbare Eigenschaften innerhalb der Konfigurationsdatei application.properties deren Wertänderung die Fehlersuche erleichtern.

Änderungen an den Parametern erfordern einen Neustart der Anwendung bzw. des Dienstes.

Loglevel erhöhen

Um das Standard-Loglevel der ForumSuiteanzupassen, verändern Sie bitte den Wert des Parameters application.log.level.

Folgende Werte stehen zur Auswahl:

Sollte eine Anpassung der internen Protokollierung bestimmter Komponenten des genutzten Spring Frameworks erforderlich sein (nach entsprechender Aufforderung durch den Support), so stehen folgende Werte zur Auswahl:

Debugging Mailversand

Für die umfangreichere Protokollierung des Mailversandes fügen Sie bitte die folgenden Parameter in der Konfigurationsdatei hinzu.

spring.mail.test-connection=true
spring.mail.properties.mail.debug=true

Die Datei Rotation für Log Dateien kann über folgende Parameter gesteuert werden:

#Dateimuster zum Erstellen von Protokollarchiven
logging.logback.rollingpolicy.file-name-pattern=myservice-%d{yyyy-MM-dd}.log

#Die maximale Größe der Protokolldatei, bevor sie archiviert wird.
logging.logback.rollingpolicy.max-file-size=2M

#Die maximale Größe, die Protokollarchive annehmen können, bevor sie gelöscht werden.
logging.logback.rollingpolicy.total-size-cap=1G

#Die maximale Anzahl der aufzubewahrenden Archivprotokolldateien (standardmäßig 7).
logging.logback.rollingpolicy.max-history=14

Anpassung der Datei start_suite

Anpassung der Datei start_suite.cmd im Programmverzeichnis der ForumSuite durch hinzufügen des Parameters -Djavax.net.ssl.trustStoreType=WINDOWS-ROOT 

FOR %%f IN (FORUM_Suite_*.jar) DO java -Djavax.net.ssl.trustStoreType=WINDOWS-ROOT -Xmx4G -jar %%f

Anpassung der Datei application.properties

Anpassung der Datei application.properties im Verzeichnis conf des Programmverzeichnisses der ForumSuite durch Anpassung der Parameters application.ad.url.

application.ad.url=ldaps://<server>.<domain>.<tld>:<port>

Die Angabe des Ports (Standard: 636) ist optional.

Nach der Anpassung der Werte ist der Neustart des ForumSuite Dienstes erforderlich.

Dieser Artikel betrifft ausschließlich die Java Plattform.

Der Einsatz der in die ForumSuite integrierten Benutzerverwaltung zur Authentifizierung von Nutzern wird nicht für den produktiven Betrieb empfohlen. Nutzen Sie nach Möglichkeit die Anbindung an ein Active Directory oder LDAP-Verzeichnis.

Eine weitere Möglichkeit für die Einrichtung von Benutzern außerhalb des zentralen Verzeichnisdienstes ist die Anlage und Passwortvergabe innerhalb der ForumSuite. Die Passworte werden in diesem Fall verschlüsselt in der Datenbank der ForumSuite abgelegt.

1. Anpassung der Datei conf\application.propierties durch Modifikation/Hinzufügen des Parameters application.auth.user.suite.enabled.
   
   

   conf\application.properties

   BASH

   application.auth.user.suite.enabled=true

   

   Neustart des ForumSuite Dienstes nach Anpassung erforderlich.

2. Deaktivierung des AD/LDAP Importes
   
   

   

   Abbildung: Deaktivierung AD/LDAP Sync

3. Anlegen eines Mitarbeiters in der Mitarbeiterverwaltung.
   
   

   

   Abbildung: Weg zur Mitarbeiterverwlatung

   

   Abbildung: neu angelegter Mitarbeiter

   Mit den im Feld Login-Kennung hinterlegten Daten meldet sich der Benutzer dann an.

4. Initiales Vergabe eines Passwortes durch den Administrator in der Benutzerverwaltung.
   
   

   

   Abbildung:; Aufruf Nutzer in der Benutzerverwaltung

   

   Abbildung: Eingabemöglichkeit Initialkennwort
   

   Nach speichern des Nutzerdokumentes kann sich der manuell angelegte Mitarbeiter mit der Login-Kennung und dem Passwort anmelden und über den oben beschriebenen Weg ein eigenes Kennwort vergeben.

5. Falls der AD/LDAP Import vor der Anlage aktiv war, muss nun die Schnittstelle wieder aktiviert werden.
   
   

   

Dieser Artikel betrifft ausschließlich die Java Plattform.

Um nur Benutzern einer bestimmten im Active Directory vorhandenen Gruppe den Zugriff auf die ForumSuite zu gewähren müssen Sie den Parameter application.ldap.user.searchfilter in der Datei application.properties  anpassen.
Nutzen Sie hier als Filter bitte das Attribut memberOf .

application.ldap.user.searchfilter=(&(|(cn={0})(mail={0})(displayName={0}))(memberOf=CN=<Gruppe>,CN=Users,DC=domain,DC=de))

Dieser Artikel betrifft ausschließlich die Java Plattform.

Die Absenderadresse kann durch einen Parameter in der Datei application.properties angepasst werden.

#Beipiel für Anpassung des Absendernamens zu suite@noreply.lan
spring.mail.properties.mail.smtp.from=suite@noreply.lan

Starten Sie die Anwendung bzw. den Dienst der ForumSuite nach hinzufügen des Parameters bitte neu.

Anpassungen bereits vorhandener Parameter

Um die ForumSuite via HTTPS aufrufen zu können, müssen der Konfigurationsdatei application.properties weitere Parameter hinzugefügt werden.

ForumSuite > Version 2022-12.1

#KeyStore Parameter und Pfade
server.ssl.certificate=config/my-cert.crt
server.ssl.certificate-private-key=config/my-cert.key
server.ssl.trust-certificate=config/ca-cert.crt

ForumSuite <= Version 2022-12.1 (deprecated)

Die nachfolgende Anleitung setzt die Nutzung von AdoptOpenJDK voraus. Wenn Sie eine andere Runtime nutzen, müssen die Pfade entsprechend angepasst werden.

"c:\Program Files\AdoptOpenJDK\jre-11.0.7.10-hotspot\bin\keytool.exe" -genkeypair -alias tomcat -keyalg RSA -keysize 2048 -storetype PKCS12 -keystore C:\<Pfad zur ForumSuite>\config\keystore.p12 -validity 3650 -storepass <Ihr Password>

"c:\Program Files\AdoptOpenJDK\jre-11.0.7.10-hotspot\bin\keytool.exe" -import -alias tomcat -file C:\<Pfad>\myCertificate.crt -keystore C:\<Pfad zur ForumSuite>\config\keystore.p12 -storepass <Ihr Password>

#KeyStore Parameter und Pfade
server.ssl.key-store-type=PKCS12
server.ssl.key-store=config/keystore.p12
server.ssl.key-store-password=password
server.ssl.key-alias=tomcat
security.require-ssl=true

Darüber hinaus muss in der Konfigurationsdatei application.properties der Parameter für die Frontend URL angepasst werden. Dieser wird für die Generierung der Links in EMail's verwendet.

#an dieser Stelle http durch https ersetzen
application.frontend.url=https://<ip> oder <fqdn>/

#Port über welchen die Anwendung aufgerufen werden soll - 8443 oder 443 (https Standard)
server.port=443

Nach erfolgreicher Anpassung der Parameter starten Sie den Dienst der ForumSuite bitte neu.

Dieser Artikel betrifft ausschließlich die Java Plattform.

Einleitung

Zur Aktivierung des SingleSignOn (SSO) über Kerberos muss die Funktionalität im Active Directory (AD) des Unternehmens aktiviert und konfiguriert werden.
Darüber hinaus müssen Anpassungen in den Einstellungen der ForumSuite sowie ggf. für den auf dem Windows Desktop des Anwenders verwendeten Browsers vorgenommen werden.

Anpassung am Active Directory

Sämtliche nachfolgende Angaben zu Benutzern, Passworten, Servern und Domains müssen auf die für ihr Unternehmen gültigen Werte angepasst werden.

#Am AD Server auszuführen. 
#In der Befehlszeile den Server auf welchem die ForumSuite gehostet wird hinterlegen. 
#Die Angabe des Ports ist optional (falls abweichend von Standard HTTP Port). Notation: HTTP/server.domain.lan:<Port>

PS C:\>setspn -A HTTP/server.domain.lan Benutzer

PS C:\>ktpass /out c:\fsuite.keytab /mapuser Benutzer@domain.lan /princ HTTP/server.domain.lan@DOMAIN.LAN /pass 'Password' /ptype KRB5_NT_PRINCIPAL /crypto All

Die erzeugte Datei im Ordner config der ForumSuite ablegen und den Pfad im Parameter application.kerberos.keytab-location hinterlegen (siehe nächster Abschnitt).

Notwendige Parameter in der Datei application.properties der ForumSuite

Anpassung Browser

Zur Nutzung von Kerberos SSO müssen – sofern noch nicht erfolgt – Anpassungen der auf den Windows Desktop des Anwenders genutzten Browser vorgenommen werden.

Firefox Browser

Die nachfolgende Einstellung existiert nur für Windows! Unter MacOS und Linux ist die Einstellungsmöglichkeit für SSPI nicht vorhanden.

Abbildung: Trusted URL's

Chrome, Internet Explorer

Fügen Sie die Domäne zum lokalen Intranet hinzu.

Abbildung: Einstellungen für IE und Chrome

Nein.
Der aus CVE-2022-42252 betroffene Parameter wurde lediglich in Version 8.5 mit Standardwert false versehen.
Bei neueren Versionen steht dieser Wert auf true.

Die FORUM Gesellschaft für Informationssicherheit hat unmittelbar nach Bekanntwerden der Sicherheitslücke „log4shell“ in der Java-Bibliothek „log4j2“ eine umfassende Schwachstellenanalyse vorgenommen und Kontakt zu den Softwareherstellern der von durch uns eingesetzten Drittanwendungen aufgenommen.

Die Analyse ergab, dass unsere Softwareplattform „FORUM Suite“ sowie die von uns intern genutzten Anwendungen nicht von der Schwachstelle betroffen waren. Die Bibliothek „Log4j2“ ist aufgrund einer Abhängigkeit aus dem von uns genutzten Software-Frameworks „Spring Boot“ zwar in den Installationsdateien der Java Plattform der FORUM Suite enthalten, wird jedoch nicht durch die Software genutzt. In den Dateien für die HCL Domino Plattform ist die fragliche Bibliothek nicht enthalten. Daher bestand zu keinem Zeitpunkt eine mögliche Gefährdung für Anwender unserer Software durch die Sicherheitslücke.

Unabhängig davon wurden sämtliche von den Herstellern verfügbaren Updates und Patches umgehend nach deren Verfügbarkeit durch uns in unserer Systemlandschaft eingespielt und mit dem Release 2022-01 auch unsere eigene Software auf die zum Releasezeitpunkt neueste verfügbare Version 2.17.1 der Bibliothek Log4J2 aktualisiert. Diese wird weiterhin nicht durch unsere Software verwendet.

Eventuelle Kompromittierungen unserer Systeme wurden nicht festgestellt.

Die FORUM Gesellschaft für Informationssicherheit hat unmittelbar nach Bekanntwerden der Sicherheitslücke „Spring Core Remote Code Execution“ eine Schwachstellenanalyse vorgenommen.
Die Analyse ergab, dass unsere Softwareplattform ForumSuite sowie die von uns intern genutzten Anwendungen nicht von der Schwachstelle betroffen sind.
Da die notwendigen Abhängigkeiten zur Ausnutzung der Schwachstelle fehlen (Nutzung von spring-webmvc oder spring-webflux und Bereitstellung der Anwendung via Tomcat WAR), bestand zu keinem Zeitpunkt eine mögliche Gefährdung für Anwender unserer Software durch die Sicherheitslücke.

Unabhängig davon werden sämtliche von den Herstellern verfügbaren Updates und Patches umgehend nach deren Verfügbarkeit durch uns in unserer Systemlandschaft eingespielt und mit den nächsten Releases ausgerollt.