Wenn ein Projekt aus der vorherigen Version konvertiert werden soll, wird für die Unterstützung ein Konverter angeboten. Dieser Konverter konvertiert das Projekt und erstellt ein neues Projekt auf Basis der zuvor konvertierten Daten.

In diesem Abschnitt gehen wir zusammen die einzelnen Schritte durch die bei der Konvertierung eines Projektes zu vorherigen Version durchgeführt werden müssen damit dieses dann lauffähig ist.

Vorbereitung

Bevor wir die Konvertierung eines Projektes starten können, müssen wir folgende Schritte durchführen um eine erfolgreiche Konvertierung zu tätigen.

Aktualität des zu konvertierenden Projektes

Als aller erstes müssen wir sorge tragen, dass unser zu konvertierendes Projekt aktuell ist und alle Änderungen gespeichert wurden.

Es wäre von Vorteil wenn das zu konvertierenden Projekt in der letzten aktuellen Version der vorherigen Version geöffnet und alle Einstellungen gespeichert wurden. Somit kann sichergestellt werden, dass das Projekt benötigte Updates in der Konfiguration erhalten hat.

Wurde das Projekt nicht in der aktuellsten Version geöffnet und jede Einstellung gespeichert, kann es sein, dass bestimmte Einstellungen nicht korrekt übernommen werden.

Projekt kopieren und Verzeichnisse vorbereiten

Wenn unser Projekt aktuell und zum konvertieren bereit ist, müssen wir ein Verzeichnis auf unserem Zielsystem für den Konvertierungsprozess erstellen. Hier ist darauf zu achten, dass genügen Platz auf der Festplatte ist.

Da je nach Projektgröße die Anforderung am Plattenplatz variieren kann soll die folgende Formel für die Kalkulation des benötigten Plattenplatzes unterstützen: Dateigröße SDF*2 = Bedarf.

Das würde bei einer Projektdateigröße von 40 MB folgende Formel ergeben: 40MB * 2 = 80 MB. Somit würde wir 80 MB Platz auf der Platte für die Daten benötigten.

Haben wir genug Platz auf der Festplatte sollten wir noch einen Quell- und Zielordner erstellen. Auf unserem Testsystem wurden folgende Verzeichnisse erstellt:

<HDD>\convert
- database
- output

In das Verzeichnis database wird unsere Projektdatenbank kopiert und das Verzeichnis output wird für die Ausgabe der Konvertierung verwendet.

Installieren des Konverters

Für die Installation des Konverters wird nur ein Windows-Setup ausgeliefert. Für die Installation ist nachstehend eine Schritt-für-Schritt Anleitung aufgeführt.

Schritt 1: Stellen Sie sicher, dass Ihr Computer für die Installation bereit ist

Vor der Installation des Konverters:

Informieren Sie sich über die Systemanforderungen. Anhand dieser Anforderungen können Sie feststellen, ob Ihr Computer den Betrieb des Konverters unterstützt
Laden Sie die aktuellen Updates für das Betriebssystem herunter. So stellen Sie sicher, dass Ihr Computer sowohl die neuesten Sicherheitsupdates, als auch die erforderlichen Systemkomponenten für das Modul hat
Starten Sie den Computer neu. Dadurch wird sichergestellt, dass keine ausstehenden Installationen oder Updates die Installation vom Konverter behindern.
Geben Sie Speicherplatz frei. Entfernen Sie nicht benötigte Dateien und Anwendungen z.B. mit der Datenträgerbereinigung-App von Ihrem %Systemlaufwerk%.

Schritt 2: Herunterladen vom Modul

Als nächsten Schritt laden wird das Setup aus dem Partner-Portal herunter.

Schritt 3: Installieren des Konverters

Jetzt führen wir das Setup aus, um das Konverters zu installieren. Das Installationsprogramm enthält alle Elemente, die wir zum Installieren und Anpassen vom Konverter benötigen.

1	Zum Ausführen des Setup tätigen wir einen Doppelklick auf das Setup im Ordner Downloads (sofern das Setup dort gespeichert wurde). Wenn eine Benachrichtigung der Benutzerkontensteuerung angezeigt wird, klicken wir auf Ja.
2	Wir werden anschließend vom Installationsprogramm begrüßt und können mit einem Klick auf Weiter die Installation beginnen.
3	Jetzt wählen wir das entsprechende Verzeichnis aus in dem den Konverter und die entsprechenden Komponenten installiert werden sollen. Zusätzlich müssen wir noch die Lizenzbestimmungen und -bedingungen bestätigen und können mit einem Klick auf Weiter zum nächsten Einrichtungsschritt gelangen.
4	Jetzt können wir die Installation und Registrierung der einzelnen Komponenten mit einem klick auf Install starten. Das System installiert jetzt den Konverter und die benötigten Komponenten, die für den Betrieb benötigt werden.
5	Nachdem das Installationsprogramm alle Komponenten installiert hat, erhalten wir eine Erfolgsmeldung welche wir mit einem klick auf Beenden schließen können

Konvertieren des Projektes

Nachdem die Vorbereitungen abgeschlossen wurden, können wir unser Projekt konvertieren. Hierzu verwenden wir den bereits zuvor installierten Konverter.

Um unser Projekt zu konvertieren, starten wir die Eingabeaufforderung (oder alternative Befehlszeile) und wechseln in das Installationsverzeichnis des Konverters. Anschließend führen wir folgenden Befehl aus und die Konvertierung des Projektes startet:

<install-dir>\Sdf2Service.exe mode=0 auth_service="http://localhost:30001" project_service="http://localhost:30002" user="admin" password="admin" database="D:\convert\database\Demo.sdf" destination="D:\convert\output"

Nach dem die Konvertierung erfolgreich durchgeführt wurde, fragt der Konverter nach ob dieser auch das Projekt direkt erstellen soll:

Would you like to create new project (0/1)?

Um das konvertierte Projekt zu erstellen, geben wir 1 an. Anschließend werden wir nach einem Projektnamen gefragt.

Please enter project name:

Hier können wir einen Namen unserer Wahl angeben und das System erstellt das Projekt mit der angegebenen Bezeichnung.

Letzte Schritte um das Projekt verwenden zu können

Wenn die vorherigen Schritte erfolgreich ausgeführt wurden, müssen noch folgende Vorbereitungen getroffen werden um das Projekt verwenden zu können.

Image-Repository bereitstellen

Bei der Konvertierung werden auch die verwendeten Bilder aus dem Projekt übernommen, damit diese verwendet werden können müssen wir als erstes diese den Services bereitstellen.

Hierzu wechseln wir im Designer in den Bereich Image Repository um die Übersicht der vorhandenen Image Repositories zu erhalten

In der Übersicht laden wir dann das Image Repository Default auf den Services hoch.

Smart-Search Profile

Wurde in dem konvertierten Projekt Connect mit SmartEnterpriseSearch verwendet, wurde die Konfiguration in die zentrale Konfiguration Smart-Search umgewandelt.

Sollte diese Situation zutreffen ist zu beachten, dass in der vorherigen Version für jede Kachel die eine Suche ausgeführt hat die vollständige Suche für diese Kachel konfiguriert werden musste. In der aktuellen Version ist es jetzt, dass die Suche zentral Verwaltet wird und über einen Suchtab in der Seitenleiste angeboten wird. Aus diesem Grund ist es nach der Konvertierung auch nötig in Rollen und Situationen:

sowie in Bereitstellungsprofilen auszuwählen, welches Suchprofil verwendet werden soll.

Wichtiger Hinweise

Verwendung von Skripten aus der vorherigen Version

Wenn in der vorherigen Version Skripte verwendet wurden, werden diese vom Konverter ebenfalls konvertiert. Hier kann es aber dazu kommen, dass diese entsprechend noch angepasst werden müssen.

Wichtig dabei ist, dass die Skripte heute als Modul ausgeliefert werden müssen. Aus diesem Grund muss nach der Konvertierung und Anpassung der Skripte diese als Modul veröffentlicht werden.

ACTIWARE.IO

Konvertierung von Projekten der vorherigen Version