Mögliche Probleme
Windows: Dienst existiert bereits
Beim Aufruf von fs-server installstart erscheint eine Fehlermeldung, z. B.
wrapperm | Unable to install the FirstSpirit 5.2 service - The service already exists. (0x431)
Dies geschieht, wenn bereits eine andere FirstSpirit-Instanz installiert ist. Um den FirstSpirit-Servicenamen für die neue Instanz zu ändern, muss die Datei ~FS/conf/fs-wrapper.isolated.conf geöffnet und die Einstellung von wrapper.ntservice.name geändert werden.
Beispiel:
wrapper.ntservice.name=FirstSpiritServer5_Instance2
Nachdem die Datei gespeichert wurde, kann fs-server installstart erneut aufgerufen werden.
 |
Nach erfolgreicher Installation des Dienstes sollten die Einstellungen des Dienstnamens nicht mehr geändert werden. Ist dennoch eine Änderung gewünscht, muss immer auch der technische Name des Windows-Dienstes geändert werden. Folgende Schritte sind notwendig:
|
FirstSpirit nach der Installation nicht erreichbar
Beim ersten Start werden die FirstSpirit-Komponenten ausgerollt, daher benötigen die Web-Anwendungen einige Zeit zum Starten.
Sollte FirstSpirit trotz längerer Wartezeit noch nicht verfügbar sein, ist der Grund dafür in der Regel, dass der Standard-Port 8000 bereits von einer anderen Anwendung verwendet wird. In diesem Fall hat FirstSpirit automatisch einen anderen verfügbaren Port gewählt.
Bitte öffnen Sie ~FS/log/fs-wrapper.log und suchen Sie nach einer Zeile mit setup ports. Unterhalb dieser Zeile sehen Sie höchstwahrscheinlich eine oder mehrere Zeilen wie
Standard TCP port 8000 for HTTP_PORT already in use. Trying other ports…
Suchen Sie von dort aus abwärts z. B. die Zeile, die angibt, welche Ports alternativ genutzt werden:
Using TCP port 5000 for HTTP_PORT and 5001 for SOCKET_PORT.
Die gefundenen Ports werden automatisch in der Datei ~FS/conf/fs-server.conf gespeichert, so dass sie auch verwendet werden, wenn die Standard-Ports später wieder verfügbar sind. Wenn Sie möchten, können Sie die Ports manuell in der Datei ~FS/conf/fs-server.conf ändern.
Im obigen Beispiel wird FirstSpirit unter http://localhost:5000 verfügbar sein.
Es wird eine fslnch-Datei heruntergeladen, die sich nicht öffnen lässt
Die fslnch-Datei wird für die Konfiguration des FirstSpirit Launcher benötigt und sorgt zunächst dafür, dass die Java-Umgebung und das JAR vom FirstSpirit-Server heruntergeladen werden.
Starten die FirstSpirit Desktop Apps nicht, ist vermutlich der FirstSpirit Launcher auf Ihrem lokalen Arbeitsplatzrechner noch nicht installiert. Klicken Sie in diesem Fall einfach auf den Link „FirstSpirit Launcher herunterladen“ auf der FirstSpirit Startseite und folgen Sie den Anweisungen zur Installation.
Weitere Informationen zu den Installationsschritten des FirstSpirit Launcher finden Sie im Abschnitt Installation des FirstSpirit Launcher.
Nach der Installation wird die Option „FirstSpirit Launcher verwenden“ automatisch aktiviert. Sie können die FirstSpirit Desktop Apps jetzt über den FirstSpirit Launcher starten.