README.md 2.82 KB
Newer Older
1 2 3 4 5 6 7
# Reliable Networking Atom (RNA)

## Network Setup

* Subnet: `10.8.0.0/24`
* Hosts:
    * Gateway: `10.8.0.1`
rna's avatar
rna committed
8
    * Master: `10.8.0.1`
9 10 11 12 13 14 15 16 17 18 19 20
    * Hosts: `10.8.0.10` - `10.8.0.50`

## RNA-Master Virtual Machine

### Idea

We administer the network using a master-machine, which includes DHCP, DNS and a SaltStack master.

The virtual machine is bridged to the physical interface where the hosts are attached to.

### Usage
* Start using `vagrant up`.
Andreas Schmidt's avatar
Andreas Schmidt committed
21

Andreas Schmidt's avatar
Andreas Schmidt committed
22 23 24 25 26
### Deploying Files

* Execute e.g. `salt '*' state.sls video.deploy`.
* Make sure to run `salt-run fileserver.clear_file_list_cache()` if files are not found.

27 28
### States

Andreas Schmidt's avatar
Andreas Schmidt committed
29 30 31 32 33 34 35
#### Common

##### WLAN

* Execute `common.wlan` to setup wireless LAN on the RNAs. The devices automatically connect to the LARN network.
* Check for present WLAN networks: `sudo iwlist wlan0 scan | grep ESSID`

Andreas Schmidt's avatar
Andreas Schmidt committed
36 37 38 39 40
#### Demo

* Execute `demo.control` to deploy the control demo.
* Execute `demo.video` to deploy the video demo.

41 42 43 44 45 46 47 48 49 50 51 52 53
#### Gstreamer

Gstreamer is installed from the sources, which are fetched from GitHub. We are using `gst-uninstalled`, a environment system much as virtualenv for Python. As we are using many different gstreamer elements, we build all plugins together with Gstreamer.

#### Video

Contains everything for the video demonstrations.

* `video.apps` (Gstreamer application, featuring a fully synced split-screen).
* `video.deploy` (Sets up everything for demonstrations).
* `video` (Create directory, copy files, build PRRT, plugin etc.).
* `video.scripts` (Copies scripts for send/recv the demonstration streams).
* `video.videos` (Copies all video files to the host).
Andreas Schmidt's avatar
Andreas Schmidt committed
54 55 56 57 58 59 60 61 62 63 64 65 66 67

## Odroid

### Images

* Images are built based on `ubuntu-16.04.2-minimal-odroid-xu4-20170516.img`.
* The latest image can be found under "Pipelines."
* Deploy image on eMMC module.

### Initial Setup

* The RNA comes with SaltStack and SSH installed.
* You can login using the `rna` user with the same password.
* Upon first startup:
68
  * Make sure that the hostname is updated (edit `/etc/hostname`) and the Salt `minion_id` is set appropriately (edit `/etc/salt/minion_id`).
Andreas Schmidt's avatar
Andreas Schmidt committed
69 70 71 72
  * Enter root mode with `sudo -i`
  * Run `salt-call test.ping` once.
  * Inside the RNA-Master, accept the key using `salt-key -L` and afterwards `salt-key -a` for the specific key.
* Afterwards, the system can be administered from the RNA-Master.
73 74 75 76 77 78 79 80 81 82 83 84 85


### eMMC Recovery

1. Flash emmc_recovery.img to a MicroSD card.
2. Connect both the eMMC and MicroSD to XU4.
3. Set the dip-switchs near the ethernet Jack to "SD boot mode".
4. Connect Power and watch the LED status
5. One the Blue led goes out and only RED is on. This may take 40seconds ~ 3minutes. And remove the power supply.
6. Set the dip switchs back to eMMC.
7. Remove the microSD card.
8. Proceed with normal power up with your peripherals attached.
9. After checking the eMMC, you can install other Linux OS images on the eMMC later.