aboutsummaryrefslogtreecommitdiffstats
path: root/install/README.md
diff options
context:
space:
mode:
authorRobin ALEXANDER <colisee@hotmail.com>2022-03-03 19:15:55 +0100
committerRobin ALEXANDER <colisee@hotmail.com>2022-03-03 19:15:55 +0100
commit11c606c43b46cd86616da2f889d7f97c8eb297eb (patch)
tree1665495397a32f12fd747acc23019ec1ab6cd455 /install/README.md
parent82b0aced9133507f588486bcef3af322672e8819 (diff)
downloaddab-scripts-11c606c43b46cd86616da2f889d7f97c8eb297eb.tar.gz
dab-scripts-11c606c43b46cd86616da2f889d7f97c8eb297eb.tar.bz2
dab-scripts-11c606c43b46cd86616da2f889d7f97c8eb297eb.zip
New version
Diffstat (limited to 'install/README.md')
-rw-r--r--install/README.md56
1 files changed, 56 insertions, 0 deletions
diff --git a/install/README.md b/install/README.md
new file mode 100644
index 0000000..017267a
--- /dev/null
+++ b/install/README.md
@@ -0,0 +1,56 @@
+# Table of contents
+- [Introduction](#introduction)
+- [Installation](#installation)
+- [Removal](#removal)
+
+# Introduction
+The goal of the odr-get shell script is to install:
+- the [odr-mmbtools](https://www.opendigitalradio.org/mmbtools) components developed by the [Open Digital Radio](https://www.opendigitalradio.org/) non-profit association on a clean debian environment
+- Working configuration files that you can later customize as you see fit
+
+# Installation
+## Preliminary notes
+We **highly recommend** that you install odr-mmbTools on a **new debian** environment, starting from the Bullseye release. Since some software components, like the audio encoders or the modulator, are CPU-intensive, we recommend you setup a lite debian environment (ie. without a GUI framework).
+
+If you want to quickly setup a lite clean debian environment, we suggest you use [Vagrant](https://www.vagrantup.com) associated with a virtualization hypervisor, like [Virtualbox](https://www.virtualbox.org). A sample Vagrantfile is available in the Vagrant folder of this repository.
+
+## Steps
+1. Sign-in with your user profile
+1. Update your system:
+ ```
+ sudo apt-get update
+ sudo apt-get upgrade -y
+ ```
+1. Find your time zone:
+ ```
+ timedatectl list-timezones
+ ```
+1. Set your time zone:
+ ```
+ sudo timedatectl set-timezone your_timezone
+ ```
+1. Install the git command:
+ ```
+ sudo apt-get install -y git
+ ```
+1. Clone this repository:
+ ```
+ cd $HOME
+ git clone https://github.com/opendigitalradio/dab-scripts.git
+ ```
+1. Install the ODR-mmbTools suite and the sample configuration folder
+ ```
+ # Install the stable version of odr-mmbTools
+ bash $HOME/dab-scripts/install/odr-get --branch master install
+
+ # Or install the current version of odr-mmbTools
+ bash $HOME/dab-scripts/install/odr-get --branch next install
+ ```
+
+# Removal
+If you wish to remove the odr-mmbTools suite and the sample configuration folder, then follow these steps:
+1. Stop all odr-mmbTools related jobs in supervisor
+2. Remove the ODR-mmbTools software suite and the configuration folder
+ ```
+ bash $HOME/dab-scripts/install/odr-get remove
+ ```