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
  • Manage your Fleet
    • 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
      • 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
  • Releases
    • What's New?
    • Connect Agent Release Notes
  • Troubleshooting
    • Connect Server Status
    • Troubleshoot Topics
      • Device Registration
      • Terminal Troubleshooting
Powered by GitBook
On this page

Was this helpful?

Export as PDF
  1. Troubleshooting
  2. Troubleshoot Topics

Terminal Troubleshooting

Some tips in case you are having trouble using the Terminal feature in JFrog Connect.

If the JFrog Connect's Terminal feature is not working with your devices, you can try the tips below.

  1. Ensure that the root user exists and is enabled. If it is locked, enable it as follows:

    • Set root password sudo passwd root

    • Activate root user sudo passwd -u root

  2. Ensure that openssh-server is installed, or install it by running apt-get -y install openssh-server

  3. Ensure that network port 443 is OPEN in the device firewall or on the router (OUTPUT table) when opening a remote control session.

  4. Ensure that you have a valid DNS record. You can add a DNS record by running the command: echo "nameserver 8.8.8.8" >> /etc/resolv.conf

  5. If the device firewall is in DROP mode, run the following commands to enable the Connect Agent,I using iptables:

    • iptables -I INPUT 1 -i lo -j ACCEPT

    • iptables -A INPUT -s 127.0.0.1 -p tcp --sport 442 -j ACCEPT

    • iptables -A INPUT -s 127.0.0.1 -p tcp --dport 442 -j ACCEPT

    • iptables -A OUTPUT -s 127.0.0.1 -p tcp --sport 442 -j ACCEPT

    • iptables -A OUTPUT -s 127.0.0.1 -p tcp --dport 442 -j ACCEPT

    • iptables -A OUTPUT -p tcp -d api.connect.jfrog.io --dport 443 -j ACCEPT

    • iptables -A OUTPUT -p tcp -d remote.connect.jfrog.io --dport 443 -j ACCEPT

    • iptables -A INPUT -m conntrack --ctstate ESTABLISHED,RELATED -j ACCEPT

If the Terminal is not working and you do not have other access to the device's terminal, you can run the script below using the Micro-update tool. This will set and enable the root user. Complete the steps below the script.

#!/bin/sh

username="root"
password="ENTER_SOME_PASSWORD"

passwd ${username} << EOD
${password}
${password}
EOD

sudo passwd -u root

To run the script:

  1. Create a new Micro update and choose the relevant device.

  2. Enter a version number. You can enter anything here.

  3. In the section Before Update, upload the bash script above.

    1. Save the script with .sh extension (for example: enable_user.sh).

    2. Change ENTER_SOME_PASSWORD to a password you will remember.

  4. To deploy the micro-update on the device, click Deploy.

Once deployed, the root user will be set and enabled. You can now try to open Terminal on that device.

If none of the tips above solves the issue, check your device and Internet connection stability.

CentOS/Red Hat - SELinux Permission Issue

PreviousDevice Registration

Last updated 2 days ago

Was this helpful?

If you are having this issue, complete the steps in the page.

Device Registration