<site server="jmeno-serveru-a-port-pro-informatika" uri="/sites/informatika.zcu.cz/"/>
<site server="jmeno-serveru-a-port-pro-www.kiv" uri="/sites/www.kiv.zcu.cz/"/>

Jména serverů a portů musí být taková, aby každá site běžela na jiném portu v rámci serveru, na kterém běží daná instalace opencms. (Viz též svn @@opencms-libs/configs/opencms-system.xml@@ a informace od systémového admina, které jsou to servery a porty.)

# [[Nainstalovat čité OpenCms 7.5.2 -> Instalace]]

Pro potřeby stránky informatika.zcu.cz jsou potřeba ještě následující moduly:

Přihlašte se k OpenCms jako administrátor, v poli @@Site@@ zvolte @@/@@ a v levém panelu otevřte adresář @@sites@@. V tomto umístění založte a publikujte dva adresáře: @@informatika.zcu.cz@@ a @@www.kiv.zcu.cz@@. Tím jsme připravili OpenCms pro konfiguraci Multisite.

Na platformě windows se pro server Tomcat toto provede přidáním následujících řádků do souboru @@catalina.bat@@, pro platformu Linux se jedná o soubor @@catalina.sh@@, na cestě @@CATALINA_HOME\bin@@. Tyto řádky umístit do souboru catalina.sh (catalina.bat???) za část, kde se načtou standardní proměnné Javy.
* Pro Windows
** [@set JAVA_OPTS=%JAVA_OPTS% -Djava.security.auth.login.config=%CATALINA_HOME%\Kerberos_Configuration\KerbNastaveni.conf@]
** [@set JAVA_OPTS=%JAVA_OPTS% -Djava.security.krb5.conf=%CATALINA_HOME%\Kerberos_Configuration\krb5.conf@]
*Pro Linux(Ubuntu)
** JAVA_OPTS="$JAVA_OPTS -Djava.security.auth.login.config=$CATALINA_HOME/conf/Kerberos/KerbNastaveni.conf"
** JAVA_OPTS="$JAVA_OPTS -Djava.security.krb5.conf=$CATALINA_HOME/conf/Kerberos/krb5.conf"

Na celou akci je třeba počítat aspoň 4h čistého času (když se něco vysype, je z toho klidně celý dlouhý den).

Import archivu @@www.kiv.zcu.cz@@ může trvat delší dobu kvůli velkým souborům (data "produktů" autorizovaného software). Po naimportování stránek proveďte: @@Publish Projekt@@. OpenCms nyní publikuje všechen naimportovaný obsah. Tato operace může trvat poměrně dlouhou dobu. Občas se kvůli velkým datům může stát, že import a/nebo publish zkrachuje. Je proto vhodné:
* před importem udělat zálohu databáze OpenCms, aby bylo možno ji případně obnovit kdyby se importem rozbil VFS
* koukat se do logu OpenCms, co to dělá (@@tail -f WEB-INF/logs/opencms.log@@)
* před "Publish" zapnout ''Preferences > Show publish notification popup'' a po spuštění publikování počkat, až se objeví okénko, že bylo publikování skončeno

!!! Restartujte Tomcat

(Po importu archivy z adresáře @@packages@@ smažte, aby zbytečně nezabíraly místo.)

! C. Import obsahu

----

C. Import obsahu

Import archivu @@www.kiv.zcu.cz@@ může trvat delší dobu kvůli velkým souborům (data "produktů" autorizovaného software). Po naimportování stránek proveďte: @@Publish Projekt@@. OpenCms nyní publikuje všechen naimportovaný obsah. Tato operace může trvat poměrně dlouhou dobu. Občas se kvůli velkým datům může stát, že import a/nebo publish zkrachuje. Je proto vhodné si před importem udělat zálohu databáze OpenCms, aby bylo možno ji případně obnovit kdyby se importem rozbil VFS.

!!! Zastavte Tomcat

!!! Spusťte Tomcat

Nyní doplníme konfiguraci pro multisite. Nejdříve je potřeba přidat informace o těchto stránkách do souboru @@opencms-system.xml@@ na cestě @@<opencmsroot>/WEB-INF/config/@@. V tomto souboru najděte sekci, která vypadá následujícím způsobem:

(Viz též svn @@opencms-libs/configs/opencms-system.xml@@.)

Jako další musí být v produkčním prostředí nastaven Tomcat a Apache, tak aby tyto sites poskytovaly bez @@opencms/opencms/@@ prefixu. Podrobnější popis viz [[http://opencms-wiki.org/MultiSite_configuration_instructions]] .

''Vlastní import předpokládá, že jsou k dispozici jeden nebo více .zip archivů s obsahem webu. Ty musí vznikout exportem z (produkčního) OpenCms tak, že admin je v ''Site: www.kiv.zcu.cz'' kořenovém adresáři, přepne do Administration, udělá @@Administration - Database Management - Export Database@@ a vybere v ''Resources to export'' kořenový adresář. Je potřeba mít krom resources vyexportované také uživatele. (Přemek: Já jsem si udělal dva exporty - v jednom je jen /robots.txt soubor a všichni uživatelé, v druhém jsou všechny soubory a nejsou uživatelská data; to mi pomáhá když chci dělat pokusy s právy a nechci přitom mít pakárnu s čekáním na dlouhý import celého webu.)''

Přihlašte se do OpenCms a otevřte nebo se přepněte do okna @@Explorer@@. Přepněte se do ''Site: www.kiv.zcu.cz'' tak, abyste v poli @@Location@@ viděli: @@/@@. Toto je důležité z toho důvodu, že při importu obsahu (dtabáze) do OpenCms je ta naimportována tam, kde v okně @@Explorer@@ právě jste.

Zkopírujte archivy s daty do adresáře @@WEB-INF/packages/@@ v instalaci OpenCms. Otevřte administrační rozhraní: @@Administration - Database Management - Import File from Server@@ a vyberte soubor s daty. Tento postup opakujte pro stránky @@informatika.zcu.cz@@ a @@kiv.zcu.cz@@.

* Vzhledem ke změnám v Account Managementu mezi verzemi 6 a 7 je dobré zkontrolovat a případně opravit nastavení skupin a rolí uživatelů. Zejména by všichni z @@KIV Staff@@ měli mít roli ''Workplace user'' aby se vůbec mohli přihlásit.

Import archivu @@www.kiv.zcu.cz@@ může trvat delší dobu kvůli velkým souborům (data "produktů" autorizovaného software).

Soubory z svn adresáře @@opencms-libs/krb/@@

zkopírovat do adresáře @@conf@@ na rootu Tomcatu (adresář @@CATALINA_HOME@@, jsou tam třeba @@server.xml@@ a další). Cesta k těmto souborům musí být přidána do proměnné @@CATALINA_OPTS@@:

Pokud máte na jednom počítači nainstalováno více instancí Tomcatu a pro jejich start používáte volitelnou proměnnou @@%CATALINA_BASE%@@, změntě @@%CATALINA_HOME%@@ na @@%CATALINA_BASE%@@.

!!! Zastavte Tomcat

!! '''[+5.+] ''' Nainstalovat knihovny a konfigurace potřebné pro běh KIVáckých modulů

Z svn adresáře @@opencms-libs/lib/@@ zkopírovat všechny .jar soubory do @@WEB-INF/lib@@. Neměly by vzniknout duplicity, je ale třeba zkontrolovat - pokud by se vedle sebe vyskytly např. @@mail.jar@@ a @@mail-1.3.jar@@ pak není jisté, který bude načten a použit tomcatem; nevhodné .jary tedy buď smazat nebo přejmenovat (např. přípona @@.x@@) aby je tomcat nenačetl.

!!! Spusťte Tomcat

-> ''Následující sekvence kroků s několikerým restartem serveru je na tomto místě důležitá, aby Tomcat načetl třídy z našich modulů. Jinak by došlo k tomu, že v konfiguračním souboru Springu bude referencován třída, která ještě na OpenCms není. Tomcat by poté OpenCms vůbec nenastartoval a my bychom neměli žádnou možnost požadovaný modul do OpenCms doinstalovat - DEADLOCK!''

Pomocí administačního rozhranní @@Administration - Module Management - Import Module with HTTP@@ naimportujte modul Common v aktuální verzi (2.0.1.x).

!!! Zastavit Tomcat

Zazálohujte soubor @@WEB-INF/web.xml@@ a místo něj zkopírujte verzi z svn adresáře @@opencms-libs/@@. Dále pod @@WEB-INF@@ zkopírujte soubory @@redsys-servlet.xml@@ a @@webkiv.properties@@.

V souboru @@webkiv.properties@@ nastavte správně název databáze pro data KIV, login+heslo pro přístup, a emailové konto které bude použito pro odesílání zpráv z modulů.

-> Odbočka: Pokud se tento postup provádí nanečisto někde bokem (vývojářský server, beta.kiv.zcu.cz apod.) pak je v tuto chvíli zřejmě třeba vytvořit zde zmíněnou databázi pro data KIV a naimportovat do ní data. Viz svn adresář @@datovy-model/@@.

!!! Spustit tomcat

Nainstalovat další moduly, v tomto pořadí:

# login
# aktuality
# template
# (restart tomcatu, aby se načetly L10N properties)
# publikace
# predmety
# produkty
# osoby

Pro potřeby stránky informatiky jsou potřeba ještě následující moduly:

!! '''[+7.+] ''' Vytvoření konfigurace multisite

Přihlašte se k OpenCms a přepněte se do administračního rozhranní. V poli @@sites@@ zvolte @@/@@ a v levém panelu otevřte adresář @@sites@@. V tomto umístění založte a publikujte dva adresáře: @@informatika.zcu.cz@@ a @@www.kiv.zcu.cz@@. Tím jsme připravili OpenCms pro konfiguraci Multisite.

Nyní doplníme konfiguraci pro multisite. Tyto stránky by měly být pod cestou:
* @@/sites/informatika.zcu.cz/@@ pro Informatiku
* @@/sites/www.kiv.zcu.cz/@@ pro KIVáckou stránku

Nejdříve je potřeba přidat informace o těchto stránkách do souboru @@opencms-system.xml@@ na cestě @@<opencmsroot>/WEB-INF/config/@@. V tomto souboru najděte sekci, která vypadá následujícím způsobem:

<sites>
<workplace-server>http://www.mysite.com:8080</workplace-server>
<default-uri>/sites/default/</default-uri>
<site server="www.mysite.com" uri="/sites/default/"/>
</sites>
@]

Do elementu @@<sites>@@ přidejte následující text:

[@
<site server="TODO-Nastaveni-Apache" uri="/sites/informatika.zcu.cz/"/>
<site server="TODO-Nastaveni-Apache" uri="/sites/www.kiv.zcu.cz/"/>

Jako další musí být v produkčním prostředí nastaven Tomcat a Apache. Podrobnější popis viz link:[[http://opencms-wiki.org/MultiSite_configuration_instructions]] .

Pro samotný vývoj by výše uvedený popis měl stačit.

!!! Restartujte Tomcata

!! '''[+8.+] ''' Import obsahu ze staré verze OpenCms.

! A. Instalace systému

!! '''[+3.+] ''' Zkopírování opatchovaného @@opencms.jar@@

{-Do @@<opencmsroot>/WEB-INF/lib@@ adresáře se nakopíruje soubor @@kerberos-authentication.jar@@ z svn.-} Není třeba, příslušné třídy jsou integrovány do opatchovaného opencms.jar souboru.

Soubor @@WEB-INF/lib/opencms.jar@@ zazálohujte (například pod jménem @@opencms.jar.dist@@) a do adresáře nakopírujte @@opencms-7.5.2-patched.jar@@ z svn.

!! Spusťte Tomcat

Nyní byste se měli být schopni se přihlásit pomocí Vašeho Orion uživatelského jména a hesla. Předpoklad pro to je, že v OpenCms existuje uživatel s uživatelským jménem shodným jako je Váš Orion login.

Viz návod od p. Pavuka [[WebKiv/ZabezpecenePrihlaseni]], v kostce: v httpd proxy modulu nastavit aby všechna URL začínající @@/system/@@ a @@/site/login/@@ byla vždy přesměrována na HTTPS.

! B. Konfigurace pro moduly KIV

!! Zastavte Tomcat

'''Návod na upgrade webu KIV na OpenCms verze 7.5'''

TBD

Dále je potřeba zkontrolovat/nastavit, že [=MySQL=] má dost velký packet buffer: v my.ini nastavit

* [@max_allowed_packet = 64M@] (menší hodnoty nestačí při importu velkých souborů)

* [@set JAVA_OPTS=%%JAVA_OPTS%% -Xmx512M@] , resp.
* [@export CATALINA_OPTS="$CATALINA_OPTS -Xmx512m"@]

-> Při tomto nastavení je OpenCms schopné při úspěšně naimportovat resources o maximální velikosti kolem 60MB. Pokud jsou v datovém souboru exportovaném z předchozí instalace OpenCms ve VFS některé soubory větší (např. 120MB), je vhodné použít tento postup: soubory z archivu přesunout ven, odstranit ručně jejich záznamy z manifest.xml v kořenovém adresáři archivu, naimportovat archiv, a následně naimportovat tyto soubory jednotlivě (např. přes upload v průzkumníku workplace).

Import stránky @@kiv.zcu.cz@@ může trvat delší dobu.

Přihlašte se do OpenCms a otevřte nebo se přepněte do okna @@Explorer@@. Přepněte adresářovou strukturu tak, abyste v poli @@Location@@ viděli: @@/sites/@@. Toto je důležité z toho důvodu, že při importu obsahu (dtabáze) do OpenCms je ta naimportována tam, kde v okně @@Explorer@@ právě jste. Zkopírujte archivy s daty do adresáře @@WEB-INF/packages/@@ v instalaci OpenCms. Otevřte administrační rozhraní: @@Administration - Database Management - Import File from Server@@ a vyberte soubor s daty. Tento postup opakujte pro stránky @@informatika.zcu.cz@@ a @@kiv.zcu.cz@@.

OpenCms by mělo naimportovat data uložená v těchto souborech. Při importu se může stát, že do okna budou vypsány i nějaké chybové hlášky - hlavně při importu uživatelů. Tato chyba zřejmě souvisí s importem uživatelů, kteří mají práva ROOT. Tito uživatelé jsou však v pořádku naimportováni.

Po naimportování stránek proveďte: @@Publish Projekt@@. OpenCms nyní publikuje všechen naimportovaný obsah. Tato operace může trvat poměrně dlouhou dobu.

!! Spusťte Tomcata
Nyní byste se měli být schopni se přihlásit pomocí Vašeho Orion uživatelského jména a hesla. Předpoklad pro to je, že v OpenCms existuje uživatel s uživatelským jménem shodným jako je Váš Orion login.

Spuštění serveru je na tomto místě důležité, aby Tomcat přelozil třídy z našich modulů. Jinak by v příštím kroku došlo k tomu, že v konfiguračním souboru Springu bude referencován třída, která ještě na OpenCms není. Tomcat by poté OpenCms vůbec nenastartoval a my bychom neměli žádnou možnost požadovaný modul do OpenCms doinstalovat - DEADLOCK!

Do adresáře @@WEB-INF@@ zkopírujte soubory @@jdbc.properties@@, @@redsys-servlet.xml@@ a @@webkiv.properties@@. Projděte tyto soubory a eventuelně upravte nastavení, tak aby odpovídalo aktuální konfiguraci. Jedná se zde hlavně o jméno databáze, ve které budou uložena data KIVácké databáze - viz další bod.

Vytvořit databázi pro KIVácká data

Použít datový model, který odpovídá nasazovaným modulům.

Přihlašte se k OpenCms a přepněte se do administračního rozhranní. V poli @@sites@@ zvolte @@/@@ a v levém panelu otevřte adresář @@sites@@. V tomto umístění založte dva adresáře@@informatika.zcu.cz@@ a @@www.kiv.zcu.cz@@. Tím jsme připravili OpenCms pro konfiguraci Multisite.

Nyní doplníme konfiguraci pro multisite. Tyto stránky by měly být pod cestou:

Nejdříve je potřeba přidat informace o těchto stránkách do souboru @@opencms-system.xml@@ na cestě @@<opencmsroot>/WEB-INF/config/@@.

!! Restartujte Tomcata

!! '''[+11.+] ''' Ověření oproti původnímu stavu

!! '''[+7.+] ''' Nastavit soubory @@redsys-servlet.xml@@ a @@jdbc.properties@@

Do adresáře @WEB-INF@@@ zkopírujte soubory @@jdbc.properties@@, @@redsys-servlet.xml@@ a @@webkiv.properties@@. Projděte tyto soubory a eventuelně upravte nastavení, tak aby odpovídalo aktuální konfiguraci. Jedná se zde hlavně o jméno databáze, ve které budou uložena data KIVácké databáze - viz další bod.

!! '''[+8.+] ''' Nainstalovat dump databáze s KIVáckými daty

''' Použít datový model, který odpovídá nasazovaným modulům.'''

!! '''[+9.+] ''' Vytvoření konfigurace multisite

!! '''[+10.+] ''' Import obsahu ze staré verze OpenCms.

Protože import starého obsahu do OpenCms je poměrně pro Tomcat náročná operace, zkontrolujte, zda má nastaven dostatek paměti - zda je v souboru @@catalina.bat@@ respektive @@catalina.sh@@ (viz bod 5) nastavena JVM proměnná -Xmx a pokod ne, tak do tohoto souboru přidejte následující řádku:
* [@set JAVA_OPTS=%%JAVA_OPTS%% -Xmx512M@]

Přihlašte se do OpenCms a otevřte nebo se přepněte do okna @@Explorer@@. Přepněte adresářovou strukturu tak, abyste v poli @@Location@@ viděli: @@/sites/@@. Toto je důležité z toho důvodu, že při importu obsahu (dtabáze) do OpenCms je ta naimportována tam, kde v okně @@Explorer@@ právě jste. Otevřte administračbní rozhranní: @@Administration - Database Management Import - File with HTTP@@ a vyberte soubor s daty. Tento postup opakujte pro stránky @@informatika.zcu.cz@@ a @@kiv.zcu.cz@@.

OpenCms by mělo naimportovat data uložená v těchto souoborech. Při importu se může stát, že do okna budou vypsány i nějaké chybové hlášky - hlavně při importu uživatelů. Tato chyba zřejmě souvisí s importem uživatelů, kteří mají práva ROOT. Tyto uživatelé jsou však v pořádku naimportováni.

Import stránky @@kiv.zcu.cz@@ může trvat delší dobu.

Po naimportování stránek proveďte: @@Publisch Projekt@@. OpenCms nyní publikuje všechen naimportovaný obsah. Tato operace může trvat poměrně dlouhou dobu.


----

!! '''[+6.+] ''' Nainstalovat KIV moduly

||DatovyModel || XX
||ModulCommon || 0.14
||ModulOsoby || 0.17
||ModulPublikace || 0.1
||ModulVyuka || XX
||ModulTemata (dříve ModulStudium)|| 0.7
||ModulPredmety || 0.4
||ModulProdukty || 0.32
||ModulTemplate2008 || 0.3
||ModulAktuality || 0.12

Pro potřeby stránky informatiky jsou potřeba ještě následující moduly:
||! Modul ||! Verze
||Modul KIV || XX
||Modul staré šablony || XX

'''Moduly byly při testi brány z Tagů z SVN'''

!! Spusťe Tomcata
Spuštění serveru je na tomto místě důležité, aby Tomct přelozil třídy z našich modulů. Jinak by v příštím kroku došlo k tomu, že v konfiguračním souboru Springu bude referencován třída, která ještě na OpenCms není. Tomcat by poté OpenCms vůbec nenastartoval a my bychom neměli žádnou možnost požadovaný modul do OpenCms doinstalovat - DEADLOCK!

!! Zastavte Tomcat

Soubory z svn:

Na platformě windows se pro server Tomcat toto provede přidáním následujících řádků do souboru @@catalina.bat@@, pro platformu Linux se jedná o soubor @@catalina.sg@@, na cestě @@CATALINA_HOME\bin@@.

!! '''[+3.+] ''' Zkopírování souboru @@kerberos-authentication.jar@@ a opatchování @@opencms.jar@@.

Do @@<opencmsroot>/WEB-INF/lib@@ adresáře se nakopíruje soubor @@kerberos-authentication.jar@@ z svn.

!! '''[+4.+] ''' Zabezpečit workspace

viz návod od p. Pavuka [[WebKiv/ZabezpecenePrihlaseni]]

!! Zastavte Tomcata

!! '''[+5.+] ''' Stáhnout knihovny potřebné pro běh KIVáckého rozšíření OpenCms

!! Spusťte Tomcata

'''[+8.+] ''' Nainstalovat KIV moduly

Pomocí administačního rozhranní @@Administration - Module Management - Import Module with HTTP@@ naimportuje jednotlivé moduly.

'''Verze modulů a pořadí ve kterém mají být naimportovány'''

||border=1 cellspacing=0 width=30%
||! Modul ||! Verze
||DatovyModel || TODO neudáno
||ModulCommon || TODO neudáno
||ModulOsoby || TODO neudáno
||ModulPublikace || TODO neudáno
||ModulVyuka || TODO neudáno
||ModulTemata (dříve ModulStudium)|| TODO neudáno
||ModulPredmety || TODO neudáno
||ModulProdukty || TODO neudáno
||ModulTemplate2008 || TODO neudáno

'''TODO Link na moduly ke stažení'''
----

----

'''[+9.+] ''' Import obsahu ze staré verze OpenCms.

Protože import starého obsahu do OpenCms je poměrně pro Tomcat náročná operace, zkontrolujte, zda má nastaven dostatek paměti - zda je v souboru @@catalina.bat@@ respektive @@catalina.sh@@ (viz bod 5) nastavena JVM proměnná -Xmx a pokod ne, tak do tohoto souboru přidejte následující řádku:
* [@set JAVA_OPTS=%%JAVA_OPTS%% -Xmx512M@]

Přihlašte se do OpenCms a otevřte nebo se přepněte do okna @@Explorer@@. Přepněte adresářovou strukturu tak, abyste v poli @@Location@@ viděli: @@/sites/@@. Toto je důležité z toho důvodu, že při importu obsahu (dtabáze) do OpenCms je ta naimportována tam, kde v okně @@Explorer@@ právě jste. Otevřte administračbní rozhranní: @@Administration - Database Management Import - File with HTTP@@ a vyberte soubor s daty. Tento postup opakujte pro stránky @@informatika.zcu.cz@@ a @@kiv.zcu.cz@@.

OpenCms by mělo naimportovat data uložená v těchto souoborech. Při importu se může stát, že do okna budou vypsány i nějaké chybové hlášky - hlavně při importu uživatelů. Tato chyba zřejmě souvisí s importem uživatelů, kteří mají práva ROOT. Tyto uživatelé jsou však v pořádku naimportováni.

Import stránky @@kiv.zcu.cz@@ může trvat delší dobu.

Po naimportování stránek proveďte: @@Publisch Projekt@@. OpenCms nyní publikuje všechen naimportovaný obsah. Tato operace může trvat poměrně dlouhou dobu.

# [[Nainstalovat čité OpenCms 7.5.0 -> Instalace]]

!! '''[+1.+] ''' Nainstalovat čité OpenCms 7.5.0

!! '''[+2.+] ''' Konfigurační soubory pro protokol Kerberos

Na konec souboru @@web.xml@@ doplnit tento text:

[@
<!-- cesta ke Spring konfiguracnimu souboru -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>/WEB-INF/redsys-servlet.xml</param-value>
</context-param>

<!-- definice Spring listeneru -->
<listener>
<listener-class>
org.springframework.web.context.ContextLoaderListener
</listener-class>
</listener>
@]

* [@set JAVA_OPTS=%JAVA_OPTS% -Djava.security.auth.login.config=%CATALINA_HOME%\Kerberos_Configuration\KerbNastaveni.conf@]
* [@set JAVA_OPTS=%JAVA_OPTS% -Djava.security.krb5.conf=%CATALINA_HOME%\Kerberos_Configuration\krb5.conf@]

''' Link na soubory ke stažení a kam je v OpenCms zkopírovat respektivě, jak je uparvit.'''

''' Vytvořit databázi pro KIVácká data'''
''' Link na DDL KIVácké databáze a dump s daty'''

Protože import starého obsahu do OpenCms je poměrně pro Tomcat náročná operace, zkontrolujte, zda má nastaven dostatek paměti - zda je v souboru @@catalina.bat@@ respektive @@catalina.sh@@ (viz bod 5) nastavena JVM proměnná -Xmx a pokod ne, tak do tohoto souboru přidejte následující řádku:
* [@set JAVA_OPTS=%%JAVA_OPTS%% -Xmx512M@]

Přihlašte se do OpenCms a otevřte nebo se přepněte do okna @@Explorer@@. Přepněte adresářovou strukturu tak, abyste v poli @@Location@@ viděli: @@/sites/@@. Toto je důležité z toho důvodu, že při importu obsahu (dtabáze) do OpenCms je ta naimportována tam, kde v okně @@Explorer@@ právě jste. Otevřte administračbní rozhranní: @@Administration - Database Management Import - File with HTTP@@ a vyberte soubor s daty. Tento postup opakujte pro stránky @@informatika.zcu.cz@@ a @@kiv.zcu.cz@@.

OpenCms by mělo naimportovat data uložená v těchto souoborech. Při importu se může stát, že do okna budou vypsány i nějaké chybové hlášky - hlavně při importu uživatelů. Tato chyba zřejmě souvisí s importem uživatelů, kteří mají práva ROOT. Tyto uživatelé jsou však v pořádku naimportováni.

Import stránky @@kiv.zcu.cz@@ může trvat delší dobu.

Po naimportování stránek proveďte: @@Publisch Projekt@@. OpenCms nyní publikuje všechen naimportovaný obsah. Tato operace může trvat poměrně dlouhou dobu.

'''[+4.+] ''' Zabezpečit workspace

viz návod od p. Pavuka [[WebKiv/ZabezpecenePrihlaseni]] - TODO otestovat na OpenCms 7.5.0

''' Link na soubory ke stažení a kam je v OpenCms zkopírovat repsktive, jak je uparvit'''

''' vytvořit databázi pro KIVácká data'''

'''[+4.+] ''' Zabezpečit workspace - viz návod od p. Pavuka [[WebKiv/ZabezpecenePrihlaseni]] - TODO otestovat na OpenCms 7.5.0

'''Spring 2.5 '''

Stáhnout http://www.springsource.com/download/community?project=Spring%20Framework
Přinejmenším verze 2.5.6 při používání parametrized beanů pro natažení výsledků SQL dotazu, když je v DB tabulce null , vyhazuje chybu konverze (např. při cizích klíčích) ; verze 2.5.0 tento problém nevykazuje:
[[http://s3.amazonaws.com/dist.springframework.org/release/SPR/spring-framework-2.5-with-dependencies.zip]] k přímému stažení

Zkopírovat @@spring.jar@@ a všechny soubory z adresáře @@/modules@@ z archivu do @@<OPENCMS_DIR>/WEB-INF/lib/@@


'''Apache Commons Validator'''

[[http://commons.apache.org/downloads/download_validator.cgi]]

Soubor @@commons-validator-1.3.1.jar@@ zkopírovat do @@<OPENCMS_DIR>/WEB-INF/lib/@@ (viz výše)

'' Link na soubory ke stažení a kam je v OpenCms zkopírovat''

'''Link na DDL KIVácké databáze a dump s daty'''

Pomocí administačního rozhranní @@Administration - Module Management - Import Module with HTTP@@ naimportuje jednotlivé moduly.

'''Verze modulů a pořadí ve kterém mají být naimportovány'''

||border=1 cellspacing=0 width=30%
||! Modul ||! Verze
||DatovyModel || TODO neudáno
||ModulCommon || TODO neudáno
||ModulOsoby || TODO neudáno
||ModulPublikace || TODO neudáno
||ModulVyuka || TODO neudáno
||ModulTemata (dříve ModulStudium)|| TODO neudáno
||ModulPredmety || TODO neudáno
||ModulProdukty || TODO neudáno
||ModulTemplate2008 || TODO neudáno

'''TODO Link na moduly ke stažení'''

Protože import starého obsahu do OpenCms je poměrně pro Tomcat náročná operace, zkontrolujte, zda má nastaven dostatek paměti - zda je v souboru @@catalina.bat@@ respektive @@catalina.sh@@ (viz bod 5) nastavena JVM proměnná -Xmx a pokd ne, tak do tohoto souboru přidejte následující řádku:
* @@set JAVA_OPTS=%JAVA_OPTS% -Xmx512M@@

Konfigurace multisite předpokládá, že jste naimportovali obsah stránek KIVu @@www.kiv.zcu.cz@@ a INFORMATIKY @@informatika.zcu.cz@@ do OpenCms. Tyto stránky by poté měly být pod cestou:
* @@/sites/informatika.zcu.cz/@@ pro Informatiku
* @@/sites/www.kiv.zcu.cz/@@ pro KIVáckou stránku

V dalším kroku je potřeba přidat informace o těchto stránkách do souboru @@opencms-system.xml@@ na cestě @@<opencmsroot>/WEB-INF/config/@@.
V tomto souboru najděte sekci, která vypadá následujícím způsobem:

[@
<sites>
<workplace-server>http://www.mysite.com:8080</workplace-server>
<default-uri>/sites/default/</default-uri>
<site server="www.mysite.com" uri="/sites/default/"/>
</sites>
@]

A do elementu @@<sites>@@ přidejte následující text:

[@
<site server="TODO-Nastaveni-Apache" uri="/sites/informatika.zcu.cz/"/>
<site server="TODO-Nastaveni-Apache" uri="/sites/www.kiv.zcu.cz/"/>
@]

Jako další musí být v produkčním prostředí nastaven Tomcat a Apache. Podrobnější popis viz link:[[http://opencms-wiki.org/MultiSite_configuration_instructions]]

Pro samotný vývoj by výše uvedený popis měl stačit.

----

----

----

----

----
'''[+5.+] ''' Stáhnout knihovny potřebné pro běh KIVáckého rozšíření OpenCms

----
'''[+6.+] ''' Nastavit soubory @@redsys-servlet.xml@@ a @@jdbc.properties@@

----
'''[+7.+] ''' Nainstalovat dump databáze s KIVáckými daty

----
'''[+8.+] ''' Nainstalovat KIV moduly

----
'''[+9.+] ''' Import obsahu ze staré verze OpenCms.

----
'''[+10.+] ''' Vytvoření konfigurace multisite


----
'''[+11.+] ''' Ověření oproti původnímu stavu

Zastavte Tomcat

Na platformě windows se toto provede přidáním následujících řádků do souboru @@catalina.bat@@, pro platformu Linux se jedná o soubor @@catalina.sg@@, na cestě @@CATALINA_HOME\bin@@.
* @@set JAVA_OPTS=%JAVA_OPTS% -Djava.security.auth.login.config=%CATALINA_HOME%\Kerberos_Configuration\KerbNastaveni.conf@@
* @@set JAVA_OPTS=%JAVA_OPTS% -Djava.security.krb5.conf=%CATALINA_HOME%\Kerberos_Configuration\krb5.conf@@

Pokud máte na jednom počítacači nainstalováno více instancí Tomcatu a pro jejich start používáte volitelnou proměnnou @@%CATALINA_BASE%@@, změntě @@%CATALINA_HOME%@@ na @@%CATALINA_BASE%@@.

Do @@<opencmsroot>/WEB-INF/lib@@ adresáře se nakopíruje soubor @@kerberos-authentication.jar@@ ke stažení viz svn TODO.

Soubor @@opencms.jar@@ zazálohujte (například pod jménem @@opencms.jar.bak@@) a do originálního souboru @@opencms.jar@@ zkopírujte (například popmocí programu 7zip) adresář @@org@@ z svn.

Nyní spusťte Tomcat a měli byste být schopni se přihlásit pomocí Vašeho Orion uživatelského jména a hesla. Předpoklad pro to je, že v OpenCms existuje uživatel s uživatelským jménem shodným jako je Váš Orion login.


'''[+4.+] ''' Zabezpečit workspace - viz návod od p. Pavuka (TODO otestovat na OpenCms 7.5.0)

'''[+5.+] ''' Stáhnout knihovny potřebné pro běh KIVáckého rozšíření OpenCms

Postup upgrade systémem "přenos do čistého OpenCms" je následující:
# Nainstalovat čité OpenCms 7.5.0
# Zkopírovat konfigurační soubory pro autentizaci protokolem Kerberos a nastavit Tomcat tak, aby tyto soubory uměl najít.
# Zkopírovat jar soubor @@kerberos-authentication.jar@@ s třídami potřebnými pro autentizaci Kerberem a opatchovat soubor @@opencms.jar@@.
# Zabezpečit workspace - viz návod od p. Pavuka (otestovat na OpenCms 7.5.0)
# Stáhnout knihovny potřebné pro běh KIVáckého rozšíření OpenCms
# Nastavit soubory @@redsys-servlet.xml@@ a @@jdbc.properties@@
# Nainstalovat dump databáze s KIVáckými daty
# Nainstalovat KIV moduly
# Import obsahu ze staré verze OpenCms - při této činnosti je potřeba dávat pozor na umístění, ze kterého je starý obsah do OpenCms importován.
# Oprava resp vytvoření konfigurace multisite
# Ověření oproti původnímu stavu

Pokud by se dělalo "side-by-side" se stávajícím webem, pak je potřeba ještě poté překlopit konfiguraci apache httpd a proxy.

----

'''[+1.+] ''' Nainstalovat čité OpenCms 7.5.0

V tomto kroku se provede standardní instalace OpenCms. Je zde potřeba dát pozor na to, že v jedné instanci Tomcatu nemohou běžet dvě aplikace se stejným jménem. To je omezující faktor, pokud bude provozováno více verzí OpenCms současně. Vhodným řešením tohoto problému je přejmenovat soubor @@opencms.jar@@ na @@opencms750.jar@@ a tento soubor poté nasadit na Tomcata. Tím se umožní provozování dvou verzí OpenCms současně. Jediný rozdíl je v tom, že nová verze poběží na url @@../opencms750/..@@.

'''[+2.+] ''' Konfigurační soubory pro protokol Kerberos

Soubory (ke stažení v svn pod cestou : TODO):
* @@KerbNastaveni.conf@@
* @@krb5.conf@@

Zkopírovat do nově vytvořeného adresář adresáře @@Kerberos_Configuration@@ na rootu Tomcatu (adresář @@CATALINA_HOME@@).
Cesta k těmto souborům musí být přidána do proměnné @@CATALINA_OPTS@@:
* @@-Djava.security.auth.login.config=CESTA_K_SOUBORU_KerbNastaveni.conf@@
* @@-Djava.security.krb5.conf=CESTA_K_SOUBORU_krb5.conf@@

'''[+3.+] ''' Zkopírování souboru @@kerberos-authentication.jar@@ a opatchování @@opencms.jar@@.

Do @@<opencmsroot>/WEB-INF/lib@@ adresáře se nakopíruje soubor @@kerberos-authentication.jar@@ ke stažení viz svn.

TODO - patchovat opencms.jar

# ověření oproti původnímu stavu

Pokud by se dělalo "side-by-side" se stávajícím webem, pak je potřeba ještě poté překlopit konfiguraci apache httpd a proxy.

Postup upgrade systémem "přenos do čistého OpenCms" bude zřejmě následující:
# instalace 7.5
# aplikace Kerberos patch na 7.5
# instalace modulu pro přihlašování s Krb patch
# import tabulek databáze KIV
# instalace modulů KIV
# import obsahu (vezme s sebou users + práva) pro jednotlivé sajty
# oprava resp vytvoření konfigurace multisite
# ověření oproti původnímu stavu

* případné pozn místně důležité

Potřebujeme v rámci upgrade umět
* Kerberos patch
* modul pro přihlašování s Krb patch
* moduly KIV
* obsah + users + práva
* multisite

TBD J.Boháč
* odkazy na manuály
* případné pozn místně důležité