Wo finde ich die Log-Dateien von antony?

Die Log-Dateien von antony liegen im %LOCALAPPDATA% Verzeichnis des ausführenden Benutzers. Für das Lesen der Log-Dateien ist ein spezielles Programm notwendig. Eine Anleitung gibt es dafür hier Server Protokolle / Logs

Ich bekomme eine Fehlermeldung beim Start “Could not compile skeleton”

Diese Fehlermeldung tritt sporadisch auf und wird im Splash-Screen von antony angezeigt. Es gibt dafür folgende Lösungsansätze:

• Für gewöhnlich kann dieses Problem durch Abmelden und erneutes Anmelden der Windows Sitzung behoben werden.

• Dieses Problem reproduzierbar auf, wenn das System auf Englisch eingestellt ist. Das Problem ist, dass die lokalisierte Assembly ist und der generierte Skeleton-Code einen Syntax Fehler aufweist.

  • Workarround: Löschen der Datei “en/SCOM.Antony.EICP.resources.dll” im Programmverzeichnis

  • Das Problem ist dauerhaft gelöst ab antony >=

    Status
    colour Yellow title 2.22.121

Der Benutzer sieht keine Dokumentenvorlagen im Kontakt, Tab Dokumente

Diese Fehlermeldung tritt auf wenn die rückwirkende Berechtigungen für das Modul Dokumente nicht ausgeführt wurde

• Für gewöhnlich kann dieses Problem durch nachträgliche rückwirkende Berechtigung erledigt werden. Dazu im Administrator auf “Rückwirkende Berechtigungen”, Dokumente und als Zeitraum “Alle” auswählen

...

antony kann ein Update nur manuell installieren. Woran liegt das?

Es kann verschiedene Ursachen haben, wieso ein Update nicht automatisch installiert werden kann. Hier einige Punkte, welche geprüft werden können.

• Ist das Setup zugreifbar?

  • antony prüft, ob an der im Administrator definierten Stelle ein Setup zu finden ist. Ist dies nicht der Fall, kann kein automatisches Update verfolgen. Die Einstellung ist zu finden im Administrator unter Grundeinstellungen 1️⃣ und lautet Remote antony Updatepfad 2️⃣

  • Ist der Pfad nicht zugreifbar, ist das Problem gefunden und kann gelöst werden

...

• Ist das automatische Update auf dem Client aktiviert?

  • Das automatische Update kann pro Client deaktiviert werden. Standardmäßig ist diese Funktion aktiviert. Um dies zu prüfen, kann der Registierungsschlüssel unter HKCU\Software\SCOM\antony\installationAutoUpdateEnabled verwendet werden. Steht dieser auf '1' ist das automatische Update aktiviert.

  • Ist dieser auf 0, kann wie folgt vorgangen werden. Dafür im Administrator unter Benutzerverwaltung > Arbeitsstationen. Dort muss nun die Arbeitsstation herausgesucht werden. Verwendet wird der Name des PCs Wird diese gesetzt, muss der Client neugestartet werden. Der Wert in der Registrierung ändert sich anschließend

...

• Gibt es mehrere antony Installationen im Netzwerk?

  • Wenn es mehrere, parallele antony Installtionen in ein und dem gleichen Netzwerk befinden, so verbinden diese sich untereinander. Typisches Szenario ist eine Testumgebung, welche direkt beim Kunden läuft (Beispielsweise ein Klon). Ist dies der Fall kann endweder eine Update-Endlosschleife auftreten oder das Update kann nicht manuell durchgeführt werden.

  • Um dies zu prüfen, kann das Tool MulticastSniffer eingesetzt werden. Dieser befindet sich hier Z:\projekte\a, antony - Die Groupware\releases\requirements\Multicastsniffer 2. Dort kann oben 1️⃣ der ContainerType antony eingegeben werden. Die Liste unten unter 2️⃣ liefert das Ergebnis. Wird hier mehr als ein Knoten gelistet, muss dies untersucht werden

    Image Removed

Kann ich antony nicht einfach sagen, wo sich der Server befinden, damit er nicht via Multicast sucht?

Ja, antony kann auch eine statische Verbindung verwenden. Dafür sind allerdings zwei Einstellungen notwendig, denn antony redet sowohl HTTPs (neu), als auch TCP/EICP (alt).

• TCP/EICP einstellen

  • Wenn die Verbindung noch nicht bekannt ist, so kann diese mit den Multicast Sniffer herausgefunden werden. (siehe oben) Alternativ fragen Sie den Administrator. Der Standardport für den EICP lautet 54333 Es wird dringend empfohlen diesen nicht zu ändern!

  • Die Einstellung kann in der Datei %LOCALAPPDATA%\antony Systemhaus GmbH\<containerType>.container.settings.user.xml vorgenommen werden.

    • Der containerType ist standardmäßig antony, kann aber grade in Testumgebungen variieren. Dieser kann im Dienstefenster beim MainService in den Parameter nachgeschaut werden.

  • Image Removed

    In dieser Datei sind unter anderen die gespeicherten, verschlüsselten Login-Daten vorhanden. In dieser Datei ist folgendes XML-Element hinzuzufügen.

    Code Block
    <Item name="Starter:StaticConnect">172.20.5.11:54333</Item>

• HTTPs einstellen

  • Die HTTP(s) Schnittstelle ist einfacher einzustellen und wird für die direkte Kommunikation mit den neuen Dienste (z.B: AntonyHubService oder AntonyCalendarService) verwendet. In der Registrierung ist diese zu finden unter

    • HKCU\SOFTWARE\SCOM\antony\antonyHub\Entrypoint.<containerType> (1 / 2)

    • Image Removed

      Der containerType ist wie oben zu setzen (siehe Screenshot)

  • Hier kann nun die vollständige URI zur Desktop-API eingegeben werden. Beispielsweise https://172.20.5.11:8083.

...

Was mache ich, wenn bei einer frischen Client-Installation auf einem neuen System das Setup beim registrieren der antonymapi.net.dll abbricht?

Bei einer neu installierten Windows(Server) fehlen in diesem Fall in der Regel Abhängigkeit. antony liefert diese mit und sie können wie folgt installiert werden:

1. Die Fehlermeldung nicht weg klicken, so dass der Rollback nicht durchgeführt wird

2. In den antony Installationsordner gehen und die scom.groupware.exe starten. Diese installiert dann auch die Abhängigkeiten

3. Installationsordner wieder verlassen und die Fehlermeldung des Installations-Setups bestätigen. Das löst den Rollback aus

4. Installation erneut starten. Mit vorhandenen Abhängigkeiten wird die .DLL nun erfolgreich registriert

Was mache ich, wenn sich bei einer frischen Client-Installation auf einem neuen System keine E-Mail öffnen lässt und in der Fehlermeldung etwas von “cefsharp.core.dll nicht gefunden” steht?

Das liegt an fehlenden Abhängigkeiten von CefSharp (das ist der Chromium Webbrowser). Die Abhängigkeiten können hier eingesehen und runter geladen werden:
https://cefsharp.github.io/

Vor allem die C++ Runtime und .NET Framework fehlen auf Windows-Servern nach Neuinstallation

Wo finde ich die Log-Dateien von antony?

Die Log-Dateien von antony liegen im %LOCALAPPDATA% Verzeichnis des ausführenden Benutzers. Für das Lesen der Log-Dateien ist ein spezielles Programm notwendig. Eine Anleitung gibt es dafür hier Server Protokolle / Logs

Ich bekomme eine Fehlermeldung beim Start “Could not compile skeleton”

Diese Fehlermeldung tritt sporadisch auf und wird im Splash-Screen von antony angezeigt. Es gibt dafür folgende Lösungsansätze:

• Für gewöhnlich kann dieses Problem durch Abmelden und erneutes Anmelden der Windows Sitzung behoben werden.

• Dieses Problem reproduzierbar auf, wenn das System auf Englisch eingestellt ist. Das Problem ist, dass die lokalisierte Assembly ist und der generierte Skeleton-Code einen Syntax Fehler aufweist.

  • Workarround: Löschen der Datei “en/SCOM.Antony.EICP.resources.dll” im Programmverzeichnis

  • Das Problem ist dauerhaft gelöst ab antony >=

    Status
    colour Yellow title 2.22.121

Der Benutzer sieht keine Dokumentenvorlagen im Kontakt, Tab Dokumente

Diese Fehlermeldung tritt auf wenn die rückwirkende Berechtigungen für das Modul Dokumente nicht ausgeführt wurde

• Für gewöhnlich kann dieses Problem durch nachträgliche rückwirkende Berechtigung erledigt werden. Dazu im Administrator auf “Rückwirkende Berechtigungen”, Dokumente und als Zeitraum “Alle” auswählen

...

antony kann ein Update nur manuell installieren. Woran liegt das?

Es kann verschiedene Ursachen haben, wieso ein Update nicht automatisch installiert werden kann. Hier einige Punkte, welche geprüft werden können.

• Ist das Setup zugreifbar?

  • antony prüft, ob an der im Administrator definierten Stelle ein Setup zu finden ist. Ist dies nicht der Fall, kann kein automatisches Update verfolgen. Die Einstellung ist zu finden im Administrator unter Grundeinstellungen 1️⃣ und lautet Remote antony Updatepfad 2️⃣

  • Ist der Pfad nicht zugreifbar, ist das Problem gefunden und kann gelöst werden

...

• Ist das automatische Update auf dem Client aktiviert?

  • Das automatische Update kann pro Client deaktiviert werden. Standardmäßig ist diese Funktion aktiviert. Um dies zu prüfen, kann der Registierungsschlüssel unter HKCU\Software\SCOM\antony\installationAutoUpdateEnabled verwendet werden. Steht dieser auf '1' ist das automatische Update aktiviert.

  • Ist dieser auf 0, kann wie folgt vorgangen werden. Dafür im Administrator unter Benutzerverwaltung > Arbeitsstationen. Dort muss nun die Arbeitsstation herausgesucht werden. Verwendet wird der Name des PCs Wird diese gesetzt, muss der Client neugestartet werden. Der Wert in der Registrierung ändert sich anschließend

...

• Gibt es mehrere antony Installationen im Netzwerk?

  • Wenn es mehrere, parallele antony Installtionen in ein und dem gleichen Netzwerk befinden, so verbinden diese sich untereinander. Typisches Szenario ist eine Testumgebung, welche direkt beim Kunden läuft (Beispielsweise ein Klon). Ist dies der Fall kann endweder eine Update-Endlosschleife auftreten oder das Update kann nicht manuell durchgeführt werden.

  • Um dies zu prüfen, kann das Tool MulticastSniffer eingesetzt werden. Dieser befindet sich hier Z:\projekte\a, antony - Die Groupware\releases\requirements\Multicastsniffer 2. Dort kann oben 1️⃣ der ContainerType antony eingegeben werden. Die Liste unten unter 2️⃣ liefert das Ergebnis. Wird hier mehr als ein Knoten gelistet, muss dies untersucht werden

    Image Added

Kann ich antony nicht einfach sagen, wo sich der Server befinden, damit er nicht via Multicast sucht?

Ja, antony kann auch eine statische Verbindung verwenden. Dafür sind allerdings zwei Einstellungen notwendig, denn antony redet sowohl HTTPs (neu), als auch TCP/EICP (alt).

• TCP/EICP einstellen

  • Wenn die Verbindung noch nicht bekannt ist, so kann diese mit den Multicast Sniffer herausgefunden werden. (siehe oben) Alternativ fragen Sie den Administrator. Der Standardport für den EICP lautet 54333 Es wird dringend empfohlen diesen nicht zu ändern!

  • Die Einstellung kann in der Datei %LOCALAPPDATA%\antony Systemhaus GmbH\<containerType>.container.settings.user.xml vorgenommen werden.

    • Der containerType ist standardmäßig antony, kann aber grade in Testumgebungen variieren. Dieser kann im Dienstefenster beim MainService in den Parameter nachgeschaut werden.

  • Image Added

    In dieser Datei sind unter anderen die gespeicherten, verschlüsselten Login-Daten vorhanden. In dieser Datei ist folgendes XML-Element hinzuzufügen.

    Code Block
    <Item name="Starter:StaticConnect">172.20.5.11:54333</Item>

• HTTPs einstellen

  • Die HTTP(s) Schnittstelle ist einfacher einzustellen und wird für die direkte Kommunikation mit den neuen Dienste (z.B: AntonyHubService oder AntonyCalendarService) verwendet. In der Registrierung ist diese zu finden unter

    • HKCU\SOFTWARE\SCOM\antony\antonyHub\Entrypoint.<containerType> (1 / 2)

    • Image Added

      Der containerType ist wie oben zu setzen (siehe Screenshot)

  • Hier kann nun die vollständige URI zur Desktop-API eingegeben werden. Beispielsweise https://172.20.5.11:8083.

...

xml<?xml version="1.0" encoding ="utf-8"?>
<ls:LocalSettings xmlns:ls="http://www.scom-software.de/antony/localSettings">
    <!-- ... Hier sind weitere Einträge -->
    <ls:Item name="CW:DisableMulticastSearch">true</ls:Item>
    <!-- ... und auch noch mehr -->
</ls:LocalSettings>
<ls:LocalSettings xmlns:ls="http://www.scom-software.de/antony/localSettings">
    <!-- ... Hier sind weitere Einträge -->
    <ls:Item name="CW:DisableMulticastSearch">true</ls:Item>
    <!-- ... und auch noch mehr -->
</ls:LocalSettings>

Die Eventverarbeitung funktioniert nicht. Woran kann das liegen?

Viele neue Funktionen von antony basieren auf einem sogenannten EventStream, welcher die Änderungen am System wiederspiegeln. Diese werden im Hintergrund verarbeitet und wieder zur Anzeige geführt. Wenn hier Probleme auftreten, werden Änderungen unter Umständen nicht direkt angewandt. Beispielsweise können gesetzte Konfigurationen nicht wieder angezeigt werden, es können Termineinaldungen nicht geöffnet werden oder eine neue E-Mail kann in der globalen Suche nicht gefunden werden.

Wenn Events nicht verarbeitet werden können, dann kann das im AntonyHub unter “Eventverarbeitung” eingesehen werden. Dort ist zu sehen, dass es offene Events gibt, welche auch nach Warten nicht verarbeitet werden. (Siehe Bild).

...

Hier im Bild sind es einige ReadModels, welche ein Problem aufweisen. Die Fehlermeldung dazu wird hier bisher nicht angezeigt. Dafür muss in die Tabelle read_model_config gewechselt werden. Diese enthält den Verarbeitungsstatus der einzelnen Events pro ReadModel und Bucket und sieht wie folgt aus.

...

In der Spalte “last_error” ist die Fehlermeldung zu sehen, welche Aufschluss über die Ursache geben kann.

Im konkreten Bild gibt es mehrere Einträge pro Bucket und ReadModel. Um diese zu entfernen kann folgender Befehl ausgeführt werden, um diese zu entfernen.

DROP TEMPORARY TABLE IF EXISTS read_model_config_dub;
CREATE TEMPORARY TABLE read_model_config_dub
(
`id` int(11) NOT NULL
);

INSERT INTO read_model_config_dub select min(id) FROM read_model_config GROUP BY name, bucket;

DELETE FROM read_model_config WHERE 
	!(id in 
		(select id FROM read_model_config_dub GROUP BY name, bucket)
	);

DROP TEMPORARY TABLE IF EXISTS read_model_config_dub;