Virtlab:Protokoly/Aktivační server

Z VirtlabWiki

Verze z 10:00, 19. 8. 2007 Gry72 (Diskuse | příspěvky) ← Předchozí porovnání		Verze z 10:01, 19. 8. 2007 Gry72 (Diskuse | příspěvky) Následující porovnání →
Řádka 17:		Řádka 17:
	== 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 25:
	\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"

---

Verze z 10:01, 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 rezervací 2.2 Předání popisu topologie pro rezervaci od rezervačního serveru aktivačnímu serveru 2.3 Pokyn rezervačního serveru aktivačnímu serveru ke zrušení popisu topologie rezervace

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 rezervací

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

Příklad:

 reload\n
 \n

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

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