Požadavek update-dad

Aktualizace databáze dle DAD

Systém flexideo umožňuje provádění úprav struktury databáze dle DAD souborů defakto za provozu. Právě k jeho spuštění slouží požadavek update-dad.

<request>
<update-dad
time="{number}"
/>
</request>

Atributy

Potomci

Požadavek update-dad neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Poznámka k request

Atribut time, je-li uveden, obsahuje celé číslo udávající počet vteřin s odhadem doby odstávky. Uživatelé, kteří po spuštění akutalizace vznesou na server požadavek, jsou po dobu aktualizace informováni o jejím průběhu a to zejména informací v HTTP hlavičce (error 503), jejíž součástí je i též informace o odhadovaném čase aktualizace. Při požadavku na stránku je klientským prohlížečům zasílána stránka 503-error.htm uložená v kmenu webového sídla (zde je možné ji upravit dle individuálních potřeb).

Odpověď

Struktura odpovědi na požadavek update-dad vrácená v obálce response:

<response>
<update-dad
type="ok|error"
detail="{string}"
/>
</response>

Atributy

Potomci

Odpověď update-dad neobsahuje žádné další elementy, ani žádné jiné číselné či řetězcové hodnoty.

Výraz pro identifikaci chyb v odpovědi serveru: update-dad[@type='error'] (odkaz na popis detailu: @detail).

Další info

Odeslání požadavku je vždy spojeno alespoň s krátkou odstávkou, kdy i nadále běží služba webového serveru a na všechny URL požadavky vrací stránku s informací o provádění krátké aktualizace. Většinou v řádu sekund či desítek sekund dle rozsahu. V době této odstávky server načte z dohodnutého adresáře DAD soubory s popisem databáze a porovná je s její stávající strukturou. Při nalezení rozdílu tuto strukturu do databáze doplní. Jakmile je hotov, spustí další služby související s provozem a chod systému je automaticky zcela obnoven.

Při neplatném DAD nebo vzniku jiné chyby se je provoz serveru zastaven a je třeba chyby odstranit. K takovým chybám dochází ovšem jen velmi zřídka a situaci je možné vyřešit poměrně rychle tím, že jsou dodána DAD z předchozí verze a server je obratem obnoven s předchozí strukturou.

Standardně se při startu serveru načítá aktuální struktura DAD, která je určující pro utváření struktury databáze. Aby nebylo nutné provádět kvůli aktualizaci struktury databáze restart celého systému, je k dispozici požadavek update-dad, který zajistí pozastavení serveru a aktualizaci databáze dle *.dad souborů uložených v patřičné složce (viz. instalace verze). Pro načtení *.dad souborů ze složky a spuštění aktualizace je tedy možno zaslat požadavek update-dad.

Aktualizaci databáze může předcházet (dle způsobu nastavení) aktualizace souborová s využitím požadavku update-files.

---

Požadavek admin-unlockPožadavek cache-boostPožadavek do-managePožadavek do-optimize-filesPožadavek do-scan-filesPožadavek get-scan-filesPožadavek mimesPožadavek servicePožadavek soap-servicesPožadavek test-performancePožadavek unload-soapPožadavek unload-pseudoPožadavek update-dadPožadavek update-files

---