General installation instructions: Unterschied zwischen den Versionen
Zeile 3: | Zeile 3: | ||
== Update procedure == | == Update procedure == | ||
− | * [[General installation instructions# | + | * [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]] |
− | * [[General installation instructions# | + | * [[General installation instructions#Verify the installed version|Verify the installed version]] |
− | * [[General installation instructions# | + | * [[General installation instructions#Running the setup|Running the setup]] |
− | * [[General installation instructions# | + | * [[General installation instructions#Complete installation|Complete installation]] |
− | * [[General installation instructions# | + | * [[General installation instructions#Perform functional testing|Perform functional testing]] |
− | == | + | == Locate existing installation(s) == |
− | + | The localization usually takes place automatically in the installer. In many cases, however, the necessary registry entries may be missing due to server migrations or instance duplications. It is also common for DataGatewayServer and HVS32Monitoring to be installed in multiple instances, so it is often essential that the installation paths are localized manually. | |
{| style="width:100%" | {| style="width:100%" | ||
|style="vertical-align:top;"| | |style="vertical-align:top;"| | ||
− | ==== | + | ==== Localization of installations via Windows services ==== |
− | # | + | # Open the Services Management in Windows ( services.msc ) |
− | # | + | # Look for matching entries using the '''Service name''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', note that if there are multiple instances installed, only a part ot the name is included (eg. instead of HVS32MonitoringService, HVS32MonitoringService_Auto01 or HVS32Monitoring_Auto01) |
− | # | + | # Make a note of the path(s) displayed under Properties for later update |
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]] | |style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]] | ||
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
| | | | ||
− | ==== | + | ==== Localization of installations via Windows search ==== |
− | # | + | # Enter the name of the application you are looking for in the Windows search (column '''Main EXE''' in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''') ein |
− | # | + | # Make sure the hits are not unused local copies |
− | # | + | # Make a note of the path(s) for later update |
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]] | |style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]] | ||
|} | |} | ||
− | == | + | == Verify the installed version == |
{| style="width: 100%;" | {| style="width: 100%;" | ||
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
− | | | + | | To verify the version, open the file properties of the '''Main EXE''' of the application (see table under [[General installation instructions#Installation instructions|'''Installation instructions''']]) in Explorer. |
− | [ | + | [application].exe -> Right click -> Properties -> Details -> File version / Product version |
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]] | |[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]] | ||
|} | |} | ||
− | == | + | == Running the setup == |
{| | {| | ||
− | |'''Bitte beachten Sie unbedingt die applikationsbezogenen Hinweise der Tabelle [[General installation instructions# | + | |'''Bitte beachten Sie unbedingt die applikationsbezogenen Hinweise der Tabelle [[General installation instructions#Installation instructions|Installation instructions]] in der Spalte ''Update Hinweise''.''' |
Sollten Sie über ein HVS32 Testsystem/Testserver verfügen, spielen Sie die Updates zuerst auf dem Testsystem ein! | Sollten Sie über ein HVS32 Testsystem/Testserver verfügen, spielen Sie die Updates zuerst auf dem Testsystem ein! | ||
− | Um sich bestmöglich abzusichern, können Vorbereitungen für ein [[General installation instructions# | + | Um sich bestmöglich abzusichern, können Vorbereitungen für ein [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']] durchgeführt werden. |
* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen) | * Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen) | ||
Zeile 52: | Zeile 52: | ||
**** Stimmt der Installationspfad nicht überein, die Option '''"Nein, installiere in ein anderes Verzeichnis"''' wählen [[Datei:Setup_anderes_Verzeichnis_waehlen.png|150px|frameless|thumb|Setup anderes Verzeichnis wählen]] und mit '''Weiter''' bestätigen | **** Stimmt der Installationspfad nicht überein, die Option '''"Nein, installiere in ein anderes Verzeichnis"''' wählen [[Datei:Setup_anderes_Verzeichnis_waehlen.png|150px|frameless|thumb|Setup anderes Verzeichnis wählen]] und mit '''Weiter''' bestätigen | ||
***** Den richtigen Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen | ***** Den richtigen Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen | ||
− | * Sofern dargestellt, '''[[General installation instructions# | + | * Sofern dargestellt, '''[[General installation instructions#Warning messages|Warnmeldungen genau durchlesen]]''', bei Unklarheiten intern mit Projektverantwortlichen über mögliche Auswirkungen des Updates sprechen |
* Weitere Abfragen innerhalb des Setups mit '''Weiter''' bestätigen | * Weitere Abfragen innerhalb des Setups mit '''Weiter''' bestätigen | ||
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen | * Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen | ||
Zeile 62: | Zeile 62: | ||
|} | |} | ||
− | == | + | == Installation instructions == |
{| class="wikitable" style="width:100%;" | {| class="wikitable" style="width:100%;" | ||
!Softwareprodukt | !Softwareprodukt | ||
Zeile 117: | Zeile 117: | ||
|} | |} | ||
− | == | + | == Warning messages == |
Mit Hilfe von Warnmeldungen wir bei der Installation angezeigt, das z.B. während des Updates eine Datenbankkonvertierung durchgeführt wird oder weitere manuelle Schritte nach der Installation erforderlich sind. | Mit Hilfe von Warnmeldungen wir bei der Installation angezeigt, das z.B. während des Updates eine Datenbankkonvertierung durchgeführt wird oder weitere manuelle Schritte nach der Installation erforderlich sind. | ||
'''Die Warnmeldungen sowie darin enthaltene Hinweise sind genau zu beachten!''' | '''Die Warnmeldungen sowie darin enthaltene Hinweise sind genau zu beachten!''' | ||
− | ==== | + | ==== Example warning messages ==== |
{| style="width:100%" | {| style="width:100%" | ||
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]] | ![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]] | ||
Zeile 130: | Zeile 130: | ||
|} | |} | ||
− | == | + | == Complete installation == |
Zum Abschluss der Installation muss überprüft werden, dass die Applikation nach dem Update gestartet wurde bzw. wieder gestartet werden kann. | Zum Abschluss der Installation muss überprüft werden, dass die Applikation nach dem Update gestartet wurde bzw. wieder gestartet werden kann. | ||
Prüfen Sie dazu bei Diensten, ob der Dienst nach der Installation gestartet wurde bzw. starten Sie den Dienst manuell in der Dienste Verwaltung in Windows ( services.msc ). | Prüfen Sie dazu bei Diensten, ob der Dienst nach der Installation gestartet wurde bzw. starten Sie den Dienst manuell in der Dienste Verwaltung in Windows ( services.msc ). | ||
− | == | + | == Perform functional testing == |
Um sicherzustellen, dass ein Update erfolgreich war, sind auf die Anwendung abgestimmte Funktionstests notwendig! | Um sicherzustellen, dass ein Update erfolgreich war, sind auf die Anwendung abgestimmte Funktionstests notwendig! | ||
'''Die Durchführung der Test muss nicht nur auf dem Testsystem, sondern auch in der produktiven Umgebung erfolgen!''' | '''Die Durchführung der Test muss nicht nur auf dem Testsystem, sondern auch in der produktiven Umgebung erfolgen!''' | ||
− | == | + | == Manual Backup - Restore == |
Für ein Rollback können von den Applikationen lokale Sicherungskopien erstellt werden, die nach erfolgreichem Update und Funktionstests wieder gelöscht werden sollten. | Für ein Rollback können von den Applikationen lokale Sicherungskopien erstellt werden, die nach erfolgreichem Update und Funktionstests wieder gelöscht werden sollten. | ||
Zeile 153: | Zeile 153: | ||
* Benennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" an den Ordnernamen an | * Benennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" an den Ordnernamen an | ||
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung zurück | * Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung zurück | ||
− | * Führen Sie die Punkte [[General installation instructions# | + | * Führen Sie die Punkte [[General installation instructions#Complete installation|'''Complete installation''']] und [[General installation instructions#Perform functional testing|'''Perform functional testing''']] durch |
− | == | + | == Additional notes == |
=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) === | === Inkompatibilität bei veralteten Systemen (Firebird 1.5) === | ||
− | Gemäß der Spalte '''Update Hinweise''' in der Tabelle unter '''[[General installation instructions# | + | Gemäß der Spalte '''Update Hinweise''' in der Tabelle unter '''[[General installation instructions#Installation instructions|Installation instructions]]''' sind einige Dienste in Ihrer neuesten Version nicht mehr kompatibel mit Systemen, welche noch die Datenbankengine Firebird in Version 1.5 einsetzen. |
Sollten Sie also noch einen Dienst im Einsatz haben, welcher entsprechend notierte Abhängigkeit mit Firebird hat, dürfen Sie das Dienstupdate nicht durchführen, da dadurch keine Funktionalität mehr gegeben sein wird! | Sollten Sie also noch einen Dienst im Einsatz haben, welcher entsprechend notierte Abhängigkeit mit Firebird hat, dürfen Sie das Dienstupdate nicht durchführen, da dadurch keine Funktionalität mehr gegeben sein wird! |
Version vom 8. Februar 2022, 16:40 Uhr
Update procedure
- Locate existing installation(s)
- Verify the installed version
- Running the setup
- Complete installation
- Perform functional testing
Locate existing installation(s)
The localization usually takes place automatically in the installer. In many cases, however, the necessary registry entries may be missing due to server migrations or instance duplications. It is also common for DataGatewayServer and HVS32Monitoring to be installed in multiple instances, so it is often essential that the installation paths are localized manually.
Localization of installations via Windows services
|
|
Localization of installations via Windows search
|
Verify the installed version
To verify the version, open the file properties of the Main EXE of the application (see table under Installation instructions) in Explorer.
[application].exe -> Right click -> Properties -> Details -> File version / Product version |
Running the setup
Bitte beachten Sie unbedingt die applikationsbezogenen Hinweise der Tabelle Installation instructions in der Spalte Update Hinweise.
Sollten Sie über ein HVS32 Testsystem/Testserver verfügen, spielen Sie die Updates zuerst auf dem Testsystem ein! Um sich bestmöglich abzusichern, können Vorbereitungen für ein Manual Backup - Restore durchgeführt werden.
|
Installation instructions
Softwareprodukt | Dienstname | Haupt EXE | Versionen | Update Hinweise |
---|---|---|---|---|
DataGatewayServer V2 | DataGatewayGuardian
DataGatewayServer |
DataGatewayService.exe | 2.X.X.X |
|
DataGatewayServer V3 | DataGatewayServer | DataGatewayService.exe | 3.X.X.X |
|
Leitcode V3 | Heidler-Leitcode | HeidlerLeitcode-Service.exe | 3.X.X.X |
|
SEMWeb | Heidler-SEMWeb | SEMWebService.exe | 1.X.X.X | |
Statusdatenamanger | Heidler-StatusdatenManager | StatusdatenManager-Service.exe | 1.X.X.X | |
HFMS | Heidler-TarifWerk | TarifWerk-Service.exe | 1.X.X.X |
|
Warning messages
Mit Hilfe von Warnmeldungen wir bei der Installation angezeigt, das z.B. während des Updates eine Datenbankkonvertierung durchgeführt wird oder weitere manuelle Schritte nach der Installation erforderlich sind.
Die Warnmeldungen sowie darin enthaltene Hinweise sind genau zu beachten!
Example warning messages
Complete installation
Zum Abschluss der Installation muss überprüft werden, dass die Applikation nach dem Update gestartet wurde bzw. wieder gestartet werden kann.
Prüfen Sie dazu bei Diensten, ob der Dienst nach der Installation gestartet wurde bzw. starten Sie den Dienst manuell in der Dienste Verwaltung in Windows ( services.msc ).
Perform functional testing
Um sicherzustellen, dass ein Update erfolgreich war, sind auf die Anwendung abgestimmte Funktionstests notwendig!
Die Durchführung der Test muss nicht nur auf dem Testsystem, sondern auch in der produktiven Umgebung erfolgen!
Manual Backup - Restore
Für ein Rollback können von den Applikationen lokale Sicherungskopien erstellt werden, die nach erfolgreichem Update und Funktionstests wieder gelöscht werden sollten.
Backup
- Beenden Sie alle Anwendungen (Konfiguratoren, Verarbeitungsmasken, Dienste, ...) des entsprechenden Softwareprodukts
- Erstellen Sie eine lokale Kopie, in dem Sie entweder ein Archiv erstellen oder den Installationsverzeichnis duplizieren
- Benennen Sie die Sicherung mir einer nachvollziehbaren Bezeichnung, hängen Sie dazu z.B. den Suffix "_bak" und das Datum an den Ordnernamen an
Restore
- Beenden Sie alle Anwendungen (Konfiguratoren, Verarbeitungsmasken, Dienste, ...) des entsprechenden Softwareprodukts
- Benennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" an den Ordnernamen an
- Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung zurück
- Führen Sie die Punkte Complete installation und Perform functional testing durch
Additional notes
Inkompatibilität bei veralteten Systemen (Firebird 1.5)
Gemäß der Spalte Update Hinweise in der Tabelle unter Installation instructions sind einige Dienste in Ihrer neuesten Version nicht mehr kompatibel mit Systemen, welche noch die Datenbankengine Firebird in Version 1.5 einsetzen.
Sollten Sie also noch einen Dienst im Einsatz haben, welcher entsprechend notierte Abhängigkeit mit Firebird hat, dürfen Sie das Dienstupdate nicht durchführen, da dadurch keine Funktionalität mehr gegeben sein wird!
Setzen Sie noch Firebird 1.5 ein und sind von o.g. Dienst-Updates betroffen, muss Ihr System zuvor auf Firebird 2.5 migriert werden. Weitere Informationen sehen Sie in folgendem Artikel: Upgrade Firebird Datenbank-Engine
Aktualisierung vom SAP Java Connector (SAP JCO) 3.0 auf 3.1
Bei der Verwendung vom SAP JCO und Aktualisierung dieser Komponente ist darauf zu achten, dass alle Komponenten, welcher der SAP JCO verwendet ebenfalls aktualisiert werden müssen. So nutzt und setzt der SAP JCO 3.0 Treiber die Microsoft Visual Studio C/C++ 2005 Version voraus, welche mit der SAP GUI installiert wird. Bei der aktuellsten SAP JCO 3.1 Version wird jedoch die Visual C++ 2013 Version benötigt. Sollte die Version nicht vorhanden sein, so erhält man vom SAP JCO die folgende Fehlermeldung:
java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries
Weitere Infos zum SAP JCO unter: https://support.sap.com/en/product/connectors/jco.html