# TeamViewer Pre-Requisites # TeamViewer General Pre-Requisites ## What Each operating system platform will have its own set of pre-requisites that need to be satisfied before you can use the TeamViewer solution through FileWave. ## When/Why To control devices, will require a macOS or Windows device running the full version of TeamViewer: - [Windows TeamViewer Full Installer](https://www.teamviewer.com/en-us/download/windows/) - [macOS TeamViewer Full Installer](https://www.teamviewer.com/en-us/download/mac-os/) We'll see conditional options in the FileWave Native and Web Administrator consoles (shown below) for a TeamViewer session whenever pre-requisites are met: ![tv-menu.png](https://kb.filewave.com/uploads/images/gallery/2023-06/eX6EYwFHDwYUR5UK-tv-menu.png)![tv-menu2.png](https://kb.filewave.com/uploads/images/gallery/2023-06/X8jT3Rm1dqKF1Z2K-tv-menu2.png) Computer Client Preferences Computer clients also rely upon the client settings for these options to be available: - FileWave Client Preferences > Privacy There are two options available: - Managed remote control - Prompt client for remote control access ![PromptDontPromptUser.png](https://kb.filewave.com/uploads/images/gallery/2023-06/yjTFxoadd9MvY6G6-promptdontpromptuser.png) The first option will allow/deny any connection via TeamViewer. The second option will be considered when the first option is enabled. The second option, for prompting, will then either allow only one or both options to be available. When prompt is disabled, both the options to either prompt or not prompt should be available. If Prompt is enabled though, the option to action a 'Don't prompt user' will not be available and only prompted connections may be established. These options may be configured with a [Superpref Fileset](https://kb.filewave.com/books/filewave-client/page/superprefs-fileset "Creating a Superprefs Fileset"). ## **How** The following table highlights specific prerequisites for complete functionality and helpful tips:
PlatformFW ServerFW ClientCompanion App/Kiosk/ExtensionSupporting Apps
Windows/macOSVersion 14.7+Version 14.7+n/aTeamViewer App pre-deployed
iOS/iPadOSVersion 14.7+n/aFileWave Kiosk IPA v 14.6+TeamViewer QuickSupport App (Licensed through VPP and deployed)
AndroidVersion 14.7+n/aCompanion App v 14.6+ (auto-deployed)TeamViewer QuickSupport App required, TeamViewer device-specific add-on also needed for device control
Chrome OSVersion 14.7+n/aExtension v 2021.10.07 (auto-deployed)TeamViewer QuickSupport App required, QS add-on eventually for device control
- Note that 14.6 was a Tech Preview for Team Viewer and should work aside from Unattended access, but 14.7 is when TV support moved to production release. For specific setup instructions, view each of the platform-specific articles. For notifications to be able to be sent to your remote devices, you'll need to make sure to open traffic from your FileWave server to rcs.filewave.com and fwpn.filewave.com on port 443. These are two new services that accept the session creation and push notification requests respectively. There are several setup-related items we'll need to take care of before we can use TeamViewer, and we'll go through them in order in the related articles found below. There are also videos located in the Foundry here: [https://foundry.filewave.com/course/view.php?id=19](https://foundry.filewave.com/course/view.php?id=19) (NOTE: When logging in tot he Foundry make sure to "Login via SSO") # TeamViewer: Chrome OS Client Setup ## **What** FileWave's TeamViewer integration requires endpoint prerequisites on each supported platform. In future versions, we may embed some of these prerequisites, but at this time, we erred on the side of letting you control the elements. So, slightly more work but much greater control. ## **When/Why** We'll need to meet prerequisites for ChromeOS client devices for TeamViewer to work seamlessly. Specifically, we'll need the following: - FileWave server to be upgraded to at least 14.7 - TeamViewer full client installed where you run the FileWave Central (Native) or Anywhere (Web) - The FileWave Inventory Extension is installed and up to date (version 2021.10.07+) - The inventory extension is required because it is the element that receives the notification to start the TV session - If the extension is already being pushed, it will simply auto-update when the new version is approved (currently under review) - Note that because this is a browser extension, the browser MUST be open for the TV session to work - The Google Play Store TeamViewer QuickSupport App installed - The QuickSupport app allows screen sharing

Although TeamViewer does not support remote control of Chrome OS devices, it has been seen to work (but without consistency) in some instances by applying the QS Universal Add-on. As such, the add-on could also be considered. \* The Google Play Store TeamViewer QS Universal Add-On \* The add-on allows device control

## **How** TeamViewer’s full application for Windows can be found here: [https://www.teamviewer.com/en-us/download/windows/](https://www.teamviewer.com/en-us/download/windows/) For macOS here: [https://www.teamviewer.com/en-us/download/mac-os/](https://www.teamviewer.com/en-us/download/mac-os/). You will need to run that on the device that runs the FileWave Administrator console or WebAdmin. For your clients, the below steps discuss the deployment of TeamViewer Host. If you aren't currently distributing the FileWave Chromebook Inventory Extension, you'll want to do that, and detailed instructions can be found [here](https://kb.filewave.com/books/evaluation-guide/page/chromebook-client-pre-requisites "Quick Start Guide for Chromebooks").

Details about what the Inventory Extension enables, and frequently asked questions can be found [here](https://kb.filewave.com/books/chromeos/page/chrome-os-filewave-inventory-extension-capabilities "Chrome OS: FileWave Inventory Extension Capabilities") and [here](https://kb.filewave.com/books/chromeos/page/chrome-os-filewave-inventory-extension-behavior-faq "Chrome OS: FileWave Inventory Extension Behavior (FAQ)") respectively.

Additionally, it will be very helpful to pre-deploy the QuickSupport App and the Universal Add-On through your Google Admin Console. In our environment, we chose to push both: ![chrome-setup1.png](https://kb.filewave.com/uploads/images/gallery/2023-06/sm5Ubjd0qfYMF2jJ-chrome-setup1.png) Note that both apps are from the Google Play Store, not from the Chrome store: ![chrome-setup2.png](https://kb.filewave.com/uploads/images/gallery/2023-06/hi2eAXJzw0G76YTN-chrome-setup2.png) # TeamViewer: iOS/iPadOS Client Setup ## What FileWave's TeamViewer integration requires endpoint prerequisites on each supported platform. i(Pad)OS is relatively simplistic though. ## When/Why ### Requirements: - FileWave Kiosk App (as of Kiosk V2, this is installed automatically). - TeamViewer QuickSupport App (available through App Store and deployable through MDM with VPP) - FileWave 14.7 for full, allowed control (Amount of options will vary per OS Vendor and OS type) - Permissions. (Apple devices require user approval for Screen Control).

User Approval is an Apple requirement for user privacy protection

i(Pad)OS with older versions of FileWave, required the FileWave Kiosk App IPA be deployed to devices, which may be downloaded from the relevant Download Pages and deployed through FileWave.

## **How** #### TeamViewer Full Application The computer used to view/control devices will require the full version of TeamViewer and may be downloaded from the TeamViewer site: - Windows: [https://www.teamviewer.com/en-us/download/windows/](https://www.teamviewer.com/en-us/download/windows/) - macOS: [https://www.teamviewer.com/en-us/download/mac-os/](https://www.teamviewer.com/en-us/download/mac-os/) #### TeamViewer QuickSupport Devices require the QuickSupport version, available from the App Store: - [TeamViewer QuickSupport App Store Link](https://apps.apple.com/us/app/teamviewer-quicksupport/id661649585) - If searching for the App, e.g in Apple Business or School Manager, the App ID is: 661649585 TeamViewer QuickSupport is a free App. Any of the above may be deployed to devices as Filesets.

Always consider testing on a smaller subset of devices, prior to mass deployment.

Use of TeamViewer through FileWave requires an assigned TeamViewer licence to a FileWave Administrator through the Manage Administrator Preferences. Only assigned FileWave Administrators will have the option to control devices.

# TeamViewer: macOS Client Setup ## What FileWave's TeamViewer integration requires endpoint prerequisites on each supported platform. Majority of these have been left untouched, but may be altered, allowing slightly more work (if desired) but much greater control. ## When/Why TeamViewer is used to remotely control your clients, providing access to a device for troubleshooting or assisting a user. TeamViewer for macOS differs from other OSs since it requires a few privacy permissions before allowing TeamViewer to be installed. ## How Prerequisites for macOS client devices must be met in order for TeamViewer to work seamlessly: - Server and Clients have to be FileWave 14.7+ - [General TeamViewer Prerequisites](https://kb.filewave.com/books/teamviewer/page/teamviewer-general-pre-requisites) are met, ensuring that clients are set to allow remote control - [TCC Profile for TeamViewer Host - Accessibility and Full Admin Access](#bkmrk-tcc-profile-for-team) - [TeamViewer Host Fileset](#bkmrk-teamviewer-host-file) The below describes installing the TeamViewer Host application. The full TeamViewer application is only necessary for computers wanting to remote into other computers. The Host application is only allowed to accept connections and not initiate them; highly recommended. (During an attempt to prompt a device for control, users will be prompted to either install or launch a local copy of Teamviewer. Only the TeamViewer Host version can be launched if pre-installed.) ### FileWave Client (14.7+)

Remember to always use the client updater Fileset to update FileWave clients. Do **NOT** push the FileWave client PKG to upgrade macOS clients.

The most recent FileWave client is always included on the FileWave download pages: [Downloads](https://kb.filewave.com/books/downloads "Downloads") ### TCC Profile for TeamViewer Host - Accessibility and Full Admin Access

Both profiles enable 2 of the 3 permissions TeamViewer Host requires. The 3rd, Screen Recording, is a privacy setting that can not be allowed by anyone other than a local user. Standard Users do not have permissions to allow Screen Recording by default. This option to allow a non-Admin to enable Screen Sharing is available in one of the provided Profiles.

Screen Sharing is a service deemed by Apple as user privacy. Hence, users must locally enable Screen Sharing on macOS.

Once allowed, if left enabled, subsequent TeamViewer sessions to that device my be actioned, without user prompting.

Both Profiles have the following settings: [![image.png](https://kb.filewave.com/uploads/images/gallery/2024-04/scaled-1680-/Wr6Ov94aWjqAGa9g-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-04/Wr6Ov94aWjqAGa9g-image.png) However, one of them allows Screen Recording to be enabled by a non-Admin user: [![image.png](https://kb.filewave.com/uploads/images/gallery/2024-04/scaled-1680-/mCFamzRWYr2MtnXy-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-04/mCFamzRWYr2MtnXy-image.png) Each profile contains two payloads: Privacy Settings & Custom Settings #### Privacy Settings Permissions to allow TeamViewer access rights.
**TCC Profile for TeamViewer Host:** - **[TeamViewerHost15.mobileconfig](https://kb.filewave.com/attachments/337)** **TCC Profile for TeamViewer Host with Standard User Screen Recording Allowance 11+:** - **[TeamViewerHost15AllowUser.mobileconfig](https://kb.filewave.com/attachments/338)**
#### Custom Settings Example additional configuration. The included example settings include: - Security\_Adminrights -- Lock TeamViewer options for Administrator rights - Security\_PasswordStrength -- Password disabled, ensuring access is only via FileWave [![image.png](https://kb.filewave.com/uploads/images/gallery/2024-04/scaled-1680-/jCnzZHtokjWx9UoL-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-04/jCnzZHtokjWx9UoL-image.png) ### TeamViewer Host Fileset The included Filesets are examples which utilise a settings file set to instal the software silently. Choose an embedded TeamViewer Fileset:
**Note that only one of the below is required, but more than one version may be offered in case an older version is needed.** **[TeamViewer Host Instal macOS 15.57.3.fileset.zip](https://kb.filewave.com/attachments/386)** **[TeamViewer Host Install macOS 15.52.3.fileset.zip](https://kb.filewave.com/attachments/336)**
Latest version can be downloaded from TeamViewer directly, however, the public downloadable DMG has an application that instals the software and does not allow for the configuration presented at the time of installation; upgrades should occur automatically as indicated below - [macOS TeamViewer Host](https://download.teamviewer.com/download/TeamViewerHost.dmg) #### Fileset Contents: [![macOS TeamViewer Host Fileset Contents](https://kb.filewave.com/uploads/images/gallery/2023-06/scaled-1680-/8HUgSB7eMcTXMMm5-screenshot-2023-06-15-at-3-22-03-pm.png)](https://kb.filewave.com/uploads/images/gallery/2023-06/8HUgSB7eMcTXMMm5-screenshot-2023-06-15-at-3-22-03-pm.png) ##### Installer and Installer Options: The choices.xml file is configured to instal the .pkg silently. However, the user will be prompted with notifications, since Apple allow users to choose if apps are allowed to control the screen or not. [![image.png](https://kb.filewave.com/uploads/images/gallery/2024-09/scaled-1680-/VmJ52iXvv3u9Butt-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-09/VmJ52iXvv3u9Butt-image.png) ##### Requirement Script: Where software is already installed and services are active, Privacy Settings Profiles installed subsequently require the service of that software to be restarted. This Fileset example includes a Requirement Script that checks for profile installation before activating TeamViewer, preventing the need to restart the TeamViewer Host service. The 'check\_tv\_profile.sh' script is designed to recognise one of the two provided Profiles and, once installed, allow activation of the Fileset. If Profiles with a different Profile ID are used instead of those supplied, the script settings will require alteration. - Double click the Fileset - Select the 'check\_tv\_profile.sh' (located in a numbered subfolder in /var/scripts/) - Choose Get Info > Executable view The Launch Arguments show the two possible Payload IDs. Add in the correct Fileset Profile ID if not using the provided ones. [![image.png](https://kb.filewave.com/uploads/images/gallery/2024-04/scaled-1680-/Zg9Ly21aSi8Abtnz-image.png)](https://kb.filewave.com/uploads/images/gallery/2024-04/Zg9Ly21aSi8Abtnz-image.png)

The two profiles may be uploaded simultaneously. The Fileset Requirement Script is able to identify either profile.

##### Activation Script: The script in this case is installing the PKG. Note the script allows the specifying of the 'choices.xml' file when ran. ``` #!/bin/zsh installer -applyChoiceChangesXML /usr/local/etc/TeamViewer/choices.xml -pkg "/usr/local/etc/TeamViewer/Install TeamViewerHost.pkg" -target / exit 0 ``` ##### Post-Uninstallation Script: The 'mac\_teamviewer\_uninstaller.sh' script uninstalls TeamViewer if an association or deployment no longer exists. #### Updates The software should auto update to latest version. The PKG is not publicly accessible. For this reason, FileWave will aim to update the provided Fileset every so often, to include the latest version, but if not yet updated to the latest version, the client should auto update the installed version where the Fileset is still using an older version.

Don't forget to upgrade the full TeamViewer version on the Admin device.

## Related Content - [TeamViewer macOS Mass Deployment Guide](https://community.teamviewer.com/English/kb/articles/50739-mass-deployment-on-macos)
# TeamViewer: Windows Client Setup ## **What** FileWave's TeamViewer integration requires endpoint prerequisites on each supported platform. In future versions, we may embed some of these prerequisites, but at this time, we erred on the side of letting you control the elements. So, slightly more work but much greater control. ## **When/Why** We'll need to meet prerequisites for Windows client devices for TeamViewer to work seamlessly. (Technically, the TeamViewer App can be run or installed by the customer, but pre-deploying makes the experience much more seamless and avoids issues with administrative rights, etc.) We'll need the following: - FileWave server to be upgraded to at least 14.7 (14.6 is permitted but was a technical preview) - FileWave client to be upgraded to at least 14.7 (14.6 is permitted but was a technical preview and unattended access won't be present) - [TeamViewer Pre-Requisites](https://kb.filewave.com/books/teamviewer/chapter/teamviewer-pre-requisites "TeamViewer Pre-Requisites") are met, ensuring that clients are set to allow remote control - **TeamViewer Full Application** installed on computers running FileWave Central (Native) or Anywhere (Web) - **TeamViewer Host Application** installed on devices to be controlled.

The required TeamViewer Host installer is bundled in the below provided Fileset and pre-configuration by way of a 'tvopt' file

The host version of TeamViewer does not provide the ability for users to control other devices.

## **How** ### FileWave Client The most recent FileWave client is always included on the FileWave download pages, available here: [Downloads](https://kb.filewave.com/books/downloads "Downloads")

Remember to always use the client updater Fileset to update clients. Do **NOT** push the FileWave client MSI to upgrade Windows clients.

### TeamViewer Full Application The computer used to view/control devices will require the full version of TeamViewer and may be downloaded from the TeamViewer site: - Windows: [https://www.teamviewer.com/en-us/download/windows/](https://www.teamviewer.com/en-us/download/windows/) - macOS: [https://www.teamviewer.com/en-us/download/mac-os/](https://www.teamviewer.com/en-us/download/mac-os/) ### TeamViewer Client The installer is actioned with scripts, inside the provided Fileset, configured to ensure the installation is silent, including: - Disabling the prompt to configure Unattended Access - Removing the desktop icon

TeamViewer Host MSI download requires an account with TeamViewer. FileWave includes the MSI within the Fileset, but this should not be exported and redistributed. FileWave will aim to update the Fileset periodically to include newer versions of TeamViewer.

Choose an embedded TeamViewer Fileset:
**Note that you only need one of the below, but we may offer several versions in case you need an older version.** **[TeamViewer Host Windows 15.53.6.0.fileset.zip](https://kb.filewave.com/attachments/340)** **[TeamViewer Host Windows 15.40.8.0.fileset.zip](https://kb.filewave.com/attachments/22)**
If there is a need to update before FileWave has provided a newer version, the download of the latest version of TeamViewer Host is only available publicly as an EXE: - [Windows TeamViewer Host 32bit](https://download.teamviewer.com/download/TeamViewer_Host_Setup.exe) - [Windows TeamViewer Host 64bit](https://download.teamviewer.com/download/TeamViewer_Host_Setup_x64.exe) If downloading the EXE, a new Fileset should be created using the EXE to upgrade. Access to the MSI is limited to those with accounts, but if access is available, download the latest MSI. After downloading the MSI, replace the current 'TeamViewer\_Host.msi' with the downloaded version, ensuring the name of the MSI installer matches. - Rename download as: **'TeamViewer\_Host.msi'** - Double click current TeamViewer Fileset - Expand: '**/ProgramData/FileWave/Installers/TeamViewer**' - Replace MSI

Disassociation of the Fileset will uninstall TeamViewer Host with a pre-uninstallation script.

#### Customization The Fileset provided has an example 'tvopt' file, which will customize the installation if left as is. If no customization is desired, this file may be removed. Alternatively, it is possible to upload an alternate 'tvpopt; file, preset as desired. Example file 'example.custom.tvopt' highlighted in the image. Add a built file into the same directory called 'custom.tvopt' to override this; the 'example.custom.tvopt' may be left behind or removed. ![TV_Fileset_Contents.png](https://kb.filewave.com/uploads/images/gallery/2023-06/DaO4bZlZ3PJjAEck-tv-fileset-contents.png) #### Create Custom 'tvopt' Follow the example instructions below to create a TeamViewer Host custom settings file for enforcement at the time of installation.

The TeamViewer Host app can be customized and secured to: \* Prevent users from connecting to their own devices remotely. Connections will only be possible via FileWave \* Blocking users from editing the settings by protecting them with a password.

For example, to secure the TeamViewer Host app and export its settings: 1. Install the TeamViewer Host component on a test device. 2. Launch it from the TeamViewer icon in the system tray, edit the settings and set the following options: - Security > Random password (for spontaneous access) > Password strength=Disabled (no random password) - Advanced > TeamViewer options > Changes require administrative rights on this computer - Set Options/Confirm password fields 3. Click the Export button at the bottom of the Advanced options sections on the right. Save it as 'custom.tvopt'. - Check Export user-specific settings as default for all users 4. Drag the 'custom.tvopt' file into the Fileset within the same directory as the current example file and installer MSI 5. Test before deploying en masse TeamViewer also provides guidance here on mass deployment that may be helpful: [https://community.teamviewer.com/English/kb/articles/39639-mass-deployment-on-windows](https://community.teamviewer.com/English/kb/articles/39639-mass-deployment-on-windows) # TeamViewer: Android EMM Client Setup ## What FileWave's TeamViewer integration requires endpoint prerequisites on each supported platform. In future versions, we may embed some of these prerequisites, but at this time, we erred on the side of letting you control the elements. So, slightly more work but much greater control. ## When/Why TeamViewer’s full application for Windows can be found here: [https://www.teamviewer.com/en-us/download/windows/](https://www.teamviewer.com/en-us/download/windows/). For macOS, here: [https://www.teamviewer.com/en-us/download/mac-os/](https://www.teamviewer.com/en-us/download/mac-os/). You will need to run that on the device that runs the FileWave Administrator console or WebAdmin. For your clients, the below steps discuss the deployment. We'll need to meet prerequisites for Android client devices for TeamViewer to work seamlessly. We'll need the FileWave companion app to be upgraded to at least 14.7, and we'll want to deploy the TeamViewer QuickSupport and add-on applications as well.
ComponentInstall?Notes
Android EMM Companion App (FW Client App)\* YesAuto-deployed
TeamViewer QuickSupport App (Google Play Store)\* Yes[Details](https://play.google.com/store/apps/details?id=com.teamviewer.quicksupport.market), which can be deployed as a FileWave Fileset: [Play Store App - TeamViewer QuickSupport.fileset.zip](https://kb.filewave.com/attachments/190)
TeamViewer Add-On (Google Play Store)\* YesThe add-on is required for device control (typing, screen clicks, etc)...and is specific to each type of Android device, reference the article linked to from the How section below for specifics about best practices for deployment

FW Client App must be able to both resolve the server DNS name and reach the server since communication from this App is direct to the server, not via Google. Without this communication, the version of FW Client will not be updated on the server and the option to 'Open Remote Session' will be greyed out.

## How There are two elements we need to deploy to support TeamViewer on Android EMM devices: - The TeamViewer QuickSupport App, which provides basic TeamViewer viewing capabilities, and - The TeamViewer QuickSupport Add-On tool, which provides the ability to control the endpoint's cursor and keyboard To keep the distribution simple and elegant, we'll probably want to build a structure that looks something this: [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/eA5qEmA2n3V5Isz4-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/eA5qEmA2n3V5Isz4-image.png)

Note that you could also publish all of the apps needed to the Play Store Kiosk on the devices as well, but we feel that would be pretty cluttered for the users of the devices, albeit simpler for the FileWave admin.

In our structure, the top-level group is just a manual group, and we will assign the Fileset (Payload) for the TeamViewer QuickSupport app here. Below that top-level group we'll create groups for ***each*** type of Android device we have. The add-on is device-specific, therefore we will create a smart group for each device type based on the ***Device Product Name*** field. [![image.png](https://kb.filewave.com/uploads/images/gallery/2023-07/scaled-1680-/xXouthust1xPtx9D-image.png)](https://kb.filewave.com/uploads/images/gallery/2023-07/xXouthust1xPtx9D-image.png) In the case of the Lenovo M10 tablet, the product name is "Lenovo TB-X605F", so we created a Smart Group based on Device Product Name matching that exact name. Because this group is a smart group all M10 tablets will automatically be included and, therefore will have the QuickSupport app assigned from the group above, which addresses our first pre-requisite.

Remember, you can duplicate a smart group by right-clicking and choosing "Duplicate"...this makes it much simpler to add multiple similar smart groups.

Now, for the Add-On installation...it is a bit more complicated because we don't know which add-on fits our device best. In this case, it is best just to cheat and let the TeamViewer QuickSupport app recommend the add-on to install on a sample device. In our case, it recommends an add-on for the x705F, found here: [https://play.google.com/store/apps/details?id=com.teamviewer.quicksupport.addon.lenovo\_tb\_x705f](https://play.google.com/store/apps/details?id=com.teamviewer.quicksupport.addon.lenovo_tb_x705f) So, we'll now create a Fileset for that app. and assign it to the appropriate smart group. Then, rinse and repeat for each device type, which hopefully won't be too many.

There is also a Universal Add-On available, but at least in our testing, the device-specific add-ons worked best.

On initial setup, the option for starting a remote control session for an Android can be delayed to allow synchronization between FileWave/Google. This is only at the setup of the device though and should complete within 15-30 minutes maximum.