2018 June Release

Microsoft WindowsPermanent link for this heading

This chapter refers to a Microsoft Windows operating system.

InstallingPermanent link for this heading

Fabasoft Cloud Client

To install the Fabasoft Cloud Client (into the per-user installation context), perform the following steps:

  1. Download the CloudClient.msi installation package from the Fabasoft Cloud or Fabasoft Private Cloud.
    https://at.cloud.fabasoft.com/folio/fscasp/content/lib/CloudClient.msi
    https://<host private cloud>/cloud/fscasp/content/lib/CloudClient.msi
  2. Run the CloudClient.msi installation package and follow the installation wizard.

The Fabasoft Cloud Client is installed in the following folder: C:\Users\<username>\AppData\Local\Fabasoft\

Note: The installation of the Fabasoft Cloud Client and the Fabasoft Cloud Enterprise Client on the same computer is not supported.

Fabasoft Cloud Enterprise Client

To install the Fabasoft Cloud Enterprise Client (into the per-machine installation context), perform the following steps:

  1. Download the CloudClientEnterprise.msi installation package from the Fabasoft Cloud or Fabasoft Private Cloud.
    https://at.cloud.fabasoft.com/folio/fscasp/content/lib/CloudClientEnterprise.msi
    https://<host private cloud>/cloud/fscasp/content/lib/CloudClientEnterprise.msi
  2. Make sure that you have administrative rights.
  3. Run the CloudClientEnterprise.msi installation package and follow the installation wizard.

The Fabasoft Cloud Enterprise Client is installed in the following folder:
C:\Program Files (x86)\Fabasoft\Cloud\Client\.
In case of a 32 bit operating system the base folder is Program Files.

Note: The installation of the Fabasoft Cloud Client and the Fabasoft Cloud Enterprise Client on the same computer is not supported.

Deployment via Active DirectoryPermanent link for this heading

The deployment of per-machine installation packages (MSI) via Active Directory is described in the white paper “Deployment of ActiveX Controls via Microsoft Windows Active Directory”.

Deployment of the Google Chrome ExtensionPermanent link for this heading

The deployment of the Google Chrome Extension is described in the official Chromium documentation: http://dev.chromium.org/administrators/policy-list-3#ExtensionInstallForcelist

In case of the Fabasoft Cloud Enterprise Client the following key should be deployed:

HKEY_LOCAL_MACHINE\SOFTWARE\Policies\Google\Chrome\ExtensionInstallForcelist

"1"="icjlkccflchmagmkfidekficomdnlcig;https://clients2.google.com/service/update2/crx"

Deployment of the Mozilla Firefox ExtensionPermanent link for this heading

The deployment of the Mozilla Firefox Extension is described in the official Mozilla documentation: https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Alternative_distribution_options/Add-ons_in_the_enterprise

In case of the Fabasoft Cloud Enterprise Client the following key should be deployed:

HKEY_LOCAL_MACHINE\SOFTWARE\Mozilla\Firefox\Extensions

"nmextmozpu@fabasoft.com"="<path_to_extracted_CloudFirefoxExtension_xpi>"

This archive file is located on the web server and can be extracted using any ZIP extractor:

https://at.cloud.fabasoft.com/folio/fscasp/content/lib/CloudFirefoxExtension.xpi
https://<host private cloud>/cloud/fscasp/content/lib/
CloudFirefoxExtension.xpi

Note: Without changing the Mozilla Firefox preferences (as described in the documentation: extensions.autoDisableScopes, extensions.enabledScopes), each user will be notified on the next application startup, that a new Mozilla Firefox Extension was installed. In this case, the user must explicitly confirm, that the Mozilla Firefox Extension should be enabled.

Deployment of the Microsoft Edge ExtensionPermanent link for this heading

For deploying an offline app on a Windows client, you have to activate “sideloading” on your client as described here:

https://docs.microsoft.com/en-us/windows-hardware/manufacture/desktop/sideload-apps-with-dism-s14

After sideloading has been activated, you can download the Microsoft Edge Extension from your web server:

https://at.cloud.fabasoft.com/folio/fscasp/content/lib/CloudEdgeExtension.appxbundle
https://<host private cloud>/cloud/fscasp/content/lib/CloudEdgeExtension.appxbundle

Install the application using PowerShell by specifying the package path as described in the article above:

Add-AppxPackage -Path <path_to_bundle>\CloudEdgeExtension.appxbundle

Trusted Sites for Fabasoft app.telemetryPermanent link for this heading

To allow that Fabasoft app.telemetry get more information about the client configuration and taking a screenshot, when pressing the app.telemetry feedback button you have to manually set a trusted site registry key for your web service URL.
Key: HKEY_CURRENT_USER\Software\Fabasoft\WebClient\TrustedSites\Cloud\<web service URL e.g. at.cloud.fabasoft.com>

Note: For the Fabasoft Cloud/Fabasoft Private Cloud this key will be set automatically after a successful log-in.

General SettingsPermanent link for this heading

To avoid that users have to make settings on their own and for best performance deploy following settings on the clients:

  • Add the defined domain name (HTTP) to the trusted sites. This is necessary to enable features like opening and saving documents directly via the web browser.
    Key: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ZoneMap\Domains\<domain name e.g. example.com>\<hostname e.g. folio>\http
    Type: REG_DWORD
    Value: 2
  • Add the defined domain name (HTTPS) to the trusted sites. This is necessary to enable features like opening and saving documents directly via the web browser.
    Key: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\ZoneMap\Domains\<domain name e.g. example.com>\<hostname e.g. folio>\https
    Type: REG_DWORD
    Value: 2
  • Enable setting and retrieving HTTP cookies for the trusted site. This setting is necessary to avoid warnings in the log-in dialog of the Fabasoft Cloud Client.
    Key: HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Zones\2\1A10
    Type: REG_DWORD
    Value: 0
  • Increase the WebDAV file size limit to 1 GB to be able to work with large documents.
    Key: HKEY_LOCAL_MACHINE\SYSTEM\CurrentControlSet\Services\WebClient\Parameters\FileSizeLimitInBytes
    Type: REG_DWORD
    Value: 1073741824
  • Allow opening hyperlinks in Microsoft Office (http://support.microsoft.com/kb/218153).
    Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Office\9.0\Common\Internet\ForceShellExecute (32 bit operating system)
    or
    HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\Office\9.0\Common\Internet\ForceShellExecute (64 bit operating system)
    Type: REG_DWORD
    Value: 1

For more information about the meaning of these keys, consult http://msdn.microsoft.com.

File and Registry LocationsPermanent link for this heading

The data in these locations must not be removed or modified. The configuration settings will be written during the setup process and/or when logging in with the Fabasoft Web Browser Client.

  • C:\Users\<user>\AppData\Local\Temp (%TEMP%)
  • C:\Users\<user>\AppData\Local\Fabasoft (%LOCALAPPDATA%)
  • C:\Users\<user>\<synchronized folder> (%USERPROFILE%)
  • C:\Program Files (x86)\Fabasoft (Fabasoft Cloud Enterprise Client)
  • HKEY_CURRENT_USER\Software\Fabasoft
  • HKEY_CURRENT_USER\Software\Classes\CLSID\<CLSID>
  • HKEY_CURRENT_USER\Software\Classes\<ProgID>
  • HKEY_CURRENT_USER\Software\Microsoft\Office\Excel\AddIns\<ProgID>
  • HKEY_CURRENT_USER\Software\Microsoft\Office\Outlook\AddIns\<ProgID>
  • HKEY_CURRENT_USER\Software\Microsoft\Office\PowerPoint\AddIns\<ProgID>
  • HKEY_CURRENT_USER\Software\Microsoft\Office\Word\AddIns\<ProgID>
  • HKEY_CURRENT_USER\Software\Mozilla\NativeMessagingHosts\<ID>
  • HKEY_CURRENT_USER\Software\Google\Chrome\NativeMessagingHosts\<ID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\WOW6432Node\Fabasoft
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\<CLSID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion\Explorer\ShellIconOverlayIdentifiers
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\*\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Directory\background\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Directory\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Folder\Background\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Folder\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\IE.AssocFile.URL\ShellEx\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\IE.AssocFile.WEBSITE\ShellEx\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\InternetShortcut\ShellEx\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\lnkfile\shellex\ContextMenuHandlers\<ProgID>
  • HKEY_LOCAL_MACHINE\SOFTWARE\Classes\Microsoft.Website\shellex\ContextMenuHandlers\<ProgID>