File Synchronization Client (Deprecated Version 1.3.0.45)

 

Hinweis

  • Beim WEEASY File Synchronization Client handelt es sich aktuell noch um eine BETA-Version. Diese unterstützt nur die Readonly-Synchronisation von Dateien
  • Die Offline Synchronisation wird aktuelle nur über die Team Manager App unterstützt

Funktionsumfang

  • Der WEEASY File Synchronization Client synchronisiert automatisch die Dateien eines Benutzers von dessen WEEASY Account auf den entsprechenden Rechner
  • Welche Laufwerke Offline verfügbar sind kann pro Benutzer und Laufwerk über die Team Manager App festgelegt werden
  • Die aktuelle Version ist eine Beta-Version und unterstützt daher nur die lesende Synchronisation. Die finale Version wird die bidirektionale Synchronisation unterstützen, so dass Dokumente etc. dann auch lokal geändert werden können.
  • Jeder Benutzer kann auf einem oder mehreren Geräten den WEEASY File Synchronization Client installieren

 

Systemvoraussetzungen

  • Aktueller Windows PC (Windows 10 oder Windows 7)
  • Für die Installation werden Administratorrechte benötigt, da der File Synchronization Client als Windows Dienst eingerichtet wird
  • Die Installation des File Synchronization Client benötigt ca. 200 MB Speicherplatz
  • Zusätzlicher Speicherplatz für die Ablage der synchronisierten Datei
  • Internet / Netzwerkverbindung für die Synchronisation der Dateien (wink)

 

Installation

InstallationsschrittBemerkungen / Screenshot

WEEASY File Synchronization Client herunterladen: http://www.weeasy.de/DownloadFileSyncClient

 

Neues Verzeichnis anlegen z.B. C:\Programme\WEEASY File Synchronization Client

 

ZIP Archiv in ein temporäres Verzeichnis entpacken und danach dessen Inhalt in Installationsverzeichnis z.B. C:\Programme\WEEASY File Synchronization Client verschieben / kopieren

 

Eingabeaufforderung als Administrator starten und in Installationsverzeichnis wechseln z.B. cd C:\Programme\WEEASY File Synchronization Client

Mit folgenden Befehl über die Eingabeaufforderung File Synchronization Client als Windows Dienst einrichten 
weeasy_file_sync_client.exe --WinRun4J:RegisterService


Achtung: Der Service kann erst gestartet werden, nachdem dieser wie in den nachfolgenden Schritten beschrieben, konfiguriert wurde

Berechtigungen für Offline Synchronisation in Team Manager App vergeben über Speicherverwaltung - Laufwerke / Externe Laufwerke 

 

  • Neue File Synchronization Client über Benutzereinstellungen - Offline vorbereiten
  • Gewünschte Einstellungen vornehmen und mit OK bestätigen. Dabei darauf achten, dass der Link auf die Konfigurationsdatei per Mail zugesendet wird
  • Konfigurationsdatei herunterladen 
  • Konfigurationsdatei FileSyncConfiguration.conf in Unterverzeichnis conf im Installationsverzeichnis kopieren z.B. C:\Programme\WEEASY File Synchronization Client\conf das 
  • Eine eventuell schon mit diesem Name vorhandene Datei kann überschrieben werden
 
  • Windows Dienst für File Synchronization Client starten 
    net start WEEASY_FILE_SYNC_CLIENT
     
  • In den Benutzereinstellungen von WEEASY sollte nun der Client als registriert erscheinen. Eventuelle Probleme beim Starten können dem Logfile entnommen werden. Diese befindet sich unterhalb des Installationsverzeichnisses .\log\weeasy.log

 

Logfiles

  • Der Client schreibt seine Logs in die Datei .\log\weeasy.log z.B. C:\Programme\WEEASY File Synchronization Client\log\weeasy.log

 

Mögliche Probleme

FehlerFehlerdetailsBehebung
[Error 1446][Error 1446] You do not have access on the data of the file synchronization client with the passed access token. 
  • Zum Download des Konfigurationsfile muss der entsprechende Benutzer an WEEASY angemeldet sein. Der Download muss mit dem selben Browser erfolgen. 
  • Alternativ kann die Datei auch über die Benutzereinstellungen heruntergeladen werden
[Fehler 841][Fehler 841] The user 'donald.duck' does not have the required authorization ...
  • Hierbei handelt es sich um einen Bug in der Version 1.3.0.45. Ein Workaround zur Behebung des Fehlers befindet sich hier:
    Error rendering macro 'jira' : Unable to locate Jira server for this macro. It may be due to Application Link configuration.
MissingResourceException beim Versuch File Synchronization Client zu starten

Beim Versuch den Windows Dienst für den WEEASY File Synchronization Cient zu starten tritt folgender Fehler im Logfile auf:

 

2016-04-13 06:35:49,116 INFO - [ 181] JEAF Properties location is 'C:\Program Files\WEEASY File Synchronization Client\conf'.
2016-04-13 06:35:49,116 INFO - [ 182] accessToken: ''
2016-04-13 06:35:49,116 INFO - [ 182] serverURL: ''
Exception in thread "Thread-1" java.util.MissingResourceException: Required property with the name 'accessToken' is not set.
 at com.anaptecs.jeaf.fwk.core.util.ResourceAccessProvider.getPropertyValue(ResourceAccessProvider.java:529)
 at com.anaptecs.jeaf.fwk.core.util.ResourceAccessProvider.getStringProperty(ResourceAccessProvider.java:611)
 at com.anaptecs.jeaf.cloudservices.filesystem.SynchronizationConfiguration.loadConfiguration(SynchronizationConfiguration.java:124)
  • Die Konfigurationsdatei des File Synchronization Client ist nicht korrekt. Bitte stellen Sie sicher, dass die Konfigurationsdatei der heruntergeladenen Datei entspricht. Der Pfad und Name der Datei sind im Logfile (siehe Auszug links) ersichtlich
  • Nach Änderungen an der File Synchronization Client Konfigurationsdatei ist ein Restart des Windows Dienstes notwendig
SSL Fehler beim Starten des File Synchronization Client

Im Logfile des File Synchronization Client erscheint die SSL Fehlermeldung:

javax.net.ssl.SSLProtocolException: handshake alert: unrecognized_name

 

[ 1442] Starting exection of action 'Register File Synchronization Client'.
[ 210] Trying to login user 'anonymous' (Login-Module-Implementation: HessianClientLoginModule).
[ 19] com.caucho.hessian.client.HessianRuntimeException: javax.net.ssl.SSLProtocolException: handshake alert: unrecognized_name
 at com.caucho.hessian.client.HessianProxy.sendRequest(HessianProxy.java:268)
 at com.caucho.hessian.client.HessianProxy.invoke(HessianProxy.java:170)
 at com.sun.proxy.$Proxy0.getUserPrincipal(Unknown Source)
 at com.anaptecs.jeaf.fwk.hessian.client.HessianClientLifecycleManager.login(HessianClientLifecycleManager.java:162)
 at com.anaptecs.jeaf.fwk.hessian.client.HessianClientLoginModule.performLogin(HessianClientLoginModule.java:122)
 at com.anaptecs.jeaf.fwk.core.jaas.AbstractJEAFLoginModule.doLogin(AbstractJEAFLoginModule.java:148)
 at com.anaptecs.jeaf.fwk.hessian.client.HessianClientLoginModule.login(HessianClientLoginModule.java:71)
 at sun.reflect.NativeMethodAccessorImpl.invoke0(Native Method)
 at sun.reflect.NativeMethodAccessorImpl.invoke(NativeMethodAccessorImpl.java:57)
 at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43)
 at java.lang.reflect.Method.invoke(Method.java:606)
 at javax.security.auth.login.LoginContext.invoke(LoginContext.java:762)
 at javax.security.auth.login.LoginContext.access$000(LoginContext.java:203)
 at javax.security.auth.login.LoginContext$4.run(LoginContext.java:690)
 at javax.security.auth.login.LoginContext$4.run(LoginContext.java:688)
 at java.security.AccessController.doPrivileged(Native Method)
 at javax.security.auth.login.LoginContext.invokePriv(LoginContext.java:687)
 at javax.security.auth.login.LoginContext.login(LoginContext.java:595)
 at com.anaptecs.jeaf.fwk.core.util.JEAFApplication.login(JEAFApplication.java:118)
 at com.anaptecs.jeaf.cloudclients.ClientAction.prepare(ClientAction.java:75)
 at com.anaptecs.jeaf.cloudclients.FileSynchronizationClient.executeAction(FileSynchronizationClient.java:129)
 at com.anaptecs.jeaf.cloudclients.FileSynchronizationClient.runApplication(FileSynchronizationClient.java:83)
 at com.anaptecs.jeaf.fwk.core.util.JEAFApplication.start(JEAFApplication.java:166)
 at com.anaptecs.jeaf.cloudclients.FileSynchronizationServiceWrapper.serviceMain(FileSynchronizationServiceWrapper.java:54)
Caused by: javax.net.ssl.SSLProtocolException: handshake alert: unrecognized_name
 at sun.security.ssl.ClientHandshaker.handshakeAlert(ClientHandshaker.java:1380)
 at sun.security.ssl.SSLSocketImpl.recvAlert(SSLSocketImpl.java:1972)
 at sun.security.ssl.SSLSocketImpl.readRecord(SSLSocketImpl.java:1086)
 at sun.security.ssl.SSLSocketImpl.performInitialHandshake(SSLSocketImpl.java:1332)
 
 
  • Ursache für das Problem ist die sogenannte Server Name Indication (SNI) Überprüfung von Java. Diese prüft die korrekte Installation von SSL Zertifikaten. Sollte das SSL Zertifikat auf dem Server nicht korrekt installiert sein, so kommt es zu der links stehenden Fehlermeldung. Ob Ihre SSL Konfiguration korrekt ist können Sie mit Hilfe von https://www.digicert.com/help/ überprüfen

  • Ferner ist es möglich die SNI Prüfung von Java zu deaktivieren. Dazu ist in der Datei weeasy_file_sync_client.ini, die sich im Installationsverzeichnis befindet, folgender Eintrag zu ergänzen
# Disable Java's SNI extension
vmarg.2=-Djsse.enableSNIExtension=false

 

Deinstallation

Die Deinstallation ist denkbar einfach und besteht aus den folgenden Schritten

  1. Service über Eingabeaufforderung im Administrator-Modus deinstallieren.
    Dazu muss in das Installationsverzeichnis des File Synchronization Client gewechselt werden und dort der Befehl weeasy_file_sync_client.exe --WinRun4J:UnregisterService des ausgeführt werden.

  2. Nun kann das Installationsverzeichnis gelöscht werden

  3. Bei Bedarf kann ferner auch das Verzeichnis in dem die Daten abgelegt wurden gelöscht werden