Tutorials and documentation

Resources for Sosk users

Getting Started

Sosk consists of several parts.

  • an active tenant on Sosk SaaS platform
  • the probes spread across your network
Let's see how to bring this up.

Create your tenant

When you apply for a Sosk account we automatically create a private tenant just for you and your data. Your tenant is referred as your "zone" and has a unique ID. For example you may obtain the "zone51" if you are lucky enough.

Just use Sosk account creation form to apply for your private tenant. You just need to provide a valid mail address and a chosen password. Feel free to provide the optional informations as it allows us to better know our customers. However none of them are mandatory.

Right after your account creation you can use the login form to sign in. You will be directed to your tenant wgere demo data have been published. You can then see active probes and demonstration dashboards.

Switch your tenant to production state

To be able to register your own probes and to change settings you will need to switch your tenant mode to "production state". This operation is manually done during Beta phase. Just contact Sosk support by mentionning your account email and the zone you want to enable. Et voila !

Your tenant is ready, you can setup your probes

Setup a probe for Sosk

Sosk probes can be setup on several platforms.

  • Raspberry Pi (recommended)
  • Pi alternatives like Banana Pi etc
  • Virtual machines armhf (x86 soon)
You may find useful to launch small VPS instance or cheap ARM server from various Cloud hosting companies like OVH, Scaleway, AWS, GCE, Vultr and so on. Prices are as low as 2.5€ / month.

For now we will cover the well known Raspberry Pi setup. Future docs will allow you to setup Pi Zero, or Wireless Pi etc.

Pre-requisites

You will need
  • A Raspberry Pi v2 or v3
  • A micro SD card (min. 2Gb)
  • Sosk ISO image (MD5)
  • A micro SD card reader
  • A power adapter
  • A small USB stick

Setup the probe

Flash image

Flash the Sosk ISO image to your SD card. No need to expand the filesystem or to change partition logic. Optionaly you may check the MD5/SHA1 checksum of the SD card right after flahsing to ensure all is correct.

Enable enrollment on your zone

In your management interface, go to "Zone settings" and switch the "Probe enrollment" setting to ON. It will allows probes to join your zone for the next 1 hour, 1 day or forever (bad idea !). Choose a private value for your PSK, or let Sosk generate one for you.

Prepare the USB stick

Plug in your USB stick, create a directory exactly named "sonar" at the root. Create a text file exactly named "config.yaml" in it, and put the following content in. Replace zone2 by your zone name (example: zone51) and the zone PSK by your PSK. Be very careful, every space, tab or dash is important. The hostname of the probe will be randomly generated, this is the recommended way.

---
probesetup::myhostname: RANDOM
probesetup::myzone: zone2
probesetup::zonepsk: YOUR_ZONE_PSK_HERE
probesetup::mastername: master.sonar.acipia.net
      					

Boot the Pi

Just plug the Raspberry Pi to a DHCP-enabled network. It should be up within 2 minutes.

Plug the USB stick

Now plug the USB stick we've setup previously. This step may take up to 5 minutes depending of the Internet available bandwidth. Your probe needs to download several packages then register unt your zone. During this time feel free to open the "event log" panel in your Management interface, and go take some coffee, you deserve it.

Check the registration

Your newly enrolled probe shoudl have appear in the "probes" panel in your Management interface, with a "in-sync" status. You can unplug the USB stick and keep it for further enrollments. Congratulations !

FAQ

What about Raspberry Pi 1A 1B etc ?

These models with less than 1Gb RAM are not powerful enough.

How to flash SD card with ISO file ?

Just use dd (Linux & MacOS) or Win32DiskImager (Windows) to flash your SD card with the provided image. In cas you need further instructions you can refer to Raspberry Pi documentations.

What to do if it doesn't work ?

Check the "event logs" pane and double-check you've entered the right PSK. You may also contact support..

What does the image contain ?

The image contains just a Raspbian OS, which is a Debian-based Linux distribution customized for Raspberry Pi. Sosk version differs only by adding Puppet agent package and some bootstrap logic specific to Sosk usage.

Under which license is this OS distributed ?

Sosk image is just a Raspbian Jessie image with additional packages like Puppet. These packages are free software, the exact distribution terms for each program are described in the individual files in /usr/share/doc/*/copyright. You may contact us if you feel we forgot to provide the source code of modified opensource software. For more details see our FLOSS testimony.

Menu 3

Eaque ipsa quae ab illo inventore veritatis et quasi architecto beatae vitae dicta sunt explicabo.

Menu 5

veritatis et quasi architecto beaasi architecto beatae v veritatis et quasi architecto beaplicabo.