Apple macOS

In order to select the correct package depending on the processor, check the chip of the Apple macOS device you are using:

1. At the top left, open the Apple menu.
2. Click "About This Mac".
3. In the appearing window, look for "Processor" or "Chip".
4. Check if it says "Intel" or "Apple".

Installing

To install the Fabasphere Client, perform the following steps:

1. Download the installation package that fits the chip type of the device from the Fabasphere.
   Apple Chip
   https://at.cloud.fabasoft.com/folio/fscasp/content/lib/FabasphereClient-Apple.dmg
   Intel Chip
   https://at.cloud.fabasoft.com/folio/fscasp/content/lib/FabasphereClient-Intel.dmg
2. Double-click the downloaded DMG file.
3. Drag the app to the “Applications” folder.
   Note: In case of an update keep in mind to close the Fabasphere Client (menu bar > Fabasphere symbol > Quit) before dragging the new app to the “Applications” folder and replacing the old one.
4. Open the “Applications” folder and run the Fabasphere Client.
5. Enter the credentials of an administrative user to finish the installation.
   Note: For users without administrative rights, the administrator can finish the installation by executing the following command.
   sudo /Applications/Fabasoft*/Contents/MacOS/Fabasoft*UI* -runsetup:1
6. For optimum configuration, the authorizations required by the client should also be set. These are initially configured when the Fabasphere Client is started for the first time if you confirm this in the dialogs (e.g. activating the web browser extension in Safari "Safari -> "Settings" > "Extensions").

Deployment via Mobile Device Management Profile

For preconfigured workstations, where the users do not have administrative rights, the following security settings must be configured for smooth operation.

The code requirements can be obtained by following command:

codesign --display -r - <path to application>

* For “Apple Events” it is necessary to define the appropriate receiver.

Uninstalling

Uninstalling the Client

To uninstall the Fabasphere Client, perform the following steps:

1. Quit the Fabasphere Client.
2. Open “System Preferences” > “Extensions” and disable the “Finder” entry under “Fabasphere”.
3. Open “Finder” and delete the following files:
   • /Applications/Fabasphere.app
   • /Library/PrivilegedHelperTools/com.fabasoft.finderinjectorpu
   • /Library/LaunchDaemons/com.fabasoft.finderinjectorpu.plist
   • ~/Library/Application Support/Fabasoft
4. Open the following files and remove all lines containing the following:
   Fabasphere, nmextmozpu@fabasoft.com, icjlkccflchmagmkfidekficomdnlcig, jdibaejnifcnoojmhgcbaohifohjamlg
   • /Library/Preferences/org.mozilla.firefox.plist
   • /Library/Preferences/org.mozilla.thunderbird.plist
   • /Library/Managed Preferences/com.google.Chrome.plist
   • /Library/Managed Preferences/com.microsoft.Edge.plist
5. Run the command “killall cfprefsd” and restart your browser or restart the computer.

Removing the Fabasoft Settings (Optional)

To remove the settings, perform the following steps:

1. Open the Finder, point to “Go” and click “Go to folder”.
   A dialog box opens.
2. Type “~/.fsc” and click “Go”.
   
   This command leads you to the folder containing the settings.
3. Delete the .fsc folder.

Note: When removing the .fsc folder all settings and not yet saved files will be lost.

Security Settings

The following security settings must be made after installing the Fabasphere Client.

• Access for “Accessibility Access”
  The corresponding pop-up appears directly after the first start of the Fabasphere Client.
• Allow Control for “Finder.app”
  The corresponding pop-up appears when clicking "Open Fabasphere Folder" and navigating in the synchronized folder.
• Allow Control for “Mail.app”
  The corresponding pop-up appears when executing the use case "Send as Link".
• Access for “Screen Recording”
  The corresponding pop-up appears when you log in for the first time in the Fabasphere.

Predefined Settings for Users

The users have the possibility to make different settings in the options dialog. These settings can also be set by the administrator using group policies so that the users can no longer change them.

The predefined settings can be defined in the following path:

/Library/Preferences/com.fabasoft/machine/Software/Policies/Fabasoft/NativeClient/Cloud

Each setting is stored in a text file. Note, that the file must not contain any leading or trailing whitespace characters or line breaks.

For more information about the functionality, see https://help.cloud.fabasoft.com/index.php?topic=doc/User-Help-Fabasphere-AI-Core-eng/the-fabasphere-client.htm#options-dialog: new window

• Enable Automatic Update
  File name: AUTOUPDATE
  File content (disabled): 0
  File content (enabled): 1
• Automatic Update URL
  Value name: AUTOUPDATE_URL
  File content: <web server>/<vdir>
• Enable Synchronization
  Value name: SYNC_FS
  File content (disabled): 0
  File content (enabled): 1
• Enable Document Exchange via LAN
  File name: SYNC_FS_LAN
  File content (disabled): 0
  File content (enabled): 1
• Configure Port for Document Exchange via LAN
  File name: SYNC_FS_LANPORT
  File content: 1024 – 65535
• Enable Open Network Drive
  File name: MOUNT_WEBDAV
  File content (disabled): 0
  File content (enabled): 1
• Automatic Proxy Login
  File name: AUTOLOGIN_PROXY
  File content (disabled): 0
  File content (enabled): 1
• Download Speed Limitation
  File name: DOWNLOAD_KBSEC
  Type: REG_DWORD
  File content (disabled): 0
  File content (enabled): <KB/s>
• Upload Speed Limitation
  File name: UPLOAD_KBSEC
  Type: REG_DWORD
  File content (disabled): 0
  File content (enabled): <KB/s>
• Restrict the Allowed Domains
  File name: VALIDDOMAINS
  File content (only *.fabasoft.com): <empty>
  File content (explicitly allowed domains): <domain>(:<port>)
• Manually defined proxy server (see also “Manual Proxy Configuration”)
  File name: PROXYSERVER
  File content: <proxy server>(:<port>)

File and Registry Locations

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.

• /Applications/Fabasphere.app
• /Library/PrivilegedHelperTools/com.fabasoft.finderinjectorpu
• ~/Library/Application Support/Fabasoft
• ~/.fsc/
• /Library/Application Support/Adobe/CEP/extensions/com.fabasoft.cloud