Difference between revisions of "SatNOGS Client Ansible"

From SatNOGS Wiki
(Installation: git checkout stable)
(Fix ansible-playbook command to explicitly specify the production/inventory/hosts inventory file instead of just the directory)
Line 22: Line 22:
 
On the host system run the following commands:
 
On the host system run the following commands:
 
  $ git clone <nowiki>https://gitlab.com/librespacefoundation/satnogs/satnogs-client-ansible.git</nowiki>    # Clone SatNOGS Client Ansible repository
 
  $ git clone <nowiki>https://gitlab.com/librespacefoundation/satnogs/satnogs-client-ansible.git</nowiki>    # Clone SatNOGS Client Ansible repository
  $ cd satnogs-client-ansible                             # Change to cloned repository directory
+
  $ cd satnogs-client-ansible                                   # Change to cloned repository directory
  $ git checkout stable                                   # Optionally, check out stable (Debian Buster 10) branch
+
  $ git checkout stable                                         # Optionally, check out stable (Debian Buster 10) branch
  $ cp -r production.dist production                       # Copy dist configuration
+
  $ cp -r production.dist production                             # Copy dist configuration
  $ vi production/inventory/hosts                         # Update file with your own target host e.g. 127.0.0.1, user and SSH password
+
  $ vi production/inventory/hosts                               # Update file with your own target host e.g. 127.0.0.1, user and SSH password
  $ ssh youruser@yourtargetsystem true                     # Test SSH connection to target system
+
  $ ssh youruser@yourtargetsystem true                           # Test SSH connection to target system
  $ ansible-playbook -i production/inventory -K site.yml  # Run Ansible playbook
+
  $ ansible-playbook -i production/inventory/hosts -K site.yml  # Run Ansible playbook
  $ ssh -t youruser@yourtargetsystem sudo satnogs-setup   # Setup SatNOGS client (see below)
+
  $ ssh -t youruser@yourtargetsystem sudo satnogs-setup         # Setup SatNOGS client (see below)
  
 
<br />
 
<br />
  
== See also ==
+
==See also==
* [[SatNOGS Client Setup]]
+
 
 +
*[[SatNOGS Client Setup]]
  
 
[[Category:Build]]
 
[[Category:Build]]
 
[[Category:Software]]
 
[[Category:Software]]

Revision as of 08:54, 16 December 2020

Introduction

SatNOGS Client Ansible makes the actual provisioning of the SatNOGS Client system. It is called, under the hood, when applying the configuration using SatNOGS Client Setup utility. It currently supports Raspbian and Debian (stretch and buster).

Raspbian

For Raspberry Pi, which is the reference platform for SatNOGS, a Raspbian image with SatNOGS Client Ansible pre-installed is available.

Debian

Important.png
Follow these instructions only if you are provisioning SatNOGS to Debian from another host or are installing on the same host. If you are using SatNOGS Raspbian image, follow SatNOGS Client Setup to set up your system.

These sections contain generic instructions for installing SatNOGS Client on a Debian system.

Prerequisites

  • A target Debian system. To install Debian please follow the Debian Installation Guide and chose the net installer if you want to run a headless server. The target system can be the host itself.
  • A user (referenced later as youruser) which is member of 'sudo' group exists on the target system.
  • An SSH server running on the target system.
  • A host system with Git and latest version of Ansible installed. To install Ansible on Debian, follow the Ansible Installation Guide.

Installation

On the host system run the following commands:

$ git clone https://gitlab.com/librespacefoundation/satnogs/satnogs-client-ansible.git    # Clone SatNOGS Client Ansible repository
$ cd satnogs-client-ansible                                    # Change to cloned repository directory
$ git checkout stable                                          # Optionally, check out stable (Debian Buster 10) branch
$ cp -r production.dist production                             # Copy dist configuration
$ vi production/inventory/hosts                                # Update file with your own target host e.g. 127.0.0.1, user and SSH password
$ ssh youruser@yourtargetsystem true                           # Test SSH connection to target system
$ ansible-playbook -i production/inventory/hosts -K site.yml   # Run Ansible playbook
$ ssh -t youruser@yourtargetsystem sudo satnogs-setup          # Setup SatNOGS client (see below)


See also