Tento krok je nutný pro funkčnost DAO vrstvy KIV modulů; nejprve je třeba nainstalovat modul common do čistého OpenCms, pak teprv je možno upravit redsys-servlet.xml jak uvedeno dále.

Modul Common a další jsou v SVN včetně funkčního buildu.

url.osobyPagesUrl=http://localhost:8080/opencms/opencms/system/modules/cz.zcu.kiv.osoby/pages/osoby
url.publikacePagesUrl=http://localhost:8080/opencms/opencms/system/modules/cz.zcu.kiv.publikace/pages

Pro možnost prolinkování modulů je potřeba od revize 240 přidat do redsys-servlet.xml

[@
<bean id="appProperties" class="cz.zcu.kiv.appProperties.AppPropertiesBean">
<property name="urlPrefix" value="${url.prefix}"/>
<property name="urlOsobyPages" value="${url.osobyPagesUrl}"/>
<property name="urlPublikacePages" value="${url.publikacePagesUrl}"/>
</bean>
@]

a do webkiv.properties (nebo do jdbc.properties) přidat

[@
url.prefix=/opencms/opencms
url.osobyPagesUrl=http://localhost:8080/opencms/opencms/system/modules/cz.zcu.kiv.osoby/pages/osoby/
url.publikacePagesUrl=http://localhost:8080/opencms/opencms/system/modules/cz.zcu.kiv.publikace/pages/
@]

pro správné odkazování pak ještě patřičně upravit tyto url dle vaší konfigurace.

* WebKiv/RedSys - především WebKiv/PouzivaneTechnologie a WebKiv/PravidlaProVyvojare

!! Prostředí (platformy, servery, knihovny)

!!! Java 6 JDK

!!! Servlet container - Apache Tomcat 6 nebo 5.5 ...

!!! ... nebo Jetty 6.1.14 (jen pro OpenCMS 7)

!!! MySQL 5

!!! OpenCMS 6.2.3

!!! OpenCMS 7.0.5 na Jetty 6.1.14

!!! Spring 2.5

!!! Apache Commons Validator

!!! Databáze WWW KIV

!! Instalace KIV Common modulu do OpenCMS

modul Common a další jsou v SVN

** http://s3.amazonaws.com/dist.springframework.org/release/SPR/spring-framework-2.5-with-dependencies.zip k přímému stažení

v ubuntu je třeba nastavit v /etc/mysql/my.cnf proměnnou lower_case_table_names=1 (více na [[http://dev.mysql.com/doc/refman/5.0/en/identifier-case-sensitivity.html]])

!!! Apache Tomcat 6 nebo 5.5

!! Servlet container

!!! Apache Tomcat 5.5

!!! nebo Jetty 6.1.14 (jen pro OpenCMS 7)

!! OpenCMS 7.0.5 na Jetty 6.1.14

Instalace pod Windows / Linux, adresář kam byla Jetty rozbalena je JETTY_HOME:

instalace pod Windows / Linux, adresář kam byla Jetty rozbalena je JETTY_HOME:

*spustťe Jetty (z adresáře JETTY_HOME příkazem: java -jar start.jar etc\jetty.xml).POZOR při spouštění dojde k chybě:

javax.servlet.ServletException:
Critical error during OpenCms inialization:
The OpenCms setup wizard is still enabled.

*otevřte prohlížeč na stranu http://localhost:8080/opencms/setup/ a standardním způsobem nechte projít instalaci. Zde je jen nutné zaškrntout volbu, že OpenCms chcete nainstalovat na Jetty.

javax.servlet.ServletException:
Critical error during OpenCms initialization:
The OpenCms setup wizard is still enabled.

!! OpenCMS 7.0.5 a Jetty 6.1.14

*v adresáři JETTY_HOME/webapp vytvořte adresář opencms

*do tohoto adresáře opecms nakopírujte soubor opencms.war

*tento soubor rozbalte příkazem: jar xvf opencms.war

*nyní můžete soubor opencms.war smazat

*spustťe Jetty, POZOR při spouštění dojde k chybě:

*nyní je možné tuto chybu ignorovat

*otevřte prohlížeč na stranu http://localhost:8080/opencms/setup/ a starndardním způsobem nechte projít instalaci. Zde je jen nutné zaškrntout volbu, že OpenCms chcete nainstalovat na Jetty.

*po ukončení instalace se při pokusu o přihlášení do OpenCms opět objeví chyba:
[@
javax.servlet.ServletException: Critical error during OpenCms initialization: The OpenCms setup wizard is still enabled.
@]

*nyní je potřeba Jetty restartovat. Pokud by problém pokračoval i po restarování, je zapotřebí zkontolovat v souboru JETTY_HOME\webapps\opencms\WEB-INF\config\opencms.properties hodnotu proměnné wizard.enabled, ta by měla být nastavená na false.

*tím by měla být instalace hotova

!! Apache Tomcat 5.5

!! Jetty 6.1.14

http://www.mortbay.org/jetty/

!! OpenCMS 6.2.3 a Jetty 6.1.14
instalace pod Windows / Linux:
*v adresari JETTY_HOME/webapp vytvorte adresar opencms

*do adresare /opecms nakopirujte soubor opencms.war

*tento soubor rozbalte prikazem jar xvf opencms.war

*nyni muzete soubor opencms.war smazat

*spustte Jetty, POZOR pri spousteni dojde k chybe:
[@
javax.servlet.ServletException: Critical error during OpenCms initialization: The OpenCms setup wizard is still enabled.
@]

!! Nejdřívě čtěte

!! Java 6 JDK

!! Apache Tomcat 5.5 _nebo_ Jetty 6.x

TBD J.Boháč dopsat ruční instalaci do windows a ubuntu

!! MySQL 5

!! OpenCMS 6.2.3

TBD J.Boháč přidat sekci pro OpenCMS 7

!! Spring 2.5

!! Apache Commons Validator

!! Databáze WWW KIV

!! Konfigurace OpenCMS

TBD J.Boháč přidat sekci pro OpenCMS 7

!! Instalace commons modulu do OpenCMS

!! Nastavení IDE pro kompilaci

* knihovny potřebné pro překlad jsou v <OPENCMS_DIR>/WEB-INF/lib/ a v adresáři tomcatu (na ubuntu 8.04 /usr/share/tomcat5.5/common/lib/)

ubuntu 8.04 - balíky sun-java6-jre

windows - kompletní stack mysql + php (pro phpmyadmin) + apache ("klasický") - http://www.wampserver.com/en/

*View: Administration -> Module Management -> Import module with HTTP

_pomocí např. phpMyAdmin_

_soubory .sql se k vám dostanou od vedoucího týmu, vyučujícího,..._

*restartovat Tomcat (sudo /etc/init.d/tomcat5.5 restart )

!Nejdřívě čtěte
* [WebKiv/RedSys] - především [WebKiv/PouzivaneTechnologie] a [WebKiv/PravidlaProVyvojare]

_návod vychází z http://linuxfellaz.net/doku.php?id=debian:opencms_

oficální dokumentace k instalaci http://www.opencms.org/en/development/installation/ a také v zipu opencms

*upravit /etc/default/tomcat5.5 - "#TOMCAT5_SECURITY=yes" odkomentovat a nastavit TOMCAT5_SECURITY=no

*import beta_kiv_zcu_cz.sql ( skript by s k vám měl dostat od vedoucího týmu, vyučujícího,...)
*pokud dává chyby na constrainech - "SET AUTOCOMMIT=0;SET FOREIGN_KEY_CHECKS=0;" toto vypne, je třeba na konci opět analogicky zapnout

_redsys-servlet.xml a jdbc.properties se k vám dostanou od vedoucího týmu, vyučujícího,..._

**redsys-servlet.xml

*více o servlet 2.3 vs. serverl 2.4 na [[http://www.opencms-wiki.org/Changing_from_Servlet_2.3_to_Servlet_2.4_%28JSP_2.0%29 | http://www.opencms-wiki.org/Changing_from_Servlet_2.3_to_Servlet_2.4_(JSP_2.0)]]

modul commons a další jsou v SVN

_pro tomcat na localhost:8180_

* dále je třeba upravit <OPENCMS-DIR>/WEB-INF/opencms.tld a ke každému @@attribute@@ přidat/nastavit @@<rtexprvalue>true</rtexprvalue>@@

ostatní moduly se přidávají také takto

!Nastavení IDE pro kompilaci
* knihovny potřebné pro překlad jsou v <OPENCMS_DIR>/WEB-INF/lib/ a v adresáři tomcatu (na ubuntu 8.04 /usr/share/tomcat5.5/common/lib/)

*vytvořím databázi kiv_zcu_cz (porovnávání utf8_czech_ci nebo utf8_bin)

* vytvořit adresář /usr/share/tomcat5.5-webapps/opencms.war/
* rozbalit obsah souboru opencms.war do tohoto adresáře
* sudo chmod -R 777 /usr/share/tomcat5.5-webapps/opencms.war/
* vytvořit soubor /usr/share/tomcat5.5/conf/Catalina/localhost/opencms.xml s obsahem

*upravit /etc/default/tomcat5.5/ - "#TOMCAT5_SECURITY=yes" odkomentovat a nastavit TOMCAT5_SECURITY=no

* sudo chmod -R 666 /usr/share/tomcat5.5-webapps/opencms.war/
*spustit v prohlížeči http://localhost:8180/opencms/setup/ a pokračovat setup wizardem

*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

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

*restartovat Tomcat

*http://commons.apache.org/downloads/download_validator.cgi
*commons-validator-1.3.1.jar do <OPENCMS_DIR>/WEB-INF/lib/ (viz výše)

*vytvořím databázi kiv_zcu_cz (porovnávání utf8_*)
*import beta_kiv_zcu_cz.sql
*dává chyby na constrainech - "SET AUTOCOMMIT=0;SET FOREIGN_KEY_CHECKS=0;" toto vypne, je třeba na konci opět zapnout

*do <OPENCMS_DIR>/WEB-INF/
**redsys-servlet.xml
**jdbc.properties - parametry pripojeni k databazi

*do <OPENCMS_DIR>/WEB-INF/web.xml pridam :

*změnit nastavení pro přístup k databázi KIV v jdbc.properties

*následujícím

*pozor!! - deklarace std. tag libraries je potom potřeba psát namísto

*takto

*a je třeba také do <OPENCMS_DIR>/WEB-INF/lib/ nahrát z http://jakarta.apache.org/site/downloads/downloads_taglibs-standard.cgi jstl.jar a standard.jar

*http://localhost:8180/opencms/opencms/index.jsp login
*View: Administration
*Import module with HTTP

TODO - přidat všechny potřebné soubory (jdb.properties, redsys.xml, downloady?, sql skripty, sql dumpy)

!Java 6 JDK
http://java.sun.com/javase/downloads/index.jsp

ubuntu 8.04 - balíky sun-java6-*

!Apache Tomcat 5.5
http://tomcat.apache.org/download-55.cgi

ubuntu 8.04 - balíky tomcat5.5, tomcat-5.5-admin, tomcat5.5-webapps

!MySQL 4
kompletní stack mysql + php (pro phpmyadmin) + apache ("klasický") - http://www.wampserver.com/en/

ubuntu 8.04 - balíky puze pro MySQL 5 ( mysql-sever, mysql-client, mysql-common), ale pro vývoj by sice měla fungovat (a do budoucna se plánuje přechod na MySQL 5, takže snad potom nebude problém) + balík phpmyadmin (měl by závistet na nějakém apache a php (vč. balíku php5-mysql))

!OpenCMS 6.2.3
http://www.opencms.org/downloads/opencms/opencms_6.2.3.zip

instalace pod ubuntu 8.04
- vytvořit adresář /usr/share/tomcat5.5-webapps/opencms.war/
- rozbalit obsah souboru opencms.war do tohoto adresáře
- $ sudo chmod -R 777 /usr/share/tomcat5.5-webapps/opencms.war/
- vytvořit soubor /usr/share/tomcat5.5/conf/Catalina/localhost/opencms.xml s obsahem

[@
<Context path="/opencms" docBase="/usr/share/tomcat5.5-webapps/opencms.war"
debug="0" privileged="true" allowLinking="true">
</Context>
@]

- upravit /etc/default/tomcat5.5/ - "#TOMCAT5_SECURITY=yes" odkomentovat a nastavit TOMCAT5_SECURITY=no

- $ sudo chmod -R 666 /usr/share/tomcat5.5-webapps/opencms.war/
- spustit v prohlížeči http://localhost:8180/opencms/setup/ a pokračovat setup wizardem

!Spring 2.5
- stáhnout http://www.springsource.com/download/community?project=Spring%20Framework
- zkopírovat spring.jar a všechny soubory z adresáře /modules v archivu z archivu do <OPENCMS_DIR>/WEB-INF/lib/
(ubuntu 8.04 /ush/share/tomcat5.5-webapps/opencms.war/WEB-INF/lib/)
- restartovat Tomcat
(ubuntu 8.04 sudo /etc/init.d/tomcat5.5 restart)

!Apache Commons Validator
- http://commons.apache.org/downloads/download_validator.cgi
- commons-validator-1.3.1.jar do <OPENCMS_DIR>/WEB-INF/lib/ (viz výše)

!Databáze WWW KIV
pomocí např. phpMyAdmin
- vytvořím databázi kiv_zcu_cz
- import beta_kiv_zcu_cz.sql
- dává chyby na constrainech - "SET AUTOCOMMIT=0;SET FOREIGN_KEY_CHECKS=0;" toto vypne, je třeba na konci opět zapnout


!Konfigurace OpenCMS


- do <OPENCMS_DIR>/WEB-INF/
- redsys-servlet.xml
- jdbc.properties - parametry pripojeni k databazi

- do <OPENCMS_DIR>/WEB-INF/web.xml pridam :
[@
<!--
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>
@]

- změnit nastavení pro přístup k databázi KIV v jdbc.properties



Pokud JSP budou využívat EL, je třeba změnit v <OPENCMS_DIR>/WEB-INF/web.xml deklaraci z servletu 2.3 na 2.4, tj. nahradit

[@
<!DOCTYPE web-app

PUBLIC "-//Sun Microsystems, Inc.//DTD Web Application 2.3//EN"

"http://java.sun.com/dtd/web-app_2_3.dtd">

<web-app>
@]

následujícím

[@
<web-app xmlns="http://java.sun.com/xml/ns/j2ee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee web-app_2_4.xsd"
version="2.4">
@]

pozor!! - deklarace std. tag libraries je potom potřeba psát namísto

[@
<%@ taglib prefix="c" uri="http://java.sun.com/jstl/core" %>
@]


takto

[@
<%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %>
@]

a je třeba také do <OPENCMS_DIR>/WEB-INF/lib/ nahrát z http://jakarta.apache.org/site/downloads/downloads_taglibs-standard.cgi jstl.jar a standard.jar


!Instalace commons modulu do OpenCMS
- http://localhost:8180/opencms/opencms/index.jsp login
- View: Administration
- Import module with HTTP