Native installation

You can chose to install xds-server ‘natively’ instead of within a docker container but note that only Linux host OSes are supported and tested for native installation !

Install packages for debian distro type

# 'DISTRO' can be set to { xUbuntu_16.04, xUbuntu_16.10, xUbuntu_17.04, Debian_8.0, Debian_9.0}
export DISTRO="xUbuntu_16.04"

wget -O - http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/app-Development/${DISTRO}/Release.key | sudo apt-key add -
sudo bash -c "cat >> /etc/apt/sources.list.d/AGL.list <<EOF
deb http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/app-Development/${DISTRO}/ ./
EOF"

sudo apt-get update
sudo apt-get install agl-xds-server

Install packages for openSUSE distro type

# DISTRO can be set to {openSUSE_Leap_42.2, openSUSE_Leap_42.3, openSUSE_Tumbleweed}
export DISTRO="openSUSE_Leap_42.2"

sudo zypper ar http://download.opensuse.org/repositories/isv:/LinuxAutomotive:/app-Development/${DISTRO}/isv:LinuxAutomotive:app-Development.repo

sudo zypper ref
sudo zypper install agl-xds-server

Configure xds-server

Optional step: skip this chapter if you plan to use default settings

Please refer to Configuration chapter of xds-server documentation for more details about JSON configuration file.

Start/Stop xds-server

xds-server can be managed as a systemd service with the following commands:

# Status XDS server:
systemctl --user status xds-server.service

# Stop XDS server
systemctl --user stop xds-server.service

# Start XDS server
systemctl --user start xds-server.service

# Get XDS server logs
systemctl --user --unit=xds-server.service --output=cat

To check if xds-server is correctly install and running, you can access the web interface, using a web browser :

xdg-open http://localhost:8000

or get the current version using the following curl command:

curl http://localhost:8000/api/v1/version