Installations-Schritte

Schritt 1: Installationsarchiv entpacken

In einem ersten Schritt muss das Installationsarchiv fs-install-[version].tar.gz entpackt werden.

Windows:

• Die Datei selbst mit einem Zip-Tool wie 7-zip oder IZArc entpacken (Sie erhalten eine .tar-Datei)
• Den Inhalt dieser .tar-Datei ebenfalls entpacken

Linux / MacOS:

• tar -xvzf fs-install-[version].tar.gz

Es gibt nach dem Entpacken den Ordner „firstspirit5“ mit einigen Unterordnern. Die Dateistruktur sollte wie folgt aussehen:

Dateistruktur

Der Ordner "firstspirit5" kann umbenannt und an einen beliebigen geeigneten Ort verschoben werden.

Sein Pfad (einschließlich des Ordners "firstspirit5") wird von nun an als ~FS notiert.

Es sollte sichergestellt werden, dass der Ordnername selbst und auch der vollständige Pfad zu diesem Ordner keine Leerzeichen enthält.

Schritt 2: fs-isolated-server.jar hinzufügen

Die Datei
fs-isolated-server.jar
für die gewünschte FirstSpirit-Version in das Verzeichnis
~FS/server/lib-isolated/
kopieren.

Schritt 3: Lizenzdatei hinzufügen

Die Lizenzdatei
fs-license.conf
in das Verzeichnis
~FS/conf/
kopieren.

Sofern die Lizenzdatei nicht anderweitig zur Verfügung gestellt wurde, kann die aktuelle Version dieser Datei als Download über den Technical Support angefordert werden.

Schritt 4. Pfad zu Java konfigurieren

1.) ~FS/conf/fs-wrapper.isolated.conf öffnen.
2.) Die Zeile mit wrapper.java.command= suchen.
3.) Den Pfad zur ausführbaren Java-Datei (einschließlich der ausführbaren Datei selbst) des JDK festlegen.
Alternativ kann der entsprechende Pfad auch in der Umgebungsvariable FS_JAVA_HOME definiert werden.

Beispiel für Windows:
wrapper.java.command=C:\Programs\java\jdk-11.0.6.10\bin\java

Es können vorwärts oder rückwärts gerichtete Schrägstriche für Windows-Pfade verwendet werden.

Beispiel für Linux / MacOS:
wrapper.java.command=/Library/Java/JavaVirtualMachines/adoptopenjdk-11.jdk/Contents/Home/bin/java

Schritt 5. Erster Start des FirstSpirit-Servers

Kommandozeile öffnen (für Windows cmd verwenden), in den Ordner ~FS/bin wechseln und dann die folgenden Befehle aufrufen:

fs-server installstart [installiert und startet den FirstSpirit-Dienst]

Später wird der FirstSpirit-Server über den entsprechenden Dienst gesteuert oder kann mittels fs-server stop bzw. fs-server start gestoppt und wieder gestartet werden.

Soll kein Dienst installiert werden, kann statt dessen unter

Windows

fs-server console [gestoppt wird mittels STRG-C]

Linux / MacOS

fs-server start [gestoppt wird mittels fs-server stop]

zum Starten des Servers verwendet werden.

Nach dem erstmaligen Start werden neue Ordner erstellt und die Dateistruktur sollte wie folgt aussehen:

Dateistruktur

Beim ersten Start kann es einige Zeit dauern, bis FirstSpirit die Dateistruktur ausgerollt und seine Web-Anwendungen gestartet hat.

Schritt 6: Anmeldung an FirstSpirit

In einem Browser (empfohlen: Google Chrome) muss die folgende URL aufgerufen werden:

http://localhost:8000 (Nicht https verwenden!)

Wenn der Server nicht erreichbar ist, liegt das höchstwahrscheinlich daran, dass der Port bereits verwendet wird (siehe dazu auch Seite Mögliche Probleme, Abschnitt „FirstSpirit nach der Installation nicht erreichbar“).

Standardbenutzername und -kennwort sind beide „Admin“

Nach der Anmeldung erscheint die „FirstSpirit-Startseite“: