Revision as of 13:38, 11 October 2017

Installing SatNOGS on Fedora runnning on a Raspberry Pi 3

This tutorial assumes the following:

1. You have a Raspberry Pi 3 with external power (5V, 2A).

2. USB keyboard, HDMI screen, HDMI cable, network cable (Wi-Fi isn't working on Fedora for now) and a Class 10 SDHC card at least 8GB.

3. One of the following sdr devices: RTL-SDR or USRP B200.

4. You have an account and a ground station registered on either network.satnogs.org or network-dev.satnogs.org_. This is needed for getting your ground station ID number and your SatNOGS Network API key.

Prepare Raspberry Pi

Download fedora minimal or server RPi image (current 26) from Fedora ARM Project (server edition provides a nice web interface, admin console, with several stats and SSH access).

Connect SD card to your computer/laptop and prepare it as described at Fedora wiki (don't forget to resize the root partition).

Attach sdcard to your RPi, plug in the HDMI cable, keyboard and ethernet and turn on the HDMI screen. Plug RPi to the power source.

Fedora installation starts, follow the steps that show up in the screen. You'll have to setup:
- root password
- network connection
- timezone and ntp server, add at least one, `pool.ntp.org` is suggested
- a new user, e.g. `satnogs`. Don't forget to set administrator flag and add user to `dialout` group (needed for having access to sdr device).

From now on you are able to access you RPi directly or through SSH. You can also use admin console if you have selected the fedora server version.

Update fedora package to the latest version by running:

    sudo dnf -y update

Install dependencies for gr-satnogs and satnogs-client:

    sudo dnf install -y util-linux-user git gcc redhat-rpm-config python-devel redis vorbis-tools hamlib gnuradio gnuradio-devel cmake swig fftw3-devel gcc-c++ cppunit cppunit-devel doxygen gr-osmosdr libnova libnova-devel gnuplot libvorbis-devel libffi-devel openssl-devel libpng-devel

In order to expand the lifetime of the SD Card, edit /etc/fstab file with your favourite editor:
- Comment out the line of the swap partition
- Only if you used the "minimal" Fedora installation (not the "server" build), change options of root partition line (/ ext4) from `defaults,noatime` to `defaults,noatime,commit=1800`. This change means that changes on root partition will be written on SD Card every 30min
- Move /var/log and /var/tmp directories to memory by adding the following two lines:

      tmpfs /var/tmp tmpfs defaults,noatime,nosuid,size=120m 0 0
      tmpfs /var/log tmpfs defaults,noatime,nosuid,mode=0755,size=80m 0 0

Automate creating of redis directory in /var/log path after boot by running:

    sudo sh -c 'echo "#Type Path                Mode UID   GID   Age Argument" > /etc/tmpfiles.d/logdirs.conf'
    sudo sh -c 'echo "d     /var/log/redis      0750 redis redis 1d  -" >> /etc/tmpfiles.d/logdirs.conf'

Enable and start Redis service in order to run automatically on startup:

    sudo systemctl enable redis.service
    sudo systemctl start redis.service

Configure automatic cleanup of old data (while this is an optional step, if old files are not cleaned out regularly you run the risk of filling your disk over time)
- As-is this will clean out files older than 1 week. Adjust mtime to your liking
- Create /etc/cron.daily/satnogs with your favorite editor and add the following:

      #!/bin/sh
      find /tmp/.satnogs/data -type f -mtime +7 -delete

- Then run:

      sudo chmod +x /etc/cron.daily/satnogs

If you used Fedora Server, configure firewall for SatNOGS web user interface
- Create /usr/lib/firewalld/services/satnogs.xml and add the following:

      <?xml version="1.0" encoding="utf-8"?>
        <service>
        <short>SatNOGS (HTTP)</short>
        <description>HTTP is the protocol used to serve Web pages. If you plan to make your Web server publicly available, enable this option. This option is not required for viewing pages locally or developing Web pages.</description>
        <port protocol="tcp" port="5000"/>
      </service>

- If you used the server image run:

      sudo firewall-cmd --zone=FedoraServer --add-service=satnogs --permanent
      sudo firewall-cmd --zone=FedoraServer --add-service=satnogs

- Or for the minimal image:

      sudo firewall-cmd --zone=public --add-service=satnogs --permanent
      sudo firewall-cmd --zone=public --add-service=satnogs

Install gr-satnogs

SatNOGS Client uses GNU Radio scripts in order to get observation data from satelites, gr-satnogs provide this functionality.

Run the following command to install the packaged version of SatNOGS Client:

    git clone https://github.com/satnogs/gr-satnogs.git
    cd gr-satnogs
    mkdir build
    cd build
    cmake -DLIB_SUFFIX=64 -DCMAKE_INSTALL_PREFIX=/usr ..
    make -j4
    sudo make install
    sudo sh -c 'echo /usr/lib64 > /etc/ld.so.conf.d/lib64.conf'
    sudo ldconfig

Install satnogs-client

Building from source is outside of the scope of this document, we will use the packaged install for now.

Run the following command to install the packaged version of SatNOGS Client

   sudo pip install satnogsclient

Configure satnogs-client

SatNOGS Client needs some configuration before running:

Create a .env file in your home directory (`~/.env`) and add station's details as they are defined at SatNOGS Network:

    export SATNOGS_API_TOKEN="1234567890qwertyuiopasdfghjklzxcvbnm1234"
    export SATNOGS_STATION_ID="65"
    export SATNOGS_STATION_LAT="40.662"
    export SATNOGS_STATION_LON="23.337"
    export SATNOGS_STATION_ELEV="150"
    export SATNOGS_NETWORK_API_URL="https://network-dev.satnogs.org/api/"

Optional settings

There are more option you can export in the created .env file. You will probably need to change the default values of the settings bellow:

SATNOGS_RX_DEVICE
- Defines the sdr device. It could be 'usrpb200' or 'rtlsdr'.
- Default Type: string
- Default Value: 'rtlsdr'

SATNOGS_PPM_ERROR
- Defines PPM error of sdr, check :doc:`finding-ppm` for more details on PPM.
- Default Type: integer
- Default Value: 0

Other optional settings:

SATNOGS_APP_PATH
- Defines the path where the sqlite database will be created.
- Default Type: string
- Default Value: '/tmp/.satnogs'

SATNOGS_OUTPUT_PATH
- Defines the path where the observation data will be saved.
- Default Type: string
- Default Value: '/tmp/.satnogs/data'

SATNOGS_COMPLETE_OUTPUT_PATH
- Defines the path where data will be moved after succesful upload on network.
- Default Type: string
- Default Value:

SATNOGS_INCOMPLETE_OUTPUT_PATH
- Defines the path where data will be moved after unsuccesful upload on network.
- Default Type: string
- Default Value: '/tmp/.satnogs/data/incomplete'

SATNOGS_ROT_IP
- Defines IP address where rotctld process listens.
- Default Type: string
- Default Value: '127.0.0.1'

SATNOGS_ROT_PORT
- Defines port where rotctld process listens.
- Default Type: integer
- Default Value: 4533

SATNOGS_RIG_IP
- Defines IP address where rigctld process listens.
- Default Type: string
- Default Value: '127.0.0.1'

SATNOGS_RIG_PORT
- Defines port where rigctld process listens.
- Default Type: integer
- Default Value: 4532

Prepare SDR Device

In order to have access and use SDR device you need to follow the next steps for your device: The next step is to access and use the SDR device you have. Which steps you follow depends on your device.

USRP B200

Install uhd package:

    sudo dnf install -y uhd

Download uhd images:

    sudo /usr/bin/uhd_images_downloader

As the access will be only by ssh and not by direct login we are not be able to access SDR device through Access Control List (ACL), so we need to setup the appropriate udev rules by following the next steps:

Copy udev rules from `/usr/lib/udev/rules.d/10-usrp-uhd.rules` to `/etc/udev/rules.d/10-usrp-uhd.rules`:

      sudo cp /usr/lib/udev/rules.d/10-usrp-uhd.rules /etc/udev/rules.d/10-usrp-uhd.rules

Replace ACL reference:

      sudo sed -i 's/0", ENV{ID_SOFTWARE_RADIO}="1"/6"/g' /etc/udev/rules.d/10-usrp-uhd.rules

Reload udev rules:

      sudo udevadm control --reload-rules

Confirm access on device by running (without sudo, just as single user):

      uhd_find_devices

In case you don't have access, make sure that the device is connected and that the created user is member of the `dialout` group by running:

      groups

If user isn't member of `dialout` group run (replace satnogs with the username of your user):

      sudo usermod -aG dialout satnogs

RTL-SDR

As the access will be only by ssh and not by direct login we are not be able to access SDR device through Access Control List (ACL), so we need to setup the appropriate udev rules by following the next steps:

Copy udev rules from `/usr/lib/udev/rules.d/10-rtl-sdr.rules` to `/etc/udev/rules.d/10-rtl-sdr.rules`:

      sudo cp /usr/lib/udev/rules.d/10-rtl-sdr.rules /etc/udev/rules.d/10-rtl-sdr.rules

Replace ACL reference and change group ownership:

      sudo sed -i 's/0", ENV{ID_SOFTWARE_RADIO}="1"/6"/g' /etc/udev/rules.d/10-rtl-sdr.rules
      sudo sed -i 's/rtlsdr/dialout/g' /etc/udev/rules.d/10-rtl-sdr.rules

Reload udev rules:

      sudo udevadm control --reload-rules

If your rtlsdr device was already plugged in, you will need to unplug it and plug it back in. Otherwise, it is safe to plug it in now.

In case you don't have access, make sure that the device is connected and that the created user is member of the `dialout` group by running:

      groups

If user isn't member of `dialout` group run (replace satnogs with the username of your user):

      sudo usermod -aG dialout satnogs

If you had to take that step, log out and log back in.

Run satnogs-client

Manually

In order to manually run satnogs-client you need to follow the next steps:

Export all the environment variables:

    source .env

Start rotctl daemon(note: given example parameters bellow, you may need to change, add or omit some of them. For a Yaesu G-5500 use -m 601 and -s 9600):

    rotctld -m 202 -r /dev/ttyACM0 -s 19200 &

Run the SatNOGS Client:

    satnogs-client

- At this point your client should be fully functional! It will check in with the network URL at a 1 minute interval. You should check your ground station page on the website, the station ID will be in a red box until the station checks in, at which time it will turn green. There are many ways to automate the running and control of satnogs, we will give you 2 options below, supervisord and systemd.**

Automaticaly with Supervisord

Supervisord is one of the ways to automatically run SatNOGS Client. This is very useful especialy after a power failure or reboot of raspberry pi.

In order to setup supervisord we need to follow the next steps:

Install supervisord:

    sudo dnf install -y supervisor

Automate creating of supervisor directory in /var/log path after boot by running:

    sudo sh -c 'echo "d     /var/log/supervisor 0750 root  root  3d  -" >> /etc/tmpfiles.d/logdirs.conf'

Configure supervisord for rotctld

Open with sudo and your favorite editor and add this into /etc/supervisord.d/rotctld.ini:

   [program:rotctld]
   command=/usr/bin/rotctld <rotctld PARAMETERS>
   autostart=true
   autorestart=true
   user=<USERNAME>
   priority=1
   stdout_logfile=/var/log/supervisor/rotctld.log
   stderr_logfile=/var/log/supervisor/rotctld-error.log

Replace <USERNAME> with the username of the user you have created and <rotctld PARAMETERS> with the parameters needed to run rotctl in your case.

Configure supervisord for satnogs-client

Add this into /etc/supervisord.d/satnogs.ini:

   [program:satnogs]
   command=/usr/bin/satnogs-client
   autostart=true
   autorestart=true
   user=<USERNAME>
   environment=SATNOGS_NETWORK_API_URL="<URL>",SATNOGS_API_TOKEN="<TOKEN>",SATNOGS_STATION_ID="<ID>",SATNOGS_STATION_LAT="<LATITUDE>",SATNOGS_STATION_LON="<LONGITUDE>",SATNOGS_STATION_ELEV="<ELEVATION>"
   stdout_logfile=/var/log/supervisor/satnogs.log
   stderr_logfile=/var/log/supervisor/satnogs-error.log

Replace <USERNAME> with the username of the user you have created. Replace <...> instances in environment with the values you used in .env file, you can also add in this list any other of the :ref:`optional settings <optional_settings>`.

Reloading supervisord to get the new configuration:

  sudo systemctl enable supervisord.service
  sudo systemctl start supervisord.service

With that rotctld and satnogs-client should have started, you can follow the logs in /var/log/supervisor/.

NOTE:* In case that you want to change something in .ini files like satnogs environment variables (url from the dev one to production one), then you will need to run:

sudo supervisorctl reload

Automaticaly with Systemd

Systemd is one of the ways to automatically run SatNOGS Client. This is very useful especialy after a power failure or reboot of raspberry pi.

In order to setup systemd we need to follow the next steps:

Create the script which will initialize and run rotctld and satnogs-client in your home directory (`~/start-satnogs-client.sh`) with the following content:

    rotctld <rotctld PARAMETERS> &
    date >> satnogs-auto.log
    source .env
    satnogs-client

Replace <rotctld PARAMETERS> with the parameters needed to run rotctl in your case.

Create as root the file /lib/systemd/system/satnogs-client.service and add the following content:

    [Unit]
    Description=Satnogs Client
    Requires=redis.service
    After=redis.service

    [Service]
    User=<USERNAME>
    WorkingDirectory=/home/<USERNAME>/
    ExecStart=/bin/bash start-satnogs-client.sh
    KillMode=control-group

    [Install]
    WantedBy=multi-user.target

Replace <USERNAME> with the username of the user you have created.

Enable and start satnogs-client.service:

    sudo systemctl enable satnogs-client.service
    sudo systemctl start satnogs-client.service

With that rotctld and satnogs-client should have started, you can follow the logs with journactl:

    journalctl -u satnogs-client.service

Use `-f` flag if you want to see the latest updates on logs:

    journalctl -f -u satnogs-client.service

NOTE:* In case that you want to change something in start-satnogs-client.sh, make the change and then run:

    sudo systemctl stop satnogs-client.service
    sudo systemctl start satnogs-client.service

NOTE:* In case that you want to change something in satnogs-client.service, make the change and then run:

    sudo systemctl daemon-reload

Difference between revisions of "Fedora Installation"