--- title: "Aktualisierung auf portier Vision 5 mit Firebird-Migration und MS SQL Server" description: "Umstieg von portier Vision 4.1x auf Vision 5, mit der Migration der Firebird-Datenbank von 2.5 auf 4.0 in drei Szenarien und der Verbindungsprüfung im portier Vision Companion." url: https://help.portiervision.com/de/articles/113-aktualisierung-auf-portier-vision-5-mit-firebird-migration-und-ms-sql-server collection: "Integrationen & IT-Einrichtung" updated: 2026-08-28 language: de alternates: [en, fr] --- # Aktualisierung auf portier Vision 5 mit Firebird-Migration und MS SQL Server Umstieg von portier Vision 4.1x auf Vision 5, mit der Migration der Firebird-Datenbank von 2.5 auf 4.0 in drei Szenarien und der Verbindungsprüfung im portier Vision Companion. ## Für wen dieser Artikel gilt Dieser Artikel beschreibt den einmaligen Umstieg von portier Vision 4.1x auf Vision 5, einschließlich der Migration der Firebird-Datenbank von 2.5 auf 4.0. Arbeiten Sie bereits mit Vision 5.5.0 oder neuer, brauchen Sie ihn nicht. Weitere Versionen installiert dann der eingebaute Updater, siehe [Automatische Updates für portier Vision](https://help.portiervision.com/de/articles/123-automatische-updates-fuer-portier-vision.md). Planen Sie ein Wartungsfenster ein. Während der Umstellung arbeitet niemand in Vision. **Inhalt** - Vorbereitung - Wo die Datenbankeinstellungen in Vision 5 liegen - Szenario 1: lokaler Firebird-Server - Szenario 2: externer Firebird-Server - Szenario 3: Microsoft SQL Server - Nach dem Speichern - Wenn etwas schiefgeht ## Vorbereitung - **Sichern Sie die Datenbank.** Bei Firebird ist das die Datei PORTIERVISION.GDB. Bei Microsoft SQL Server erstellen Sie das Backup über SQL Server Management Studio. Legen Sie die Sicherung außerhalb des Vision-Ordners ab. - **Notieren Sie Datenbankpfad und Anmeldedaten.** Beides brauchen Sie für die Verbindungsprüfung am Ende. - **Beenden Sie Vision auf allen Arbeitsplätzen.** - Prüfen Sie vorab den Artikel **Systemanforderungen & Performance**. ## Wo die Datenbankeinstellungen in Vision 5 liegen Die Datenbankverbindung stellen Sie im **portier Vision Companion** ein. Der Companion wird zusammen mit Vision installiert und liegt als `portierVisionCompanion.exe` im selben Ordner wie `PortierVision.exe`. Ein eigenes Konfigurationsprogramm gibt es nicht. Es gibt zwei Wege dorthin. - **Aus Vision heraus.** Der Companion startet über das Vision-Menü und ist bereits angemeldet. Klicken Sie oben auf **Datenbankkonfiguration**. - **Direkt.** Starten Sie `portierVisionCompanion.exe`. Auf dem Anmeldebildschirm klicken Sie unten auf **Datenbank-Konfigurator öffnen**. Dafür ist keine Anmeldung nötig. Bei einer Umstellung zählt der zweite Weg. Er funktioniert auch dann, wenn Vision die Datenbank noch nicht erreicht. ![Anmeldebildschirm des Companion. Über „Datenbank-Konfigurator öffnen" kommen Sie ohne Anmeldung in die Datenbankkonfiguration.](https://staticfiles.gleap.io/p69f19d405a24ffe33e3bc1d5/ElA90ja3BUeLm4Xd1Th3LdfClZVy0Z9Eu2NoGDwou1FvSsNZdMrGtfle6onDaLnTb3HgW7b8tCN.png) _Anmeldebildschirm des Companion. Über „Datenbank-Konfigurator öffnen" kommen Sie ohne Anmeldung in die Datenbankkonfiguration._ Vision und Companion lesen dieselbe Datei `portiervision.ini`. Was Sie im Companion speichern, gilt für beide. ## Szenario 1: lokaler Firebird-Server **Schritt 1: Firebird 4.0 installieren** - Starten Sie das Firebird-4.0-Setup auf dem Server. - Akzeptieren Sie die Lizenzvereinbarung. - Wählen Sie das Verzeichnis, in dem die vorhandene Firebird-2.5-Datenbank liegt. - Bestätigen Sie das Entfernen von Firebird 2.5. ![Das Firebird-4.0-Setup startet auf dem Server.](https://staticfiles.gleap.io/g/VVbRIRbpBOTmuQquObrR8L9ByHrFe4OJ1JcqNO7s5ZXToRczpaT2KQwXl1eHrnj87xayglOHH8G.png) _Das Firebird-4.0-Setup startet auf dem Server._ ![Im Setup bestätigen Sie die Lizenzvereinbarung und wählen das Verzeichnis der vorhandenen Firebird-2.5-Datenbank.](https://staticfiles.gleap.io/g/wpd6PbchiHn34ir6FrhMbkBbeeGI0LcXFWh9qsVxCRDwbWtOtFYWxgUFYdXptKvjTS3RoL5gAWc.png) _Im Setup bestätigen Sie die Lizenzvereinbarung und wählen das Verzeichnis der vorhandenen Firebird-2.5-Datenbank._ **Schritt 2: Datenbank migrieren** - Lassen Sie das Setup die vorhandene Datenbank erkennen und migrieren. - Schließen Sie die Installation ab. **Schritt 3: portier Vision 5 installieren** - Führen Sie das Vision-5-Setup auf dem Server und an allen Arbeitsplätzen aus. - Setzen Sie den Haken bei **Ich stimme den Lizenzbedingungen zu**. - Das Setup findet eine vorhandene Vision-Installation selbst und installiert in deren Ordner. Wollen Sie einen anderen Ordner, klicken Sie auf **Optionen** und tragen ihn unter **Installationsordner:** ein. - Auf einer Firebird-Anlage brauchen Sie keinen ODBC-Treiber. Nehmen Sie den Haken bei **Microsoft ODBC-Treiber 18 für SQL Server installieren (empfohlen)** heraus. ![Das Vision-5-Setup auf dem Server, mit dem Lizenzhaken und dem Installationsordner unter Optionen.](https://staticfiles.gleap.io/g/7kMVJau4ugV5sIrexVH2bgBuZAgXWIJAcnIbSaUcV2wbjO4F4Q40u6OVS2yQmcQKduTi3ETu6po.png) _Das Vision-5-Setup auf dem Server, mit dem Lizenzhaken und dem Installationsordner unter Optionen._ **Schritt 4: Verbindung prüfen** - Öffnen Sie die **Datenbankkonfiguration** im Companion. - Wählen Sie unter **Datenbanktyp** den Eintrag **Firebird**. - Füllen Sie **Host**, **Port**, **Datenbankpfad**, **Benutzername** und **Passwort** aus. Über **Durchsuchen** wählen Sie die GDB-Datei direkt aus. - Klicken Sie auf **Verbindung testen** und warten Sie auf die Meldung „Verbindung erfolgreich, bitte speichern Sie die Konfiguration". - Klicken Sie auf **Konfiguration speichern**. ![Datenbankkonfiguration im Companion mit Datenbanktyp Firebird.](https://staticfiles.gleap.io/p69f19d405a24ffe33e3bc1d5/f77zJAJq6ztNC8V3frDGyNE6bWb7ZZhOe8VtyMJJbzm7CiakE6MvwC1IJIjvZ5H95wKEqlxp82g.png) _Datenbankkonfiguration im Companion mit Datenbanktyp Firebird._ - Starten Sie Vision, melden Sie sich an und prüfen Sie stichprobenartig Schlüssel, Zylinder und Personal. ## Szenario 2: externer Firebird-Server **Schritt 1: Vorbereitung** - Stellen Sie sicher, dass der externe Firebird-Server erreichbar ist. - Kopieren Sie `portiervision.ini` von einem Arbeitsplatz in den Ordner auf dem Server, in dem die Datenbankdatei (\\\*.GDB) liegt. So bestätigen Sie Pfad und Zugriff. ![Die Datei portiervision.ini liegt auf dem Server im selben Ordner wie die Datenbankdatei.](https://staticfiles.gleap.io/g/J41xFbhf7lghvdqjsAlw2MUtQ1eo3nXrZzSdGhRl9fbP78ILoq0o9gTBM67186dB5c60phS9B8v.png) _Die Datei portiervision.ini liegt auf dem Server im selben Ordner wie die Datenbankdatei._ Diese Kopie ist nur eine Pfadangabe für das Firebird-Setup. Standardmäßig ist die Datei mit DPAPI an Benutzer und Rechner gebunden und lässt sich anderswo nicht auswerten. Verwenden Sie sie nicht als fertige Konfiguration für weitere Arbeitsplätze. **Schritt 2: Firebird 4.0 aus der Ferne aktualisieren** - Starten Sie das Firebird-4.0-Setup und wählen Sie „Firebird Remote Upgrade". - Geben Sie das Verzeichnis auf dem externen Server an, in dem Datenbank und PORTIERVISION.INI liegen. - Das Setup erkennt die vorhandene Firebird-2.5-Installation und migriert die Datenbank. ![Im Firebird-4.0-Setup wählen Sie den Eintrag „Firebird Remote Upgrade".](https://staticfiles.gleap.io/g/tCE17MDWAue5vsWxHuDxtBnW07m8x5tTi174EN1Z2f7QSsQHJXQrCpJGm9A5Yg3KaOC2e33xFEh.png) _Im Firebird-4.0-Setup wählen Sie den Eintrag „Firebird Remote Upgrade"._ **Schritt 3: Bestätigen** - Bestätigen Sie das Entfernen der alten Version und der gemeinsam genutzten Dateien. - Schließen Sie die Installation ab. **Schritt 4: portier Vision 5 installieren** - Führen Sie das Vision-5-Setup an allen betroffenen Arbeitsplätzen aus. - Setzen Sie den Haken bei **Ich stimme den Lizenzbedingungen zu**. - Nehmen Sie den Haken bei **Microsoft ODBC-Treiber 18 für SQL Server installieren (empfohlen)** heraus. ![Das Vision-5-Setup auf einem Arbeitsplatz, mit dem Haken für die Lizenzbedingungen.](https://staticfiles.gleap.io/g/TXhyIkjANYubJMCGhugybKFkSFycsgQXcGc4yObdyE5f1FzwEZBzIIGeoBIgwZmmF7YOcdDH97u.png) _Das Vision-5-Setup auf einem Arbeitsplatz, mit dem Haken für die Lizenzbedingungen._ **Schritt 5: Verbindung prüfen** - Öffnen Sie die **Datenbankkonfiguration** im Companion. - **Datenbanktyp**: **Firebird**. Unter **Host** tragen Sie den Servernamen ein, unter **Datenbankpfad** den Pfad so, wie der Server ihn sieht. - Klicken Sie auf **Verbindung testen**, warten Sie die Erfolgsmeldung ab und klicken Sie auf **Konfiguration speichern**. - Wiederholen Sie das an jedem Arbeitsplatz. Jeder Rechner hat seine eigene `portiervision.ini`. Wollen Sie die Datei stattdessen verteilen, stellen Sie unter **Erweiterte Konfiguration** die **Konfigurationsverschlüsselung** auf **Gemeinsamer Schlüssel** um. Mit **DPAPI** bleibt sie an Benutzer und Rechner gebunden. ## Szenario 3: Microsoft SQL Server **Schritt 1: Vorbereitung** - Erstellen Sie ein Backup der Datenbank mit SQL Server Management Studio oder Ihrem gewohnten Werkzeug. - Die Anmeldung, mit der Vision arbeitet, braucht `db_ddladmin`. Ohne dieses Recht bleibt das Upgrade bei der ersten Schemaänderung stehen. Siehe **Datenbank-Anmeldung ohne Passwort**. ![Sicherung der SQL-Server-Datenbank im SQL Server Management Studio, Schritt 1 von 4.](https://staticfiles.gleap.io/g/LTYmePOU77foKy6TO5kBJLk5AAACN0dgH3QMrTBphk3Y7UmTRljAmEXNxlHIAozHXLrqf2U405j.png) _Sicherung der SQL-Server-Datenbank im SQL Server Management Studio, Schritt 1 von 4._ ![Sicherung der SQL-Server-Datenbank im SQL Server Management Studio, Schritt 2 von 4.](https://staticfiles.gleap.io/g/JiT9adqqorndNjUhbJ4CJ9wbAieIiVxZO71HsjrerBKVJSYyzbvGjuhUdSFwp85FcmB6ZBMxZgG.png) _Sicherung der SQL-Server-Datenbank im SQL Server Management Studio, Schritt 2 von 4._ ![Sicherung der SQL-Server-Datenbank im SQL Server Management Studio, Schritt 3 von 4.](https://staticfiles.gleap.io/g/INSHMNnYkRmnWajUyqYoseExRZ6GWtmh4Q82qqujbj3VePQBNADW0kIFpts8n84q1fXIGzNz5LB.png) _Sicherung der SQL-Server-Datenbank im SQL Server Management Studio, Schritt 3 von 4._ ![Sicherung der SQL-Server-Datenbank im SQL Server Management Studio, Schritt 4 von 4.](https://staticfiles.gleap.io/g/TDN6gW5BiISe1Kblf0mCdPf2vobSwMhrdjHat8OK7XWImYiuZw7ESEACpIyE04YnySz3vGyabNC.png) _Sicherung der SQL-Server-Datenbank im SQL Server Management Studio, Schritt 4 von 4._ **Schritt 2: portier Vision 5 installieren** - Führen Sie das Vision-5-Setup auf dem Server und an allen Arbeitsplätzen aus. - Setzen Sie den Haken bei **Ich stimme den Lizenzbedingungen zu**. - Lassen Sie den Haken bei **Microsoft ODBC-Treiber 18 für SQL Server installieren (empfohlen)** gesetzt. Der Vision-Desktop verbindet sich über diesen Treiber mit SQL Server. Ist der Treiber schon vorhanden, überspringt das Setup den Schritt. Der Companion braucht ihn nicht, er verbindet sich direkt. **Schritt 3: Verbindung prüfen** - Öffnen Sie die **Datenbankkonfiguration** im Companion. - Wählen Sie unter **Datenbanktyp** entweder **Microsoft SQL Server - Normale Authentifizierung** oder **Microsoft SQL Server - Windows-Anmeldung**. - Füllen Sie **Host**, **Datenbankname** und **Schema** aus, bei normaler Authentifizierung dazu **Benutzername** und **Passwort**. - Ein eigenes Feld für den Port gibt es hier nicht. Weicht der Port vom Standard ab, hängen Sie ihn mit Komma an den Host an, zum Beispiel `SQLSRV01, 1444`. - Verschlüsselte Verbindungen schalten Sie unter **Erweiterte Konfiguration** mit **SSL/TLS Verbindung** ein. - Klicken Sie auf **Verbindung testen**, warten Sie die Erfolgsmeldung ab und klicken Sie auf **Konfiguration speichern**. ![Datenbankkonfiguration mit Microsoft SQL Server und normaler Authentifizierung.](https://staticfiles.gleap.io/p69f19d405a24ffe33e3bc1d5/zai8MjPFFCKuIErzvkXT9gIS02AJ5ed5eQakVFqO21d6OeCG3wPtDyhEk4dsybsppjKupftAVwP.png) _Datenbankkonfiguration mit Microsoft SQL Server und normaler Authentifizierung._ ## Nach dem Speichern Ändern Sie die Datenbank, meldet der Companion Sie nach dem Speichern ab. Melden Sie sich neu an, damit er mit der neuen Datenbank arbeitet. Starten Sie danach Vision und melden Sie sich dort an. Läuft die Anmeldung durch und stimmen die Stammdaten, ist die Umstellung abgeschlossen. Siehe auch **portier Erstinstallation und Anmeldung**. ## Wenn etwas schiefgeht Bricht das Firebird-Setup ab oder öffnet Vision die Datenbank nicht, spielen Sie die Sicherung aus der Vorbereitung zurück und setzen Sie neu an. Arbeiten Sie nicht mit einer halb migrierten Datenbank weiter, auch nicht testweise. Kommen Sie nicht weiter, melden Sie sich beim portier-Support, bevor Sie einen weiteren Versuch starten. Meldet Vision beim Start des Companion „Das Programm ‚portierVisionCompanion.EXE' befindet sich nicht im Verzeichnis!", fehlt die Datei im Installationsordner. Führen Sie das Vision-5-Setup auf diesem Rechner erneut aus.