Reassign the Starter Kit to another TeamViewer Account - TeamViewer Support
<main> <article class="userContent"> <p><br></p><p>Use this procedure to move the <strong>TeamViewer Starter Kit</strong> from the preassigned account to another <strong>TeamViewer Account</strong>.</p><p>This procedure contains 3 basic steps:</p><ol><li>Unmanage and Reassign the Starter Kit</li><li>Reconfigure the Digital Inputs/Outputs</li><li>Apply the Reconfiguration and Restart</li></ol><p><br></p><h3></h3><h2 data-id="what-you-will-need">What you will need</h2><p>Make sure that you have prepared the following points:</p><ul><li>Your login credentials for the Starter Kit (user name, and password).</li><li>You created a new TeamViewer Account (see <a href="https://teamviewer-iot.com/?_ga=2.243542021.1267155332.1678714263-1498331324.1676560266&_gac=1.3401476.1677856287.EAIaIQobChMI8MLb24XA_QIVTY1oCR1RMQOWEAAYASAAEgIoV_D_BwE" rel="nofollow noreferrer ugc">https://teamviewer-iot.com/</a>).</li><li>You have the <a href="https://community.teamviewer.com/English/kb/articles/109803-get-the-ip-address-of-the-edge-device-iot-agent" rel="nofollow noreferrer ugc">IP Address of the Edge Device / IoT Agent</a>.</li><li>A tool to access the Starter Kit remotely via ssh (e.g. <a href="https://www.putty.org/" rel="nofollow noreferrer ugc">Putty</a>).</li><li>Basic knowledge of the editor <a href="https://www.nano-editor.org/" rel="nofollow noreferrer ugc">nano</a>.</li></ul><p><br></p><h3 data-id="-1"></h3><h2 data-id="unmanage-and-reassign-the-starter-kit">Unmanage and reassign the Starter Kit</h2><p>📌<strong>Note:</strong> When unmanaging the Starter Kit, it is no longer available for your old TeamViewer Account.</p><p>1. Log in to the <strong>Starter Kit</strong> and use your credentials by using an <strong>ssh-tool</strong>.</p><p>2. Unmanage the Starter Kit. In the terminal type in the following command and press return.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo teamviewer-iot-agent unmanage </pre><p>3. Assign the Starter Kit to the new TeamViewer Account. In the terminal, type in the following command and press return. Use your <strong>new TeamViewer Account credentials</strong> when prompted.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo teamviewer-iot-agent setup </pre><p>4. Restore the configuration of the <strong>Monitoring Agent</strong> for the <strong>Bosch XDK sensors</strong>. In the terminal type in the following commands and press return.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo teamviewer-iot-agent disable system-health sudo su sudo cat /var/lib/teamviewer-iot-agent/system_monitors_kit.conf > /var/lib/teamviewer-iot-agent/system_monitors.conf sudo teamviewer-iot-agent enable system-health </pre><p><br></p><h3 data-id="-2"></h3><h2 data-id="reconfigure-the-digital-inputsoutputs">Reconfigure the digital inputs/outputs</h2><p>To use the <strong>Digital Inputs/Outputs</strong> (DIOs) of the Starter Kit with the TeamViewer IoT Agent, you need to create corresponding Sensors/Metrics.</p><p>1. To log in to the <strong>IoT Management Console</strong>, open a web browser. Navigate to the <strong>IP address</strong> of the Starter Kit (obtained by <a href="https://community.teamviewer.com/English/kb/articles/109803-get-the-ip-address-of-the-edge-device-iot-agent" rel="nofollow noreferrer ugc">Get the IP Address of the Edge Device / IoT Agent</a>).</p><p>2. From the left menu select <strong>API Clients</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/O9Z4BX20YBM4/reassign-starterkit-api-clients.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/O9Z4BX20YBM4/reassign-starterkit-api-clients.png" alt="reassign-starterkit-api_clients.png" height="426" width="1200" loading="lazy" data-display-size="large" data-float="none" srcset="https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=10/https://us.v-cdn.net/6032394/uploads/O9Z4BX20YBM4/reassign-starterkit-api-clients.png 10w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=300/https://us.v-cdn.net/6032394/uploads/O9Z4BX20YBM4/reassign-starterkit-api-clients.png 300w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=800/https://us.v-cdn.net/6032394/uploads/O9Z4BX20YBM4/reassign-starterkit-api-clients.png 800w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1200/https://us.v-cdn.net/6032394/uploads/O9Z4BX20YBM4/reassign-starterkit-api-clients.png 1200w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1600/https://us.v-cdn.net/6032394/uploads/O9Z4BX20YBM4/reassign-starterkit-api-clients.png 1600w, https://us.v-cdn.net/6032394/uploads/O9Z4BX20YBM4/reassign-starterkit-api-clients.png"></img></a> </div> </div> <p>3. As <strong>client name</strong> type in <code class="code codeInline" spellcheck="false" tabindex="0">Digital Out</code> then 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/PVFZEBSWCK8F/reassign-starterkit-digital-out.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/PVFZEBSWCK8F/reassign-starterkit-digital-out.png" alt="reassign-starterkit-digital_out.png" height="543" width="1200" loading="lazy" data-display-size="large" data-float="none" srcset="https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=10/https://us.v-cdn.net/6032394/uploads/PVFZEBSWCK8F/reassign-starterkit-digital-out.png 10w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=300/https://us.v-cdn.net/6032394/uploads/PVFZEBSWCK8F/reassign-starterkit-digital-out.png 300w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=800/https://us.v-cdn.net/6032394/uploads/PVFZEBSWCK8F/reassign-starterkit-digital-out.png 800w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1200/https://us.v-cdn.net/6032394/uploads/PVFZEBSWCK8F/reassign-starterkit-digital-out.png 1200w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1600/https://us.v-cdn.net/6032394/uploads/PVFZEBSWCK8F/reassign-starterkit-digital-out.png 1600w, https://us.v-cdn.net/6032394/uploads/PVFZEBSWCK8F/reassign-starterkit-digital-out.png"></img></a> </div> </div> <p>4. Click <strong>Manage API Client</strong>.</p><p>5. Click <strong>New Sensor</strong> and name it <code class="code codeInline" spellcheck="false" tabindex="0">Digital Outputs</code>.</p><p>6. Click <strong>(+)</strong> to add 8 metrics. Name the metrics <code class="code codeInline" spellcheck="false" tabindex="0">Out 0</code> to <code class="code codeInline" spellcheck="false" tabindex="0">Out 7</code>. Set each <strong>Value Type</strong> to <code class="code codeInline" spellcheck="false" tabindex="0">Bool</code> and set each <strong>Display Unit</strong> to <code class="code codeInline" spellcheck="false" tabindex="0">I/O</code>. For example:</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/9XH4B56IK1AU/reassign-starterkit-create-metrics.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/9XH4B56IK1AU/reassign-starterkit-create-metrics.png" alt="reassign-starterkit-create-metrics.png" height="918" width="1200" loading="lazy" data-display-size="large" data-float="none" srcset="https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=10/https://us.v-cdn.net/6032394/uploads/9XH4B56IK1AU/reassign-starterkit-create-metrics.png 10w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=300/https://us.v-cdn.net/6032394/uploads/9XH4B56IK1AU/reassign-starterkit-create-metrics.png 300w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=800/https://us.v-cdn.net/6032394/uploads/9XH4B56IK1AU/reassign-starterkit-create-metrics.png 800w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1200/https://us.v-cdn.net/6032394/uploads/9XH4B56IK1AU/reassign-starterkit-create-metrics.png 1200w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1600/https://us.v-cdn.net/6032394/uploads/9XH4B56IK1AU/reassign-starterkit-create-metrics.png 1600w, https://us.v-cdn.net/6032394/uploads/9XH4B56IK1AU/reassign-starterkit-create-metrics.png"></img></a> </div> </div> <p>7. Optional: When a metric becomes superfluous, click the <strong>bin icon</strong> to remove it.</p><p>8. To finish click <strong>Create</strong>.</p><p>You will be provided with new <strong>connector</strong>, <strong>sensor</strong> and <strong>metric Ids</strong>. For example:</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/X2GBUMY7KDF2/reassign-starterkit-final-metric-ids.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/X2GBUMY7KDF2/reassign-starterkit-final-metric-ids.png" alt="reassign-starterkit-final-metric-ids.png" height="921" width="1200" loading="lazy" data-display-size="large" data-float="none" srcset="https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=10/https://us.v-cdn.net/6032394/uploads/X2GBUMY7KDF2/reassign-starterkit-final-metric-ids.png 10w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=300/https://us.v-cdn.net/6032394/uploads/X2GBUMY7KDF2/reassign-starterkit-final-metric-ids.png 300w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=800/https://us.v-cdn.net/6032394/uploads/X2GBUMY7KDF2/reassign-starterkit-final-metric-ids.png 800w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1200/https://us.v-cdn.net/6032394/uploads/X2GBUMY7KDF2/reassign-starterkit-final-metric-ids.png 1200w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1600/https://us.v-cdn.net/6032394/uploads/X2GBUMY7KDF2/reassign-starterkit-final-metric-ids.png 1600w, https://us.v-cdn.net/6032394/uploads/X2GBUMY7KDF2/reassign-starterkit-final-metric-ids.png"></img></a> </div> </div> <p>Keep this window open. You need these <strong>Ids</strong> in the step <strong>Apply the Reconfiguration and Restart</strong>.</p><p><br></p><h3 data-id="-3"></h3><h2 data-id="apply-the-reconfiguration-and-restart">Apply the reconfiguration and restart</h2><p>You need the provided <strong>Ids</strong> from the step <strong>Unmanage and Reassign the Starter Kit</strong>.</p><p>1. Access the <strong>Starter Kit</strong> remotely (<a href="https://community.teamviewer.com/English/kb/articles/109829-access-the-edge-device-via-remote-terminal" rel="nofollow noreferrer ugc">Access the Edge Device via Remote Terminal</a>).</p><p>2. Open the <code class="code codeInline" spellcheck="false" tabindex="0">teamviewer_gpio.py</code> file with the editor nano. In the terminal type in the following command and press return.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo nano teamviewer_gpio.py </pre><p>3. Replace the <code class="code codeInline" spellcheck="false" tabindex="0">client_id</code>, <code class="code codeInline" spellcheck="false" tabindex="0">sensor_id</code> and <code class="code codeInline" spellcheck="false" tabindex="0">Out0_id</code> to <code class="code codeInline" spellcheck="false" tabindex="0">Out7_id</code> on the top of the file with corresponding Ids obtained in step <strong>Unmanage and Reassign the Starter Kit</strong>. For example:</p><pre class="code codeBlock" spellcheck="false" tabindex="0">client_id = "5385da5e6c854abc8d65c0c80b5d79e9" sensor_id = "e6218136a1144c8e9d117dc55a24297c" Out0_id = "4ee43a05e70a4a97a20fe13e6baf286e" Out1_id = "58f38038ea0b48519332a190688a325e" Out2_id = "cf1aceeb62f3479fb07d81213dd21269" Out3_id = "05f12c7970704172a374f777bedc83ef" Out4_id = "d67d349dba2347699096bc0989f638c8" Out5_id = "8dac154dfeef4d5aa4ec33b39a675ee4" Out6_id = "cefdd235b1c243a2b6f7d89a6ce639e3" Out7_id = "50835cca2df34f19bb13b8a5e0873ed2" </pre><div class="embedExternal embedImage display-large float-none"> <div class="embedExternal-content"> <a class="embedImage-link" href="https://us.v-cdn.net/6032394/uploads/KGRPK44W6CX6/reassign-starterkit-digital-out-nano-example.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/KGRPK44W6CX6/reassign-starterkit-digital-out-nano-example.png" alt="reassign-starterkit-digital_out-nano-example.png" height="714" width="1059" loading="lazy" data-display-size="large" data-float="none" srcset="https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=10/https://us.v-cdn.net/6032394/uploads/KGRPK44W6CX6/reassign-starterkit-digital-out-nano-example.png 10w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=300/https://us.v-cdn.net/6032394/uploads/KGRPK44W6CX6/reassign-starterkit-digital-out-nano-example.png 300w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=800/https://us.v-cdn.net/6032394/uploads/KGRPK44W6CX6/reassign-starterkit-digital-out-nano-example.png 800w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1200/https://us.v-cdn.net/6032394/uploads/KGRPK44W6CX6/reassign-starterkit-digital-out-nano-example.png 1200w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1600/https://us.v-cdn.net/6032394/uploads/KGRPK44W6CX6/reassign-starterkit-digital-out-nano-example.png 1600w, https://us.v-cdn.net/6032394/uploads/KGRPK44W6CX6/reassign-starterkit-digital-out-nano-example.png"></img></a> </div> </div> <p>4. Save the file and close the nano editor.</p><p>5. Restart the <strong>service</strong> for the <strong>General Purpose Inputs/Outputs</strong> (GPIOs). In the terminal, type in the following command and press return.</p><pre class="code codeBlock" spellcheck="false" tabindex="0">sudo service teamviewer_gpio restart </pre><p>6. Verify that the <strong>DIOs</strong> are configured correctly. In the <strong>IoT Management Console</strong> navigate to <strong>Dashboard</strong>.</p><p>7. Pin (see <a href="https://community.teamviewer.com/English/kb/articles/109861-add-a-widget" rel="nofollow noreferrer ugc">Add a Widget</a>) the <code class="code codeInline" spellcheck="false" tabindex="0">Out0_id</code> to <code class="code codeInline" spellcheck="false" tabindex="0">Out7_id</code> metrics to the dashboard. Configure each as a <strong>Control</strong> with <strong>Toggle-Switch function</strong>. Use <code class="code codeInline" spellcheck="false" tabindex="0">true</code> and <code class="code codeInline" spellcheck="false" tabindex="0">false</code> for the control values. For example:</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/NIZNOKXGPMCS/reassign-starterkit-pinned-dios.png" rel="nofollow noreferrer noopener ugc" target="_blank"> <img class="embedImage-img" src="https://us.v-cdn.net/6032394/uploads/NIZNOKXGPMCS/reassign-starterkit-pinned-dios.png" alt="reassign-starterkit-pinned_dios.png" height="879" width="1200" loading="lazy" data-display-size="large" data-float="none" srcset="https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=10/https://us.v-cdn.net/6032394/uploads/NIZNOKXGPMCS/reassign-starterkit-pinned-dios.png 10w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=300/https://us.v-cdn.net/6032394/uploads/NIZNOKXGPMCS/reassign-starterkit-pinned-dios.png 300w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=800/https://us.v-cdn.net/6032394/uploads/NIZNOKXGPMCS/reassign-starterkit-pinned-dios.png 800w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1200/https://us.v-cdn.net/6032394/uploads/NIZNOKXGPMCS/reassign-starterkit-pinned-dios.png 1200w, https://us.v-cdn.net/cdn-cgi/image/fit=scale-down,width=1600/https://us.v-cdn.net/6032394/uploads/NIZNOKXGPMCS/reassign-starterkit-pinned-dios.png 1600w, https://us.v-cdn.net/6032394/uploads/NIZNOKXGPMCS/reassign-starterkit-pinned-dios.png"></img></a> </div> </div> <p><br></p><h3 data-id="-4"></h3> </article> </main>
