!! Poznámky a návody

Export-import v OpenCms

# jakékoli změny systému a větší změny obsahu je třeba 24h dopředu avizovat do konference web-fav-oznam@mail.kiv.zcu.cz.

# jakékoli změny systému a větší změny obsahu je třeba dopředu avizovat do konference web-fav-oznam@mail.kiv.zcu.cz.

!! [[#system]] Nasazení změn systému

Tj. změn, kdy se aktualizuje funkčnost ovlivňující obsah - např. upgrade OpenCms, změny datového modelu, XSD.

Update modulů (vyžaduje restart web serveru):

Update obsahu velkého rozsahu (přes OpenCms import, nevyžaduje restart web serveru):

# musí být napřed připraveno na testing
# platí postup zamknutí -> záloha ostrého -> export z testing -> import na ostrý -> ověření -> odemknutí

Pravidla pro aktualizaci (a) [[systému pro web FAV -> #system]], (b) [[obsahu na webu -> #obsah]].

!! [[#system]] Nasazení system-wide změn

!! [[#obsah]] Aktualizace modulů či obsahu

----

# ostrý OpenCms admin > db mgmt > export db > nahoře v Site mít správný root (/sites/default/), do Resources to export dát správný podadresář (nejlépe naklikat přes ikonu Search)
# výsledný .zip (na AFS v .../WEB-INF/packages/) zkopírovat na dev stroj do stejného adr
# testing OpenCms admin > db mgmt > Import File from Server > vybrat .zip *a mít stejný Site adr jako byl při exportu*

** [@/WEB-INF/config/opecms.properties@]

!!! Základní axiomy:

Související dokumenty: OpenCMS obecně, OpenCmsNastaveniProFAV, [[Instalace]] na čistý systém.

Související dokumenty: OpenCmsNastaveniProFAV, [[Instalace]] na čistý systém.

Tj. změn, kdy se aktualizuje funkčnost ovlivňující obsah - např. změny datového modelu, XSD.

Tj. změn, kdy se aktualizuje funkčnost ovlivňující obsah - např. změny datového modelu, XSD. Viz též [[Instalace]] když se to dělá na čistý systém.

# rozlišují se role _vývojář_, _admin_, _manažer_, _uživatel_
# rozlišují se staging třídy _develop_, _testing_, _ostrý_
** u strojů, OpenCms instalací, a databází
# obsah testing je považován za nestabilní, slouží jen k ověřování funkčnosti
** důsledek: na testing se v žádném případě nikdy neplní nový obsah, který není na ostrém
# na testing nemají přístup uživatelé, jen vývojáři a admin

!! Nasazení system-wide změn

Tj. změn, kdy se aktualizuje funkčnost ovlivňující obsah - např. změny datového modelu, XSD.

!!! 2. Překlopení, v _dopředu ohlášený den D hodinu H_

Pre-flight check

Akce

# admin na ostrém vrátí ze zálohy OpenCms properties na aktualizovanou instalaci

!! Aktualizace modulů či obsahu

Tj. zpětně kompatibilní úpravy.

!!! 1. Příprava

!!! 2. Překlopení

Základní axiomy:

# rozlišují se staging třídy _develop_, _testing_, _ostrý_ a to u strojů, OpenCms instalací, a databází
# na testing se v žádném případě nikdy neplní nový obsah, který není na ostrém
# na ostrý nemají v žádném případě přístup vývojáři, jen admin

1. Příprava

# vývojáři připraví změny (moduly, obsah) a update skripty na develop
# admin udělá na ostrém webu cvičný dump databází (db pro opencms, db pro aplikace), OpenCms projektu @@Administration > Db Mgmt > Export db@@ a OpenCms modulů @@Admin > Module Mgmt > šipka dolů u modulu@@
# vývojáři proženou dumpy svými update scripty
# vývojáři výsledek nainstalují na testing web
# vývojáři otestují změny na testing webu
** zobrazování obsahu, editace, přístup do backendu

2. Překlopení

V dopředu ohlášený den D hodinu H

# admin na ostrém zamkne celý projekt
# admin udělá na ostrém zálohu všech db (db pro opencms, db pro aplikace)
# admin na ostrém udělá dump db, případně OpenCms projektu a modulů
# vývojáři proženou tento dump update scripty, výsledek nasadí na testing
# vývojáři a manažer ozkouší že vše funguje
** zobrazování obsahu, editace, přístup do backendu
# admin na ostrém udělá zálohu properties souboru OpenCms
** _TODO který soubor to přesně je_
# admin shodí web kontejner s OpenCms na ostrém i na testing
# admin na ostrém zazálohuje instalaci OpenCms
** nejlíp přejmenováním adresáře, např. na @@opencms-old@@
# admin zkopíruje instalaci OpenCms z testing na ostrý
# admin zkopíruje všechny db z testing na ostrý
** přes dump, nebo fyzicky, podle toho co je vhodné
# admin na ostrém vrátí OpenCms properties ze zálohy na aktualizovanou instalaci
# admin nahodí web kontejner na ostrém i testing
# admin na ostrém nastaví v OpenCms administraci konfiguraci na DNS pro ostrý
# manažer otestuje že na ostrém vše funguje
** zobrazování obsahu, editace, přístup do backendu, přihlašování a práva
# admin na ostrém odemkne projekt

!! Při instalaci "per partes" tj. po modulech či blocích obsahu

# platí postup zamknutí -> ostrý dump -> testing instalace a update -> testing ověření -> instalace na ostrý -> odemknutí
# postup instalace je: admin smaže obsah, smaže modul, nasadí změněný modul, restartuje Tomcat, nasadí obsah

!! Pravidla nasazení změn [=OpenCMS=] obsahu a modulů při vývoji

!! Pravidla nasazení změn OpenCMS obsahu a modulů při vývoji

# vývojáři připraví změny (moduly, obsah) vč. skriptu pro update
# admin udělá v OpenCMS cvičný dump projektu @@Administration > Db Mgmt > Export db@@ a modulů @@Admin > Module Mgmt > šipka dolů u modulu@@
# vývojáři otestují scripty na tomto dumpu
# v dopředu ohlášený den D hodinu H
## admin udělá ostrý dump projektu a modulů
## admin zamkne celý projekt
## vývojáři proženou dump scripty
## admin odemkne projekt, smaže obsah, smaže modul, nasadí změněný modul, restartuje Tomcat, nasadí obsah
** NO-NO: nemazat modul před obsahem (když se napřed smaže modul a pak obsah, řve to a nejde vyexportovat obsah, nejde smazat, nejde nic - musí se ručně vše vrátit přes db!!!)
** NO-NO: neimportovat obsah před modulem (analogické důvody)
## admin zamkne projekt, otestuje se
## OK -> admin odemkne projekt