Globale Einstellungen GTNet

Work in Progress

Die Implementierung von GTNet ist noch nicht vollständig abgeschlossen. Diese Dokumentation beschreibt die geplante und teilweise bereits umgesetzte Funktionalität.

Die GTNet-Funktionalität wird über spezifische globale Parameter gesteuert. Diese Parameter befinden sich in der Ansicht Globale Einstellungen. Sie tragen zwei unterschiedliche Präfixe: «g.gnet» für die Parameter der GTNet-Infrastruktur selbst und «gt.gtnet» für jene, die den Austausch von Kursdaten betreffen.

Vom Administrator verwaltete Parameter

Diese Parameter können vom Administrator konfiguriert werden, um das Verhalten von GTNet anzupassen.

g.gnet.use

Aktiviert oder deaktiviert die gesamte GTNet-Funktionalität. Ein Wert von 0 bedeutet deaktiviert, ein Wert ungleich 0 aktiviert GTNet. Standardmässig ist GTNet deaktiviert. Ohne diese Aktivierung findet kein Datenaustausch mit anderen Instanzen statt.

g.gnet.use.log

Steuert die Protokollierung des Datenaustauschs. Wenn aktiviert (Wert ungleich 0), werden alle Austauschvorgänge zwischen den Instanzen aufgezeichnet. Diese Protokolle können in der Ansicht Austauschprotokoll eingesehen werden. Die Protokollierung ist standardmässig deaktiviert und kann für Diagnosezwecke oder zur Überwachung der Netzwerkaktivität aktiviert werden.

g.gnet.connection.timeout

Legt fest, wie viele Sekunden Ihr Server beim Kontakt mit einer anderen Instanz wartet, bevor er den Versuch als fehlgeschlagen betrachtet. Der Standardwert beträgt 30 Sekunden, der gültige Bereich liegt zwischen 5 und 40 Sekunden. Einer einzelnen Instanz kann in der Ansicht GTNet und Nachrichten ein eigener Timeout zugewiesen werden; dieser globale Parameter gilt für alle Instanzen, für die kein eigener Wert erfasst wurde.

gt.gtnet.lastprice.delay.seconds

Definiert eine zusätzliche Verzögerung in Sekunden für die Berechnung des Frischeschwellenwerts bei Letztpreisanfragen. Dieser Wert wird zusammen mit dem Watchlist-Timeout verwendet, um zu bestimmen, ob ein empfangener Preis noch aktuell genug ist. Preise, die älter als (aktuelle Zeit - Watchlist-Timeout - dieser Verzögerungswert) sind, werden als veraltet abgelehnt. Der Standardwert beträgt 300 Sekunden (5 Minuten).

gt.gtnet.quote.retry

Legt fest, wie viele zusätzliche Versuche über GTNet erfolgen, sobald der konfigurierte Konnektor sein Wiederholungslimit «gt.history.retry» bzw. «gt.intra.retry» erreicht hat. Bis zu diesem zusätzlichen Budget übernimmt GTNet die Aktualisierung der Kursdaten, ohne den Wiederholungszähler des Konnektors auf 0 zurückzusetzen. Dadurch bleibt der Ausfall des Konnektors für die Überwachung sichtbar, während der Benutzer weiterhin Kursdaten erhält. Der Standardwert ist 8, der gültige Bereich beträgt 0 bis 50. Eine ausführliche Beschreibung des Verhaltens finden Sie unter Wiederholungszähler und GTNet-Fallback.

g.gnet.del.message.recv

Steuert die Aufbewahrungsdauer für empfangene Austauschnachrichten im PropertyString-Format. Das Format ist «LP=Tage,HP=Tage,SL=Tage», wobei:

LP (LastPrice): Anzahl Tage, bevor Letztpreis-Austauschnachrichten (Codes 60, 61) gelöscht werden
HP (HistoryPrice): Anzahl Tage, bevor historische Preisaustauschnachrichten (Codes 80, 81) gelöscht werden
SL (SecurityLookup): Anzahl Tage, bevor Nachrichten zur Instrumentensuche (Codes 90 bis 95) gelöscht werden

Der gültige Bereich für alle drei Werte ist 1-10 Tage. Der Standardwert ist «LP=1,HP=5,SL=5», was bedeutet, dass Letztpreis-Nachrichten nach 1 Tag sowie historische Preisnachrichten und Nachrichten zur Instrumentensuche nach jeweils 5 Tagen gelöscht werden. Diese Bereinigung wird durch die Hintergrundaufgabe 22 durchgeführt.

g.gnet.log.aggregate.days

Steuert die Schwellenwerte für die Aggregation von Austauschprotokollen im PropertyString-Format. Das Format ist «D=Tage,W=Tage,M=Tage,Y=Tage», wobei:

D: Anzahl Tage, bevor einzelne Einträge zu täglichen Zusammenfassungen aggregiert werden
W: Anzahl Tage, bevor tägliche Einträge zu wöchentlichen aggregiert werden
M: Anzahl Tage, bevor wöchentliche Einträge zu monatlichen aggregiert werden
Y: Anzahl Tage, bevor monatliche Einträge zu jährlichen aggregiert werden

Der Standardwert ist «D=1,W=7,M=30,Y=365». Diese Aggregation wird durch die Hintergrundaufgabe 22 durchgeführt.

Vom System verwaltete Parameter

Diese Parameter werden automatisch vom System gesetzt und sollten nicht manuell geändert werden.

g.gnet.my.entry.id

Enthält die eindeutige ID der eigenen Instanz im GTNet. Dieser Wert wird automatisch gesetzt, wenn der eigene Server in der Ansicht GTNet und Nachrichten eingetragen wird. Die ID dient als Referenz für die Identifikation der eigenen Instanz im Netzwerk.

In seltenen Fällen bleibt dieser Parameter beim Erfassen des eigenen Servers leer oder behält einen alten Wert. Grafioschtrader erkennt den eigenen Eintrag daran, dass die erfasste URL auf eine Adresse des Rechners zeigt, auf dem die Applikation läuft. Läuft sie in einem Container oder hinter einer Adressumsetzung, kennt sie nur die Adresse dieser Umgebung und nicht jene, unter der sie von aussen erreichbar ist; der Abgleich schlägt dann fehl, ohne dass eine Meldung erscheint. Dasselbe gilt nach dem Einspielen der persönlichen Daten einer anderen Instanz, denn dabei wird dieser Parameter mit übernommen, die Serverliste dagegen nicht – er zeigt anschliessend auf einen Eintrag, den es hier gar nicht gibt.

Erkennbar ist das daran, dass in der Ansicht GTNet und Nachrichten weiterhin der rote Hinweis auf die notwendige Eintragung des eigenen Servers steht, obwohl dieser bereits erfasst wurde. Der Parameter wird dann von Hand auf die ID des eigenen Eintrags gesetzt. Diese ID nennt der Tooltip der Spalte URL in der Server-Übersicht; sie steht dort vor der URL. Nach der Änderung empfiehlt sich ein Neustart der Applikation, damit der eigene Eintrag wieder als «Online» geführt wird.

Anmerkung

Die URL eines Eintrags lässt sich nachträglich nicht mehr ändern. Wurde der eigene Server mit einer falschen Adresse erfasst, muss der Eintrag gelöscht und neu angelegt werden. Löschen lässt er sich erst, wenn dieser Parameter nicht mehr auf ihn zeigt.

gt.gtnet.exchange.sync.timestamp

Speichert den Zeitstempel der letzten erfolgreichen Synchronisation der austauschbaren Entitäten. Dieser Wert wird automatisch aktualisiert, nachdem ein Synchronisationsvorgang abgeschlossen wurde. Er wird verwendet, um zu ermitteln, welche Einträge seit der letzten Synchronisation geändert wurden.

Statussynchronisation zwischen Servern

GTNet hält die Serverstatusinformationen automatisch zwischen verbundenen Instanzen synchron. Dieser Abschnitt erklärt, wann Statusänderungen an Remote-Server gesendet werden und wann Updates von Remote-Servern Ihre Instanz erreichen.

Ausgehende Statusänderungen (Ihr Server → Remote-Server)

Statusänderungen Ihres Servers werden an alle Remote-Server gesendet, mit denen eine etablierte Kommunikation besteht (abgeschlossener Handshake mit ausgetauschten Tokens).

Automatische Broadcasts

Ereignis	Nachrichtentyp	Auslöser
Server-Start	Server ist jetzt online	Wenn die Anwendung startet und GTNet aktiviert ist (`g.gnet.use` > 0)
Server-Stopp	Server ist jetzt offline	Wenn die Anwendung ordnungsgemäss heruntergefahren wird
Auslastungsänderung	Server ist ausgelastet / Server ist nicht mehr ausgelastet	Wenn das Kontrollkästchen «Nutzung eingeschränkt» in GTNet und Nachrichten geändert wird
Einstellungsänderung	Einstellungen aktualisiert	Wenn Einstellungen wie Tägliches Anfragelimit, Anfrage akzeptieren, Server-Status oder Max. Limit in GTNet und Nachrichten geändert werden

Manuelle Broadcasts

Die folgenden Statusnachrichten können manuell über das Kontextmenü in der Ansicht GTNet und Nachrichten gesendet werden:

Nachrichtentyp	Zweck
Server befindet sich während des Zeitraums im Wartungsmodus	Ankündigung eines geplanten Wartungsfensters mit «Beginn» und «Ende»
Wartung abgesagt	Absage eines zuvor angekündigten Wartungsfensters
Der Serverbetrieb wird ab diesem Datum eingestellt	Ankündigung der dauerhaften Einstellung des Dienstes mit Wirksamkeitsdatum
Betriebseinstellung abgesagt	Absage einer zuvor angekündigten Einstellung

Wie diese Nachrichten erfasst werden und wie sich die Gegenparts danach richten, ist unter Wartung und Betriebseinstellung beschrieben.

Eingehende Statusänderungen (Remote-Server → Ihr Server)

Ihr Server empfängt Statusaktualisierungen von Remote-Servern auf zwei Arten:

1. Explizite Statusnachrichten

Wenn ein Remote-Server eine Statusänderung sendet (online, offline, ausgelastet, Wartung usw.), empfängt und speichert Ihr Server diese Nachricht. Diese Nachrichten sind in der Nachrichtenhistorie der Ansicht GTNet und Nachrichten sichtbar.

2. Automatische Einstellungssynchronisation

Jede von einem Remote-Server empfangene Nachricht enthält die aktuelle GTNet-Konfiguration des Absenders im Nachrichtenumschlag. Ihr Server extrahiert und aktualisiert automatisch die Einstellungen des Remote-Servers aus diesem Umschlag, wodurch sichergestellt wird, dass:

Tägliche Anfragelimits immer aktuell sind
Anfrage-Akzeptanz-Status (Geschlossen, Offen, Push-Offen) synchronisiert sind
Server-Status (Keine, Offen, Push-Offen) auf dem neuesten Stand sind
Maximale Instrumentenlimits aktuell sind

Das bedeutet, dass auch ohne explizite Statusnachrichten Ihre lokale Kopie der Einstellungen eines Remote-Servers durch regelmässige Kommunikation synchron bleibt.

Server-Lebenszyklus-Ereignisse

Anwendungsstart

Wenn Ihr GT-Server startet:

Wenn g.gnet.use aktiviert ist (Wert > 0), wird die GTNet-Funktionalität aktiviert
Eine «Server ist jetzt online»-Nachricht wird automatisch an alle verbundenen Peers gesendet
Remote-Server aktualisieren ihre Aufzeichnungen, um Ihren Server als online anzuzeigen

Anwendungsstopp

Wenn Ihr GT-Server ordnungsgemäss heruntergefahren wird:

Eine «Server ist jetzt offline»-Nachricht wird automatisch an alle verbundenen Peers gesendet
Remote-Server aktualisieren ihre Aufzeichnungen, um Ihren Server als offline anzuzeigen

Anmerkung

Wenn der Server abstürzt oder gewaltsam beendet wird, kann die Offline-Nachricht nicht gesendet werden. In diesem Fall erkennen Remote-Server die Nichtverfügbarkeit erst, wenn sie versuchen zu kommunizieren und keine Antwort erhalten.

Praktische Auswirkungen

Für Administratoren

Änderungen im GTNet und Nachrichten-Bearbeitungsdialog werden sofort an alle verbundenen Peers gesendet
Keine manuelle Aktion erforderlich, um Peers über Konfigurationsänderungen zu informieren
Die Nachrichtenhistorie zeigt sowohl gesendete als auch empfangene Statusnachrichten für Prüfzwecke

Für Netzwerkteilnehmer

Ihr Server respektiert automatisch die aktuellen Limits und Status von Remote-Servern
Wenn ein Remote-Server ausgelastet wird, reduziert Ihr Server die Anfragehäufigkeit
Wenn ein Remote-Server offline geht, werden keine Anfragen versucht, bis er wieder online ist