Dies ist kein offiziell unterstütztes Nuclos Feature und richtet sich ausschließlich an Entwickler. Es wird nicht garantiert, dass dieser Import/Export vollständig, zwischen Nuclos Versionen kompatibel, oder fehlerfrei re-importiertbar ist.
Im Allgemeinen ist es mit diesem Feature nicht möglich, eine Nuclos Instanz auf von der RDB eines Datenbankherstellers auf die eines anderen Herstellers zu verschieben, da Nuclos einige (wenige) DB Objekte bei der Erstinstallation anlegt, die herstellerspezifisch sind. Zumindest diese DB Objekte müssen manuell gelöscht und neu angelegt werden.
Weitere Details finden sich auch im Ticket NUCLOS-3693.
Nuclos bietet ab Version 4.3 eine Möglichkeit, das komplette Nuclos-Schema von der Kommandozeile aus zu exportieren und zu importieren. Es ist kein Client nötig, sondern nur der Server muss laufen.
Damit lassen sich schnell Snapshots einer Nuclos-Instanz inklusive Stammdaten erstellen, die zudem noch unabhängig vom Datenbank-Typ sind.
Angesteuert wird die Funktionalität über den REST-Service. Voraussetzung sind Super-User-Rechte. Die URL, sowie die Login-Credentials müssen natürlich angepasst werden.
In den folgenden Aufrufen wird beispielhaft das Shell-Kommando curl verwendet.
Schritt 1: Einloggen und abholen der SessionID (dieser Schritt ist bei jedem REST-Service-Aufruf mindestens einmal nötig)
sessionid=`curl http://localhost:8080/nuclos-war/rest -X POST -H "Accept:application/json" -H "Content-Type: application/json" -d '{"username":"nuclos","password":""}' | awk -v FS="\"" '{ print $4 }'`
Schritt 2: Datenbank Export, dieser erzeugt xml, welches in eine beliebige Datei gezippt ausgeleitet werden kann.
curl http://localhost:8080/nuclos-war/rest/maintenance/dbexport?sessionid=$sessionid > full.xml.gz
Achtung: Der nächste Schritt kann das bestehende Nuclos-Schema komplett zerstören. Erstellen Sie bei Bedarf zusätzlich noch einen klassischen Datenbank-Dump!
Schritt 3: Datenbank Import.
curl -F "file=@full.xml.gz" http://localhost:8080/nuclos-war/rest/maintenance/dbimport?sessionid=$sessionid
Der Import eines Dumps einer Nuclos-Instanz einer unterschiedlichen Nuclos-Schema-Version ist grundsätzlich nicht unmöglich. Dabei muss jedoch die Schema-Version manuell hochgezählt oder der AutoSetup deaktiviert werden. Der Vorgang ist nur für fortgeschrittene Nuclos-Administratoren zu empfehlen.
Überblick
Inhalte