In den folgenden Absätzen und verknüpften Artikeln finden Sie eine Anleitung, wie Sie Nuclos auf Ihrem System installieren können. Bitte wenden Sie sich bei Fragen oder auftretenden Schwierigkeiten an das Nuclos Forum unter http://www.nuclos.de/forum.

Welches Installationsprogramm benötige ich?

Laden Sie die aktuellste Version des Installationsprogramm auf http://www.nuclos.de herunter. Das Installationsprogramm können Sie in unterschiedlichen Varianten beziehen. Die Wahl eines Download-Pakets hängt davon ab, auf welchem Betriebssystem Sie Nuclos einsetzen, ob Sie eine PostgreSQL 9.0 Datenbank installieren und in welchem Modus Sie die Installation ausführen möchten. PostgreSQL kann nur dann vom Nuclos-Installationsassitenten installiert werden, wenn Sie den für Ihr Betriebssystem passenden Download verwenden. Auch falls Sie PostgreSQL nicht benötigen, empfehlen wir Ihnen die Verwendung des Betriebssystem-spezifischen Installers, da dieser je nach Betriebssystem einfacher auszuführen ist und eventuell notwendige Voraussetzungen vor dem Start der Installation überprüfen kann.

Welche Voraussetzungen muss mein System erfüllen?

Bevor Sie Nuclos erfolgreich installieren können, sollte bzw. muss Ihr System diverse Voraussetzungen erfüllen.

Java Runtime Environment

Wenn Ihr System noch nicht über ein installiertes Java Runtime Environment verfügt, sollten Sie dieses auf http://java.sun.com/javase/downloads/index.jsp herunterladen. Folgen Sie den Installationsanweisungen, die Sie dort finden. Sie sollten bei der Installation von Java darauf achten, dass Sie eine für Ihre Betriebssystem-Architektur passende Version von Java verwenden. Sollten Sie beispielsweise eine 32-bit Java-Version auf einem 64-bit System verwenden, kann dies bei der Installation oder im Betrieb von Nuclos zu Problemen führen.

Bis einschliesslich Nuclos 3.9.x kann Nuclos nur unter Java 6 betrieben werden, ab Nuclos 3.10.x setzt Nuclos Java 7 voraus, auf Anfrage kann für eine Übergangsphase ein Build für Java 6 bereitgestellt werden.

Datenbanksystem

Für die persistente Speicherung der Daten Ihres ERP-Systems benötigt Nuclos eine relationale Datenbank. Dabei werden die folgenden Datenbanksysteme unterstützt:

• PostgreSQL Server (ab Version 8.4)
• Oracle Database Server (ab Version 10)
• Microsoft SQL Server (ab Version 2005)
• Sybase SQL Anywhere (ab Version 10)
• IBM DB2 Express-C (ab Version 10)

Sollten Sie noch keine Datenbank installiert haben, empfehlen wir Ihnen die Installation der Open Source Datenbank PostgreSQL, für die keine Lizenzkosten anfallen. Falls Sie einen Betriebssystem-spezifisches Installationsprogramm von Nuclos verwenden und sie den Installer im grafisch-interaktiven Modus ausführen, bietet Ihnen der Installationsassistent auch die Möglichkeit, PostgreSQL 9.0 automatisch zu installieren. Falls die Installation der Datenbank über den Assistenten nicht möglich ist, können Sie PostgreSQL auf http://www.postgresql.org/download/ herunterladen und gemäß den dort zu findenden Installationsanweisungen installieren.

Falls Sie PostgreSQL als Datenbanksystem verwenden möchten, kann der Installationsassistent die Datenbank auch entsprechend konfigurieren, sodass keine weiteren Schritte zur Vorbereitung einer Datenbank mehr notwendig sind - Sie müssen lediglich die Daten kennen, um sich mit der Datenbank verbinden zu können. Falls Sie eine andere kompatible Datenbank verwenden oder die Vorbereitung der Datenbank lieber manuell durchführen möchten, finden Sie unter folgenden Links die jeweils notwendigen Schritte, um eine Datenbank für Nuclos einzurichten:

• PostgreSQL Server
• Oracle Database Server
• Microsoft SQL Server
• Sybase SQL Anywhere
• IBM DB2

Falls Sie Oracle, Microsoft SQL Server, Sybase SQL Anywhere oder IBM DB2 Express-C verwenden: Nuclos benötigt einen sog. JDBC-Treiber für den Zugriff auf die jeweilige Datenbank. Die JDBC_Treiber für diese Datenbanken ist aus lizenzrechtlichen Gründen nicht Bestandteil der Nuclos Distribution. Falls Sie nicht PostgreSQL einsetzen möchten, laden Sie daher den passenden JDBC-Treiber (Download-Links sind auf den oben verlinkten Seiten zu finden) für Ihre Datenbank herunter und geben Sie den Pfad zur Datei bei der Installation an.

Administrationsberechtigungen (optional)

Wenn Sie PostgreSQL mitinstallieren möchten oder Nuclos als Dienst in Ihrem Betriebssystem einrichten möchten, starten Sie das Installationprogramm bitte mit administrativen Berechtigungen. Sofern Sie den Betriebssystem-spezifischen Installer unter Windows Vista, Windows 7 oder Mac OS X verwenden, erfolgt automatisch die Nachfrage, ob Sie das Programm mit Administrationsberechtigungen ausführen möchten. Falls Sie Linux als Betriebssystem verwenden oder das Installationsprogramm über die Kommandozeile ausführen, führen Sie bitte die für Ihr Betriebssystem notwendigen Schritte durch, um das Programm mit den entsprechenden Berechtigungen zu starten (z.B. sudo unter diversen Linux-Distributionen).

Sie können Nuclos auch ohne Administrationsberechtigungen installieren - allerdings kann der Installer in diesem Fall keine Dienste konfigurieren oder PostgreSQL installieren.

Wie starte ich das Installationsprogramm?

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

Grafisch-interaktive Installation

Bitte wählen Sie die grafisch-interaktive Installation, wenn Ihr Betriebssystem über eine grafische Benutzeroberfläche verfügt. Die Installer für Windows und Mac OS X können Sie bequem per Doppelklick starten (*.exe oder *.app). Falls Ihr vorliegendes Installationsprogramm eine *.jar-Datei ist, starten Sie den Installer im grafisch-interaktiven Modus bitte mit folgendem Aufruf:

java -jar nuclos-<version>-installer-generic.jar

Der Assistent führt Sie anschließend durch die Installation.

Textuell-interaktive Installation

Bitte wählen Sie die textuell-interaktive Installation, wenn Ihr Betriebssystem nicht über eine grafische Benutzeroberfläche verfügt oder wenn Sie beispielsweise über SSH die Installation durchführen. Für die textuell-interaktive Installation verwenden Sie bitte den Download nuclos-<version>-installer-generic.jar, und rufen Sie diesen wie folgt aus:

java -jar nuclos-<version>-installer-generic.jar -c

Der Parameter -c stellt dabei sicher, dass die Abfrage der Einstellungen text-basiert erfolgt. Der Assistent führt Sie anschließend durch die 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.

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.