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”

...

Wieso findet antony den Server nicht, wenn ich über ein VPN arbeite?

antony sucht die Server in zwei verschiendenen Phasen. Zunächst wird der (neue) Entrypoint für die Desktop-API gesucht. Dieser wird unter anderen mit einen DNS SRV Record gefunden. Ist dies passiert sucht antony die (alte) Verbindung zum Verbinden über das Protocol EICP.

Das Suchen der alten Verbindung funktioniert über einen Multicast. Dazu wird auf der Multicast IP Adresse 239.192.21.71 auf den Ports von 30000-30043 Anfragen geschickt. Sobald ein antony Server diese Anfrage bekommt, antwortet er entsprechend. Je nachdem wie die Infrastruktur eingestellt ist, kann es passieren, dass diese Auflösung über ein VPN nicht funktioniert. Hier muss entsprechend das VPN, Firewall(s), Server etc geprüft werden.

Alternative: Ist diese Prüfung nicht möglich, zu aufwändig oder kann auch technischen Gründen der Multicast nicht konfiguriert werden, so kann die IP des Server manuell eingetragen werden. Sobald antony bei den Punkt Server werden gesucht... angekommen ist, wird nach einer kurzen Zeit ein Zahnrad (1) angezeigt (siehe Abbildung).

...

Hier kann die IP des Server angegeben werden. Der Standardport des Servers lautet 54333. Die IP ist entsprechend zu vervollständigen. Wird noch der Harken bei “Speichern” gesetzt, dann kann antony anschließend auch über ein VPN durch den normalen Benutzer gestartet werden.

Der Suchindex ist kaputt. Wie kann ich ihn neu aufbauen?

Ist der Suchindex kaputt, so muss er neu aufgebaut werden. Das kann passieren, wenn beispielsweise der MainService wärend des Schreibens abstürzt. In diesen Fällen erhalten die Benutzer endweder eine Fehlermeldung oder ein unvollständiges Suchergebnis. In diesen Fällen kann man ihn neu aufbauen.

Dafür muss der Administrator gestartet werden. Anschließend kann in der Ribbonbar mit Konsole eine Konsole geöffnet werden, mit der man auf den Diensten direkte Befehle absetzen kann (1). In dem sich öffnenen Fenster kann anschließend auf Suche geklickt werden (2). Nach einer kurzen Wartezeit füllt sich die Seite der Konsole mit Reitern. Dort muss der Knoten [Service] AntonyMainService.exe ausgewählt werden (3)

...

Im Fenster hat man nun die Möglichkeit einen Befehl einzutippen. Für das Aufbauen des Suchindexes lautet dieser

• base:RebuildSearchIndex. Dieser Befehl baut den Index für alle Module auf

• base:RebuildSearchIndex -addin 1: Bau den Index für Kontakte auf

• base:RebuildSearchIndex -addin 2: Bau den Index für Anrufe auf

• base:RebuildSearchIndex -addin 3: Bau den Index für E-Mails auf

• base:RebuildSearchIndex -addin 4: Bau den Index für Kalender auf

• base:RebuildSearchIndex -addin 14: Bau den Index für Flexobjekte auf

• base:RebuildSearchIndex -addin 80: Bau den Index für Kommunikationen auf

• base:RebuildSearchIndex -addin 10: Bau den Index für Fax auf

• base:RebuildSearchIndex -addin 8: Bau den Index für Aufgaben auf

Die Konsole quittiert den Befehl mit einem JobStarted (1). Anschließend kann der Fortschritt des Jobs unter Einstellungen > ServerJobs im Administrator eingesehen werden. (2+3)

...

Ein Benutzer kann nicht aktiviert werden. Was kann ich tun?

Wenn ein Benutzer nicht aktiviert werden kann, dann gibt es mehrere mögliche Ursachen. Ein bisschen Hintergrund: Die Benutzer werden in der Tabelle user gespeichert. Gleichzeitig wird auch der Eventstream für Benutzer (Tabelle eventstream_usermngt befüllt). In dieser Tabelle sind alle fachlichen Events zu finden, welche Benutzer betreffen. Ein Benutzer kann meistens nicht aktiviert werden, wenn das dazugehörige Event nicht vorhanden ist.

Um das abzufragen, benötitigen wir die UserId des problematischen Benutzers. Diese kann aus der Tabelle users (oder aus den Administrator) herausgefunden werden. Mit dieser BenutzerId kann nun folgende Abfrage ausgeführT werden

select * 
  from eventstream_usermngt 
  where event_type=2 and identifier="<user_id>"  -- event_type = 2 = UserAddedEvent

Kommt hier kein Ergebnis, dann wurde das Event nicht erzeugt.

Das Hinzufügen des Benutzers kann über folgenden SQL Befehl erfolgen. Auch hier ist die BenutzerId auszufüllen.

INSERT INTO eventstream_usermngt (timestamp, identifier, action, app, event_type, payload, user_id, user_name)
SELECT 
		utc_timestamp() as timestamp,
		LOWER(id) as identifier,
		"Manually Added by Support" as action,
		"Navicat" as app,
		2 as event_type, 
		CONCAT_WS ("", "{", CHAR(13), CHAR(10),
						' "UserId":', id, ",", CHAR(13), CHAR(10),
						' "Division":', '"', division, '"', ",",CHAR(13), CHAR(10),
						' "UserName":', '"', username, '"', ",",CHAR(13), CHAR(10),
						' "FirstName":', '"', firstname, '"', ",",CHAR(13), CHAR(10),
						' "LastName":', '"', lastname, '"', ",",CHAR(13), CHAR(10),
						' "Acronym":', '"', shortcut, '"', ",",CHAR(13), CHAR(10),
						' "Mail":', '"', email, '"', ",",CHAR(13), CHAR(10),
						' "Telephone":', '"', phone, '"', ",",CHAR(13), CHAR(10),
						' "Comment":', '"', comment, '"', ",",CHAR(13), CHAR(10),
						' "IsInvisible":', IF(invisible=0,false, true), ",",CHAR(13), CHAR(10),
						' "Location":', '"', location, '"', ",",CHAR(13), CHAR(10),
						' "Position":', '"', position, '"', ",",CHAR(13), CHAR(10),
						' "ExternalTelephone":', '"', external_phone, '"', ",",CHAR(13), CHAR(10),
						' "Fax":', '"', fax, '"', ",",CHAR(13), CHAR(10),
						"}") as payload, 
		0 as user_id,
		"Support" as user_name
FROM user
where id = <userId>

Nachdem die Abfrage ausgeführt wurde, kann mit der ersten Abfrage das Ergebnis validiert werden. Anschließend muss noch dafür gesorgt werden, dass der Benutzer in die entsprechenden Benutzergruppen kommt. Dies sind ebenfalls separate Events mit der event_type = 5 (UserAddedToGroup). Über folgenden SQL Befehl können diese Events erzeugt werden

INSERT INTO eventstream_usermngt (timestamp, identifier, action, app, event_type, payload, user_id, user_name)
SELECT 
		utc_timestamp() as timestamp,
		LOWER(user_id) as identifier,"Manually Added by Support" as action,
		"Navicat" as app,
		15 as event_type, -- EventId = 15 = UserAddedToGroup

		CONCAT_WS("", "{", CHAR(13), CHAR(10),
						' "UserId":', user_id, ",", CHAR(13), CHAR(10),
						' "GroupId":', group_id, ",", CHAR(13), CHAR(10),
						"}") as payload, 
		0 as user_id,
		"Support" as user_name
FROM `user-group` WHERE `user-group`.user_id=<userId>

Ist hier nun der Eintrag vorhanden, dann kann der Benutzer im nächsten Schritt im Administrator aktiviert werden.

Was mache ich, wenn sich die Server nicht untereinander finden können?

Es kann vorkommen, dass sich die alten Legacy-Dienst (MainService, Pop3Service) untereinander nicht finden können, wenn diese z.B. auf unterschiedlichen Servern ausgeführt werden. Ein typisches Anwendungsbeispiel ist (bzw war) das Auslagern des Fax-Dienstes auf eine separate Hardware. Der Dienst versuchen sich über den EICP Multicast zu finden. Ist dies nicht erfolgreich, kann er nicht gestartet werden

Um das Problem zu lösen, kann ein (oder auch mehrere) feste Endpunkte konfiguriert werden, zu welchen sich der Dienst verbinden soll. Dieser muss in die “*.config.xml” Datei des Dienstes eingetragen werden. Diese befindet sich im Programm-Verzeichnis der Dienste im Unterordner “config”. Der übliche Pfad lautet:

• Für den MainService: C:\Program Files (x86)\antony Systemhaus GmbH\antony - Die Services\configs\mainservice.settings.xml

• Für alle anderen Dienste C:\Program Files (x86)\antony Systemhaus GmbH\antony - Die Services\configs\default.settings.xml

Um die feste Verbindung zu konfigurieren. muss folgender Eintrag vorgenommen werden.

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:Array name="CW.StaticConnections">
        <ls:Item>127.0.0.1:54333</ls:Item>
    </ls:Array>
    <!-- ... und auch noch mehr -->
</ls:LocalSettings>

Nach Neustart wird diese Verbindung statisch versucht aufzubauen.

Es wird weiterhin zusätzlich per Multicast gesucht. Dieses Verhalten ist bei einer festen EICP Verbindung vermutlich nicht notwendig. Um es zu deaktivieren kann zusätzlich folgender Eintrag vorgenommen werden

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>

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;