====== Vzdálená údržba stanic ======

Pro přístup k servisnímu rozhraní je třeba mít přístupové údaje na server space.astro.cz. Z něj je pak možné přistupovat k většině stanic a stanice spravovat. 

Postup připojení je následující: 

  ssh jmeno_observatoře@space.astro.cz

V případě že autentizace veřejným klíčem proběhne v pořádku, budete připojeni na server space.astro.cz. Na něm si můžete prohlížet svoje staniční data. Případně promazávat nehodnotná data, která byla do datového úložiště omylem zanesena. 

Ke svojí [[cs:stations|stanici]] se pak připojíte příkazem

  ssh jmeno_uzivatele@jmeno_stanicniho_pocitace.tunnel

<WRAP center round info 100%>
Tento návod počítá s tím, že stanice má zapnutý a [[cs:odroid-u3#vzdaleny_pristup_na_stanici|nakonfigurovaný reverzní ssh tunnel]]. A jeho parametry jsou v konfiguračním souboru /etc/ssh_config na serveru space.astro.cz

  wget http://space.astro.cz/bolidozor/support/scripts/setup_reverse_tunnel.sh
  chmod +x ./setup_reverse_tunnel.sh
  sudo ./setup_reverse_tunnel.sh 
</WRAP>


===== Získání přístupu na space.astro.cz =====

Nejlepší možností je použití přihlašování veřejným klíčem. V takovém případě server space.astro.cz nebude vyžadovat heslo. 
Pár klíčů je potřeba vygenerovat na počítači ze kterého chcete získat přístup na space.astro.cz. Z příkazové řádky to provedeme spuštěním utility ssh-keygen: 

  ssh-keygen

Ta se zeptá na několik údajů, které nebudeme vyplňovat. Pouze potvrdíme volbu klávesou enter.
Utilita vygeneruje dva soubory id_rsa.pub a id_rsa.  Soubor id_rsa.pub obsahuje veřejný klíč, který je potřeba přenést na server space.astro.cz

To lze udělat buď ze stanice nakopírováním obsahu souboru do souboru ///~/.ssh/authorized_keys// který už na serveru space.astro.cz existuje v domovském adresáři observatoře.

Druhou možností je nastavení přístupového hesla. Heslo lze nastavit při připojení se na space.astro.cz  (stanice se na server připojuje automaticky s použitím autentizace klíčem) Ze stanice se na space.astro.cz připojíme pomocí: 

  ssh jmeno_observatoře@space.astro.cz
  
V příkazovém řádku na serveru space.astro.cz pak můžeme nastavit heslo nástrojem passwd.


===== Nastavení SSH klienta pro přístup přes reverzní tunely =====

Aby bylo možné pohodlně přistupovat ke stanicím přímo z vašeho počítače, bez nutnosti se nejdříve přihlašovat na server ''space.astro.cz'', doporučuje se upravit konfiguraci SSH vašeho PC.

==== 1. Povolení adresáře s doplňkovými konfiguracemi ====

Otevřete (nebo vytvořte) soubor <file>~/.ssh/config</file> a na jeho začátek přidejte řádek:

<code bash>
Include ~/.ssh/config.d/*
</code>

Tím zajistíte, že SSH klient bude načítat i konfigurační soubory uložené v adresáři <file>~/.ssh/config.d/</file>.

==== 2. Vytvoření konfiguračního souboru pro tunely ====

Vytvořte adresář (pokud ještě neexistuje) a soubor ''~/.ssh/config.d/space_tunnels'':

<code bash>
mkdir -p ~/.ssh/config.d
nano ~/.ssh/config.d/space_tunnels
</code>

Do souboru vložte následující obsah:

<file bash>
# ~/.ssh/config.d/space_tunnels
#
# Pro aktualizaci seznamu tunelů ze serveru:
# ssh space.astro.cz "grep -E '^\s*(Host |Port|User|#)' /etc/ssh/ssh_config.d/ssh_tunnel_bolidozor.conf" > ~/.ssh/config.d/space_tunnels_list

Host *.tunnel
  HostName localhost
  ProxyJump space.astro.cz
</file>


<WRAP info>
Pokud se na server ''space.astro.cz'' přihlašujete pod jiným uživatelem, než je vaše lokální uživatelské jméno, je nutné buď:

  * nahradit uživatelské jméno přímo v definici ProxyJump, např.  
    ''ProxyJump uzivatel@space.astro.cz''
    
  * nebo mít v samostatném souboru (např. ''~/.ssh/config.d/space_astro'') definovaný záznam:
    <code bash>
    Host space.astro.cz
      User uzivatel
    </code>
Tím se zajistí, že SSH bude při připojování používat správného uživatele.
</WRAP>

==== 3. Načtení seznamu aktivních tunelů ====

Získejte aktuální seznam všech dostupných stanic s aktivním reverzním tunelem:

<code bash>
ssh space.astro.cz "grep -E '^\s*(Host |Port|User|#)' /etc/ssh/ssh_config.d/ssh_tunnel_bolidozor.conf" > ~/.ssh/config.d/space_tunnels_list
</code>

Tímto se vytvoří nebo aktualizuje soubor ''~/.ssh/config.d/space_tunnels_list'', který obsahuje definice všech dostupných stanic.


==== 4. Připojení ke stanici ====

Po provedení výše uvedených kroků je možné se připojit ke stanici přímo ze svého počítače:

<code bash>
ssh radio-stanice.tunnel
</code>


==== 5. Příklad: Připojení pro aplikaci [[cs:freya|Freya]] ====

Pokud chcete přesměrovat port například pro použití aplikace ''Freya'', použijte:

<code bash>
ssh -L 3731:localhost:3731 radio-stanice.tunnel
</code>

Tím se na vašem počítači otevře port 3731, který bude přesměrován na danou stanici.  
Poté lze Freyu spustit lokálně bez nutnosti připojovat se přes ''space.astro.cz''.

Viz podrobnější [[cs:freya|návod]].


===== Nejčastější operace na stanici =====

==== Zastavení a spuštění detekčního software ====

  cd repos/station-supervisor/
  ./stop.sh
  ./start.sh
  
==== Restartování stanice ====

  sudo reboot 
  
==== Vypnutí stanice ====

  sudo poweroff


==== Nahrání testovacího RAW záznamu z přijímače ====

  nc localhost 3701 | sox -t f32 -c 2 -r 96000 - test.wav trim 0 30

Tento příkaz vytvoří na spuštěné stanici 30s dlouhý WAV záznam komplexních vzorků z přijímače. Pro jeho další zpracování je užitečné si jej zkopírovat na space.astro.cz do účtu stanice. 

  scp test.wav ZVOLENEVES@space.astro.cz:/storage/bolidozor/ZVOLENEVES/.