General installation instructions: Unterschied zwischen den Versionen
Zeile 3: | Zeile 3: | ||
== Update procedure == | == Update procedure == | ||
− | * [[ | + | * [[General installation instructions#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]] |
− | * [[ | + | * [[General installation instructions#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]] |
− | * [[ | + | * [[General installation instructions#Ausf.C3.BChrung des Setups|Ausführung des Setups]] |
− | * [[ | + | * [[General installation instructions#Abschluss der Installation|Abschluss der Installation]] |
− | * [[ | + | * [[General installation instructions#Durchf.C3.BChrung von Funktionstests|Durchführung von Funktionstests]] |
== Lokalisierung vorhandener Installation(en) == | == Lokalisierung vorhandener Installation(en) == | ||
Zeile 15: | Zeile 15: | ||
==== Lokalisierung der Installationen über die Windows-Dienste ==== | ==== Lokalisierung der Installationen über die Windows-Dienste ==== | ||
# Öffnen Sie die Dienste Verwaltung in Windows ( services.msc ) | # Öffnen Sie die Dienste Verwaltung in Windows ( services.msc ) | ||
− | # Suchen Sie anhand der Spalte '''Dienstname''' in der Tabelle unter '''[[ | + | # Suchen Sie anhand der Spalte '''Dienstname''' in der Tabelle unter '''[[General installation instructions#Installationshinweise|Installationshinweise]]''' nach übereinstimmenden Einträgen, beachten Sie, dass bei mehreren installierten Instanzen nur der Teil des Namens enthalten ist (z.B. statt HVS32MonitoringService, HVS32MonitoringService_Auto01 oder HVS32Monitoring_Auto01) |
# Notieren Sie sich den/die unter den Eigenschaften angezeigten Pfad(e) für das spätere Update | # Notieren Sie sich den/die unter den Eigenschaften angezeigten Pfad(e) für das spätere 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]] | ||
Zeile 22: | Zeile 22: | ||
==== Lokalisierung der Installationen über die Windows-Suche ==== | ==== Lokalisierung der Installationen über die Windows-Suche ==== | ||
− | # Geben Sie in der Windows Suche den Namen der gesuchten Applikation (Spalte '''Haupt EXE''' in der Tabelle unter '''[[ | + | # Geben Sie in der Windows Suche den Namen der gesuchten Applikation (Spalte '''Haupt EXE''' in der Tabelle unter '''[[General installation instructions#Installationshinweise|Installationshinweise]]''') ein |
# Prüfen Sie bei den Treffern, dass es sich nicht um ungenutzte lokale Kopien handelt | # Prüfen Sie bei den Treffern, dass es sich nicht um ungenutzte lokale Kopien handelt | ||
# Notieren Sie sich den/die Pfad(e) für das spätere Update | # Notieren Sie sich den/die Pfad(e) für das spätere Update | ||
Zeile 31: | Zeile 31: | ||
{| style="width: 100%;" | {| style="width: 100%;" | ||
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
− | | Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[ | + | | Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[General installation instructions#Installationshinweise|'''Installationshinweise''']]) im Explorer. |
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion | [Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion | ||
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]] | |[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]] | ||
Zeile 38: | Zeile 38: | ||
== Ausführung des Setups == | == Ausführung des Setups == | ||
{| | {| | ||
− | |'''Bitte beachten Sie unbedingt die applikationsbezogenen Hinweise der Tabelle [[ | + | |'''Bitte beachten Sie unbedingt die applikationsbezogenen Hinweise der Tabelle [[General installation instructions#Installationshinweise|Installationshinweise]] 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 [[ | + | Um sich bestmöglich abzusichern, können Vorbereitungen für ein [[General installation instructions#Manuelles Backup - Restore|'''Manuelles 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, '''[[ | + | * Sofern dargestellt, '''[[General installation instructions#Warnmeldungen|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 85: | Zeile 85: | ||
* Nicht im laufenden Betrieb möglich | * Nicht im laufenden Betrieb möglich | ||
* Vor Update den im Windows-Dienst hinterlegten Benutzer notieren und nach dem Update erneut eintragen (Rechtsklick auf den Windows-Dienst > Eigenschaften > Reiter "Anmelden" > "Dieses Konto") | * Vor Update den im Windows-Dienst hinterlegten Benutzer notieren und nach dem Update erneut eintragen (Rechtsklick auf den Windows-Dienst > Eigenschaften > Reiter "Anmelden" > "Dieses Konto") | ||
− | * [[ | + | * [[General installation instructions#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]] |
|- | |- | ||
|Leitcode V3 | |Leitcode V3 | ||
Zeile 106: | Zeile 106: | ||
| | | | ||
* [[Upgrade Firebird Datenbank-Engine|INKOMPATIBEL mit Firebrid 1.5 ! Bei Verwendung von Firebird 1.5 ist vor Update des VerladefreigabeService zwingend ein Firebird Update auf 2.5.x notwendig]] | * [[Upgrade Firebird Datenbank-Engine|INKOMPATIBEL mit Firebrid 1.5 ! Bei Verwendung von Firebird 1.5 ist vor Update des VerladefreigabeService zwingend ein Firebird Update auf 2.5.x notwendig]] | ||
− | * [[ | + | * [[General installation instructions#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]] |
|- | |- | ||
|HFMS | |HFMS | ||
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 [[ | + | * Führen Sie die Punkte [[General installation instructions#Abschluss der Installation|'''Abschluss der Installation''']] und [[General installation instructions#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch |
== Weitere Hinweise == | == Weitere Hinweise == | ||
=== 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 '''[[ | + | Gemäß der Spalte '''Update Hinweise''' in der Tabelle unter '''[[General installation instructions#Installationshinweise|Installationshinweise]]''' 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:15 Uhr
Update procedure
- Lokalisierung vorhandener Installation(en)
- Prüfung der installierten Version
- Ausführung des Setups
- Abschluss der Installation
- Durchführung von Funktionstests
Lokalisierung vorhandener Installation(en)
In der Regel findet die Lokalisierung automatisch im Installer statt. Durch Servermigrationen oder Duplikationen der Instanzen können jedoch die notwendigen Registry-Einträge in vielen Fällen fehlen. Außerdem ist es üblich, dass die Installationen vom DataGatewayServer und den HVS32Monitoring in mehreren Instanzen durchgeführt werden, daher ist es oft unabdingbar, dass die Installationspfade manuell lokalisiert werden.
Lokalisierung der Installationen über die Windows-Dienste
|
|
Lokalisierung der Installationen über die Windows-Suche
|
Prüfung der installierten Version
Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der Haupt EXE der Applikation (siehe Tabelle unter Installationshinweise) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion |
Ausführung des Setups
Bitte beachten Sie unbedingt die applikationsbezogenen Hinweise der Tabelle Installationshinweise 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 Manuelles Backup - Restore durchgeführt werden.
|
Installationshinweise
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 |
|
Warnmeldungen
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!
Beispiel Warnmeldungen
Abschluss der 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 ).
Durchführung von Funktionstests
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!
Manuelles 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 Abschluss der Installation und Durchführung von Funktionstests durch
Weitere Hinweise
Inkompatibilität bei veralteten Systemen (Firebird 1.5)
Gemäß der Spalte Update Hinweise in der Tabelle unter Installationshinweise 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