Troubleshooting

Last updated: February 9th, 2020

Agent Installation

Installing Upswift agent returns "http/1.1 400 bad request"

Upswift installation requires an updated "wget" or "Busybox" (from 2015 and above).

  1. To upgrade "Busybox", please ​download the binary and replace with the old binary or contact us at contact@upswift.io for technical installation support.
  2. To upgrade "wget", please run the commands below:
    • apt -y update
    • apt install -y wget

Cannot verify dashboard.upswift.io certificate

Add --no-check-certificate after the 'wget' inside the installation command:
wget --no-check-certificate -O - "https://dashboard.upswift.io/install_upswift"....

CentOS/Red Hat - SELinux permission issue

Upswift agent can’t work properly with SELinux enabled, to fix the issue, please create a rule to allow systemd upswift_manager service, or disable SELinux using the next commands:

  1. vim /etc/selinux/config (edit SELinux config file)
  2. Change the SELINUX parameter from enforcing to disabled (disable SELinux system)
  3. reboot (reboot the device)

Micro-updates

Running apt before/after the Micro-Update

Some packages installations require user interaction. If you are installing/upgrading packages using the apt command, add the next option at the beginning of your apt command: DEBIAN_FRONTEND=noninteractive.

For example:
DEBIAN_FRONTEND=noninteractive apt-get -y install <package name>

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 user root 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 80 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 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 80 -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 80 -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