Virtlab:Protokoly/Aktivační server
Z VirtlabWiki
< Virtlab:Protokoly(Rozdíly mezi verzemi)
Verze z 10:00, 19. 8. 2007 Gry72 (Diskuse | příspěvky) ← Předchozí porovnání |
Aktuální verze Vav166 (Diskuse | příspěvky) |
||
Řádka 6: | Řádka 6: | ||
* Komunikace přes TCP spojení, standardně na portu 50002. | * Komunikace přes TCP spojení, standardně na portu 50002. | ||
* Pro názvy příkazů a jména argumentů nerozlišuje velká a malá písmena (''case insensitive''). | * Pro názvy příkazů a jména argumentů nerozlišuje velká a malá písmena (''case insensitive''). | ||
- | * První řádek a každý další první po prázdném řádku určuje příkaz, následující řádky jeho argumenty. | + | * První řádek určuje příkaz, následující řádky jeho argumenty. |
* Na pořadí argumentů nezáleží a jsou case-insensitive. | * Na pořadí argumentů nezáleží a jsou case-insensitive. | ||
* Za názvem argumentu je dvojtečka, za kterou ihned nasledují jeho parametry, za dvojtečkou nesmí být mezera. | * Za názvem argumentu je dvojtečka, za kterou ihned nasledují jeho parametry, za dvojtečkou nesmí být mezera. | ||
* Bílé znaky (''whitespace''), jako tabelátory (0x09), mezery (0x20) nejsou povoleny, slouží jako oddělovače. parametrů pro argumenty. Výjimku tvoří mezery a tabelátory před názvem příkazu a argumentu. Tyto jsou odfiltrovány. | * Bílé znaky (''whitespace''), jako tabelátory (0x09), mezery (0x20) nejsou povoleny, slouží jako oddělovače. parametrů pro argumenty. Výjimku tvoří mezery a tabelátory před názvem příkazu a argumentu. Tyto jsou odfiltrovány. | ||
* Odeslání prázdného řádku (jen <LF> (0x0A)), potvrdí, že všechny argumenty byly odeslány a je možno zpracovat příkaz. | * Odeslání prázdného řádku (jen <LF> (0x0A)), potvrdí, že všechny argumenty byly odeslány a je možno zpracovat příkaz. | ||
- | * Po odeslání prázdného řádku je možno psát další příkaz. | ||
* Spojení ukončeno vždy na žádost klienta, mimo speciální případy, kdy server přijímaným datům nerozumí, nebo je klient připojen příliš dlouho. | * Spojení ukončeno vždy na žádost klienta, mimo speciální případy, kdy server přijímaným datům nerozumí, nebo je klient připojen příliš dlouho. | ||
* Při odpovědi serveru na příkaz je na prvním řádku návratový kód, mezera a za ní popis odpovědi. | * Při odpovědi serveru na příkaz je na prvním řádku návratový kód, mezera a za ní popis odpovědi. | ||
Řádka 17: | Řádka 16: | ||
== Popis protokolu == | == Popis protokolu == | ||
- | === Pokyn rezervačního serveru aktivačnímu serveru ke znovunačtení databáze === | + | === Pokyn rezervačního serveru aktivačnímu serveru ke znovunačtení databáze rezervací === |
* Příkaz: "reload\n" | * Příkaz: "reload\n" | ||
* Odpověď: Návratový kód. | * Odpověď: Návratový kód. | ||
Řádka 25: | Řádka 24: | ||
\n | \n | ||
- | === Předání seznamu spojení pro konfiguraci od rezervačního serveru aktivačnímu serveru === | + | === Předání popisu topologie pro rezervaci od rezervačního serveru aktivačnímu serveru === |
* Příkaz: "linkconf\n" | * Příkaz: "linkconf\n" | ||
* Argument (povinný): resid:''ID rezervace''\n" | * Argument (povinný): resid:''ID rezervace''\n" | ||
Řádka 52: | Řádka 51: | ||
\n | \n | ||
</pre> | </pre> | ||
+ | |||
+ | |||
+ | [[Kategorie:Protokol]] | ||
+ | [[Kategorie:Aktivační server]] |
Aktuální verze
Tento článek popisuje komunikační prokokol mezi rezervačním a aktivačním serverem distribuovaného Virtlabu.
Obsah |
[editovat]
Vlastnosti
- Textově orientovaný protokol.
- Textové příkazy, oddělené <LF> (0x0A), (symbol <CR> (0x0D) je ignorován)
- Komunikace přes TCP spojení, standardně na portu 50002.
- Pro názvy příkazů a jména argumentů nerozlišuje velká a malá písmena (case insensitive).
- První řádek určuje příkaz, následující řádky jeho argumenty.
- Na pořadí argumentů nezáleží a jsou case-insensitive.
- Za názvem argumentu je dvojtečka, za kterou ihned nasledují jeho parametry, za dvojtečkou nesmí být mezera.
- Bílé znaky (whitespace), jako tabelátory (0x09), mezery (0x20) nejsou povoleny, slouží jako oddělovače. parametrů pro argumenty. Výjimku tvoří mezery a tabelátory před názvem příkazu a argumentu. Tyto jsou odfiltrovány.
- Odeslání prázdného řádku (jen <LF> (0x0A)), potvrdí, že všechny argumenty byly odeslány a je možno zpracovat příkaz.
- Spojení ukončeno vždy na žádost klienta, mimo speciální případy, kdy server přijímaným datům nerozumí, nebo je klient připojen příliš dlouho.
- Při odpovědi serveru na příkaz je na prvním řádku návratový kód, mezera a za ní popis odpovědi.
[editovat]
Popis protokolu
[editovat]
Pokyn rezervačního serveru aktivačnímu serveru ke znovunačtení databáze rezervací
- Příkaz: "reload\n"
- Odpověď: Návratový kód.
Příklad:
reload\n \n
[editovat]
Předání popisu topologie pro rezervaci od rezervačního serveru aktivačnímu serveru
- Příkaz: "linkconf\n"
- Argument (povinný): resid:ID rezervace\n"
- Argument (povinný, opakuje se alespoň jednou): link:popis_spojení\n"
- Odpověď: Návratový kód. (objeví-li se v resid lomítko, jde o špatnou syntaxi parametrů)
Příklad:
linkconf\n resid:1@koleje\n link:rp@koleje:fastethernet1, rm@koleje:fastethernet1;\n link:ro@koleje:fastethernet1, rp@koleje:fastethernet0;\n link:rn@koleje:fastethernet1, ro@koleje:fastethernet0;\n link:rm@koleje:fastethernet0, rn@koleje:fastethernet0;\n \n
[editovat]
Pokyn rezervačního serveru aktivačnímu serveru ke zrušení popisu topologie rezervace
- Příkaz: "dellinkconf\n"
- Argument (povinný): delresid:ID rezervace\n"
- Odpověď: Návratový kód. (objeví-li se v delresid lomítko, jde o špatnou syntaxi parametrů)
Příklad:
dellinkconf\n delresid:1@koleje\n \n