TeamViewer IoT on Microsoft Azure - TeamViewer Support
<main> <article class="userContent"> <p><em>This guide contains the instructions to install TeamViewer IoT from the Azure Marketplace on an IoT Edge device which is managed with Microsoft Azure.</em></p><p><br></p><h3></h3><h2 data-id="prerequisites">Prerequisites</h2><p>This integration falls under the TeamViewer IoT license plan</p><ol><li>A TeamViewer Account and a TeamViewer Client installed on Windows</li><li>Azure IoT hub needs to be installed on the device </li><li>And the device registered as IoT edge to an Azure IoT Hub</li></ol><p>For reference on step 1 and 2 please refer to</p><div class="js-embed embedResponsive" data-embedjson="{"body":"Create and provision a single IoT Edge device in IoT Hub for manual provisioning with symmetric keys","photoUrl":"https:\/\/docs.microsoft.com\/en-us\/media\/logos\/logo-ms-social.png","url":"https:\/\/docs.microsoft.com\/en-us\/azure\/iot-edge\/how-to-provision-single-device-linux-symmetric?view=iotedge-2020-11&tabs=azure-portal","embedType":"link","name":"Create and provision an IoT Edge device on Linux using symmetric keys - Azure IoT Edge"}"> <a href="https://docs.microsoft.com/en-us/azure/iot-edge/how-to-provision-single-device-linux-symmetric?view=iotedge-2020-11&tabs=azure-portal" rel="nofollow noreferrer ugc"> https://docs.microsoft.com/en-us/azure/iot-edge/how-to-provision-single-device-linux-symmetric?view=iotedge-2020-11&tabs=azure-portal </a> </div><p><br></p><h3 data-id="-1"> </h3><h2 data-id="installation-instructions">Installation Instructions</h2><h2 data-id="download">Download</h2><p>1.) Download TeamViewer IoT from the Azure marketplace. Search for <code class="code codeInline" spellcheck="false" tabindex="0">Teaviewer-iot-edge</code> or use the link <a href="https://azuremarketplace.microsoft.com/de-de/marketplace/apps/teamviewergmbh.test_iot?tab=Overview" rel="nofollow noreferrer ugc">https://azuremarketplace.microsoft.com/de-de/marketplace/apps/teamviewergmbh.test_iot?tab=Overview</a></p><p>2.) Click on <strong>Get it now:</strong></p><p><br></p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/02L39YNSGNA7/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/02L39YNSGNA7/image.png" alt="image.png" height="860" width="1734" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>3.) Log in to your Azure Account and select the subscription under which the IoT device with Azure IoT has been registered </p><p>4.) Select the edge device and click <strong>Create</strong></p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/VC9CRE92UH4F/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/VC9CRE92UH4F/image.png" alt="image.png" height="267" width="759" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p><br></p><h3 data-id="-2"></h3><h2 data-id="setup">Setup</h2><p>A new module called <strong>TeamViewerIoTEdge</strong> shows up under <strong>IoTEdge </strong>Modules</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/T1RGCQ9FGA8F/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/T1RGCQ9FGA8F/image.png" alt="image.png" height="499" width="817" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>1.) Click on TeamviewerIoTEdge to finalize the configuration </p><p>2.) Provide the requested parameters for the Environment variables and optional ones to your needs from the table below</p><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/KO21V57ROEGG/image.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/KO21V57ROEGG/image.png" alt="image.png" height="658" width="843" loading="lazy" data-display-size="large" data-float="none"></img></a> </div> </div> <p>The same info as in the table above but for you to copy/paste and the search engine to use the info:</p><p><START TABLE></p><p><strong>Variable </strong>(Required Variables): SERIAL_NUMBER_DOCKER_CONTAINER</p><p><strong>Parameter Value</strong>: 8 character string</p><p><strong>Description</strong>: Unique ID for this agent, select any min 8-characters string</p><p>__</p><p><strong>Variable </strong>(Required Variables): ASSIGNMENT_API_TOKEN</p><p><strong>Parameter Value</strong>: Assignment Token</p><p><strong>Description</strong>: Login to teamviewer-iot.com and click on the username on the top right and select "assignment token" </p><p>__</p><p><strong>Variable </strong>(Required Variables): ASSIGNMENT_GROUP_NAME</p><p><strong>Parameter Value</strong>: String</p><p><strong>Description</strong>: Group name in the TeamViewer Contact list the device shall be added to</p><p>__</p><p><strong>Variable </strong>(Required Variables): EULA_ACCEPTED</p><p><strong>Parameter Value</strong>: Yes or No</p><p><strong>Description</strong>: Must be set to 'Yes' (case sensitive!) the TeamViewer EULA can be found here: <a href="https://www.teamviewer.com/eula/" rel="nofollow noreferrer ugc">https://www.teamviewer.com/eula/</a></p><p>__</p><p><strong>Variable </strong>(Optional Variables): ENABLE_REMOTE_TERMINAL</p><p><strong>Parameter Value</strong>: 0 or 1</p><p><strong>Description</strong>: Enable or disable the terminal to have access to the Commandline of the docker container from TeamViewer</p><p>__</p><p><strong>Variable </strong>(Optional Variables): ENABLE_APP_CONTROL</p><p><strong>Parameter Value</strong>: 0 or 1 (default is 1)</p><p><strong>Description</strong>: Webinterface to show from Teamviewer</p><p>__</p><p><strong>Variable </strong>(Optional Variables): APP_CONTROL_PORT</p><p><strong>Parameter Value</strong>: Default 80</p><p><strong>Description</strong>: Port of the webserver that is running in the container and shall be accessed</p><p>__</p><p><strong>Variable </strong>(Optional Variables): APP_CONTROL_WEB_SERVER_IP_ADDRESS</p><p><strong>Parameter Value</strong>: -</p><p><strong>Description</strong>: -</p><p>__</p><p><strong>Variable </strong>(Optional Variables): APP_CONTROL_URL_SUFFIX</p><p><strong>Parameter Value</strong>: -</p><p><strong>Description</strong>: In case that the webserver uses a suffix a part of the URL (<a href="unsafe:http://SERVER-IP:PORT/SUFFIX" rel="nofollow noreferrer ugc">http://SERVER-IP:PORT/SUFFIX</a>)</p><p>__</p><p><strong>Variable </strong>(Optional Variables): APP_CONTROL_NAVIGATION_PANEL</p><p><strong>Parameter Value</strong>: -</p><p><strong>Description</strong>: There is also a navigation panel available in the AppControl window which you can activate or deactivate</p><p>__</p><p><strong>Variable </strong>(Optional Variables): APP_CONTROL_ENABLE_TLS</p><p><strong>Parameter Value</strong>: -</p><p><strong>Description</strong>: Enables AppControl to support TLS. Please change AppControlPort to 443</p><p>__</p><p><strong>Variable </strong>(Optional Variables): ENABLE_APP_CONNECT</p><p><strong>Parameter Value</strong>: -</p><p><strong>Description</strong>: TeamViewer port forwarding connects local ports to ports on the target device via a TeamViewer connection.</p><p>__</p><p><strong>Variable </strong>(Optional Variables): APP_CONNECT_ALLOWED_PORTS</p><p><strong>Parameter Value</strong>: -</p><p><strong>Description</strong>: To define which ports are allowed to connect to you have to fill out the port white list. You can add more than one port to the environment variable. E.g: 22 443</p><p><END TABLE></p><p>__</p><p>3.) Copy container create options from the template below</p><p>a.) Note adapt Hostname that the device should later show in your TeamViewer Inventory</p><pre class="code codeBlock" spellcheck="false" tabindex="0">{ "Hostname": "ubuntu-server-amd64", "Mounts": [ { "Type": "bind", "Source": "/var/run/dbus", "Destination": "/var/run/dbus", "Mode": "", "RW": true, "Propagation": "rprivate" }, { "Type": "bind", "Source": "/proc", "Destination": "/var/persistent/proc", "Mode": "", "RW": true, "Propagation": "rprivate" } ], "HostConfig": { "Binds": [ "/var/run/dbus:/var/run/dbus", "/proc:/var/persistent/proc" ], "ContainerIDFile": "", "LogConfig": { "Type": "json-file", "Config": {} } }, "Config": { "Volumes": { "/tmp/teamviewer-iot-agent": {}, "/var/run/dbus": {}, "/proc": {} } } } </pre><p>4.) Click <strong>Update </strong>and follow flow on<strong> review+create</strong></p><p><br></p><h3 data-id="-3"></h3><h2 data-id="finalize">Finalize</h2><p>Wait ~10 mins to have the agent downloaded to your device and let the Azure IoT hub set it up.</p><p>The IoT agent should show up in Computer & Contacts list plus and on the inventory page on <a href="http://www.teamviewer-iot.com" rel="nofollow noreferrer ugc">www.teamviewer-iot.com</a> and is ready to connect.</p> </article> </main>
