LogoLogo
What's New?Connect Agent ReleasesBook a DemoPricing
  • Documentation
  • Developers
  • Administration
  • OVERVIEW
    • JFrog Connect Overview
      • Architecture Overview
        • Connect Agent
        • Connect & JFrog Platform
      • Plan Your Update Strategy
        • Software Update Objectives & Concepts
        • Software Update Process & Procedures
  • Get Started
    • Create JFrog Connect Account
    • Log in to JFrog Connect
    • Network Requirements
    • Register Device
      • Device Registration Troubleshooting
  • Fleet Management
    • Register Devices at Scale
      • Freeze Image on Device
      • Build Image with Agent
    • Register & Update Device at Once
    • Organize Your Fleet
      • Create Project
      • Move Device between Projects
      • Create Groups
        • Add Device to Group
        • Add Many Devices to Group
        • Change Group Name
        • Delete Group
      • Tag Devices
        • Remove a Tag
      • Remove Many Devices
  • Devices
    • Fleet Overview
      • Filter Devices
      • Locate Devices
    • Device Details
      • Delete a Device
      • Block Updates with Update Trigger
    • Update Connect Agent
    • Delete Many Devices
  • Deployment
    • Create Update Flow
      • Actions
        • Run Command
        • Run Script
        • Deploy File
        • Deploy Docker
          • Use Docker Image
          • Use Docker Compose
          • Get Artifactory Parameters
        • Clone Git Repository
        • Download Artifact
          • Get Artifactory Path
        • Download Release Bundle
          • Get Artifactory Parameters for Release Bundle
        • Update Image
        • Install Debian Package
          • Get Artifactory Parameters for Debian
      • Use Update Parameters
      • On Failure & Rollback
      • Vulnerability Scans
      • Sample Use Case: Build Update Flow for Reuse
    • Deploy Software
      • Set Application & Version
      • Set Alert upon Failure
      • Set Phased Rollout
      • View Deployment Progress
        • Detailed Deployment Information
        • Abort a Deployment
      • Deploy in Groups
      • Sample Use Case: Deploy Docker Images to Devices
  • Tools
    • Remote Tools
      • Use Terminal
        • Terminal Troubleshooting
      • Open Port Tunnel Session
        • Access with VNC
        • Connect with SSH
        • Access Device Web Applications
      • Run Commands Remotely
        • Run Command as Non-Root User
      • Get Device Files (Fetch Files)
    • Alerts
      • Create Channel
      • Set Webhook
    • Monitor
      • Resource Monitor
      • Process Monitor
    • Connect Server Status
  • Releases
    • What's New?
    • Connect Agent Release Notes
Powered by GitBook
On this page
  • Prerequisites
  • Open Session
  • View Remote Terminal Session History
  • What’s Next?

Was this helpful?

Export as PDF
  1. Tools
  2. Remote Tools

Use Terminal

JFrog Connect makes it easy to troubleshoot and maintain devices by using remote support tools. This page describes how to use Terminal.

PreviousRemote ToolsNextTerminal Troubleshooting

Last updated 23 days ago

Was this helpful?

JFrog Connect’s Terminal tool enables you to connect to your Linux terminal through a web-based SSH. Using Terminal, you can troubleshoot remotely and resolve issues on your edge devices.

Prerequisites

In order to use Terminal, you need the following:

  • The following software installed on the device: ssh-server and ssh-client. (The ssh-client is installed by default when you download Connect Agent to the device. You will need to install ssh-server separately.)

  • The edge device is online

  • The root user enabled

You do not need to open any ports on the device or the firewall for the terminal to function.

Open Session

To open a Terminal session, do the following:

  1. In the left navigation pane, go to Devices. In the Devices table, click the three dots on the far right side of the relevant device and choose Remote Terminal.

Alternatively, you can go to Terminal in the left menu and choose a device from the dropdown list. Click Open Session.

  1. A panel will appear showing the progress of opening your remote terminal session. A timer, counting down, also appears on the Connect button. Before the timer finishes (and before all the tiles turn green), enter the username you want to use for connecting to the device and click Connect. The default username is root.

When your Remote Terminal session is open, you will see a new window with the command-line interface of your Linux terminal. You can start your troubleshooting in this window.

View Remote Terminal Session History

To view a brief history of the remote control sessions you have had, go to Remote Tools/Terminal in the left menu. The sessions are listed in order of device name. For each session, the table shows:

  • Device name and UUID

  • Session Duration

  • Close time

  • State

If you don’t see the session you are looking for in the table, use the Search to locate the session.

What’s Next?

Learn how you can access and control your edge device with Connect’s tool.

Port Tunnel