Remote control

There are several cases when the Remote control tool will not work. If the tool doesn't work with your devices, please check the option below:

  1. Make sure root user exists and enabled. In case it is locked, here is how to enable it:

    • Set root password sudo passwd root

    • Activate root user sudo passwd -u root

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

  3. Make sure network port 443 is OPEN in the device firewall or on the Router (OUTPUT table) when opening a remote control session.

  4. Make sure 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. In case the device firewall is on DROP mode, please run the next commands to allow Upswift agent 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.upswift.io --dport 443 -j ACCEPT

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

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

In case the Remote Control isn't working and you don't have other access to the device's terminal, you can run the next script using the Micro-update tool, in order to set and enable the root user. (follow the steps below the script)

#!/bin/sh
username="root"
password="ENTER_SOME_PASSWORD"
passwd ${username} << EOD
${password}
${password}
EOD
sudo passwd -u root
  1. Create a new Micro update, choose the relevant device.

  2. Enter a version number, you can enter anything here.

  3. At the section 'before update', upload the bash script above.

    1. Make sure to save the script with .sh extension (for example: enable_user.sh)

    2. Make sure to change the ENTER_SOME_PASSWORD to a password you will remember

  4. Click on 'Deploy' to deploy the micro-update on the device.

Once deployed, the root user will be set and enabled. You should now try to open Remote Control to that device.

CentOS/Red Hat - SELinux permission issue

Please follow this guide.