| Warning |
|---|
Beachten Sie vor Beginn der Aktualisierung die Hinweise zur Aktualisierung. |
Planen der Aktualisierung
Informieren Sie die Anwender über die bevorstehende Aktualisierung und weisen Sie diese an, SmartTaxBalance zu beenden bzw. nicht zu benutzen. Wenn Sie SmartTaxBalance im Client-/Server-Betrieb nutzen, beenden Sie die Server-Anwendung bzw. den Server-Dienst.
Migration der HB-Umgliederungen beim Update von Version 19.0.x auf 20.0.x
In der SmartTaxBalance Version 20.0 gibt es nicht mehr die Möglichkeit, HB-Umgliederungen über die Umgliederungsspalte anzulegen. Mehr dazu finden Sie in den Release Notes. Da die dazu notwendige Migration der Daten aus fachlichen Gründen nicht datenbankseitig geschehen kann, ist es notwendig, die Datenbank vor dem Update von Version 19.0.x auf Version 20.0.x mittels einer Konsolenanwendung zu migrieren.
Vorbereitung
Es muss ein Benutzer in der Datenbank angelegt sein, der global die Berechtigung "Alles bearbeiten" zugewiesen hat. Sollte dies nicht der Fall sein, muss dieser angelegt werden (siehe Allgemeine Informationen zu Benutzern und Rollen).
Die Konvertierungssoftware benötigt Zugriff auf die SmartTaxBalance Datenbank. Dazu muss die Datei connections.config im Ordner config angepasst werden wie unter Konfiguration und Wartung beschrieben.
Es muss eine Sicherung der Datenbank durchgeführt werden, bevor mit der Migration begonnen wird.
Durchführung der Migration
- Starten Sie die Anwendung SmartTaxBalanceReclassificationConverter.exe
- Geben Sie die Anmeldedaten eines geeigneten Benutzers ein (siehe Vorbereitung)
- Die Migration wird nun von der Anwendung vorgenommen. Währenddessen wird auf der Konsole der Fortschritt sowie eventuelle Fehler ausgegeben. Nach Beendigung der Migration wird ausgegeben, für welche Gesellschaften neue Datensätze angelegt wurden. Darüber hinaus werden alle Ausgaben, die nach der Anmeldung des Bentutzers ausgegeben werden, in einer Datei Migrationsprotokoll.txt gespeichert.
- Nach Beendigung der Migration können Sie mit dem Update der Datenbank fortfahren, wie unten beschrieben.
| Info | ||
|---|---|---|
Es kann während der Konvertierung zu einer Meldung wie dieser kommen:
Diese Meldung tritt normalerweise auf, weil die betreffende Gesellschaft gelöscht ist. In der Datei Migrationsprotokoll.txt ist am Ende aufgeführt, wie viele Gesellschaften nicht gefunden wurden. Außerdem ist eine SQL Abfrage enthalten, die den Namen und die Gelöscht-Eigenschaft aller nicht gefundenen Gesellschaften ausgibt. Sollten alle gefundenen Gesellschaften gelöscht sein, können diese Meldungen ignoriert werden. Sollte es nicht gelöschte Gesellschaften geben oder sollte die Abfrage weniger Gesellschaften liefern als die Anzahl der nicht gefundenen Gesellschaften, wenden Sie sich bitte an unseren Support. |
Datenbank
Erstellen Sie eine Sicherung der Datenbank, um bei einem eventuell aufgetretenen Fehler einen Datenverlust zu vermeiden.
Führen Sie das Skript database-setup.sql aus dem Auslieferungspaket aus.
Deinstallation Server-Anwendung
| Info |
|---|
Dieser Schritt ist nur notwendig, wenn Sie SmartTaxBalance im Client-/Server-Betrieb nutzen. |
Entfernen Sie die Server-Anwendung. Folgende Schritte sind dabei auszuführen:
- Notieren Sie sich die bisherige Konfiguration des Servers. Weitere Informationen zur Konfiguration erhalten Sie auf der Seite Konfiguration und Wartung. Folgende Daten werden bei der Neuinstallation mindestens benötigt:
- Namen des Datenbankservers, der Datenbank und die Zugangsdaten zum Datenbankserver
- Serveradresse (IP-Adresse oder Host-Name und Port) des SmartTaxBalance-Servers
- Verwendung Single-Sign-On und ggf. die SSO-Methode
- Entfernen Sie den SmartTaxBalance-Server über den Windows-Dialog „Programme und Features“.
Stellen Sie sicher, dass das Installationsverzeichnis nach der Deinstallation leer bzw. nicht mehr vorhanden ist.
Note Wurde eine zusätzliche Schnittstelle installiert, ist der Unterordner
Interfacesweiterhin vorhanden. Dieser wird in einem späteren Schritt entfernt.
Installation der Server-Anwendung
| Info |
|---|
Dieser Schritt ist nur notwendig, wenn Sie SmartTaxBalance im Client-/Server-Betrieb nutzen. |
Folgen Sie der Anweisung auf der Seite Installation SmartTaxBalance Server.
Verwenden Sie die zuvor notierten Konfigurationsparameter.
Deinstallation Client-Anwendung
Entfernen Sie die Client-Anwendung auf den Rechnern der Anwender. Folgende Schritte sind dabei auszuführen:
- Notieren Sie sich die bisherige Konfiguration des Clients. Weitere Informationen zur Konfiguration erhalten Sie auf der Seite Konfiguration und Wartung. Folgende Daten werden bei der Neuinstallation mindestens benötigt:
- Namen des Datenbankservers, der Datenbank und die Zugangsdaten zum Datenbankserver (sofern SmartTaxBalance nur im Client-Betrieb verwendet wird)
- Serveradresse (IP-Adresse oder Host-Name und Port) des SmartTaxBalance-Servers (sofern SmartTaxBalance im Client-/Server-Betrieb verwendet wird)
- Verwendung Single-Sign-On und ggf. die SSO-Methode
- Entfernen Sie den SmartTaxBalance-Client über den Windows-Dialog „Programme und Features“.
Stellen Sie sicher, dass das Installationsverzeichnis nach der Deinstallation leer bzw. nicht mehr vorhanden ist.
Note Wurde eine zusätzliche Schnittstelle installiert, ist der Unterordner
Interfacesweiterhin vorhanden. Dieser wird in einem späteren Schritt entfernt.
Installation der Client-Anwendung
Folgen Sie der Anweisung auf der Seite Installation Client.
Verwenden Sie die zuvor notierten Konfigurationsparameter.
Schnittstellen
Dem Auslieferungsspaket kann ein zusätzliches MSI-Paket mit einer Import-Schnittstelle beiliegen. In diesem Fall muss auf dem Client und - sofern vorhanden - auf dem Server diese Schnittstelle ebenfalls aktualisiert werden.
- Entfernen Sie die Schnittstelle über den Windows-Dialog „Programme und Features“
- Installieren Sie die neue Schnittstelle.
| Info |
|---|
| Das Installationsverzeichnis für die Schnittstelle wird automatisch bestimmt. |