Wiki - Heidler Strichcode GmbH - Benutzerbeiträge [de]

General installation instructions

2022-02-09T15:58:02Z

Preichert: /* Locate existing installation(s) */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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_Service_path.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Service path]]
|- 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_path.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE path]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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_file_version.png|frameless|mini|Show version]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_not_detected.png|200px|frameless|thumb|Setup Installation not detected]]
*** Enter the installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_detected.png|200px|frameless|thumb|Setup Installation detected]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_show_path.png|200px|frameless|thumb|Setup show path]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_choose_different_path.png|150px|frameless|thumb|Setup choose different path]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* For updates of version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|please also update all plugins]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update_warning_message_1.png|frameless|center|230px|mini|Update warning message 1]]
![[Datei:Update_warning_message_2.png|frameless|center|230px|mini|Update warning message 2]]
![[Datei:Update_warning_message_3.png|frameless|center|230px|mini|Update warning message 3]]
![[Datei:Update_warning_message_4.png|frameless|center|230px|mini|Update warning message 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* Give the backup a comprehensible name, e.g. add the suffix "_bak" and the date to the folder name

'''Restore'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Rename the current application directory, e.g. add the suffix "_error" to the folder name
* Unzip the local backup or rename it back to the original folder name
* Carry out the following steps, [[General installation instructions#Complete installation|'''Complete installation''']] and [[General installation instructions#Perform functional testing|'''Perform functional testing''']]

== Additional notes ==

=== Incompatibility with legacy systems (Firebird 1.5) ===
According to the '''Update notes''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', some services in their latest version are no longer compatible with systems that still use the Firebird database engine in version 1.5.

If you are still using a service that has a correspondingly noted dependency with Firebird, you must not carry out the service update, as this will no longer provide any functionality!

If you are still using Firebird 1.5 and are affected by the service updates mentioned above, your system must first be migrated to Firebird 2.5. For more information see the following article: [[Upgrade Firebird Datenbank-Engine]]

=== Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1 ===
When using SAP JCO and updating this component, it should be noted that all components used by SAP JCO must also be updated. The SAP JCO 3.0 driver uses and requires the Microsoft Visual Studio C/C++ 2005 version, which is installed with the SAP GUI. With the latest SAP JCO 3.1 version, however, the Visual C++ 2013 version is required. If the version is not available, you will receive the following error message from SAP JCO:

''java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries''

More information about SAP JCO at: https://support.sap.com/en/product/connectors/jco.html

General installation instructions

2022-02-09T15:57:00Z

Preichert: /* Verify the installed version */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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_file_version.png|frameless|mini|Show version]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_not_detected.png|200px|frameless|thumb|Setup Installation not detected]]
*** Enter the installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_detected.png|200px|frameless|thumb|Setup Installation detected]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_show_path.png|200px|frameless|thumb|Setup show path]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_choose_different_path.png|150px|frameless|thumb|Setup choose different path]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* For updates of version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|please also update all plugins]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update_warning_message_1.png|frameless|center|230px|mini|Update warning message 1]]
![[Datei:Update_warning_message_2.png|frameless|center|230px|mini|Update warning message 2]]
![[Datei:Update_warning_message_3.png|frameless|center|230px|mini|Update warning message 3]]
![[Datei:Update_warning_message_4.png|frameless|center|230px|mini|Update warning message 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* Give the backup a comprehensible name, e.g. add the suffix "_bak" and the date to the folder name

'''Restore'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Rename the current application directory, e.g. add the suffix "_error" to the folder name
* Unzip the local backup or rename it back to the original folder name
* Carry out the following steps, [[General installation instructions#Complete installation|'''Complete installation''']] and [[General installation instructions#Perform functional testing|'''Perform functional testing''']]

== Additional notes ==

=== Incompatibility with legacy systems (Firebird 1.5) ===
According to the '''Update notes''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', some services in their latest version are no longer compatible with systems that still use the Firebird database engine in version 1.5.

If you are still using a service that has a correspondingly noted dependency with Firebird, you must not carry out the service update, as this will no longer provide any functionality!

If you are still using Firebird 1.5 and are affected by the service updates mentioned above, your system must first be migrated to Firebird 2.5. For more information see the following article: [[Upgrade Firebird Datenbank-Engine]]

=== Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1 ===
When using SAP JCO and updating this component, it should be noted that all components used by SAP JCO must also be updated. The SAP JCO 3.0 driver uses and requires the Microsoft Visual Studio C/C++ 2005 version, which is installed with the SAP GUI. With the latest SAP JCO 3.1 version, however, the Visual C++ 2013 version is required. If the version is not available, you will receive the following error message from SAP JCO:

''java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries''

More information about SAP JCO at: https://support.sap.com/en/product/connectors/jco.html

Datei:ComManager Service path.png

2022-02-09T15:56:32Z

Preichert: ComManager Service path

== Beschreibung ==
ComManager Service path

Datei:ComManager EXE path.png

2022-02-09T15:56:03Z

Preichert: ComManager EXE path

== Beschreibung ==
ComManager EXE path

Datei:ComManager details file version.png

2022-02-09T15:55:39Z

Preichert: ComManager details file version

== Beschreibung ==
ComManager details file version

General installation instructions

2022-02-09T12:18:54Z

Preichert: /* Example warning messages */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_not_detected.png|200px|frameless|thumb|Setup Installation not detected]]
*** Enter the installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_detected.png|200px|frameless|thumb|Setup Installation detected]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_show_path.png|200px|frameless|thumb|Setup show path]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_choose_different_path.png|150px|frameless|thumb|Setup choose different path]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* For updates of version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|please also update all plugins]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update_warning_message_1.png|frameless|center|230px|mini|Update warning message 1]]
![[Datei:Update_warning_message_2.png|frameless|center|230px|mini|Update warning message 2]]
![[Datei:Update_warning_message_3.png|frameless|center|230px|mini|Update warning message 3]]
![[Datei:Update_warning_message_4.png|frameless|center|230px|mini|Update warning message 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* Give the backup a comprehensible name, e.g. add the suffix "_bak" and the date to the folder name

'''Restore'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Rename the current application directory, e.g. add the suffix "_error" to the folder name
* Unzip the local backup or rename it back to the original folder name
* Carry out the following steps, [[General installation instructions#Complete installation|'''Complete installation''']] and [[General installation instructions#Perform functional testing|'''Perform functional testing''']]

== Additional notes ==

=== Incompatibility with legacy systems (Firebird 1.5) ===
According to the '''Update notes''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', some services in their latest version are no longer compatible with systems that still use the Firebird database engine in version 1.5.

If you are still using a service that has a correspondingly noted dependency with Firebird, you must not carry out the service update, as this will no longer provide any functionality!

If you are still using Firebird 1.5 and are affected by the service updates mentioned above, your system must first be migrated to Firebird 2.5. For more information see the following article: [[Upgrade Firebird Datenbank-Engine]]

=== Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1 ===
When using SAP JCO and updating this component, it should be noted that all components used by SAP JCO must also be updated. The SAP JCO 3.0 driver uses and requires the Microsoft Visual Studio C/C++ 2005 version, which is installed with the SAP GUI. With the latest SAP JCO 3.1 version, however, the Visual C++ 2013 version is required. If the version is not available, you will receive the following error message from SAP JCO:

''java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries''

More information about SAP JCO at: https://support.sap.com/en/product/connectors/jco.html

Datei:Update warning message 1.png

2022-02-09T12:18:32Z

Preichert: Preichert lud eine neue Version von Datei:Update warning message 1.png hoch

== Beschreibung ==
Update warning message 1

Datei:Update warning message 4.png

2022-02-09T12:15:20Z

Preichert: Update warning message 4

== Beschreibung ==
Update warning message 4

Datei:Update warning message 3.png

2022-02-09T12:15:02Z

Preichert: Update warning message 3

== Beschreibung ==
Update warning message 3

Datei:Update warning message 2.png

2022-02-09T12:12:51Z

Preichert: Update warning message 2

== Beschreibung ==
Update warning message 2

Datei:Update warning message 1.png

2022-02-09T12:11:56Z

Preichert: Update warning message 1

== Beschreibung ==
Update warning message 1

General installation instructions

2022-02-08T15:59:58Z

Preichert: /* Run the setup */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_not_detected.png|200px|frameless|thumb|Setup Installation not detected]]
*** Enter the installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_detected.png|200px|frameless|thumb|Setup Installation detected]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_show_path.png|200px|frameless|thumb|Setup show path]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_choose_different_path.png|150px|frameless|thumb|Setup choose different path]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* For updates of version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|please also update all plugins]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* Give the backup a comprehensible name, e.g. add the suffix "_bak" and the date to the folder name

'''Restore'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Rename the current application directory, e.g. add the suffix "_error" to the folder name
* Unzip the local backup or rename it back to the original folder name
* Carry out the following steps, [[General installation instructions#Complete installation|'''Complete installation''']] and [[General installation instructions#Perform functional testing|'''Perform functional testing''']]

== Additional notes ==

=== Incompatibility with legacy systems (Firebird 1.5) ===
According to the '''Update notes''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', some services in their latest version are no longer compatible with systems that still use the Firebird database engine in version 1.5.

If you are still using a service that has a correspondingly noted dependency with Firebird, you must not carry out the service update, as this will no longer provide any functionality!

If you are still using Firebird 1.5 and are affected by the service updates mentioned above, your system must first be migrated to Firebird 2.5. For more information see the following article: [[Upgrade Firebird Datenbank-Engine]]

=== Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1 ===
When using SAP JCO and updating this component, it should be noted that all components used by SAP JCO must also be updated. The SAP JCO 3.0 driver uses and requires the Microsoft Visual Studio C/C++ 2005 version, which is installed with the SAP GUI. With the latest SAP JCO 3.1 version, however, the Visual C++ 2013 version is required. If the version is not available, you will receive the following error message from SAP JCO:

''java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries''

More information about SAP JCO at: https://support.sap.com/en/product/connectors/jco.html

General installation instructions

2022-02-08T15:59:17Z

Preichert: /* Run the setup */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_not_detected.png|200px|frameless|thumb|Setup Installation not detected]]
*** Enter the installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_show_path.png|200px|frameless|thumb|Setup show path]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_choose_different_path.png|150px|frameless|thumb|Setup choose different path]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_enter_path.png|200px|frameless|thumb|Setup enter path]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* For updates of version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|please also update all plugins]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* Give the backup a comprehensible name, e.g. add the suffix "_bak" and the date to the folder name

'''Restore'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Rename the current application directory, e.g. add the suffix "_error" to the folder name
* Unzip the local backup or rename it back to the original folder name
* Carry out the following steps, [[General installation instructions#Complete installation|'''Complete installation''']] and [[General installation instructions#Perform functional testing|'''Perform functional testing''']]

== Additional notes ==

=== Incompatibility with legacy systems (Firebird 1.5) ===
According to the '''Update notes''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', some services in their latest version are no longer compatible with systems that still use the Firebird database engine in version 1.5.

If you are still using a service that has a correspondingly noted dependency with Firebird, you must not carry out the service update, as this will no longer provide any functionality!

If you are still using Firebird 1.5 and are affected by the service updates mentioned above, your system must first be migrated to Firebird 2.5. For more information see the following article: [[Upgrade Firebird Datenbank-Engine]]

=== Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1 ===
When using SAP JCO and updating this component, it should be noted that all components used by SAP JCO must also be updated. The SAP JCO 3.0 driver uses and requires the Microsoft Visual Studio C/C++ 2005 version, which is installed with the SAP GUI. With the latest SAP JCO 3.1 version, however, the Visual C++ 2013 version is required. If the version is not available, you will receive the following error message from SAP JCO:

''java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries''

More information about SAP JCO at: https://support.sap.com/en/product/connectors/jco.html

Datei:Setup Installation detected.png

2022-02-08T15:55:18Z

Preichert: Setup Installation detected

== Beschreibung ==
Setup Installation detected

Datei:Setup show path.png

2022-02-08T15:53:56Z

Preichert: Setup show path

== Beschreibung ==
Setup show path

Datei:Setup choose different path.png

2022-02-08T15:53:37Z

Preichert: Setup choose different path

== Beschreibung ==
Setup choose different path

Datei:Setup enter path.png

2022-02-08T15:53:19Z

Preichert: Setup enter path

== Beschreibung ==
Setup enter path

Datei:Setup Installation not detected.png

2022-02-08T15:53:04Z

Preichert: Setup Installation not detected

== Beschreibung ==
Setup Installation not detected

General installation instructions

2022-02-08T15:37:20Z

Preichert: /* Installation instructions */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Enter the installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_anderes_Verzeichnis_waehlen.png|150px|frameless|thumb|Setup anderes Verzeichnis wählen]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* For updates of version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|please also update all plugins]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* Give the backup a comprehensible name, e.g. add the suffix "_bak" and the date to the folder name

'''Restore'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Rename the current application directory, e.g. add the suffix "_error" to the folder name
* Unzip the local backup or rename it back to the original folder name
* Carry out the following steps, [[General installation instructions#Complete installation|'''Complete installation''']] and [[General installation instructions#Perform functional testing|'''Perform functional testing''']]

== Additional notes ==

=== Incompatibility with legacy systems (Firebird 1.5) ===
According to the '''Update notes''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', some services in their latest version are no longer compatible with systems that still use the Firebird database engine in version 1.5.

If you are still using a service that has a correspondingly noted dependency with Firebird, you must not carry out the service update, as this will no longer provide any functionality!

If you are still using Firebird 1.5 and are affected by the service updates mentioned above, your system must first be migrated to Firebird 2.5. For more information see the following article: [[Upgrade Firebird Datenbank-Engine]]

=== Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1 ===
When using SAP JCO and updating this component, it should be noted that all components used by SAP JCO must also be updated. The SAP JCO 3.0 driver uses and requires the Microsoft Visual Studio C/C++ 2005 version, which is installed with the SAP GUI. With the latest SAP JCO 3.1 version, however, the Visual C++ 2013 version is required. If the version is not available, you will receive the following error message from SAP JCO:

''java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries''

More information about SAP JCO at: https://support.sap.com/en/product/connectors/jco.html

General installation instructions

2022-02-08T15:36:48Z

Preichert: /* Installation instructions */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Enter the installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_anderes_Verzeichnis_waehlen.png|150px|frameless|thumb|Setup anderes Verzeichnis wählen]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* Für Updates von Version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|please also update all plugins]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* Give the backup a comprehensible name, e.g. add the suffix "_bak" and the date to the folder name

'''Restore'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Rename the current application directory, e.g. add the suffix "_error" to the folder name
* Unzip the local backup or rename it back to the original folder name
* Carry out the following steps, [[General installation instructions#Complete installation|'''Complete installation''']] and [[General installation instructions#Perform functional testing|'''Perform functional testing''']]

== Additional notes ==

=== Incompatibility with legacy systems (Firebird 1.5) ===
According to the '''Update notes''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', some services in their latest version are no longer compatible with systems that still use the Firebird database engine in version 1.5.

If you are still using a service that has a correspondingly noted dependency with Firebird, you must not carry out the service update, as this will no longer provide any functionality!

If you are still using Firebird 1.5 and are affected by the service updates mentioned above, your system must first be migrated to Firebird 2.5. For more information see the following article: [[Upgrade Firebird Datenbank-Engine]]

=== Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1 ===
When using SAP JCO and updating this component, it should be noted that all components used by SAP JCO must also be updated. The SAP JCO 3.0 driver uses and requires the Microsoft Visual Studio C/C++ 2005 version, which is installed with the SAP GUI. With the latest SAP JCO 3.1 version, however, the Visual C++ 2013 version is required. If the version is not available, you will receive the following error message from SAP JCO:

''java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries''

More information about SAP JCO at: https://support.sap.com/en/product/connectors/jco.html

General installation instructions

2022-02-08T15:35:54Z

Preichert: /* Manual Backup - Restore */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Enter the installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_anderes_Verzeichnis_waehlen.png|150px|frameless|thumb|Setup anderes Verzeichnis wählen]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* Für Updates von Version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|Bitte auch alle Plugins aktualisieren]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* Give the backup a comprehensible name, e.g. add the suffix "_bak" and the date to the folder name

'''Restore'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Rename the current application directory, e.g. add the suffix "_error" to the folder name
* Unzip the local backup or rename it back to the original folder name
* Carry out the following steps, [[General installation instructions#Complete installation|'''Complete installation''']] and [[General installation instructions#Perform functional testing|'''Perform functional testing''']]

== Additional notes ==

=== Incompatibility with legacy systems (Firebird 1.5) ===
According to the '''Update notes''' column in the table under '''[[General installation instructions#Installation instructions|Installation instructions]]''', some services in their latest version are no longer compatible with systems that still use the Firebird database engine in version 1.5.

If you are still using a service that has a correspondingly noted dependency with Firebird, you must not carry out the service update, as this will no longer provide any functionality!

If you are still using Firebird 1.5 and are affected by the service updates mentioned above, your system must first be migrated to Firebird 2.5. For more information see the following article: [[Upgrade Firebird Datenbank-Engine]]

=== Upgrade from SAP Java Connector (SAP JCO) 3.0 to 3.1 ===
When using SAP JCO and updating this component, it should be noted that all components used by SAP JCO must also be updated. The SAP JCO 3.0 driver uses and requires the Microsoft Visual Studio C/C++ 2005 version, which is installed with the SAP GUI. With the latest SAP JCO 3.1 version, however, the Visual C++ 2013 version is required. If the version is not available, you will receive the following error message from SAP JCO:

''java.lang.ExceptionInInitializerError: JCo initialization failed with java.lang.UnsatisfiedLinkError: <Pfad>\sapjco3.dll: Can't find dependent libraries''

More information about SAP JCO at: https://support.sap.com/en/product/connectors/jco.html

Allgemeine Installationshinweise

2022-02-08T15:26:04Z

Preichert: /* Manuelles Backup - Restore */

[[en:General_installation_instructions]]

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update im laufendem Betrieb nicht möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update im laufendem Betrieb nicht möglich
* 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)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update im laufendem Betrieb nicht möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
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 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

General installation instructions

2022-02-08T15:25:48Z

Preichert: /* Warning messages */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Enter the installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_anderes_Verzeichnis_waehlen.png|150px|frameless|thumb|Setup anderes Verzeichnis wählen]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* Für Updates von Version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|Bitte auch alle Plugins aktualisieren]]
|}

== Warning messages ==
During the installation, warning messages are displayed, e.g. that a database conversion is being carried out during the update or that further manual steps are required after the installation.

'''The warnings and the information contained therein must be observed!'''

==== Example warning messages ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== Complete installation ==
At the end of the installation, it must be checked that the application was started or can be started again after the update.

For services, check whether the service was started after installation or start the service manually in the Windows service management ( services.msc ).

== Perform functional testing ==
To ensure that an update was successful, function tests tailored to the application are necessary!

'''The tests must not only be carried out on the test system, but also in the productive environment!'''
== Manual Backup - Restore ==
For a rollback, local backup copies of the applications can be created, which should be deleted again after a successful update and function test.

'''Backup'''

* Close all applications (configurators, processing screens, services, ...) of the corresponding software product
* Make a local copy by either creating an archive or duplicating the installation directory
* 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 [[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) ===
Gemäß der Spalte '''Update notes''' 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!

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

Allgemeine Installationshinweise

2022-02-08T15:14:42Z

Preichert: /* Installationshinweise */

[[en:General_installation_instructions]]

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update im laufendem Betrieb nicht möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update im laufendem Betrieb nicht möglich
* 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)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update im laufendem Betrieb nicht möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
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 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

General installation instructions

2022-02-08T15:12:18Z

Preichert: /* Run the setup */

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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 (e.g. 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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''Please note the application-related information in the [[General installation instructions#Installation instructions|Installation instructions]] table in the ''Update notes''''' '''column.'''
If you have an HVS32 test system/test server, install the updates on the test system first!

To be as safe as possible, preparations can be made for a [[General installation instructions#Manual Backup - Restore|'''Manual Backup - Restore''']].

* Start setup with administrative privileges (right click -> Run as administrator)
* Selection of the installation path
** No installation was detected [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Enter the installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
** At least one installation was detected [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Compare the installation path with the previously created list (mark the question mark with the mouse) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** If the installation path matches, confirm with '''Next'''
**** If the installation path does not match, select the option '''"No, install into a different directory"''' [[Datei:Setup_anderes_Verzeichnis_waehlen.png|150px|frameless|thumb|Setup anderes Verzeichnis wählen]] and confirm with '''Next'''
***** Enter the correct installation path [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] and confirm with '''Next'''
* If presented, '''[[General installation instructions#Warning messages|read warning messages carefully]]''', if anything is unclear, talk internally to project managers about the possible effects of the update
* Confirm further screens within the setup with '''Next'''
* Allow the installation and subsequent processes (such as a database conversion) to complete fully
* Complete the installation with '''Finish'''

If an application has been installed in several instances (to be recognized by the fact that several installation paths were previously found for a software product), which is often the case with the applications DataGatewayServer and HVS32Monitoring. The installation must be executed for each instance into the manually adjusted target path (e.g. first installation = C:\Heidler\HVS32MonitoringService_Auto01, second installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Software product
!Service name
!Main EXE
!Versions
!Update notes
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Update not possible during operation
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* Update not possible during operation
* Before the update, make a note of the user stored in the Windows service and enter it after the update (Right-click on the Windows service > Properties > "Log On" tab > "This account")
* [[General installation instructions#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Update not possible during operation
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[Upgrade Firebird Datenbank-Engine|INCOMPATIBLE with Firebird 1.5! When using Firebird 1.5, a Firebird update to 2.5.x is mandatory before updating the StatusdatenManager-Service]]
* [[General installation instructions#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Update of SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Update is not possible during operation if the SPM plugin is used
* Für Updates von Version <= 1.6.4: [[Plugin installieren / aktualisieren (Tarifwerk)|Bitte auch alle Plugins aktualisieren]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[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) ===
Gemäß der Spalte '''Update notes''' 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!

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

General installation instructions

2022-02-08T14:46:56Z

Preichert:

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Run the setup|Run the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Run the setup ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[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
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[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) ===
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!

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

General installation instructions

2022-02-08T14:40:19Z

Preichert:

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[General installation instructions#Locate existing installation.28s.29|Locate existing installation(s)]]
* [[General installation instructions#Verify the installed version|Verify the installed version]]
* [[General installation instructions#Running the setup|Running the setup]]
* [[General installation instructions#Complete installation|Complete installation]]
* [[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="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: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]]
|}

== Verify the installed version ==
{| style="width: 100%;"
|- 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]]
|}

== Running the setup ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installation instructions ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[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
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[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) ===
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!

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

General installation instructions

2022-02-08T14:15:51Z

Preichert:

[[de:Allgemeine_Installationshinweise]]

== 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) ==
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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Öffnen Sie die Dienste Verwaltung in Windows ( services.msc )
# 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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 '''[[General installation instructions#Installationshinweise|Installationshinweise]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| 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
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[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
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[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 ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
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!

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

General installation instructions

2022-02-08T14:13:44Z

Preichert:

[[de:Allgemeine_Installationshinweise]]

== Update procedure ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
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 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

Allgemeine Installationshinweise

2022-02-08T14:11:43Z

Preichert:

[[en:General_installation_instructions]]

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
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 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

General installation instructions

2022-02-08T14:11:19Z

Preichert:

[[de:Allgemeine_Installationshinweise]]

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
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 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

Allgemeine Installationshinweise

2022-02-08T14:10:03Z

Preichert: /* Aktualisierung vom SAP Java Connector (SAP JCO) 3.0 auf 3.1 */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
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 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

Allgemeine Installationshinweise

2022-02-08T14:08:51Z

Preichert: /* Inkompatibilität bei veralteten Systemen (Firebird 1.5) */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
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 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 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

Allgemeine Installationshinweise

2022-02-08T14:05:59Z

Preichert: /* Manuelles Backup - Restore */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 [[Allgemeine Installationshinweise#Abschluss der Installation|'''Abschluss der Installation''']] und [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|'''Durchführung von Funktionstests''']] durch

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Allgemeine Installationshinweise

2022-02-08T14:01:45Z

Preichert: /* Ausführung des Setups */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''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!

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)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* 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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

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, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Allgemeine Installationshinweise

2022-02-08T13:49:03Z

Preichert: /* Lokalisierung der Installationen über die Windows-Suche */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''') ein
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Allgemeine Installationshinweise

2022-02-08T13:47:51Z

Preichert: /* Lokalisierung der Installationen über die Windows-Dienste */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|

==== 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]]''')
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Allgemeine Installationshinweise

2022-02-08T13:47:06Z

Preichert: /* Lokalisierung vorhandener Installation(en) */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|
==== Lokalisierung der Installationen über die Windows-Dienste ====
# Ö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 übereinstimmt (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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|
==== 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]]''')
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Allgemeine Installationshinweise

2022-02-08T13:43:53Z

Preichert: /* Ausführung des Setups */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|Auffinden der Installationen über die Windows-Dienste
# Ö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 übereinstimmt (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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|Auffinden 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]]''')
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation erkannt [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Allgemeine Installationshinweise

2022-02-08T13:43:30Z

Preichert: /* Ausführung des Setups */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|Auffinden der Installationen über die Windows-Dienste
# Ö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 übereinstimmt (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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|Auffinden 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]]''')
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation erkannt [[Datei:Setup_Installation_nicht_erkannt.png|200px|frameless|thumb|Setup Installation nicht erkannt]]
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation gefunden [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Datei:Setup Installation nicht erkannt.png

2022-02-08T13:42:15Z

Preichert: Setup Installation nicht erkannt

== Beschreibung ==
Setup Installation nicht erkannt

Allgemeine Installationshinweise

2022-02-08T13:13:04Z

Preichert: /* Ausführung des Setups */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|Auffinden der Installationen über die Windows-Dienste
# Ö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 übereinstimmt (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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|Auffinden 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]]''')
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation gefunden
*** Den Installationspfad eingeben [[Datei:Setup_Pfad_eingeben.png|200px|frameless|thumb|Setup Pfad eingeben]] und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation gefunden [[Datei:Setup_Installation_erkannt.png|200px|frameless|thumb|Setup Installation erkannt]]
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (Fragezeichen mit der Maus markieren) [[Datei:Setup_Pfad_anzeigen.png|200px|frameless|thumb|Setup Pfad anzeigen]]
**** Stimmt der Installationspfad überein, 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
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Datei:Setup Pfad eingeben.png

2022-02-08T13:11:30Z

Preichert: Setup Pfad eingeben

== Beschreibung ==
Setup Pfad eingeben

Datei:Setup anderes Verzeichnis waehlen.png

2022-02-08T13:08:03Z

Preichert: Setup anderes Verzeichnis wählen

== Beschreibung ==
Setup anderes Verzeichnis wählen

Datei:Setup Pfad anzeigen.png

2022-02-08T13:04:55Z

Preichert: Setup Pfad anzeigen

== Beschreibung ==
Setup Pfad anzeigen

Datei:Setup Installation erkannt.png

2022-02-08T13:01:08Z

Preichert: Setup Installation erkannt

== Beschreibung ==
Setup Installation erkannt

General installation instructions

2022-02-08T12:50:18Z

Preichert: Die Seite wurde neu angelegt: „.“

Allgemeine Installationshinweise

2022-02-08T12:21:17Z

Preichert: /* Abschluss der Installation */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|Auffinden der Installationen über die Windows-Dienste
# Ö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 übereinstimmt (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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|Auffinden 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]]''')
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation gefunden
*** Den Installationspfad eingeben und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation gefunden
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (siehe Screenshot)
**** Stimmt der Installationspfad überein, mit '''Weiter''' bestätigen
**** Stimmt der Installationspfad nicht überein, die Option '''"Nein, installiere in ein anderes Verzeichnis"''' wählen und mit '''Weiter''' bestätigen
***** Den richtigen Installationspfad eingeben und mit '''Weiter''' bestätigen
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Allgemeine Installationshinweise

2022-02-08T12:07:29Z

Preichert: /* Durchführung von Funktionstests */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|Auffinden der Installationen über die Windows-Dienste
# Ö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 übereinstimmt (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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|Auffinden 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]]''')
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation gefunden
*** Den Installationspfad eingeben und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation gefunden
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (siehe Screenshot)
**** Stimmt der Installationspfad überein, mit '''Weiter''' bestätigen
**** Stimmt der Installationspfad nicht überein, die Option '''"Nein, installiere in ein anderes Verzeichnis"''' wählen und mit '''Weiter''' bestätigen
***** Den richtigen Installationspfad eingeben und mit '''Weiter''' bestätigen
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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 ====
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== 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 wurden 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 erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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

Allgemeine Installationshinweise

2022-02-08T10:10:20Z

Preichert: /* Lokalisierung vorhandener Installation(en) */

== Vorgehensweise bei Updates ==

* [[Allgemeine Installationshinweise#Lokalisierung vorhandener Installation.28en.29|Lokalisierung vorhandener Installation(en)]]
* [[Allgemeine Installationshinweise#Pr.C3.BCfung der installierten Version|Prüfung der installierten Version]]
* [[Allgemeine Installationshinweise#Ausf.C3.BChrung des Setups|Ausführung des Setups]]
* [[Allgemeine Installationshinweise#Abschluss der Installation|Abschluss der Installation]]
* [[Allgemeine Installationshinweise#Durchf.C3.BChrung von Funktionstests|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.
{| style="width:100%"
|style="vertical-align:top;"|Auffinden der Installationen über die Windows-Dienste
# Ö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 übereinstimmt (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
|style="vertical-align:middle;"|[[Datei:ComManager Dienst Pfad.png|alternativtext=ComManager Dienst Pfad|frameless|center|200px|mini|ComManager Dienst Pfad]]
|- style="vertical-align:top;"
|Auffinden 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]]''')
# 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
|style="vertical-align:middle;"|[[Datei:ComManager EXE Pfad.png|alternativtext=ComManager EXE Pfad|frameless|center|300px|mini|ComManager EXE Pfad]]
|}

== Prüfung der installierten Version ==
{| style="width: 100%;"
|- style="vertical-align:top;"
| Zur Prüfung der Version, öffnen Sie die Datei-Eigenschaften von der '''Haupt EXE''' der Applikation (siehe Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|'''Installationshinweise''']]) im Explorer.
[Applikation].exe -> Rechtsklick -> Eigenschaften -> Details -> Dateiversion / Produktversion
|[[Datei:Commanager details-dateiversion.png|frameless|mini|Version anzeigen]]
|}

== Ausführung des Setups ==
{|
|'''Bitte beachten Sie unbedingt die Applikationsbezogenen Update Hinweise in entsprechender Spalte der Tabelle unter [[Allgemeine Installationshinweise#Installationshinweise|Installationshinweise]].'''
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.

* Setup mit administrativen Berechtigungen starten (Rechtsklick -> Als Administrator ausführen)
* Auswahl des Installationspfades
** Es wurde keine Installation gefunden
*** Den Installationspfad eingeben und mit '''Weiter''' bestätigen
** Es wurde mindestens eine Installation gefunden
*** Den Installationspfad mit der zuvor erstellten Liste abgleichen (siehe Screenshot)
**** Stimmt der Installationspfad überein, mit '''Weiter''' bestätigen
**** Stimmt der Installationspfad nicht überein, die Option '''"Nein, installiere in ein anderes Verzeichnis"''' wählen und mit '''Weiter''' bestätigen
***** Den richtigen Installationspfad eingeben und mit '''Weiter''' bestätigen
* Mögliche '''[[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
* Die Installation sowie nachgelagerte Prozesse (z.B. eine Datenbankkonvertierung) komplett durchführen lassen
* Die Installation mit '''Fertigstellen''' beenden

Sollte eine Applikation in mehreren Instanzen installiert worden sein (zu erkennen, daran, dass zu einer Applikationen zuvor mehrere Installationspfade gefunden wurden), was unteranderem bei den Applikationen DataGatewayServer und HVS32Monitoring oft der Fall ist. Muss die Installation pro Instanz mit jeweils manuell korrigierten Zielpfad durchgeführt werden (z.B. erste Installation = C:\Heidler\HVS32MonitoringService_Auto01, zweite Installation = C:\Heidler\HVS32MonitoringService_Auto02, ...)
|
|}

== Installationshinweise ==
{| class="wikitable" style="width:100%;"
!Softwareprodukt
!Dienstname
!Haupt EXE
!Versionen
!Update Hinweise
|-
|DataGatewayServer V2
|DataGatewayGuardian
DataGatewayServer
|DataGatewayService.exe
|2.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|DataGatewayServer V3
|DataGatewayServer
|DataGatewayService.exe
|3.X.X.X
|
* 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")
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|Leitcode V3
|Heidler-Leitcode
|HeidlerLeitcode-Service.exe
|3.X.X.X
|
* Nicht im laufenden Betrieb möglich
|-
|SEMWeb
|Heidler-SEMWeb
|SEMWebService.exe
|1.X.X.X
|
|-
|Statusdatenamanger
|Heidler-StatusdatenManager
|StatusdatenManager-Service.exe
|1.X.X.X
|
* [[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]]
* [[Allgemeine Installationshinweise#Aktualisierung vom SAP Java Connector .28SAP JCO.29 3.0 auf 3.1|Aktualisierung vom SAP Java Connector (SAP JCO)]]
|-
|HFMS
|Heidler-TarifWerk
|TarifWerk-Service.exe
|1.X.X.X
|
* Nicht im laufenden Betrieb 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]]
|}

== 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!

== 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 wurden 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!'''
{| style="width:100%"
![[Datei:Update Warnmeldung 1.png|frameless|center|230px|mini|Update Warnmeldung 1]]
![[Datei:Update Warnmeldung 2.png|frameless|center|230px|mini|Update Warnmeldung 2]]
![[Datei:Update Warnmeldung 3.png|frameless|center|230px|mini|Update Warnmeldung 3]]
![[Datei:Update Warnmeldung 4.png|frameless|center|230px|mini|Update Warnmeldung 4]]
|}

== Manuelles Backup - Restore ==
Für ein Rollback können von den Applikationen lokale Sicherungskopien erstellt werden, die nach erfolgreichen 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
* Bennen 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
* Bennen Sie das aktuelle Applikationsverzeichnis um, hängen Sie dazu z.B. den Suffix "_error" and den Ordnernamen an
* Entpacken Sie bzw. benennen Sie die lokale Sicherungskopie auf die ursprüngliche Ordnerbezeichnung um
* 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

== Weitere Hinweise ==

=== Inkompatibilität bei veralteten Systemen (Firebird 1.5) ===
Gemäß der Spalte "Update Hinweise" o.g. Tabelle 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 ist!

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 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