The Lightstep Satellite is available in Debian package format for Ubuntu 16.04 Xenial users. You can find that Debian package here.

Presently, Ubuntu packages are not distributed via an apt-get repository. The Lightstep Satellite is signed and will be verified automatically by dpkg.

Check out these instructions to convert the Debian package to RPM.

To install the package:

1
$ dpkg -i lightstep-collector_{version}_amd64.deb

The package places a configuration file in /etc/lightstep/collector.yaml. You can find a description of each of the configuration parameters here.

To start the server:

The Lightstep Satellite is configured to run at startup via an upstart config: /etc/init/lightstep-collector.conf

If needed, the satellite can also be started manually:

1
$ service lightstep-collector start

Use the public key below for signature verification.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
-----BEGIN PGP PUBLIC KEY BLOCK-----

mQENBFkU0fIBCACyB6QycEWl0xPrQYwAHgWfzODbp1Kf3HsRq+3OC+eM6QUaj2jT
niVmeHzfxkfvgK8kVaNfoxJDorUwGb8iltaR7JnFSTPw9AcGc56ZVmTtg7V6YYCg
uakNM1uh2ue/jbFfoL6/4UbvFINWyVAmTWA9/UELHPAAeMosDUW4ltRdLmtl3W8W
q7VTSM76TA/hfY+slr8jDJcN4mOD9Hx8LoGJP7t8fhpEIlo9pW+seFQwo6lvk6sK
5PHF72BuaWOivvNjvJbJpbOimDET54sNJf+rVVWoljszCRvTahAj3LpBHGOzeORr
L6ux3WOrDUW1FN9vJKeL0GLKirf54cby4oltABEBAAG0KUxpZ2h0U3RlcCBTdXBw
b3J0IDxzdXBwb3J0QGxpZ2h0c3RlcC5jb20+iQE4BBMBAgAiBQJZFNHyAhsDBgsJ
CAcDAgYVCAIJCgsEFgIDAQIeAQIXgAAKCRDpq4dbJcMAWAgvCACue3+qR1cavJDc
31MVVNNOZblMlUd+aC1u9s9chG3As28V0vn5O+6tWSE93r+k0FUj5GDiFXKv9g4E
NpKRPJor0CKsa28qsBESNyNrgAPsr5I6WptYveLn39MQfDZGHEDrasLDGxkeLklB
UCD4zqRy4jNnk39IqVtnNZY4i/3asGfKexfv8YqJTNn+oMZ9zXDraOuoWsivbtt0
8/4RTEGY2U44TmxWjDr4/tdjkCRgi60h6q5y+C2++bntvrAGgiuWb/b9u5acbqm+
MWwLV6ltgb7bR0/t2HkZBAe43NkMrYw0jE7dc9TTI+Ik7NPZF1fuWTbMdRUcWp+K
iBL4QqicuQENBFkU0fIBCADNSWsIn2Z8F3QmI8ZqjD6768Lr03ahJO2oQ5rFXm17
inDsMLByDccRcdlZzjUowOBbunw+RMG4BknotqNo9i7sUQ1D3oPhNMR4TBeJqeYb
2BsURq0AJaofDiDKwJvmdaG9zW4ZVoYNZ3tM980uH+R9mIuoopQvmTGk+H0Ro9M7
+dtj1slZ4T5+HS0NY6vuyFQSg3JBKkt0zzHewGDKC56I8Fg0ijjoe1xGkkiJ951S
HoMWrDgFkN9xcrEKwCYO6rSgHDR3rNkf7vQSMpejFT1f+430qG/tPwUlWlESJf4q
zdRdCDS9WD7TmWZLD3fv0IZHUMePPZRg20zW+7aWbGCTABEBAAGJAR8EGAECAAkF
AlkU0fICGwwACgkQ6auHWyXDAFihHwf8D/y3PI5P8wUdvRtFIifwThYtzVxj5HYV
sIG9lOGlU9LKQPwMAPJrZ+frkg2/cr34MbRRPcuhnFnQMhCLT/3NwjZHDS7n6YJg
wXXfy0wJ71bejtD0w00iYyBCRoBztoEGZcyFex6EWfowZuR/VJLVuDRUvOJ0o8dv
96mG57Tp5SQVETtCWBrSWlF/OpRdunXTSE32uXw/teYafb5u7ximdcImc7l/PbdX
UrXlENGvdGDHIELLnGebrpEK4AhJB/dctWfHvPO9HrXOfGWDcDC9nVuRW6ESFNBh
ECQOgPL1icpZm5YBfXOXmOszpU1ZCtOyrQo8RCkrU95vEEzbl5WIOA==
=qtrh
-----END PGP PUBLIC KEY BLOCK-----

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

You configure your instrumentation 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.