<
Collaboration (Beta), 2025.9
Collaboration (Beta), 2025.9

Installationsanleitung – Collaboration

Voraussetzungen

Für die Verwendung von FirstSpirit™ Collaboration müssen folgende Dienste installiert und vorkonfiguriert sein:

  • Modul FirstSpirit™ Collaboration in der aktuellen Version
  • FirstSpirit™ (Version 2025.5 oder neuer)
  • Tomcat 10.1.11 oder neuer
  • Vollständig konfigurierte CXT-Platform (inklusive Tomcat-properties-Dateien)
  • PostgreSQL (Version 12.0 oder neuer)

Es wird nur ein externer Webserver unterstützt.
Ein Downgrade kann generell nicht garantiert werden.

Konfiguration

Eine Konfiguration ist nur notwendig, wenn Sie einen lokalen FirstSpirit-Server betreiben. Wenn FirstSpirit in der Cloud gehostet wird, ist alles bereits für Sie eingerichtet.

Die folgenden Konfigurationen müssen vor der ersten Installation des Moduls in beliebiger Reihenfolge vorgenommen werden.

Tomcat

  1. Kopieren Sie die zur Datenbankversion passende Datei postgre-[Version der Datenbank].jar in das Verzeichnis [Tomcat]/lib/.
  2. Legen Sie im Verzeichnis [Tomcat]/lib/config/ eine neue Datei mit dem Namen fs-collaboration-microapp.properties und folgendem Inhalt an:

fs.microapp.collaboration.database.driver=org.postgresql.Driver
fs.microapp.collaboration.database.url=<JDBC URL>
fs.microapp.collaboration.database.user=<Username>
fs.microapp.collaboration.database.password=<Password>
fs.microapp.collaboration.database.schema=<Schema> (Standard: public)

Beispiel für die Datei fs-collaboration-microapp.properties:

fs.microapp.collaboration.database.driver=org.postgresql.Driver
fs.microapp.collaboration.database.url=jdbc:postgresql://localhost:5432/microapps
fs.microapp.collaboration.database.user=myDatabaseUser
fs.microapp.collaboration.database.password=myUserPassword
fs.microapp.collaboration.database.schema=collaboration

Datenbank

Legen Sie ein zum Parameter fs.microapp.collaboration.database.schema passendes Schema in der Datenbank an (wenn angegeben, der Standard-Wert ist public).

Vergeben Sie dem User, der im Parameter fs.microapp.collaboration.database.user angegeben ist, die vollständige Schreib- & Leseberechtigung für dieses Schema.

Die Konfiguration ist erst nach einem Neustart des FirstSpirit™-Servers und von Tomcat wirksam.

Installation

Eine Installation ist nur notwendig, wenn Sie einen lokalen FirstSpirit-Server betreiben. Nur FirstSpirit-Serveradmins können Module installieren. Wenn FirstSpirit in der Cloud gehostet wird, ist alles bereits für Sie eingerichtet.

Installieren Sie das Modul FirstSpirit™ Collaboration (fs-collaboration-[version].fsm) auf dem FirstSpirit-Server über den ServerManager.

Für die initiale Konfiguration des Moduls werden während der Installation einige Prozesse automatisiert:

  1. Anlegen und Ausrollen der globalen FirstSpirit Collaboration-Web-App.
    Die Web-App wird auf demselben Webserver ausgerollt wie die Root-Web-App.
    • ID: fs-collaboration-microapp
    • Name: FirstSpirit Collaboration | MicroApp
    • Web-Kontext: /fs-collaboration-microapp
  2. Hinzufügen der "FirstSpirit Collaboration | ContentCreator Integration"-Web-Komponente zur ContentCreator-Web-App.

Die ContentCreator-Web-App muss manuell von einem Server-Admin ausgerollt werden.
Wenn für ein Projekt eine gesonderte ContentCreator-Instanz konfiguriert ist, müssen die "FirstSpirit Collaboration" und "CXT-Platform | CC Integration"Web-Komponenten hinzugefügt werden.
Da jede Web-Anwendung Rechenzeit, Speicher und Speicherplatz benötigt, wird für produktive Umgebungen empfohlen, auf den Einsatz von projektlokalen Web-Anwendungen nach Möglichkeit zu verzichten.

Aktivierung

Die Aktivierung des Features für individuelle Projekte ist in allen FirstSpirit-Umgebungen notwendig, unabhängig davon, ob FirstSpirit lokal oder in der Cloud gehostet wird.

Um das Feature Collaboration in einem Projekt nutzen zu können, müssen Sie die entsprechende Projekt-Komponente dem Projekt hinzufügen.

  • Navigieren Sie zu den Projekt-Komponenten des Projektes in dem Collaboration genutzt werden soll.
    ServerManager > Projektauswahl > Eigenschaften ändern > Projekt-Komponenten
  • Klicken Sie auf Hinzufügen.
  • Wählen Sie die Projekt-Komponente FirstSpirit Collaboration | ProjectApp aus.
  • Klicken Sie auf OK.

    → Collaboration ist in Ihrem Projekt aktiv.