Startoptionen

Konfiguration

Konfigurationsdateien

Im Unterverzeichnis conf des FirstSpirit-Servers befinden sich Dateien, die wichtige Konfigurationseinstellungen für den Serverstart und das Java-System des FirstSpirit-Servers enthalten. Diese Konfigurationsdateien sind zuständig für Start und Stop des Java-Prozesses und enthalten Parameter zur optimalen Ausnutzung des Hauptspeichers des Host-Betriebssystems.

Folgende Dateien können vorhanden sein:

• die Datei fs-wrapper-vendor.conf
  enthält die empfohlenen Hersteller-Startoptionen der Java VM.
• die Datei conf/fs-wrapper.conf 
  enthält nur die Startoptionen, die serverspezifisch angepasst werden sollten
  (Konfiguration der Java VM für Non-Isolated-Installationen)
• die Datei conf/fs-wrapper.isolated.conf 
  enthält nur die Startoptionen, die serverspezifisch angepasst werden sollten.
  (Konfiguration der Java VM für Isolated-Installationen)
• die Datei conf/fs-wrapper.slave.conf 
  (allgemeine Konfiguration der Java VM für Cluster-Knoten für Non-Isolated-Installationen)
• die Datei fs-wrapper.isolated.slave.conf
  (allgemeine Konfiguration der Java VM für Cluster-Knoten für Isolated-Installationen)
• die Datei conf/fs-wrapper-j1.include.conf 
  (Konfiguration spezieller Startparameter für Oracle Java 8)
  (obsolet nach Umstellung auf die neue Konfiguration)
• die Datei conf/fs-wrapper-j2.include.conf 
  (Konfiguration spezieller Startparameter für Oracle Java Versionen >= 9)
  (obsolet nach Umstellung auf die neue Konfiguration)

Einige Dateien sind nur relevant für den Einsatz mit bestimmten Java-Versionen (siehe Abhängigkeit zur Java-Version).

Die Konfigurationsdatei fs-wrapper-vendor.conf ist Bestandteil des FirstSpirit Aktualisierungsarchivs fs-update-[version].tar.gz. Bei der Aktualisierung des FirstSpirit-Servers über das Aktualisierungsarchiv fs-update-[version].tar.gz werden die Startoptionen automatisch aktualisiert. Damit sind diese Konfigurationsanpassungen ohne manuelle Anpassung auch für bestehende FirstSpirit-Installationen verfügbar (ohne die serverspezifisch angepassten Werte durch eine Aktualisierung zu überschreiben).
Weiterführende Dokumentation siehe FirstSpirit aktualisieren (→Installationsanleitung).

Die Konfigurationsdatei fs-wrapper-vendor.conf sollte nicht geändert werden. Sollte es in Einzelfällen notwendig sein, die empfohlenen Hersteller-Startoptionen anzupassen, sollten die entsprechenden Startparameter in der Konfigurationsdatei fs-wrapper[.isolated].conf erneut definiert werden (und nicht in der fs-wrapper-vendor.conf überschrieben werden).

Hinweise zu unterstützten Java-Versionen siehe Technische Voraussetzungen und Empfehlungen und FirstSpirit Release Notes.

Darstellung über das FirstSpirit ServerMonitoring

Darstellung der Startoptionen (ServerMonitoring)

Die Startoptionen aus den Konfigurationsdateien werden in einer Ansicht zusammengefasst.

Mit einem Klick auf Editieren, können die Startoptionen bei Bedarf angepasst werden.
Die zugehörigen Parameter siehe Java-VM und -Wrapper (fs-wrapper*.conf).

Bearbeiten über das FirstSpirit ServerMonitoring

Bearbeiten der Startoptionen (ServerMonitoring)

Hier wird nur der Inhalt der Konfigurationsdatei fs-wrapper[.isolated].conf zum Bearbeiten angeboten.

Die Startparameter der Konfigurationsdatei fs-wrapper-vendor.conf werden darunter „readonly“ angezeigt, mit dem Hinweis, dass die Werte zum Überschreiben erneut definiert werden sollen („Herstellereigenschaften: Eigenschaft erneut definieren, um den empfohlenen Wert zu überschreiben“).

Durch das Übertragen und Ändern der Werte in der Konfigurationsdatei fs-wrapper[.isolated].conf können alle Parameter der Konfigurationsdatei fs-wrapper-vendor.conf überschrieben werden (nicht nur die allgemeinen Java-Parameter wrapper.java.additional.#)

Liste: Mit einem Klick auf diese Schaltfläche wird der Bearbeitungsmodus wieder verlassen und zurück in die Listenansicht gewechselt.

Mit einem Klick auf Speichern werden die Änderungen in den Konfigurationsdateien gespeichert. Werden ungültige Konfigurationen vorgenommen, wird beim Speichern der Konfiguration im ServerMonitoring auf den Fehler hingewiesen und der Speichervorgang wird nicht ausgeführt:

unexpected configuration property key 'wrapper.startUp.timeout' in line 76

Durch einen Klick auf die Schaltfläche Abbrechen kann der Benutzer zurück zur Konfigurationsübersicht wechseln. Aktuelle Änderungen an der Konfigurationsdatei, die nicht bereits gespeichert wurden, werden zurückgesetzt.

Server neustarten: Ist diese Option aktiviert, dann werden durch einen Klick auf die Schaltfläche Speichern die aktuellen Änderungen der Server-Konfiguration gespeichert und anschließend der Server neu gestartet.

Alle Änderungen der oben genannten Konfigurationsdateien wirken sich erst nach einem Neustart des FirstSpirit-Servers aus.