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.