Der Nuclos-Installer

Sie können das Nuclos-Installationsprogramm in verschiedenen Varianten ausführen:

Grafisch-interaktive Installation

Starten Sie den Installer per Doppelklick.

Textuell-interaktive Installation

Setzen von Dokumenten- und Index-Pfaden

Bei der Installation hat der Benutzer die Möglichkeit für die Dokumentenablage wie auch für die Index-Erstellung eigene Pfade anzugeben.
Die Verzeichnisse können im Installationsschritt "Server Konfiguration" gesetzt werden, wobei die Standard-Werte vorbelegt sind:

      Wichtig ist, dass das Installationsprogramm, wie auch die später laufende Nuclos-Instanz für die gesetzten Verzeichnisse Schreibrechte besitzen.
          Andererseit können keine Daten hinterlegt werden und es kommt zu Fehlern.

      Das Dokumentenverzeichnis kann im Gegensatz zum Index-Pfad nur bei der Erstinstallation gesetzt werden.
          Bei jedem folgenden Update ist das Feld ausgegraut und kann nicht mehr verändert werden.
          Ist dies dennoch gewünscht, kann das manuell wie folgt vorgenommen werden:

• 1. Pfad direkt in nuclos.xml ändern

     <nuclos>
         <server>
             <home>C:\nuclos</home>
             <name>nuclos</name>
             <documentPath>C:\nuclos\data\documents</documentPath>
             <indexPath>C:\nuclos\data\index</indexPath>
     
     		...
         </server>
         ...
     </nuclos>

  2. Installer ausführen
     Mit den Änderungen aus Schritt 1) übernimmt der Installer beim Update die Werte aus der nuclos.xml und verwendet diese bei den weiteren Installationsschritten.
  3. Dokumente manuell in das neue Verzeichnis umkopieren.

Wie starte ich Nuclos?

Um Nuclos verwenden zu können, müssen Sie zuerst den Nuclos Server starten. Sollten Sie bei der Installation die Option "Beim Systemstart starten" nicht aktiviert haben, müssen Sie dies manuell durchführen. Die folgende Tabelle zeigt, wie Sie den Nuclos Server als Dienst (falls Nuclos mit Administrationsberechtigungen installiert wurde) bzw. per Script (falls Nuclos nicht mit Administrationsberechtigungen installiert wurde) starten können. Um Nuclos als Dienst starten zu können, müssen Sie den jeweiligen Befehl i.d.R. mit Administrationsberechtigungen ausführen.

Den Nuclos Client starten Sie anschließend über Ihren Webbrowser mit dem Aufruf http://localhost:<http-port>/<instance> bzw. https://localhost:<https-port>/<instance> - je nachdem, welches Kommunikationsprotokoll Sie bei der Installation aktiviert haben. Wenn Sie den Nuclos Client nicht direkt auf dem Nuclos Server starten, sondern auf einem anderen Rechner, ersetzen Sie „localhost“ durch die IP-Adresse oder den Servernamen Ihres Nuclos Servers.

Um sich an Nuclos erstmalig anzumelden, verwenden Sie bitte den Benutzernamen „nuclos“ und ein leeres Passwort. Weitere Benutzer können Sie dann innerhalb Nuclos hinzufügen, ebenso können Sie innerhalb von Nuclos das Passwort ändern.

Wie aktualisiere ich eine vorhandene Installation?

Wenn Nuclos auf Ihrem Server bereits installiert ist, folgen Sie den Anweisungen dieses Kapitels, um Ihre bestehende Installation von Nuclos auf die neueste Version von Nuclos zu aktualisieren. Wenden Sie sich bei Fragen oder auftretenden Schwierigkeiten an das Nuclos Forum unter http://forum.nuclos.de. Bitte stoppen Sie vor jeder Aktualisierung den Nuclos Server (schließen Sie vorher sicherheitshalber alle offenen Nuclos Clients, damit keine Daten verlorengehen, die durch Ihre Anwender gerade bearbeitet werden) und erstellen Sie ein Backup der Datenbank und des Installationsverzeichnisses.

Aktualisierung von Nuclos-Installation mit einer Version größer oder gleich 3.0.0

Wenn Sie eine Nuclos-Installation mit einer Version größer oder gleich 3.0.0 starten Sie das Installationsprogramm analog zur Erstinstallation. Wenn Sie als Installationspfad das Verzeichnis einer bereits vorhandenen Installation auswählen, werden die Einstellungen der letzten Installation automatisch geladen. Bevor die Aktualisierung durchgeführt wird, können Sie nochmal alle Einstellungen überprüfen.

Aktualisierung von Nuclos-Installation mit einer Version kleiner 3.0.0

Wenn Sie eine Nuclos-Installation mit einer Version kleiner 3.0.0 aktualisieren möchten, sollten Sie den Download nuclos-<version>-installer-generic.jar verwenden. Starten Sie das Installationprogramm bitte wie folgt (<Pfad zur alten nuclos.xml> := Nuclos 2.6: „<jboss-home-dir>/server/<server-name>/nuclos.xml“; Nuclos 2.7.*: „<tomcat-home-dir>/webapps/<server-name>/WEB-INF/nuclos.xml“):

java -jar nuclos-<version>-installer-generic.jar <Pfad zur alten nuclos.xml>

Nuclos 3.0.0 kann nicht in dasselbe Verzeichnis installiert werden, in das Sie bereits eine ältere Version von Nuclos installiert haben, daher müssen Sie einen neuen leeren oder noch nicht vorhandenen Zielpfad wählen. Das Verzeichnis der alten Installation können Sie nach erfolgreich durchgeführtem Update automatisch vom Installationsprogramm löschen lassen (bitte erstellen Sie sicherheitshalber eine Sicherheitskopie). Um eine ältere Version von Nuclos zu aktualisieren, muss der Installer gewisse Dateien (z.B. gespeicherte Dokumentanhänge) aus dem Verzeichnis der alten Installation in das Verzeichnis der neuen Installation kopieren. Wenn Sie Ihre bereits existierende Konfigurationsdatei aus dem JBoss- (Nuclos 2.6.*) oder Tomcat-Verzeichnis (Nuclos 2.7.*) beim Update verwenden, wird der Generic Installer nach Rückfrage automatisch eine Migration der Dateien vornehmen.

Häufige Fragen zur Installation

Antworten zu häufig gestellten Fragen zur Installation von Nuclos finden Sie unter Häufige Fragen zur Installation.

Automatisierte Installation

Sie können das Nuclos-Installationsprogramm (sofern es als *.jar-datei vorliegt, also z.B. nuclos-<version>-installer-generic.jar) auch parametrisiert starten, wenn Sie eine Interaktion mit dem Benutzer nicht wünschen, z.B. um die Installation automatisiert auszuführen. Um die Installationseinstellungen als Parameter an den Installer übergeben zu können, erstellen Sie bitte eine XML-Datei mit beliebigem Namen und folgender Struktur:

<?xml version="1.0"?>
<nuclos>
  <server>
    <home><!-- installation path --></home>
    <name><!-- instance name --></name>
    <http>
      <enabled>true</enabled>
      <port>80</port>
    </http>
    <https>
      <enabled>false</enabled>
      <port>$443</port>
      <keystore>
        <file>/home/.keystore</file>
        <password>keystore-passord</password>
      </keystore>
    </https>
    <shutdown-port>8005</shutdown-port>
    <heap-size>1024</heap-size>
    <java-home>/opt/java</java-home>
    <launch-on-startup>true</launch-on-startup>
  </server>
  <client>
    <singleinstance>false</singleinstance>
  </client>
  <database>
    <adapter>postgresql</adapter>
    <driver>org.postgresql.Driver</driver>
    <driverjar></driverjar>
    <connection-url>jdbc:postgresql://localhost:5432/postgres</connection-url>
    <username>nuclos</username>
    <password>nuclos</password>
    <schema>nuclos</schema>
    <tablespace>dat_nuclos</tablespace>
    <tablespace-index></tablespace-index>
  </database>
</nuclos>

Die Erläuterung der einzelnen Konfigurationselemente finden Sie unter Beschreibung der Konfigurations Datei nuclos.xml.

Wechseln Sie nun in der Kommandozeile in das Verzeichnis, in dem die *.jar-Datei liegt und führen Sie den Installer mittels

 java -jar nuclos-<version>-installer-generic.jar -s <Pfad zur Konfigurationsdatei>

aus. Der Parameter -s legt dabei fest, dass die Installation ohne Interaktion ausgeführt wird. Sollten Fehler oder Wanrungen auftreten, bricht das Installationsprogramm mit der entsprechenden Fehlermeldung ab.

Wenn Sie eine vorhandene Installation (> 3.0.0) mit diesem Modus aktualisieren möchten, verwenden Sie bitte als Konfigurationsdatei die Datei <nuclos-home>/nuclos.xml.