Installation mySync

Professional ERP mySync ist einer der Professional ERP Mehrwertdienste. Er ermöglicht die Synchronisation der Informationen im Kontaktmanagement (CRM) von Professional ERP mit externen Kalenderdiensten, die das Format CalDAV unterstützen. Die Zusatzkomponente DavMail wird für die Synchronisation mit Microsoft Exchange Server (ab Version 2010) benötigt. Die Installationsprogramme für Professional ERP mySync und die Zusatzkomponente DavMail werden auf dem Installationsmedium zusammen mit Professional ERP in den Verzeichnissen mySync und SUPPORT\DavMail 4.4.1 ausgeliefert.

Systemanforderungen

Minimale Hardwarevoraussetzungen

Unterstützte Betriebssysteme:

Systemanforderungen Software

Installation und Konfiguration Professional ERP mySync

Für die Installation von Professional ERP mySync muss die zugehörige Installationsdatei „Professional ERP mySync.msi“ ausgeführt werden, welche sich im Verzeichnis mySync des Professional ERP Installationsmediums befindet. Die Installation wird nicht automatisch gestartet.

Installation Professional ERP mySync

Nach dem Start der Installationsdatei werden Sie schrittweise durch die Installation geführt.

1. Beginn der Installation mit der Willkommensseite und anschließendem Akzeptieren der Lizenzbedingungen
   
   Unable to render {include} The included page could not be found.
    
   Unable to render {include} The included page could not be found.
   
   
   
2. Auswahl des Installationspfades
   
   Unable to render {include} The included page could not be found.
   
   Hier kann ein lokales Verzeichnis des Servers gewählt werden, in dem der Professional ERP mySync Dienst bereitgestellt werden soll.
   
   
3. Beginn der eigentlichen Installation
   
   Unable to render {include} The included page could not be found.
   
   
   
4. Schließen Sie die Installation über die Schaltfläche Fertig stellen
   
   Unable to render {include} The included page could not be found.
   
   

Hier kann ein lokales Verzeichnis des Servers gewählt werden, in dem der Professional ERP mySync Dienst bereitgestellt werden soll.

Falls die Option „Port 1080 in Windows Firewall freigeben“ aktiviert wurde, wird eine Firewall-Regel angelegt, welche eingehenden TCP-Verkehr auf Port 1080 erlaubt. Dieser Port wird für die DavMail-Komponente benötigt, die in Abschnitt III näher beschrieben wird.

Nach Abschluss der Installation erscheint in der Windows Dienstverwaltung ein neuer Systemdienst SWS mySync, der zu diesem Zeitpunkt noch nicht ausgeführt werden sollte.

Falls der Dienst bereits gestartet sein sollte, stoppen Sie ihn bitte.

Konfiguration Professional ERP mySync

Die Konfiguration des Professional ERP mySync Dienstes erfolgt über die Konfigurationsdatei SWSDAV.INI des im vorherigen Abschnitt in Schritt [2] festgelegten Installationsverzeichnisses. Die Konfigurationsdatei wird im Rahmen der Installation des Diensts bereits vorbereitet. Die Datei kann über den im System eingestellten Texteditor zur Bearbeitung aufgerufen werden.

Aufbau SWSDAV.INI

Die Konfigurationsdatei ist in zwei Kategorien gegliedert: [SWSDAV] und [DataRepositories]. Die Kategorie [SWSDAV] umfasst Basiseinstellungen des Dienstes, die – abgesehen vom Eintrag „ProgramDir“ – in der Regel unverändert übernommen werden können.

• SyncThreads: Gibt an, wie viele Synchronisationskonten parallel abgearbeitet werden. Dieser Eintrag sollte nur in Ausnahmefällen auf einen anderen Wert als 1 gesetzt werden.
• SyncInterval: Gibt das Synchronisationsintervall in Minuten vor. Standardmäßig wird alle 15 Minuten ein neuer Synchronisationslauf durchgeführt.
• WeeksInPast: Gibt vor, für wie viele Wochen eine Synchronisation der Termine im Kontaktmanagement in die Vergangenheit durchgeführt werden soll. Standardmäßig werden Termine bis zu 2 Wochen in die Vergangenheit synchron gehalten.
• ProgramDir: [notwendig] Fügen Sie hier einen vom Dienst erreichbaren Pfad ein (wenn möglich, einen UNC-Pfad), der auf Ihr Professional ERP Programmverzeichnis zeigt. Zum Beispiel:

\\localdomain\dfs\Professional ERP

Die Kategorie [DataRepositories] beschreibt die vom Dienst zu verwendenden Datenquellen (Datenlaufwerke / SQL-Datenbanken)

a) Count: Gibt an, wie viele unterschiedliche Datenquellen mit dem Professional ERP mySync Dienst synchronisieren werden sollen.

b) Repository[N]: Beim Wert N handelt es sich um einen fortlaufenden Zähler, der bei 1 beginnt. Der jeweilige Eintrag Repository1 bis RepositioryN gibt jeweils den Pfad zu einem der Datenlaufwerke, bzw. den SQL-Connection-String der gewünschten Datenquelle an. Zum Beispiel:

\\localdomain\dfs\Professional ERP\WEEKEND.DAT oder

DRIVER=SQL Server;Address=[SQL-SERVER-Instanz],[PORT];Trusted_Connection=Yes;SERVER=[SERVERNAME/IP];Description=ProfErp;DataBase=[DATENBANKNAME]

Dienstanmeldung konfigurieren

Der Professional ERP mySync Dienst wird zunächst mit dem Systembenutzer Netzwerkdienst in die Windows Dienst-Verwaltung eingetragen. Mit dieser Benutzeranmeldung erhält der Dienst aus sicherheitstechnischen Gründen nur eingeschränkten Zugriff auf die in der SWSDAV.INI konfigurierten Datenquellen. Für den ordentlichen Betrieb des Dienstes wird jedoch ein Domänenbenutzer benötigt, dessen Passwort nicht ablaufen kann und der sowohl lesend als auch schreibend Zugriff auf die konfigurierten Datenquellen besitzt. Ordnen Sie dem Dienst diesen Domänenbenutzer auf dem Register Anmelden in den Eigenschaften des Dienstes zu.

DavMail für die Kommunikation mit Microsoft Exchange / Microsoft Outlook365

Für die Synchronisation der Termine im Kontaktmanagement von Professional ERP mit Outlook in Verbindung mit Microsoft Exchange Server (ab Version 2010) bzw. Microsoft Outlook365 wird zusätzlich zum Professional ERP mySync Dienst die Zusatzkomponente DavMail POP/IMAP/SMTP/Caldav/Carddav/LDAP Exchange Gateway (kurz DavMail) benötigt.

DavMail unterliegt der GNU General Public License. Die zugehörige Installationsdatei davmail-4.6.2-2377-setup.exe befindet sich auf dem Professional ERP Installationsmedium im Verzeichnis SUPPORT\DavMail 4.6.2. Alternativ kann die Komponente auch direkt von der Homepage des Entwicklerteams bezogen werden. Die Webseite findet sich unter:

http://davmail.sourceforge.net/

Vorbereitungsmaßnahmen für die Verwendung von DavMail

Zusätzlich zu den allgemeinen Systemanforderungen (vgl. „I –Systemanforderungen“) muss sichergestellt werden, dass der verwendete Microsoft Exchange Server bzw. Outlook365 vom Hostrechner des DavMail Dienstes erreichbar ist.

a) Microsoft Exchange Server im Firmennetzwerk

Ein einfacher Test für die Erreichbarkeit des Microsoft Exchange Servers ist es, auf dem DavMail Hostrechner im Internet Explorer die folgende URL zu öffnen:

https://[MSEXCHANGE-SERVERNAME.IHREDOMÄNE]/ews/exchange.asmx

[MSEXCHANGE-SERVERNAME.IHREDOMÄNE] ist entsprechend des verwendeten Domänen- bzw. Servernamens anzupassen. Sofern der Microsoft Exchange Server erreichbar ist, öffnet sich ggf. ein Windows-Authentifizierungsdialog. Für eine solche Authentifizierung ist ein dem Microsoft Exchange Server bekanntes Benutzerkonto zu verwenden. Da für Microsoft Exchange Server typischerweise domänengebundene Benutzerkonten aus dem Active Directory verwendet werden, entfällt die Eingabe von Benutzerdaten jedoch in aller Regel, weil die benötigten Informationen aus der aktuellen Benutzeranmeldung automatisch übermittelt werden. Nach einer erfolgreichen Authentifizierung wird im Browser der Inhalt einer XML-Datei angezeigt, deren Inhalt DavMail nach erfolgter Konfiguration für die Kommunikation mit dem Microsoft Exchange Server verwendet.

b) Microsoft Outlook365

Analog zum Test für einen im eigenen Firmennetzwerk befindlichen Microsoft Exchange Server kann auch für Microsoft Outlook365 ein vergleichbarer Test mit einem beliebigen Internetbrowser durchgeführt werden, indem die folgende URL aufgerufen wird:

https://outlook.office365.com/EWS/Exchange.asmx

Sofern die Microsoft Outlook365 Server erreichbar sind, öffnet sich auch hier ein Authentifizierungsdialog. In diesem Dialog ist für die Authentifizierung als Benutzername zunächst die E-Mailadresse eines Microsoft Outlook365 Kontos anzugeben, welchem explizit die Rolle Administrator zugeordnet ist, und dann das zugehörige Microsoft Outlook365 Passwort. Nach erfolgreicher Authentifizierung wird dann auch hier der Inhalt einer XML-Datei angezeigt, deren Inhalt DavMail nach erfolgter Konfiguration für die Kommunikation mit den Microsoft Outlook365 Servern verwendet.

Nach diesem grundlegenden Kommunikationstest sind für Microsoft Outlook365 weitere Konfigurationsmaßnahmen nötig, da andernfalls nur Microsoft Outlook365 Konten Professional ERP mySync benutzen können, die über die Rolle Administrator verfügen. Um Microsoft Outlook365 Konten ohne diese Rollenzuordnung den Zugriff via DavMail zu ermöglichen, sind daher folgende Schritte durchzuführen:

1. Öffnen des Windows Azure Active Directory-Modul in der PowerShell mit lokalen administrativen Rechten.
   
   
2. Eingabe folgender Befehle:
   a) $LiveCred = Get-Credential
   Es öffnet sich der Dialog für die Eingabe der Anmeldedaten. Hier werden analog zum vorherigen Kommunikationstest die Anmeldedaten eines Outlook365 Kontos mit der Rolle Administrator benötigt.
   b) $Session = New-PSSession –ConfigurationName Microsoft.Exchange –ConnectionUri https://ps.outlook.com/powershell -Credential $LiveCred -Authentication Basic –AllowRedirect
   Die PowerShell meldet dann typischer Weise Warnhinweise hinsichtlich der Verbindungsumleitung auf outlook.com spezifische URI, die im Zusammenhang mit der übergebenen Benutzerkennung stehen
   c) Import-PSSession $Session
   Hiermit wird die Verbindungssession importiert. Im Anschluss können die eigentlichen Einstellungsmaßnahmen durchgeführt werden.
   
3. Für jedes Benutzerpostfach in Outlook365, welches später per DavMail synchronisiert werden soll, muss mit folgendem Befehl der EWS-Zugriff explizit freigegeben werden:
   a) Set-CasMailbox –Identity [Outlook365-E-Mailadresse] –EwsEnabled:$true
   Danach ist das zugehörige Postfach für die Anbindung an Professional ERP mySync vorbereitet.
   Falls der DavMail-Zugriff auf ein Postfach nicht mehr möglich sein, kann die mit nachfolgendem Befehl rückgängig gemacht werden:
   Set-CasMailbox –Identity [Outlook365-E-Mailadresse] –EwsEnabled:$false

Installation DavMail

Für die Installation von DavMail muss das bereitgestellte Installationsprogramm ausgeführt werden. Folgen Sie hierbei den Anweisungen der Installationsroutine.

Patch-Maßnahmen für DavMail Version 4.6.2

Falls DavMail im Rahmen der Installation gestartet wurde, beenden Sie die Anwendung jetzt über das Icon in der Systemstatusleiste mittels des Kontextmenüs der rechten Maustaste:

Falls DavMail im Rahmen einer früheren Installation bereits als Dienst eingerichtet wurde, beenden Sie den Dienst DavMail-Gateway über die Dienste-Verwaltung:

Führen Sie im Anschluss die nachfolgend beschrieben Patch-Maßnahmen durch.

Im Anwendungsverzeichnis von DavMail – standardmäßig C:\Program Files(x86)\DavMail\ – befindet sich die Datei davmail.jar.

Erstellen Sie zunächst eine Sicherung dieser Datei und ersetzen Sie das Original durch die gleichnamige Datei aus dem Verzeichnis SUPPORT\DavMail 4.6.2\DavMail Patch\ ihres Installationsmediums.
Sofern der Patch im Rahmen einer Erstinstallation erfolgte, starten Sie die Anwendung jetzt über die vorhandene Desktopverknüpfung und befolgen Sie die weiteren Konfigurationsschritte.
War der Dienst DavMail-Gateway bereits eingerichtet, können Sie diesen in der Dienste-Verwaltung wieder starten. Weitere Konfigurationsmaßnahmen sind dann nicht mehr erforderlich.

Erstkonfiguration von DavMail

Nach Installation und Start von DavMail kann die Erstkonfiguration vorgenommen werden. Das Konfigurationsmenü wird durch Auswahl des Eintrags Settings geöffnet, welcher im Kontextmenü erscheint, wenn dieses durch Betätigung der rechten Maustaste auf dem DavMail-Icon in der Statusleiste aufgerufen wird.

Auf den einzelnen Registern sind dann die nachfolgend beschriebenen Einstellungen vorzunehmen.

Register «Main»

1. Exchange Protocol: EWS
2. OWA URL: Hier ist dieselbe URL einzutragen, die bereits für den grundsätzlichen Kommunikationstest mit dem Microsoft Exchange Server Microsoft Outlook365 verwendet wurde. Also entweder:
   

   https://[MSEXCHANGE-SERVERNAME.IHREDOMÄNE]/ews/exchange.asmx

   oder

   https://outlook.office365.com/EWS/Exchange.asmx

   [MSEXCHANGE-SERVERNAME.IHREDOMÄNE] für die Kommunikation mit einem im Firmennetz befindlichen Microsoft Exchange Server ist auch hier entsprechend des verwendeten Domänen- und Servernamens anzupassen.

3. Setzen Sie den Haken im Klickfeld Caldav http port: und geben Sie den zu verwendenden, lokalen Port an (default: 1080).

Register «Network»

1. Setzen Sie den Haken im Klickfeld Allow Remote Connections