Vorbereitung

Informieren Sie die Anwender über die bevorstehende Aktualisierung und weisen Sie diese an, sich aus dem VAT@GTC auszuloggen bzw. nicht zu benutzen.

Laden Sie das Aktualisierungspaket über den Link aus der Ihnen zugesendeten E-Mail herunter und entpacken die Zip-Datei. (ggf. Passwort beachten)

In Ihrer Auslieferung sollte Sie nach dem Entpacken der bereitgestellenten ZIP-Datei folgende Ordnerstruktur vorfinden:

databasescript → alle notwendigen Update-Skripte für die Datenbank
deployment → war-Datei mit der aktuellen Applikation

Aktualisierung VAT@GTC (Apache Tomcat)

1. Web-Applikationsserver stoppen

   1. Stoppen Sie den Web-Applikationsserver (z.B. Tomcat) wie gewohnt über die Kommandozeile oder den Dienstemanager

   2. Löschen Sie den Inhalt des Verzeichnisses „work“ der Tomcat Installation
      
      
2. Altes Deployment sichern

   1. Im Unterverzeichnis \webapps des Web-Applikationsservers finden Sie das bisherige Deployment (i.d.R. mit dem Namen \vat)

   2. Sichern Sie den Ordner oder die Datei *.war außerhalb des \webapps Ordners

3. Datenbank aktualisieren
   Wenn Ihrer Auslieferung SQL-Skripte beiliegen, führen Sie bitte folgende Schritte aus:
   1. Erstellen Sie eine Sicherung der Datenbank, um bei einem eventuell aufgetretenen Fehler einen Datenverlust zu vermeiden.
   2. Starten sie bei einem MSSQL Server das SQL Management Studio  oder bei Oracle den SQLDeveloper ihres DB-Servers und wählen sie das DB-Schema aus das zur VAT@GTC Applikation gehört.
   3. Führen Sie die mitgelieferten SQL-Update-Skripte in Sortierreihenfolge der Dateinamen bzw. Versionen auf diesem Schema aus. Nutzen Sie einen Benutzer, der volle Rechte auf der Datenbank hat.
      Beispiel:
      
      • 01_MSSQL_11.00.00_11.00.04.sql
      • 02_Insert_Reporting_MSSQL.sql
      • usw.
   4. Sollte es wiedererwarten zu Fehlermeldung bei Ausführung der Skripte kommen, kontaktieren Sie bitte unseren Support und schicken uns das Ausführungsprotokoll.
       
4. Web-Applikationsserver starten
   1. Starten Sie den Web-Applikationsserver (z.B. Tomcat) wie gewohnt über die Kommandozeile oder den Dienstemanager.
      Beachten Sie bitte, dass der erste Start nach einem Update länger (mehrere Minuten) dauern kann, da evtl. Aktualisierungs-Jobs oder Formular-Updates den Start verzögern.

Aktualisierung TransferClient

Beachten Sie hierzu die Installationsanleitung des TC: Installation und Aktualisierung

Test der Aktualisierung

1. Testen des Zugriffs auf das VAT@GTC. Loggen Sie sich bitte mit Ihrem Benutzer ein und kontrollieren auf dem Stammdaten → Home Dialog Applikations- und Datenbankversion.
   
   
2. Test Sie die Verbindung zum TransferClient: Einstellungen → Verbindungsparameter → ElsterWebservice → Verbindungstest
   
   
   

3. Informieren Sie Ihre zuständige Fachabteilung, um die notwendigen fachlichen Testfälle durchzuführen.

Abschließende Bemerkungen

Zum Abschluss noch einige Anmerkungen:

1. Falls nach der Aktualisierung Fehler in der Webapplikation auftreten, kontaktieren Sie bitte unseren Support und schicken uns die Logdateien aus dem Unterordner „/logs“ der Tomcatinstallation.

2. Wir möchten empfehlen, eine regelmäßige Sicherung der Datenbank durchzuführen, da diese die Daten der Applikation enthält.
3. Das Deployment muss nicht ständig gesichert werden. Hier reicht es, den Stand bei Auslieferung einer Version bereitzuhalten.
4. Die durchgeführte Konfiguration sollten Sie dokumentieren, damit Anpassungen im Falle von Aktualisierungen des Systems, oder einer Wiederherstellung nachvollzogen werden können. Insbesondere Anpassungen, die abweichend von diesem Dokument vorgenommen wurden, sind zu beachten.

Preconditions

Concluding remarks

After the successful activation of the VAT@GTC installation is completed. The software can be handed over to departments for productive use or functional tests.

And finally:
1.We recommend you to make a regular backup of the database, since it contains application data.

2.The deployment doesn’t have to be constantly secured, it would be enough to keep the status on version delivery.

3.You have to document the carried out configuration to ensure traceability during the system update or recovery. Especially consider the adjustments that deviate from those recommended in this document.