Rozhraní CLI (Command Line Interface) je alternativou k přístupu přes HTTPS. S CLI rozhraním můžeme pracovat v textovém režimu pomocí klienta ssh (putty) nebo telnet.
Připojení klientem telnet k jednotce se servisní IP adresou 192.168.169.169. Na povelovou řádku napíšeme:
telnet 192.168.169.169
Pak vložíme uživatelské jméno a heslo uvedené v menu Setting / Device v https přístupu (defaultně admin, admin).
Připojení klientem putty. Do okénka Host Name (or IP address) zapíšeme:
admin@192.168.169.169
Stiskneme Open. Pak vložíme heslo admin. Tento postup (bez klíče) je podmíněn označeným políčkem Settings Device / Service access / passw enable v https přístupu.
Pokud vlastníme privátní část klíče, pak vystačíme bez hesla. V putty pokračujeme volbou Connection / SSH / Auth a vybereme cestu k souboru s klíčem např. klic.ppk. Volbou Session / Logging uložíme konfiguraci pro putty. Pak již vstupujeme do CLI jednotky pouhým výběrem spojení v putty a stiskem Open. Podrobnější popis v příloze.
Připojení klientem ssh v Linuxu.
ssh admin@192.168.169.169 -i key
Pokud známe heslo a to je povoleno v Settings Device / Service access / passw enable v https přístupu, pak můžeme klíč vynechat a v následném dotazu se prokázat heslem.
Menu se větví třemi hlavními povely:
show | stav konfigurace, data o komunikaci, toto menu je pouze pro čtení |
configure | volba a zápis konfiguračních parametrů |
tools | ovládá servisní nástroje |
Z povelu stačí napsat jen tolik písmen, aby byl odlišen od ostatních, pak Enter. Za mezerníkem pokračuje další úroveň povelu, například:
show radio local Enter
dává stejný výsledek jako
s r l Enter
Po stisku Enter se vždy dostaneme na úroveň výchozích povelů
show-configure-tools, každý krok tedy opět začíná
některým z písmen s, c
nebo t
.
Není-li povel jednoznačný, objeví se nápověda obsahující syntaxi povelu a možné volby v další úrovni:
RAy: t r --------------------------------------------- WARNING: The given command "r" is not unique within set of possible commands: restart rx_scan
Pokračujeme tedy buď povelem t re
pro restart
nebo t rx
pro měření přijímaného spektra.
Pro počáteční orientaci slouží povel help
nebo
?
, který za úvodní menu připojí schematický přehled povelů:
=========================================================================== to read: to write: to test: show configure tools radio l|r radio fre mod pow ping eth_bridge l|r eth_bridge spe dup mdi flow vlan spectrum device l|r device name peer user search time rx_scan service_acc l|r service_acc htt tel ssh snmp ip def manv tx_disabl keys l|r keys add delete indicator alarm_limit l|r alarms cpu mem pow snr rss ber air restart measure l|r rf_pow peer_eth log ... graph ... traffic_stat... config ... config restore default
Povely v prvním sloupci zakončené volbou l|r
tedy local
nebo remote jsou kompletní. Ostatní povely se dále větví naznačeným
způsobem, který je podrobněji popsán v helpech příslušné úrovně.
Povel !
poskytne zprávu o stavu linky, povelem
exit
ukončíme funkci CLI.
Zprávy povelu Show jsou přehledné, pouze povely Graph a Configuration jsou zde více rozvedeny:
Povelem show graph vybíráme z několika záznamů, které zachycují průběh vybrané veličiny během poslední hodiny. Graf je reprezentován tabulkou o dvou sloupcích, vlevo je čas, vpravo sledovaná hodnota. K dispozici jsou grafy těchto veličin:
Povel | Povel slovy | Obsah | Frekvence záznamů |
s g be l | show graph ber local | bit error rate | 1 min |
s g m l | show graph modulation local | modulation status | modulační změny |
s g v l | show graph voltage local | power source voltage | 5 min |
s g r l | show graph rss local | signal strength | 1 min |
s g bi l | show graph bitrate local | net bitrate | změny rychlosti |
s g s l | show graph snr local | signal quality (local unit) | 1 min |
s g t r | show graph temperature remote | unit inside temperature (remote unit) | 5 min |
s g e l | show graph ethernet local | traffic history | 1 min |
Například povelem show graph modulation local Enter zobrazíme průběh stavů modulace v lokální jednotce:
RAy: s g m l --------------------------------------------- Command> show graph modulation local ["2010-06-29 08:03:39",8], ["2010-06-29 08:46:52",6], ["2010-06-29 08:50:19",5],
Stupeň modulace je vyjádřen číslicemi 0 až 11, viz ACM status.
Povel show configuration Enter připraví konfigurační soubor jednotky ke stažení tftp klientem.
RAy: s c --------------------------------------------- Command> show configuration Inactivity timeout expired. INFO: The file with configuration "ray.conf" is ready to be downloaded by some TFTP client. The file is accessible for approx. 60 seconds.
Po provedení povelu je po dobu 60 sec připraven konfigurační soubor ray.conf ke stažení tftp klientem. Soubor obsahuje konfiguraci lokální i vzdálené jednotky.
Způsob stažení souboru závisí na použitém tftp klientovi. Například v Linuxu pracujeme takto:
tftp 192.168.169.169 tftp> get ray.conf
Povelem configure Enter nebo c Enter otevřeme menu pro zápis konfiguračních hodnot do jednotky. Položky jsou analogické jako v menu show:
RAy: c --------------------------------------------- NAME configure SYNOPSIS configure { radio | eth_bridge | device | service_access | alarms | configuration | keys } ... DESCRIPTION Configure device parameters radio Configure radio parameters eth_bridge Configure ethernet bridge parameters device Configure device parameters service_access Configure service access parameters alarms Configure alarm limits configuration Put stored configuration to device keys Configure product keys
Konfigurační menu se dále větví takto:
radio | kmitočet, modulace, výkon |
eth_bridge | rychlost, duplex, mdix, flow control, vlan |
device | název jednotky, číslo protější jednotky, jméno uživatele, čas |
service_access | povolení přístupových cest, IP adresa, defaultní přístup |
alarms | nastavení limitů pro alarmy |
configuration | vložení konfiguračního souboru do jednotky |
keys | vložení produktových klíčů |
Povely jsou podrobně definovány v helpech, které se vypisují při jejich aplikaci. Povely lze zkracovat ale závěrečný parametr nebo parametry musí být vypsány celé. Například parametry v následujících povelech jsou: 28, CH3, 32-QAM, hi, 16-QAM, low, auto
RAy: c r f m 28 CH3 32-QAM hi 16-QAM low
RAy: c r f m 28 CH3 auto
Povel tools Enter nabízí několik diagnostických nástrojů:
tools { ping | spectrum | rx_scan | tx_disable | indicator_rss | restart } ...
ping | vyslání testovacího pingu |
spectrum | zjištění rss v přijímaném spektru |
rx_scan | funkce spectrum pro Local / Remote, s vypnutím protější jednotky |
tx_disable | zákaz vysílání po zvolenou dobu |
indicator_rss | zvuková indikace rss |
restart | restart jednotky |