<commit_before>---
layout: page
title: Client Installation
permalink: "install/de/client/"
---

Sie finden hier die Systemvoraussetzungen und eine Anleitung für die Installation der OneOffixx Client Komponenten.

## <i class="fa fa-wrench" aria-hidden="true"></i> Systemvoraussetzung {% include anchor.html name="system-requirements" %}

__Betriebssystem__

Sie können den OneOffixx Client auf folgenden Betriebssystemen installieren:

* Windows Vista SP2 oder höher (sowohl 32bit oder 64bit) 
* Windows Server 2008 oder höher (sowohl 32bit oder 64bit)
* [Citrix XenApp/TS oder Windows Terminal Server (Versionskompatibel mit Vista SP2 32bit und 64bit)]({{ site.baseurl }}/install/de/client-citrix-ts)

__Unterstützte Microsoft Office Versionen__

OneOffixx unterstützt alle Microsoft Office Versionen ab __Office 2007__, sowohl in der 32bit als auch 64bit Variante.

__.NET Framework__

Für den OneOffixx Client wird mindestens das __[.NET Framework 4.0 (Client Profile)](https://www.microsoft.com/en-US/download/details.aspx?id=17113)__ vorausgesetzt.

__Festplattenspeicher__

Die Software selbst benötigt etwa 200 MB Festplattenspeicher. 

Der OneOffixx Client speichert zudem (für Fehlerbehandlung) Log-Dateien und Einstellungen und legt zusätzlich einen lokalen Cache für die Offline-Nutzung an.
Die Grösse des Caches ist abhängig von der Anzahl und Grösse der Vorlagen. 

__Active Directory__

Für den Betrieb ist es erforderlich, dass der OneOffixx Client und Server sich in der gleichen bzw. über Vertrauensstellung authorisierten Domäne befinden.

## <i class="fa fa-power-off" aria-hidden="true"></i> 32bit oder 64bit Installation {% include anchor.html name="bitness" %}

Den OneOffixx Installer gibt es in einer 32- oder 64bit Variante. Die benötigte Version ist __abhängig von der verwendeten Microsoft Office Version__.

Wird ein 64bit Microsoft Office verwendet, __muss__ die 64bit OneOffixx Version installiert werden. 

## <i class="fa fa-plug" aria-hidden="true"></i> Ports & Server-Verbindung {% include anchor.html name="ports" %}

Der OneOffixx Client kommuniziert __ausschliesslich über HTTP/HTTPS__ mit dem OneOffixx Server, damit wird in der Standard-Konfiguration nur Port 80 bzw. 443 benötigt.

## <i class="fa fa-windows" aria-hidden="true"></i> MSI Parameter {% include anchor.html name="msi" %}

Das OneOffixx MSI-Paket enthält den OneOffixx Client und die diversen Microsoft Office Addins. 

__OneOffixx-Spezifische Parameter:__

* APPLICATIONFOLDER = install folder (default C:\Program Files (x86)\OneOffixx)
* INSTALLDESKTOPSHORTCUT = 1 / 0 for yes or no
* AUTOSTART = 1 / 0 for yes or no
* SERVICEENDPOINTURL = Service Endpoint (*can be overwritten via registry)
* ADDLOCAL = Features
      * WordAddInFeature = Word Add-In
      * OutlookAddInFeature = Outlook Add-In
      * ExcelAddInFeature = Excel Add-In
      * PowerPointAddInFeature = PowerPoint Add-In
      * OfferOfEvidenceAddInFeature = OneOffixx Law Add-In
      * RegulationsAddInFeature = OneOffixx Booklet Add-In

Diese Parameter hier werden nur in bestimmten Installationsvarianten (z.B. Installation auf Terminal-Servern) benötigt und sind optional: 

* DATAINLOCALAPPDATAFOLDER = False/True (must be True on Network Share)
* CACHEFOLDER = Path e.g. //Share/... (with Placeholders like %username% etc.)
* SETTINGFOLDER = Path e.g. //Share/... (with Placeholders like %username% etc.)
* SHUTDOWNONDISCONNECT = true / false (Allows to configure OneOffixx to shutdown when a disconnect happens (such as disconnecting from an RDP Session) )

Es gelten ansonsten die normalen __[MSIEXEC Command-Line Options](https://msdn.microsoft.com/en-us/library/windows/desktop/aa367988%28v=vs.85%29.aspx?f=255&MSPPError=-2147217396)__.

Beispiel: 

    msiexec /qb /i "OneOffixx.Install(x86).msi" APPLICATIONFOLDER="C:\Program Files (x86)\OneOffixx" SERVICEENDPOINTURL="http://appurl/OneOffixxService.svc" INSTALLDESKTOPSHORTCUT=1 AUTOSTART=1 /l*v OneOffixxInstall.log AddLocal=WordAddInFeature,OutlookAddInFeature

__\* ServiceEndpointUrl via Registry:__

OneOffixx sucht in der Registry nach einem String-Value "ServiceAddress" unter diesem Schlüsseln (HKCU & HKLM):

    [HKEY_CURRENT_USER\Software\Sevitec Informatik AG\OneOffixx]
    "ServiceAddress"="http..."

bzw. 

    [HKEY_LOCAL_MACHINE\Software\Sevitec Informatik AG\OneOffixx]
    "ServiceAddress"="http..."

Findet der Client diesen Wert, wird dieser anstelle der ServiceAddress aus der OneOffixx.exe.config genommen. 

Um diese Einstellungen via Gruppenrichtlinien steuern zu können, stellt OneOffixx ADMX Vorlagen zum [downloaden]({ site.baseurl }/install/OneOffixx%20Group%20Policies%20Template.zip ) zur Verfügung.

## <i class="fa fa-cogs" aria-hidden="true"></i> Installationsszenarien {% include anchor.html name="install" %}

Die Standardeinstellungen des OneOffixx Installers zielen auf eine "normale" Installation auf einem System ab, welches von einem oder mehreren Windows-Nutzern gestartet werden kann. 
Hierbei werden sowohl der Cache als auch die Einstellungen unter *%AppData%* gespeichert.

Jede OneOffixx Client Instanz muss für die vollständige Funktionalität exklusiven Zugriff auf den Cache bekommen - ist dies nicht der Fall (z.B. für einige Citrix/Terminal-Server Konfiguration) muss der Speicherort des Caches angegeben werden. 

### <i class="fa fa-cog" aria-hidden="true"></i> OneOffixx Client: Standard Installation

Es werden keine weiteren Parameter benötigt, hierbei werden Cache & Einstellungen unter *%AppData%* gespeichert.

__Empfohlen für:__

☑ Keine serverseitig gespeicherten Roaming Profile

### <i class="fa fa-cog" aria-hidden="true"></i> OneOffixx Client: Cache & Einstellungen lokal

Sowohl der Cache als auch die Einstellungen können unter *%AppDataLocal%* gespeichert werden, wenn dieser Parameter gesetzt wird:

    DATAINLOCALAPPDATAFOLDER = True

__Empfohlen für:__

☑ Serverseitig gespeicherten Roaming Profile

☑ *%AppDataLocal%* Ordner wird nicht gelöscht

☑ Benutzer ist immer auf derselben Maschine eingeloggt

### <i class="fa fa-cog" aria-hidden="true"></i> OneOffixx Client: Cache in spezifischen Ordner<commit_msg>Update client.md<commit_after>---
layout: page
title: Client Installation
permalink: "install/de/client/"
---

Sie finden hier die Systemvoraussetzungen und eine Anleitung für die Installation der OneOffixx Client Komponenten.

## <i class="fa fa-wrench" aria-hidden="true"></i> Systemvoraussetzung {% include anchor.html name="system-requirements" %}

__Betriebssystem__

Sie können den OneOffixx Client auf folgenden Betriebssystemen installieren:

* Windows Vista SP2 oder höher (sowohl 32bit oder 64bit) 
* Windows Server 2008 oder höher (sowohl 32bit oder 64bit)
* [Citrix XenApp/TS oder Windows Terminal Server (Versionskompatibel mit Vista SP2 32bit und 64bit)]({{ site.baseurl }}/install/de/client-citrix-ts)

__Unterstützte Microsoft Office Versionen__

OneOffixx unterstützt alle Microsoft Office Versionen ab __Office 2007__, sowohl in der 32bit als auch 64bit Variante.

__.NET Framework__

Für den OneOffixx Client wird mindestens das __[.NET Framework 4.0 (Client Profile)](https://www.microsoft.com/en-US/download/details.aspx?id=17113)__ vorausgesetzt.

__Festplattenspeicher__

Die Software selbst benötigt etwa 200 MB Festplattenspeicher. 

Der OneOffixx Client speichert zudem (für Fehlerbehandlung) Log-Dateien und Einstellungen und legt zusätzlich einen lokalen Cache für die Offline-Nutzung an.
Die Grösse des Caches ist abhängig von der Anzahl und Grösse der Vorlagen. 

__Active Directory__

Für den Betrieb ist es erforderlich, dass der OneOffixx Client und Server sich in der gleichen bzw. über Vertrauensstellung authorisierten Domäne befinden.

## <i class="fa fa-power-off" aria-hidden="true"></i> 32bit oder 64bit Installation {% include anchor.html name="bitness" %}

Den OneOffixx Installer gibt es in einer 32- oder 64bit Variante. Die benötigte Version ist __abhängig von der verwendeten Microsoft Office Version__.

Wird ein 64bit Microsoft Office verwendet, __muss__ die 64bit OneOffixx Version installiert werden. 

## <i class="fa fa-plug" aria-hidden="true"></i> Ports & Server-Verbindung {% include anchor.html name="ports" %}

Der OneOffixx Client kommuniziert __ausschliesslich über HTTP/HTTPS__ mit dem OneOffixx Server, damit wird in der Standard-Konfiguration nur Port 80 bzw. 443 benötigt.

## <i class="fa fa-windows" aria-hidden="true"></i> MSI Parameter {% include anchor.html name="msi" %}

Das OneOffixx MSI-Paket enthält den OneOffixx Client und die diversen Microsoft Office Addins. 

__OneOffixx-Spezifische Parameter:__

* APPLICATIONFOLDER = install folder (default C:\Program Files (x86)\OneOffixx)
* INSTALLDESKTOPSHORTCUT = 1 / 0 for yes or no
* AUTOSTART = 1 / 0 for yes or no
* SERVICEENDPOINTURL = Service Endpoint (*can be overwritten via registry)
* ADDLOCAL = Features
      * WordAddInFeature = Word Add-In
      * OutlookAddInFeature = Outlook Add-In
      * ExcelAddInFeature = Excel Add-In
      * PowerPointAddInFeature = PowerPoint Add-In
      * OfferOfEvidenceAddInFeature = OneOffixx Law Add-In
      * RegulationsAddInFeature = OneOffixx Booklet Add-In

Diese Parameter hier werden nur in bestimmten Installationsvarianten (z.B. Installation auf Terminal-Servern) benötigt und sind optional: 

* DATAINLOCALAPPDATAFOLDER = False/True (must be True on Network Share)
* CACHEFOLDER = Path e.g. //Share/... (with Placeholders like %username% etc.)
* SETTINGFOLDER = Path e.g. //Share/... (with Placeholders like %username% etc.)
* SHUTDOWNONDISCONNECT = true / false (Allows to configure OneOffixx to shutdown when a disconnect happens (such as disconnecting from an RDP Session) )

Es gelten ansonsten die normalen __[MSIEXEC Command-Line Options](https://msdn.microsoft.com/en-us/library/windows/desktop/aa367988%28v=vs.85%29.aspx?f=255&MSPPError=-2147217396)__.

Beispiel: 

    msiexec /qb /i "OneOffixx.Install(x86).msi" APPLICATIONFOLDER="C:\Program Files (x86)\OneOffixx" SERVICEENDPOINTURL="http://appurl/OneOffixxService.svc" INSTALLDESKTOPSHORTCUT=1 AUTOSTART=1 /l*v OneOffixxInstall.log AddLocal=WordAddInFeature,OutlookAddInFeature

__\* ServiceEndpointUrl via Registry:__

OneOffixx sucht in der Registry nach einem String-Value "ServiceAddress" unter diesem Schlüsseln (HKCU & HKLM):

    [HKEY_CURRENT_USER\Software\Sevitec Informatik AG\OneOffixx]
    "ServiceAddress"="http..."

bzw. 

    [HKEY_LOCAL_MACHINE\Software\Sevitec Informatik AG\OneOffixx]
    "ServiceAddress"="http..."

Findet der Client diesen Wert, wird dieser anstelle der ServiceAddress aus der OneOffixx.exe.config genommen. 

Um diese Einstellungen via Gruppenrichtlinien steuern zu können, stellt OneOffixx ADMX Vorlagen zum [downloaden]({{site.baseurl }}/install/OneOffixx%20Group%20Policies%20Template.zip ) zur Verfügung.

## <i class="fa fa-cogs" aria-hidden="true"></i> Installationsszenarien {% include anchor.html name="install" %}

Die Standardeinstellungen des OneOffixx Installers zielen auf eine "normale" Installation auf einem System ab, welches von einem oder mehreren Windows-Nutzern gestartet werden kann. 
Hierbei werden sowohl der Cache als auch die Einstellungen unter *%AppData%* gespeichert.

Jede OneOffixx Client Instanz muss für die vollständige Funktionalität exklusiven Zugriff auf den Cache bekommen - ist dies nicht der Fall (z.B. für einige Citrix/Terminal-Server Konfiguration) muss der Speicherort des Caches angegeben werden. 

### <i class="fa fa-cog" aria-hidden="true"></i> OneOffixx Client: Standard Installation

Es werden keine weiteren Parameter benötigt, hierbei werden Cache & Einstellungen unter *%AppData%* gespeichert.

__Empfohlen für:__

☑ Keine serverseitig gespeicherten Roaming Profile

### <i class="fa fa-cog" aria-hidden="true"></i> OneOffixx Client: Cache & Einstellungen lokal

Sowohl der Cache als auch die Einstellungen können unter *%AppDataLocal%* gespeichert werden, wenn dieser Parameter gesetzt wird:

    DATAINLOCALAPPDATAFOLDER = True

__Empfohlen für:__

☑ Serverseitig gespeicherten Roaming Profile

☑ *%AppDataLocal%* Ordner wird nicht gelöscht

☑ Benutzer ist immer auf derselben Maschine eingeloggt

### <i class="fa fa-cog" aria-hidden="true"></i> OneOffixx Client: Cache in spezifischen Ordner
{'fraction_non_alphanumeric': 0.08306109114668409, 'fraction_numerical': 0.015681149950996405, 'mean_word_length': 5.171875, 'pattern_counts': {'":': 0, '<': 35, '<?xml version=': 0, '>': 35, 'https://': 4, 'lorem ipsum': 0, 'www.': 2, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 4, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '4009578', 'n_tokens_mistral': 4197, 'n_tokens_neox': 3993, 'n_words': 1265}