Device Configuration for Device Console Access

To enable remote access to a device through the Device Console link on the LaunchPad, you must configure both the device and the device manager.

You need the following:

  • a Telnet server running on the device

  • the device manager remote login action enabled

  • the device manager application and dependencies running on the device

Telnet

You must install and run a Telnet server on the device. The steps to install and run a server are operating-system-specific. You may be able to use a package manager to install it, you may need a third-party package (such as freesshd on Windows), or you may need to include it in the list of packages you add to the root file system when you build an image for your device (Yocto-based Linux, VxWorks 7). Ensure that you bind the server to localhost only.

Enabling Remote Access

In the actions_enabled object in the iot.cfg configuration file, specify true for the remote_login action. This is the default setting.

For more details about the configuration file, see the following:

Note:

Adding or removing Telnet from the list of protocols in the remote_access_support array in the configuration file does not enable or disable Telnet remote access through the Device Console. If you specify false for the remote_login action, all remote access protocols are disabled, including those accessed through the Remote Access link on the LaunchPad.

Python Device Manager Dependencies

If you install the Python agent on your device from the PyPI repository, all dependencies should be installed. For information about installation issues, see Troubleshooting Installation Issues with the Python Agent.

C Device Manager Dependencies on Linux

You need the following:

  • Ensure that the iot-relay application is in a system directory, such as /usr/bin or /usr/local/bin.

    The file is located in the build/bin directory after you build the agent. If you run make install, the file is installed in the /usr/local/bin directory.

  • Ensure that the libwebsockets library is in a system directory, such as /usr/lib or /usr/local/lib.

    You can find the web sockets library files in the deps/lib directory after you run the build-deps.sh script to build the dependencies.

    Ubuntu may have an older version of libwebsockets installed from the package repository that is not compatible with the agent. You may need to uninstall it first.

C Device Manager Dependencies on VxWorks 7

Ensure that the iot-relay application is on the boot media in the correct location. For more information, see Device Cloud Quick Start for VxWorks 7.