Fallbeispiel

In diesem Fallbeispiel wird schrittweise die Einrichtung der automatischen Aktualisierung des Clients gezeigt. Um einen vollständigen Ablauf zu demonstrieren, wird zunächst auf die klassische Weise eine Aktualisierung der Server- und Client-Anwendung durchgeführt. Dabei wird der Client allerdings dahingehend vorbereitet, dass für folgende Updates eine automatische Aktualisierung erfolgen kann.

Ausgangspunkt

  • Server in Version 4.2.0.0 installiert
  • Clients in Version 4.2.0.0 installiert
  • Der Client und Server ist nicht für die Verwendung der automatischen Aktualisierung eingerichtet
  • Auslieferungen mit der Version 5.0.0.0 und 5.0.1.0 stehen zur Verfügung
  • Der Server ist unter der Adresse stbserver01 und dem Port 55555 erreichbar
  • Die Client-Anwendung soll als erweiterten Fenstertitel "Produktiv" darstellen

Klassische Aktualisierung der Server- und Client-Anwendung

Aktualisieren Sie die derzeit installierte Version 4.2.0.0 der Server- und Client-Anwendung auf die Version 5.0.0.0 gemäß der Anweisungen im Kapitel Aktualisierung.

Führen Sie in jedem Fall die Deinstallation des Clients in der Version 4.2.0.0 aus. Dazu sind eventuell administrative Rechte erforderlich.

Führen Sie die Installation der Client-Anwendung in der Version 5.0.0.0 unter dem Benutzer aus, der später die Anwendung bedient und auch die automatische Aktualisierung anstoßen wird. Aktivieren Sie die Option "Automatische Aktualisierung verwenden". Wählen sie im Schritt "Installationsumfang" die Option "Nur für mich installieren".

Prüfen Sie die Installation, indem Sie die Anweisungen in den Kapiteln Inbetriebnahme Client und Inbetriebnahme Server befolgen.

Bereitstellung der Folgeversion

Ihnen steht nun die Version 5.0.1.0 zur Verfügung. Der nächste Abschnitt führt die notwendigen Schritte für die Bereitstellung auf.

Aktualisierung und Einrichtung des Servers

  1. Folgen Sie den Anweisungen im Kapitel Aktualisierung bis einschließlich des Abschnitts "Installation der Server-Anwendung"
  2. Achten Sie darauf, in der Installationsroutine die Option "Automatische Aktualisierung verwenden" zu aktivieren
  3. Erstellen Sie eine Datei update.yml und fügen Sie folgenden Inhalt ein:

    steps:
     - kill: SmartTax
     - msiexec: /i $sourcePath$\SmartTaxBalanceClient-Release-5.0.1.0.msi /qb! /L*v install.log USESERVER=True SERVERADDRESS=stbserver01 SERVERPORT=55555
     - xmlFile: file=$targetPath$\Config\appSettings.config, action=setValue, elementPath=appSettings/add[@key='SystemCaptionExtension'], name=value, value=Produktiv
     - start: $targetPath$SmartTax.exe
  4. Erstellen Sie ein ZIP-Archiv mit dem Namen Client.zip und fügen Sie die eben erstellte Datei update.yml und das MSI-Paket des Clients (SmartTaxBalance-Release-5.0.1.0.msi) hinzu.
  5. Legen Sie das ZIP-Archiv in das Installationsverzeichnis der Server-Anwendung in den Unterordner AutoUpdate.
  6. Öffnen Sie die Konfigurationsdatei appSettings.config und setzen Sie der Wert der Einstellung AutoUpdaterFilename auf den absoluten Pfad des ZIP-Archivs, z.B. C:\Program Files (x86)\AMANA Consulting\SmartTaxBalanceServer\AutoUpdate\Client.zip.

    Eine relative Angabe des Pfades hat zu Problemen geführt, daher wird empfohlen, den Pfad absolut anzugeben.

  7. Folgen Sie den Anweisungen im Kapitel Inbetriebnahme Server

Aktualisierung der Client-Anwendung

Starten Sie die Anwendung zunächst nur auf einem Anwendungsrechner, um eventuelle Fehler frühzeitig zu erkennen und beheben zu können. Die vorgeschaltete Aktualisierung wird ausgeführt und die Client-Anwendung wird von Version 5.0.0.0 auf die Version 5.0.1.0 aktualisiert. 

Sollte es zu einem Fehler während der Aktualisierung kommen, kann in der Log-Datei nach der Ursache gesucht werden. Der Ort der Log-Datei ist in der Datei Update.exe.config hinterlegt.

Darüber hinaus schreibt der Schritt, welcher die MSI-Installation vornimmt, eine Log-Datei install.log.