Logging in to the Device through the Device Console

You open a remote login session over Telnet through the Device Console link on the LaunchPad.

The session opens in a new browser tab.

There is a maximum of 30 concurrent remote access connections allowed per organization. Subsequent connection requests return an error. The number of connections to a single device is limited to the number allowed per organization, but a device can implement policies to deny a remote access connection based on factors such as the current CPU load, memory usage, and what the device is currently doing (for example, software update).

After one hour, the session disconnects automatically, regardless of the traffic status.

Note:

To remotely connect to a terminal on a device running the C agent, such as, VxWorks IoT device, you have to use the Device Cloud Device Console link on the Launchpad.

You need the following:

  • your user name, password, and URL for Device Cloud

  • pop-up blocking disabled for the Device Cloud website

  • the user name and password for an account on the device (Device Cloud does not provide a default account)

  • the device manager and device configured for remote access (see Device Configuration for Device Console Access)

  • the device manager running on the device and connected to Device Cloud

  • the thing key of the device manager thing running on the device to which you want to connect

  1. In your browser's address bar, type the URL you were given when you received your Device Cloud account, and then on the Sign In page, type your user name and password in the boxes.
  2. If the device you want to access is not connected to your default organization, select Switch organization on the LaunchPad and select the organization to which your device is connected.
    Device Cloud - LaunchPad Switch Org Menu
  3. On the LaunchPad, click Device Console.
  4. In the Device Manager Thing Key box, type or paste the thing key of the device manager running on the device to which you want to connect, and then click CONNECT.

    A new browser tab opens and shows a remote terminal window.

    If the browser tab does not open, ensure that you disabled pop-up blocking.

  5. Log in to the device with the user name and password for an account on the device.

    You must have an account on the device. The Device Cloud agent on the device does not provide a default account.

  6. If the target device runs a Linux operating system, change the value of the TERM environment variable to xterm.
    $ export TERM=xterm

    This setting applies only to the current terminal session. To apply the change to the user account you use when you log in to the device, change the setting in the .bashrc file of the user account on the device.

  7. When you finish, log out from the device and close the browser tab.