Virtlab:Protokoly/Aktivační server

Z VirtlabWiki

Verze z 06:49, 15. 8. 2007 Bam015 (Diskuse | příspěvky) (uprava komunikacniho protokolu) ← Předchozí porovnání		Verze z 07:23, 19. 8. 2007 Gry72 (Diskuse | příspěvky) Následující porovnání →
Řádka 12:		Řádka 12:
	* 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.		* 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 rezervační 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.

---

Verze z 07:23, 19. 8. 2007

Tento článek popisuje komunikační prokokol mezi rezervačním a aktivačním serverem distribuovaného Virtlabu.

Obsah 1 Vlastnosti 2 Popis protokolu 2.1 Pokyn rezervačního serveru aktivačnímu serveru ke znovunačtení databáze 2.2 Předání seznamu spojení pro konfiguraci od rezervačního serveru aktivačnímu serveru 2.3 Pokyn rezervačního serveru aktivačnímu serveru ke zrušení popisu topologií konfigurace

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 a každý další první po prázdném řádku 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.
• 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.
• Při odpovědi serveru na příkaz je na prvním řádku návratový kód, mezera a za ní popis odpovědi.

Popis protokolu

Pokyn rezervačního serveru aktivačnímu serveru ke znovunačtení databáze

• Příkaz: "reload\n"
• Odpověď: Návratový kód.

Příklad:

 reload\n
 \n

Předání seznamu spojení pro konfiguraci 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

Pokyn rezervačního serveru aktivačnímu serveru ke zrušení popisu topologií konfigurace

• 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