Allgemeine Installationshinweise: Unterschied zwischen den Versionen
(8 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
Zeile 1: | Zeile 1: | ||
+ | [[en:General_installation_instructions]] | ||
+ | |||
== Vorgehensweise bei Updates == | == Vorgehensweise bei Updates == | ||
Zeile 13: | 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 '''[[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]]''' nach übereinstimmenden Einträgen, beachten Sie, dass bei mehreren installierten Instanzen nur der Teil des Namens | + | # Suchen Sie anhand der Spalte '''Dienstname''' in der Tabelle unter '''[[Allgemeine Installationshinweise#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]] | ||
|- style="vertical-align:top;" | |- style="vertical-align:top;" | ||
| | | | ||
+ | |||
==== 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 '''[[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]]''') | + | # Geben Sie in der Windows Suche den Namen der gesuchten Applikation (Spalte '''Haupt EXE''' in der Tabelle unter '''[[Allgemeine Installationshinweise#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 35: | Zeile 38: | ||
== Ausführung des Setups == | == Ausführung des Setups == | ||
{| | {| | ||
− | |'''Bitte beachten Sie unbedingt die | + | |'''Bitte beachten Sie unbedingt die applikationsbezogenen Hinweise der Tabelle [[Allgemeine Installationshinweise#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 [[Allgemeine Installationshinweise#Manuelles Backup - Restore|'''Manuelles Backup - Restore''']] durchgeführt werden. | + | Um sich bestmöglich abzusichern, können Vorbereitungen für ein [[Allgemeine Installationshinweise#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 49: | 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, '''[[Allgemeine Installationshinweise#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 55: | Zeile 58: | ||
− | Sollte eine Applikation in mehreren Instanzen installiert worden sein ( | + | Sollte eine Applikation in mehreren Instanzen installiert worden sein (zuerkennen daran, dass zu einem Softwareprodukt zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz unter den jeweils manuell angepassten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...) |
| | | | ||
|} | |} | ||
Zeile 73: | Zeile 76: | ||
|2.X.X.X | |2.X.X.X | ||
| | | | ||
− | * | + | * Update im laufendem Betrieb nicht möglich |
|- | |- | ||
|DataGatewayServer V3 | |DataGatewayServer V3 | ||
Zeile 80: | Zeile 83: | ||
|3.X.X.X | |3.X.X.X | ||
| | | | ||
− | * | + | * Update im laufendem Betrieb nicht möglich |
− | * Vor Update den im Windows-Dienst hinterlegten Benutzer notieren | + | * Vor Update den im Windows-Dienst hinterlegten Benutzer notieren und nach dem Update eintragen (Rechtsklick auf den Windows-Dienst > Eigenschaften > Reiter "Anmelden" > "Dieses Konto") |
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]] | * [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]] | ||
|- | |- | ||
Zeile 89: | Zeile 92: | ||
|3.X.X.X | |3.X.X.X | ||
| | | | ||
− | * | + | * Update im laufendem Betrieb nicht möglich |
|- | |- | ||
|SEMWeb | |SEMWeb | ||
Zeile 102: | Zeile 105: | ||
|1.X.X.X | |1.X.X.X | ||
| | | | ||
− | * [[Upgrade Firebird Datenbank-Engine|INKOMPATIBEL mit Firebrid 1.5 ! Bei Verwendung von Firebird 1.5 ist vor Update des | + | * [[Upgrade Firebird Datenbank-Engine|INKOMPATIBEL mit Firebrid 1.5 ! Bei Verwendung von Firebird 1.5 ist vor Update des StatusdatenManager-Service ein Firebird Update auf 2.5.x notwendig]] |
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]] | * [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]] | ||
|- | |- | ||
Zeile 110: | Zeile 113: | ||
|1.X.X.X | |1.X.X.X | ||
| | | | ||
− | * | + | * Update im laufendem Betrieb nicht möglich, sofern das Plugin SPM verwendet wird |
* Für Updates von Version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|Bitte auch alle Plugins aktualisieren]] | * Für Updates von Version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|Bitte auch alle Plugins aktualisieren]] | ||
|} | |} | ||
Zeile 137: | Zeile 140: | ||
'''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!''' | ||
== Manuelles Backup - Restore == | == Manuelles Backup - Restore == | ||
− | Für ein Rollback können von den Applikationen lokale Sicherungskopien erstellt werden, die nach | + | 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''' | '''Backup''' | ||
− | * Beenden Sie alle Anwendungen (Konfiguratoren, Verarbeitungsmasken, Dienste) des entsprechenden Softwareprodukts | + | * 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 | + | * Erstellen Sie eine lokale Kopie, in dem Sie entweder ein Archiv erstellen oder den Installationsverzeichnis duplizieren |
− | * | + | * Benennen Sie die Sicherung mit einer nachvollziehbaren Bezeichnung, hängen Sie dazu z.B. den Suffix "_bak" und das Datum an den Ordnernamen an |
'''Restore''' | '''Restore''' | ||
− | * Beenden Sie alle Anwendungen (Konfiguratoren, Verarbeitungsmasken, Dienste) des entsprechenden Softwareprodukts | + | * 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 | + | * Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung zurück |
* Führen Sie die Punkte [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch | * Führen Sie die Punkte [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch | ||
Zeile 155: | Zeile 158: | ||
=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) === | === Inkompatibilität bei veralteten Systemen (Firebird 1.5) === | ||
− | Gemäß der Spalte | + | Gemäß der Spalte '''Update Hinweise''' in der Tabelle unter '''[[Allgemeine Installationshinweise#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 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 | + | 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]] | 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 === | === 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 folgende Fehlermeldung: | + | 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'' | ''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 | Weitere Infos zum SAP JCO unter: https://support.sap.com/en/product/connectors/jco.html |
Aktuelle Version vom 8. Februar 2022, 17:26 Uhr
Vorgehensweise bei Updates
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 mit 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