HVS32 Quickstart Guide: Unterschied zwischen den Versionen
Mnh (Diskussion | Beiträge) |
|||
| (37 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
| − | Hier finden Sie Allgemeine Informationen zu | + | [[en:HVS32_Quickstart_Guide_EN]] |
| + | Hier finden Sie Allgemeine Informationen zu HVS32 Komponenten, welche je nach Projekt relevant sind. | ||
| − | + | Dieser Guide soll eine schnelle Übersicht über die HVS32 Komponenten/Dienste und deren Funktionsweisen sowie Voraussetzungen für einen erste Testphase mit dem HVS32 dienen. | |
| − | + | = HVS32-Versandsystem = | |
| − | ===Wichtige Hinweise=== | + | Das HVS32 Versandsystem ist die zentrale Komponente, welche mit nachfolgenden Diensten/Schnittstellen erweitert werden kann. |
| + | |||
| + | Je nach Projektumfang finden Sie entsprechend auch installierte Dienste in Ihren Windowsdiensten wieder. | ||
| + | |||
| + | Der Standard Installationspfad ist C:\Heidler, darunter finden Sie alle Komponenten. | ||
| + | Allgemeine Systemvoraussetzungen für den Betrieb des HVS32 finden Sie hier: [[Systemvoraussetzungen]] | ||
| + | |||
| + | Pro Arbeitsplatz muss eine sog. Versandstation angelegt werden, welche dann Ihre Stationsbezogenen Einstellungen bzgl Drucker etc hat. | ||
| + | Anleitung zur Konfiguration einer neuen Versandstation: [[Neue_Versandstation_anlegen_/_HVS32_Clientinstallation|Neue Versandstation anlegen]] | ||
| + | |||
| + | == Inhaltliche Konfiguration HVS32 == | ||
| + | |||
| + | Zur initialen Konfiguration des HVS32 gehören folgende wichtigste Parts: | ||
| + | |||
| + | '''- Definition der AuftraggeberID's'''<br> | ||
| + | Pro [[Konfigurator:_Auftraggeber/Absender|Auftraggeber / Mandant]] muss eine sog. AuftraggeberID definiert werden, mit welcher im Druckdatensatz dann über die Schnittstelle der richtige Mandant im HVS32 angesteuert wird.<br> | ||
| + | Ein Auftraggeber wird dann im HVS32 pro Frachtführermodul mit seinen Vertragsparametern (Kundennummer, Nummernkreise...) konfiguriert. | ||
| + | |||
| + | '''- Definition der Versandarten'''<br> | ||
| + | Pro anzusprechende Frachtführer/Service Kombination muss eine VersandartID definiert werden (zb "DPD10" für DPD Express 10Uhr), diese Auflistung muss von Ihnen bereitgestellt werden und wird dann im HVS32 konfiguriert.<br> | ||
| + | Die Konfiguration der Versandarten findet ist hier beschrieben: [[Versandarten anlegen]] | ||
| + | |||
| + | '''- Vorbereitung der Frachtführermodul-Konfiguration'''<br> | ||
| + | Zu Beginn des Projektes senden wir Ihnen pro bestelltem Frachtführer ein entsprechendes Formular (sog. Modulvorbereitungsblätter), in welchem wir alle notwendigen Betriebsparameter abfragen welche wir für die Vorbereitung der HVS32 Konfiguration von Ihnen benötigen.<br> | ||
| + | Diese Formulare müssen Sie von Ihren Frachtführern ausfüllen lassen und an uns in die entsprechenden Projekttickets senden, damit die Vorbereitung Ihres Systems erfolgen kann.<br> | ||
| + | Ohne die in den Formularen abgefragten Daten ist eine Konfiguration des Frachtführermodules nicht möglich! | ||
| + | |||
| + | Der Ablauf des Abnahmeprozesses ist hier beschrieben: [[Leitfaden zur Integration neuer Frachtführer]] | ||
| + | |||
| + | '''- Druckerinstallation (bei zentralem Polling)'''<br> | ||
| + | Bei Projekten mit zentralem Polling (Hintergrundbetrieb via "HVS32 Monitoring Dienst") müssen die LAN Drucker zuvor auf dem HVS32 Server installiert sein.<br> | ||
| + | Bei interaktiver Verarbeitung am Packplatz muss die Druckerinstallation entsprechend an diesem durchgeführt werden sodass eine Zuweisung im HVS32 erfolgen kann. | ||
| + | |||
| + | Die Drucker werden wie nachfolgend beschrieben im HVS32 hinterlegt: [[Konfigurator: Ausgabekanäle]] | ||
| + | |||
| + | = HVS32 Komponenten / Dienste = | ||
| + | Nachfolgend eine Übersicht mit jeweiliger Funktionsbeschreibung und wichtigen Hinweisen zu den möglichen (und wichtigsten) HVS32 Komponenten / Dienste, welche je nach System im Einsatz sein können.<br> | ||
| + | Welche Dienste Sie installiert haben sehen Sie u.a. in den Windowsdiensten Ihres HVS32 Servers. | ||
| + | |||
| + | == Firebird Server - DefaultInstance == | ||
| + | '''Wichtige Hinweise''' | ||
| + | *zentraler Datenbankdienst für das HVS32 | ||
| + | *muss immer gestartet sein | ||
| + | *Haupt-Datenbank liegt unter ...HVS32\Database\hvs32.fdb | ||
| + | *Bei Einsatz von [[HVS32 Backup: Grundlegende Empfehlungen|Backupsoftware]] sinnvoll u.a. auch diesen Dienst vor Durchführung des Backups zu stoppen (Achtung: Abhängigkeiten beachten, vorher HVS32-Monitoringdienste etc beenden) | ||
| + | *wenn der Dienst gestoppt ist, kann kein HVS32 gestartet werden (meist Fehlercode .....721) | ||
| + | |||
| + | == HVS32-Monitoring == | ||
| + | |||
| + | Das HVS32-Monitoring ist eine Software, welche HVS32 Versandstationen mit unterschiedlichen Funktionalitäten aufrufen kann und überwacht. | ||
| + | In einem "zentralen Polling" System finden Sie den HVS32 Monitoring Dienst auf Ihrem HVS32 Server.<br> | ||
| + | Der Dienst startet im Hintergrund eine Konfigurierte HVS32 Versandstation (meist "Auto01") und nimmt über die Schnittstelle (Dienst "DataGatewayServer") die Druckdaten entgegen un sendet diese an die zentral installierten LAN Drucker.<br> | ||
| + | Eine detaillierte Beschreibung finden Sie unter [[Monitoring|Beschreibung HVS32 Monitoring]]<br> | ||
| + | <br> | ||
| + | '''Wichtige Hinweise''' | ||
*Wird als Windowsdienst installiert. In der Regel unter dem Namen "HVS32Monitoring" oder "HVS32Monitoring_Versandstationsname", falls mehrere Monitoring Dienste im Einsatz sind. | *Wird als Windowsdienst installiert. In der Regel unter dem Namen "HVS32Monitoring" oder "HVS32Monitoring_Versandstationsname", falls mehrere Monitoring Dienste im Einsatz sind. | ||
*Für den Windowsdienst muss ein Windowsuser hinterlegt werden, welche folgende Eigenschaften hat: | *Für den Windowsdienst muss ein Windowsuser hinterlegt werden, welche folgende Eigenschaften hat: | ||
| Zeile 15: | Zeile 70: | ||
*Der Packplatz, welcher über das Monitoring gestartet wird, benötigt eine HVS32 Workstation Lizenz. | *Der Packplatz, welcher über das Monitoring gestartet wird, benötigt eine HVS32 Workstation Lizenz. | ||
| − | = DataGatewayServer (DGS) V2 (ODBC) = | + | == DataGatewayServer (DGS) V2 (ODBC) == |
| − | |||
| − | |||
| − | + | Der DataGatewayServer V2 wird für die Bereitstellung der Schnittstelle über ODBC verwendet.<br> | |
| + | Es handel sich dabei um einen Windowsdienst. Der DGS v2 wurde Anfang 2021 vom DGS v3 abgelöst.<br> | ||
| + | <br> | ||
| + | '''Wichtige Hinweise''' | ||
*Es werden die Windowsdienste "DataGatewayServer" und "DataGatewayGuardian" installiert. | *Es werden die Windowsdienste "DataGatewayServer" und "DataGatewayGuardian" installiert. | ||
**Der Guardian ist für die Überwachung vom "DataGatewayServer" zuständig. | **Der Guardian ist für die Überwachung vom "DataGatewayServer" zuständig. | ||
*Die Konfiguration vom DGS ist im Hauptverzeichnis in der Datei "settings.xml" gespeichert. | *Die Konfiguration vom DGS ist im Hauptverzeichnis in der Datei "settings.xml" gespeichert. | ||
| − | **Bei Support Anfragen, bzw. Erweiterungswünschen sollte diese Datei zusätzlich per Mail an [ | + | **Bei Support Anfragen, bzw. Erweiterungswünschen sollte diese Datei zusätzlich per Mail an '''''support [at] heidler-strichcode.de''''' gesendet werden. |
| − | + | '''Allgemeines zu den Logs''' | |
*HVS32ClientGateway.log (Wird bei [[Verarbeitung:_Automatik-Polling|Automatik-Polling]] verwendet) | *HVS32ClientGateway.log (Wird bei [[Verarbeitung:_Automatik-Polling|Automatik-Polling]] verwendet) | ||
**Informationen, welche vom DGS an den HVS32 Packplatz gesendet werden. | **Informationen, welche vom DGS an den HVS32 Packplatz gesendet werden. | ||
| Zeile 32: | Zeile 88: | ||
**Informationen, welche vom HVS32 ans DGS gesendet werden. | **Informationen, welche vom HVS32 ans DGS gesendet werden. | ||
| − | = DataGatewayServer (DGS) V3 (SOAP, SAP, E+P, JDBC) = | + | == DataGatewayServer (DGS) V3 (SOAP, SAP, E+P, JDBC) == |
| − | Der DataGatewayServer V3 wird für die | + | Der Dienst DataGatewayServer V3 wird für die Schnittstelle über SOAP, SAP, E+P und JDBC verwendet.<br> |
| − | + | '''Wichtige Hinweise''' | |
*Wird als Windowsdienst "DataGatewayServer" installiert. | *Wird als Windowsdienst "DataGatewayServer" installiert. | ||
*Die Konfiguration vom DGS ist im Hauptverzeichnis im Ordner "config" gespeichert. | *Die Konfiguration vom DGS ist im Hauptverzeichnis im Ordner "config" gespeichert. | ||
| − | **Bei Support Anfragen, bzw. Erweiterungswünschen sollte dieser Ordner (als ZIP) zusätzlich per Mail an [ | + | **Bei Support Anfragen, bzw. Erweiterungswünschen sollte dieser Ordner (als ZIP) zusätzlich per Mail an support[at]heidler-strichcode.de gesendet werden.<br> |
| − | + | '''Allgemeines zu den Logs'''<br> | |
Logs mit dem Namen "server". Z.B. "sapserver.log" | Logs mit dem Namen "server". Z.B. "sapserver.log" | ||
| − | * | + | *Anfragen, welche das DGS über die entsprechende Schnittstelle erhält. Bei Verarbeitungen über [[Verarbeitung:_Automatik-Polling|Automatik-Polling]] ist das Hostsystem der "Server". Z.B. "sapserver.log". Bei interaktive Verarbeitung über [[HVS32_Handbuch#Verarbeitung|Lieferschein-Daten]] oder [[HVS32_Handbuch#Verarbeitung|Adress-Stamm]] ist das HVS32 der "Server" -> "hvs32server.log". |
Logs mit dem Namen "client". Z.B. "hvs32client.log" | Logs mit dem Namen "client". Z.B. "hvs32client.log" | ||
| − | *Anfragen | + | *Anfragen welche das DGS erhalten hat und entsprechend weiter leiten soll. Bei Verarbeitung über [[Verarbeitung:_Automatik-Polling|Automatik-Polling]] ist das HVS32 der Client -> "hvs32client.log". Bei interaktive Verarbeitung über [[HVS32_Handbuch#Verarbeitung|Lieferschein-Daten]] oder [[HVS32_Handbuch#Verarbeitung|Adress-Stamm]] ist das Hostsystem der "client" -> "sapclient.log". |
| + | |||
| + | == Heidler ComManager == | ||
| + | |||
| + | Der Dienst [[HVS32 Communication Manager|Heidler ComManager]] ist verantwortlich für sämtliche Verbindungen zu externen Servern wie zB für die Uploads bei den Tagesabschlüssen.<br> | ||
| + | Somit wird eine Internetverbindung für Tagesabschlüsse lediglich vom HVS32 Server benötigt. | ||
| + | |||
| + | '''Wichtige Hinweise''' | ||
| + | *Wird als Windowsdienst "[[HVS32 Communication Manager|Heidler ComManager]]" installiert. | ||
| + | *Die Konfiguration erfolgt über ...\HVS32\ComManager\ComManager-Configurator.exe | ||
| + | *Verbindung zwischen HVS32 Clients und Server erfolgt via Port 9009 | ||
| + | *Alle Ports für die verwendeten Uploadarten müssen am HVS32 freigegeben sein (FTP 21, SFTP 22, HTTPS 443...). Alle Ports Infos finden Sie in den [[Systemvoraussetzungen]] | ||
| + | |||
| + | = Datensicherung HVS32 Server = | ||
| + | Wichtige Hinweise in Bezug auf Backupprozesse für den HVS32 Server finden Sie hier: [[HVS32_Backup:_Grundlegende_Empfehlungen]] | ||
| + | |||
| + | = Support HVS32 = | ||
| + | Im Rahmen eines aktiven Softwaresupport-Vertrages können Sie Mo-Fr zwischen 8-17Uhr unseren Softwaresupport über die im Vertrag ausgewiesene Rufnummer oder über unser Ticketsystem unter '''''support [at] heidler-strichcode.de''''' erreichen. | ||
| + | *Dabei bitte immer eine aktuelle Systeminformation mitsenden, diese erzeugen Sie im HVS32 unter Setup > Systeminformation (HVS32) | ||
Aktuelle Version vom 18. Oktober 2021, 08:19 Uhr
Hier finden Sie Allgemeine Informationen zu HVS32 Komponenten, welche je nach Projekt relevant sind.
Dieser Guide soll eine schnelle Übersicht über die HVS32 Komponenten/Dienste und deren Funktionsweisen sowie Voraussetzungen für einen erste Testphase mit dem HVS32 dienen.
HVS32-Versandsystem
Das HVS32 Versandsystem ist die zentrale Komponente, welche mit nachfolgenden Diensten/Schnittstellen erweitert werden kann.
Je nach Projektumfang finden Sie entsprechend auch installierte Dienste in Ihren Windowsdiensten wieder.
Der Standard Installationspfad ist C:\Heidler, darunter finden Sie alle Komponenten. Allgemeine Systemvoraussetzungen für den Betrieb des HVS32 finden Sie hier: Systemvoraussetzungen
Pro Arbeitsplatz muss eine sog. Versandstation angelegt werden, welche dann Ihre Stationsbezogenen Einstellungen bzgl Drucker etc hat. Anleitung zur Konfiguration einer neuen Versandstation: Neue Versandstation anlegen
Inhaltliche Konfiguration HVS32
Zur initialen Konfiguration des HVS32 gehören folgende wichtigste Parts:
- Definition der AuftraggeberID's
Pro Auftraggeber / Mandant muss eine sog. AuftraggeberID definiert werden, mit welcher im Druckdatensatz dann über die Schnittstelle der richtige Mandant im HVS32 angesteuert wird.
Ein Auftraggeber wird dann im HVS32 pro Frachtführermodul mit seinen Vertragsparametern (Kundennummer, Nummernkreise...) konfiguriert.
- Definition der Versandarten
Pro anzusprechende Frachtführer/Service Kombination muss eine VersandartID definiert werden (zb "DPD10" für DPD Express 10Uhr), diese Auflistung muss von Ihnen bereitgestellt werden und wird dann im HVS32 konfiguriert.
Die Konfiguration der Versandarten findet ist hier beschrieben: Versandarten anlegen
- Vorbereitung der Frachtführermodul-Konfiguration
Zu Beginn des Projektes senden wir Ihnen pro bestelltem Frachtführer ein entsprechendes Formular (sog. Modulvorbereitungsblätter), in welchem wir alle notwendigen Betriebsparameter abfragen welche wir für die Vorbereitung der HVS32 Konfiguration von Ihnen benötigen.
Diese Formulare müssen Sie von Ihren Frachtführern ausfüllen lassen und an uns in die entsprechenden Projekttickets senden, damit die Vorbereitung Ihres Systems erfolgen kann.
Ohne die in den Formularen abgefragten Daten ist eine Konfiguration des Frachtführermodules nicht möglich!
Der Ablauf des Abnahmeprozesses ist hier beschrieben: Leitfaden zur Integration neuer Frachtführer
- Druckerinstallation (bei zentralem Polling)
Bei Projekten mit zentralem Polling (Hintergrundbetrieb via "HVS32 Monitoring Dienst") müssen die LAN Drucker zuvor auf dem HVS32 Server installiert sein.
Bei interaktiver Verarbeitung am Packplatz muss die Druckerinstallation entsprechend an diesem durchgeführt werden sodass eine Zuweisung im HVS32 erfolgen kann.
Die Drucker werden wie nachfolgend beschrieben im HVS32 hinterlegt: Konfigurator: Ausgabekanäle
HVS32 Komponenten / Dienste
Nachfolgend eine Übersicht mit jeweiliger Funktionsbeschreibung und wichtigen Hinweisen zu den möglichen (und wichtigsten) HVS32 Komponenten / Dienste, welche je nach System im Einsatz sein können.
Welche Dienste Sie installiert haben sehen Sie u.a. in den Windowsdiensten Ihres HVS32 Servers.
Firebird Server - DefaultInstance
Wichtige Hinweise
- zentraler Datenbankdienst für das HVS32
- muss immer gestartet sein
- Haupt-Datenbank liegt unter ...HVS32\Database\hvs32.fdb
- Bei Einsatz von Backupsoftware sinnvoll u.a. auch diesen Dienst vor Durchführung des Backups zu stoppen (Achtung: Abhängigkeiten beachten, vorher HVS32-Monitoringdienste etc beenden)
- wenn der Dienst gestoppt ist, kann kein HVS32 gestartet werden (meist Fehlercode .....721)
HVS32-Monitoring
Das HVS32-Monitoring ist eine Software, welche HVS32 Versandstationen mit unterschiedlichen Funktionalitäten aufrufen kann und überwacht.
In einem "zentralen Polling" System finden Sie den HVS32 Monitoring Dienst auf Ihrem HVS32 Server.
Der Dienst startet im Hintergrund eine Konfigurierte HVS32 Versandstation (meist "Auto01") und nimmt über die Schnittstelle (Dienst "DataGatewayServer") die Druckdaten entgegen un sendet diese an die zentral installierten LAN Drucker.
Eine detaillierte Beschreibung finden Sie unter Beschreibung HVS32 Monitoring
Wichtige Hinweise
- Wird als Windowsdienst installiert. In der Regel unter dem Namen "HVS32Monitoring" oder "HVS32Monitoring_Versandstationsname", falls mehrere Monitoring Dienste im Einsatz sind.
- Für den Windowsdienst muss ein Windowsuser hinterlegt werden, welche folgende Eigenschaften hat:
- Administrative Berechtigungen
- Zugang zu den Druckertreibern
- Das HVS32-Monitoring startet und überwacht einen HVS32 Packplatz. Dieser wird als Hintergrundprozess gestartet.
- Falls der entsprechende HVS32 Packplatz gestartet werden muss, um z.B. Konfigurationseinstellungen vorzunehmen, muss der Monitoring Dienst unbedingt beendet werden.
- Falls für die Testphase der HVS32 Packplatz nicht über den HVS32-Monitoring gestartet werden soll, muss der Port im Konfigurator angepasst werden. In der Regel wird in diesem Fall der Port "5034" benötigt.
- Der Packplatz, welcher über das Monitoring gestartet wird, benötigt eine HVS32 Workstation Lizenz.
DataGatewayServer (DGS) V2 (ODBC)
Der DataGatewayServer V2 wird für die Bereitstellung der Schnittstelle über ODBC verwendet.
Es handel sich dabei um einen Windowsdienst. Der DGS v2 wurde Anfang 2021 vom DGS v3 abgelöst.
Wichtige Hinweise
- Es werden die Windowsdienste "DataGatewayServer" und "DataGatewayGuardian" installiert.
- Der Guardian ist für die Überwachung vom "DataGatewayServer" zuständig.
- Die Konfiguration vom DGS ist im Hauptverzeichnis in der Datei "settings.xml" gespeichert.
- Bei Support Anfragen, bzw. Erweiterungswünschen sollte diese Datei zusätzlich per Mail an support [at] heidler-strichcode.de gesendet werden.
Allgemeines zu den Logs
- HVS32ClientGateway.log (Wird bei Automatik-Polling verwendet)
- Informationen, welche vom DGS an den HVS32 Packplatz gesendet werden.
- ODBCSG.log (Wird bei Automatik-Polling verwendet)
- Informationen, welche Daten von der ODBC-Datenquelle ans DGS gesendet werden.
- HVS32SG.log (Bei interaktive Verarbeitung über Lieferschein-Daten oder Adress-Stamm)
- Informationen, welche vom HVS32 ans DGS gesendet werden.
DataGatewayServer (DGS) V3 (SOAP, SAP, E+P, JDBC)
Der Dienst DataGatewayServer V3 wird für die Schnittstelle über SOAP, SAP, E+P und JDBC verwendet.
Wichtige Hinweise
- Wird als Windowsdienst "DataGatewayServer" installiert.
- Die Konfiguration vom DGS ist im Hauptverzeichnis im Ordner "config" gespeichert.
- Bei Support Anfragen, bzw. Erweiterungswünschen sollte dieser Ordner (als ZIP) zusätzlich per Mail an support[at]heidler-strichcode.de gesendet werden.
- Bei Support Anfragen, bzw. Erweiterungswünschen sollte dieser Ordner (als ZIP) zusätzlich per Mail an support[at]heidler-strichcode.de gesendet werden.
Allgemeines zu den Logs
Logs mit dem Namen "server". Z.B. "sapserver.log"
- Anfragen, welche das DGS über die entsprechende Schnittstelle erhält. Bei Verarbeitungen über Automatik-Polling ist das Hostsystem der "Server". Z.B. "sapserver.log". Bei interaktive Verarbeitung über Lieferschein-Daten oder Adress-Stamm ist das HVS32 der "Server" -> "hvs32server.log".
Logs mit dem Namen "client". Z.B. "hvs32client.log"
- Anfragen welche das DGS erhalten hat und entsprechend weiter leiten soll. Bei Verarbeitung über Automatik-Polling ist das HVS32 der Client -> "hvs32client.log". Bei interaktive Verarbeitung über Lieferschein-Daten oder Adress-Stamm ist das Hostsystem der "client" -> "sapclient.log".
Heidler ComManager
Der Dienst Heidler ComManager ist verantwortlich für sämtliche Verbindungen zu externen Servern wie zB für die Uploads bei den Tagesabschlüssen.
Somit wird eine Internetverbindung für Tagesabschlüsse lediglich vom HVS32 Server benötigt.
Wichtige Hinweise
- Wird als Windowsdienst "Heidler ComManager" installiert.
- Die Konfiguration erfolgt über ...\HVS32\ComManager\ComManager-Configurator.exe
- Verbindung zwischen HVS32 Clients und Server erfolgt via Port 9009
- Alle Ports für die verwendeten Uploadarten müssen am HVS32 freigegeben sein (FTP 21, SFTP 22, HTTPS 443...). Alle Ports Infos finden Sie in den Systemvoraussetzungen
Datensicherung HVS32 Server
Wichtige Hinweise in Bezug auf Backupprozesse für den HVS32 Server finden Sie hier: HVS32_Backup:_Grundlegende_Empfehlungen
Support HVS32
Im Rahmen eines aktiven Softwaresupport-Vertrages können Sie Mo-Fr zwischen 8-17Uhr unseren Softwaresupport über die im Vertrag ausgewiesene Rufnummer oder über unser Ticketsystem unter support [at] heidler-strichcode.de erreichen.
- Dabei bitte immer eine aktuelle Systeminformation mitsenden, diese erzeugen Sie im HVS32 unter Setup > Systeminformation (HVS32)