DB-Migration PostgreSQL nach MS SQL

Geändert am Do, 1 Aug, 2024 um 10:52 VORMITTAGS

Migration einer CROSSCAP-Enterprise-PostgreSQL-Datenbank auf eine MS-SQL-Datenbank


Worum geht es?

Sie haben in Ihrer CROSSCAP-Enterprise-Installation (V3 oder V4) ein PostgreSQL-DBMS im Einsatz und möchten auf MS-SQL migrieren. Im Folgenden haben wir die hierfür nötige Vorgehensweise beschrieben. Die benötigten Software-Pakete erhalten Sie von uns auf Anfrage. 


Zusammenfassung:

  • Schritt 1: Voraussetzungen schaffen
  • Schritt 2: Konfigurieren der Datenbank Migration
  • Schritt 3: Ausführen des Migrations-Tools
  • Schritt 4: CROSSCAP V4 Core Installer erneut ausführen, Services Installer ausführen
 

Schritt 1: Voraussetzungen schaffen:

Für die Migration der Datenbank ist eine vollständige CrossCap Enterprise V4 Installation vonnöten. 

Achtung: Bestehende V3 Enterprise Installationen können nicht upgedatet werden, CrossCap V3 muss deinstalliert werden, bevor CrossCap V4 installiert wird.


Für das Update von CrossCap von V3 auf V4 führen Sie bitte die folgenden Schritte durch:

Datensicherung (empfohlen)

Snapshot des Systems oder Sicherung der Postgresdatenbank
https://help.crosscap.de/a/solutions/articles/47001194494?lang=de

Lizenzdatei anpassen (auf Version 4 anheben, CROSSCAP 3 wird danach weiter funktionieren)

Enterprise Version 3 Servercore deinstallieren (Datenbank wird durch die Deinstallation nicht verändert.)

Enterprise Version 4 Servercore installieren (Crosscap Enterprise TR ResiScanV4.x.y.z_x64.exe oder Crosscap EnterpriseV4.x.y.z_x64.exe)

https://www.srz.de/crosscap/manuals/Enterprise_DE_V4/webframe.html#Installation_Enterprise_Server.html

Während der Installation werden die Parameter für die verwendete Datenbank abgefragt. An dieser Stelle müssen Sie die Daten der aktuellen PostgreSQL-Datenbank angeben, damit die notwendigen Tabellen für die Migration angelegt werden können.

Nach erfolgreicher Installation sollten nun in der aktuellen PostgreSQL-Datenbank unter Databases>Crosscap>Schemas>public>Tables folgendes erscheinen: 

 




Schritt 2: Konfigurieren der Datenbank Migration  

Zum Ausführen des Migrations-Tools benötigen Sie die 'DatabaseMigration.zip'. (Eine aktuelle Version wird Ihnen auf Anfrage per Hi-Drive zur Verfügung gestellt.)
Entpacken der 'DatseMigration.zip'

Zum Ausführen des Migrations-Tools muss als Erstes die 'DatabaseMigration.zip' in einen beliebigen Zielordner (Bsp: C:/Temp) entpackt werden:


 

DatabaseUpdate_Migration.bat anpassen

In dem von Ihnen o.a. Verzeichnis für das Entpacken der ZIP-Datei finden Sie die Datei 'DatabaseUpdate_Migration.bat'.

Die Datei 'DatabaseUpdate_Migration.bat' muss vor dem Ausführen geöffnet und wie unten beschrieben für Ihre Bedürfnisse angepasst werden:


 1 Hier muss der komplette Pfad zu dem Ordner angegeben werden, in dem sich die  'DatabaseUpdate_Migration.bat' befindet.


 2 Hier müssen die Daten Ihrer Quell-Datenbank angeben werden:

- Server = Servername, auf der die DB installiert ist (i.d.R. ist dies die Maschine auf welcher der CROSSCAP-Servercore installiert ist.)

- Port = Port (Standartport 5432)

- Name der zu migrierenden Datenbank (i.d.R.: CrosscapEnterprise)

- Datenbank-User und Passwort (z.B. postgres, scanner)


 3 Hier müssen Sie die Daten der Ziel-Datenbank angeben. 


Set targetConnectionString=Server=IhrServer\IHRE-INSTANZ;Database=NeueDatenbank;Integrated Security=true;Trust Server Certificate=true;”

Server = Name des DB-Servers (i.d.R. ist das die Maschine, auf der auch der CROSSCAP-Servercore installiert ist.) 

bei MS-SQL: Soll eine bestimmte DB-Instanz angesprochen werden, muss deren Name mit angegeben werden. Form: ...<SERVER>\<INSTANZ> 

Den Namen der INSTANZ bitte in Großbuchstaben angeben.

Wird keine Instanz angegeben, wird die Standardinstanz ermittelt und angesprochen.

Beispiele:

Server=IhrServer; stellt eine Verbindung zur Standard-Instanz her.

Server=IhrServer\INSTANZ; stellt eine Verbindung zu einer bestimmten Instanz her.

(optionale) Angabe des Ports: 

Bei Verwendung von Standard- oder dynamischen Ports muss der Port hier nicht angegeben werden.

Sollte jedoch ein fester Port verwendet werden, der vom Standartport abweicht, muss dieser hier angegeben werden. Form: Die Portnummer nach Servernamen (oder Instanz) mit Komma abgetrennt angeben:...<SERVER>\<INSTANZ>,<Port>

Beispiel:

Server=IhrServer\INSTANZ,1432; stellt eine Verbindung zu einer bestimmten Instanz über den Port 1432 her.

Database = Name der Ziel-Datenbank


Authentication:

Soll die Verbindung zum SQLServer mit Windows-Domäne-Konto vorgenommen werden, lautet der Eintrag:

 'Integrated Security=true' 

Soll eine die Verbindung mit Serverauthentifizierung erfolgen, bitte

- User Id = SQLServer-Benutzer und

- Password = SQLServer-Benutzer-Passwort eintragen.

Form: ...User Id=User2;Password=admin


Zertifikat wird nicht akzeptiert (optional)

Sollte das Zertifikat nicht akzeptiert werden, fügen Sie (mit Semikolon abgetrennt) am Ende 'Trust Server Zertifikat=true' ein.


 4 In dem hier angegebenen Verzeichnis wird während der Ausführung der Migration ein Log-File erzeugt.



Schritt 3: 

DatabaseUpdate_Migration.bat ausführen

Anschließend startet die Migration. Dies kann je nach Größe der Datenbank mehrere Stunden dauern (z.B. 15GB ca. 5 Stunden)


Ergebnis nach erfolgreicher Bearbeitung ist die neue Datenbank über MS-SQL-Server sichtbar.



Schritt 4:

Serverinstaller erneut ausführen (Crosscap Enterprise TR ResiScanV4.x.y.z_x64.exe oder Crosscap EnterpriseV4.x.y.z_x64.exe)


Nun muss der CROSSCAP-Server noch mit der neuen Datenbank verbunden werden. Dazu Serverinstallation erneut ausführen und die Daten der soeben migrierten DB entsprechend anpassen (Bitte vorher den Lizenzdienst stoppen - ist das wirklich nötig?)


 Verbindung zum SQLServer mit Server authentification:


 Verbindung zum SQLServer mit Windows-Domäne-Konto:

Gegebenenfalls noch Services und Clients updaten

Servercore, Crosscap-Services und Clients müssen immer in der gleichen Version stehen.

War dieser Artikel hilfreich?

Das ist großartig!

Vielen Dank für das Feedback

Leider konnten wir nicht helfen

Vielen Dank für das Feedback

Wie können wir diesen Artikel verbessern?

Wählen Sie wenigstens einen der Gründe aus
CAPTCHA-Verifikation ist erforderlich.

Feedback gesendet

Wir wissen Ihre Bemühungen zu schätzen und werden versuchen, den Artikel zu korrigieren