Supported Linux distributions/releases

Currently only Ubuntu Bionic Beaver 64bit is supported.

Preparing for installation

UgCS repositories are signed. You need to tell "apt" to trust them. It is accomplished by adding UgCS public key to apt trusted keys.

1) Add ugcs repository to apt trusted repositories.

    $ wget http://apt.ugcs.com/apt18.ugcs.key -O apt.ugcs.key | sudo apt-key add apt.ugcs.key

The above step is needed only once. You do not need to repeat it again on each update.

Installing UgCS

Add UgCS repository to our apt sources.

2) Add repository to apt sources:

  $ sudo sh -c 'echo "deb [arch=amd64] http://apt.ugcs.com/ubuntu bionic main" > /etc/apt/sources.list.d/ugcs.list'

3) Update apt cache

  $ sudo apt update

4) Install ugcs desktop software

  $ sudo apt install ugcs-single-host

At this point ugcs software is installed and integrated with ubuntu automatic update notifications.

Running UgCS software

From GUI
- Enter "ugcs" in search box and click on "UgCS client" entry
From command line
```
$ ugcs-client
```

Running UgCS services

$ ugcs-services         #  start all UGCS processes (do not start if process already exists)
$ ugcs-services restart #  kill and restart all UGCS processes
$ ugcs-services stop    #  kill all UGCS processes
$ ugcs-services status  #  show state of all UGCS services

Running specific component launchers

$ /usr/local/bin/ugcs-server "$1"
$ /usr/local/bin/ugcs-vehicle-emulator "$1"
$ /usr/local/bin/ugcs-vsm-ardupilot "$1"
$ /usr/local/bin/ugcs-vsm-emulator "$1"
$ /usr/local/bin/ugcs-vsm-dji "$1"
$ /usr/local/bin/ugcs-vsm-microadsb "$1"
$ /usr/local/bin/ugcs-vsm-micropilot "$1"
$ /usr/local/bin/ugcs-vsm-mikrokopter "$1"
$ /usr/local/bin/ugcs-vsm-px4 "$1"
$ /usr/local/bin/ugcs-vsm-uavionix "$1"
$ /usr/local/bin/ugcs-vsm-xbee "$1"
$ /usr/local/bin/ugcs-geoserver "$1"

Running UgCS Mapper software

Enter "ugcs" in search box and click on "UgCS Mapper" entry

Software updates

Ubuntu checks for updates automatically once a day. You will receive update notifications about new UgCS version along with other system updates.

Uninstalling UgCS software

This command will remove everything what was installed by "apt install ugcs-single-host" command above including any user data and log files.

  $ sudo apt purge --auto-remove ugcs-single-host

Reinstall after Ubuntu release upgrade

Ubuntu distribution upgrade will uninstall the UgCS system but leave all user data untouched. You need to re-enable UgCS repository after Ubuntu distribution upgrade to point apt to correct repository and reinstall UgCS from the new repository.

This is achieved by executing the steps (1), (2), (3) and (4) described above. After that you will be able to use UgCS as before.

Troubleshooting

Client cannot connect to server on startup

Possible causes and solutions:

Server fails to start due to java version mismatch.
UgCS requires java 1.7 to operate. Please use this command to set java 1.7 as default:
```
$sudo update-alternatives --config java
```
Server ip address/port is invalid.
The default server address is "localhost:3334" Check your server address if you have installed it on another machine.
Server installation failed.
Consult server log file (/var/opt/ugcs/log/server/ucs.log) for hints and contact support.

Cannot connect to vehicles via serial port

Symptoms: Vehicle is connected via radiolink on serial port but does not appear in UgCS.

Possible cause: By default regular user is not allowed to access serial devices directly. UgCS needs to access serial ports to communicate with vehicles.

Allow current user to access serial devices. This can be done from command line:
```
   $ sudo usermod -a -G dialout $USER
```
Re-login is required for the group change to take effect.

Table of Contents