Follow these instructions if you need to install using an RPM file instead of a Deb file.

This method may not create an RPM compatible with CentOS 7.

  1. Start a virtual machine (VM) on Google Cloud (or other host), using Ubuntu as the OS.
  2. Install Alien on the VM. Alien is software that converts Linux packages. You also need the universe repository.
    • Connect to your new VM.
    • Run the following commands:
      sudo add-apt-repository universe
      sudo apt-get update
      sudo apt-get install alien
  3. Download the latest Satellite from

    Replace <light-step-collector-version> with the version you are downloading, for example lightstep-collector_2019.

     wget --content-disposition<lightstep-collector_version>.deb/download.deb

    The .deb file is downloaded to your home directory.

  4. Unpack the .deb file.

    Replace <light-step-collector-version> with the version you downloaded.

     sudo alien --scripts -r -g -v lightstep-collector_<light-step-collector-version>.deb
  5. Change directory to the created directory and run the following commands:

     sudo sed -i 's#%dir "/"##' lightstep-collector*.spec
     sudo sed -i 's#%dir "/etc/init.d/"##' lightstep-collector*.spec
  6. Edit the lightstep-collector-<light-step-collector-version>.spec file as follows:
    • Replace addgroup and adduser lines with: useradd -M -r -U $USER || true

    • Replace update-rc.d and /etc/init.d/lightstep-collector restart lines with:

      systemctl daemon-reload >/dev/null || true
      systemctl enable lightstep-collector || true
      systemctl restart lightstep-collector || true
  7. Completely remove everything between the two “Automatically added” sections inclusively.
    • Replace invoke-rc.d lightstep-collector stop line with:

      systemctl stop lightstep-collector || exit $?
    • Replace the entire if [ "$1" = "purge" ] block with:

      if [ "$1" = "remove" ] ; then
        systemctl disable lightstep-collector >/dev/null
  8. Build and install the RPM.

    Replace the buildroot with your own, and change directories to match the version and spec file you are using.

     sudo rpmbuild --target=x86_64 --buildroot /home/<build-root>/lightstep-collector-<light-step-collector-version>/ -bb lightstep-collector-<light-step-collector-version>.spec
  9. Use this RPM to install your Satellite.
    • Install Satellite by running this command sudo yum install lightstep-collector-2019.
    • Edit the /etc/lightstep/collector.yaml file to add your Satellite key.
  10. Start the service:
    sudo service lightstep-collector start

    It should run some self diagnostic to see if it can connect to Lightstep.

    Stop the service by running:
    sudo service lightstep-collector stop

You can now configure your Satellite by further editing the /etc/lightstep/collector.yaml file.

Follow these instructions to further validate your installation and troubleshoot any issues.

You configure your Lightstep tracers to communicate with your Satellites by providing their location. If you are using a single Satellite, you provide the DNS name or IP address of that Satellite. For more than one, use the name or address of the load balancer you’ve deployed. Find out how to do that in the language-specific Quick Start guides.

By default, client libraries use secure connections. If you’ve configured your Satellites to use plainport connections, you must configure your tracer appropriately.