Hlavní menu
Nástroje |
InstalaceObecně, je celkem jednoduchá a bezproblémová. Je však možné, že se při instalaci objeví problémy. Většinou jde o problémy spojené s nastavením aplikací na kterých je OpenCMS závislý. Shrnutí systémových požadavků: ostrý web běží na
Pro předcházení komplikacím při vyhrnování na server se doporučuje vyvíjet na stejných verzích. Instalace Apache TomcatV podstatě jsou dva způsoby instalace Tomcata: buď se stáhne standalone balík a vše je pak v jednom adresáři, nebo se použije instalátor pro daný operační systém (pro Windows *.exe installer, pro Debian/Ubuntu např. balíček tomcat5.5) a Tomcat pak běží jako service. Při instalaci na distribuci Gentoo se může vám může stát že některé balíčky na kterých je Tomcat závislý se nechtějí emergnout. Vypozorovaným důvodem bude nastavení preferované verze Javy pro kompilaci. Nastavení jiné verze lze vynutit pomocí proměnné prostředí JAVA_PKG_FORCE_VM='verze_javy'. Osobně jsem používal icedtea6-bin. Gentoo defaultně nainstaluje Tomcat ve verzi 6, což není doporučovaná verze pro naší instalaci. Je tedy potřeba vynutit instalaci slotu verze 5.5. Pro jistotu ještě uvedu USE flagy, které je dobré nastavit: admin java5. Výsledný příkaz pro instalaci Tomcatu na Gentoo by tedy mohl vypadat:
Uvedený příkaz samozřejmě předpokládá nainstalovaný icedtea6. Osobně velmi nedoporučuji používat testing verze pro cokoliv spojeného s Javou na Gentoo. Po instalaci je ještě potřeba dodat následující řádky do souboru /etc/tomcat-5.5/tomcat-users.xml: <role rolename="manager"/> <role rolename="admin"/> <user username="root" password="moje_tajne_heslo" roles="admin,manager"/> Bez nich byste se nemohli přihlásit do administrace. Spuštěný Tomcat by měl na stránce http://localhost:8080/ vypsat uvítací obrazovku. Pro správu Tomcatu (deploy aplikací, přenastavení, apod.) doporučuji Google; výchozí instalace by měla pro potřeby vývoje vyhovovat. Instalace MySQLU MySQL je taktéž doporučeno použít balíček (Debian/Ubuntu) nebo stáhnout instalátor. Při instalaci se průvodce zeptá na heslo roota k databázi. To je dobré nezapomenout pro další údržbu databáze. Pokud někdo nehoví konzoli pro práci s databází, pak je dobrým GUI programem MySQL Administrator. Pro provozování OpenCms je dobré vytvořit samostatného uživatele a vytvořit mu vlastní databázi s patřičnými právy. Tedy např. vytvořit uživatele Instalace OpenCmsStažení OpenCms 7.0.3Na adrese http://www.opencms.org/downloads/opencms/opencms_7.0.3.zip stáhnout zip a rozbalit. Soubor Instalace OpenCmsNahodit Tomcata a spustit instalátor na http://localhost:8080/opencms/setup/ . Projít průvodcem instalace. Při zadávání konexe do databáze použít výše vytvořeného uživatele Při výběru modulů OpenCms nainstalujte pouze ty, které mají v názvu:
Ostatní do naší instalace nepotřebujeme. Po instalaci OpenCms je dobré restartovat Tomcat. Otestování instalace: http://localhost:8080/opencms/opencms/system/login a přihlásit se s defaultním Konfigurace OpenCms podle ostrého webuJe třeba upravit <staticexport enabled="true"> na <staticexport enabled="false"> Následující změna není nutná, spíše experimentální (tzn. je riziko, že se něco rozhodí). <vfs-prefix>${CONTEXT_NAME}${SERVLET_NAME}</vfs-prefix> změnit na <vfs-prefix>${CONTEXT_NAME}</vfs-prefix> Instalace WebFav moduluPřidání potřebných elementů do xml configurace OpenCms
$svn export https://students.kiv.zcu.cz/svn-fav/misc/copy-elements.sh
$./copy-elements.sh TOMCAT_HOME/webapps/opencms/WEB-INF/config/opencms-workplace.xml Skripty jsou psány pro Linux. Pokud instalujete pod Windows, pak je třeba ručně upravit soubor
následující elementy: <explorertype name="fav-folders" key="fileicon.fav-folders" icon="fav-folder.gif" reference="folder"> <newresource uri="newresource.jsp?page=fav-folders" order="1" autosetnavigation="false" autosettitle="false"/> </explorertype> <explorertype name="fav-files" key="fileicon.fav-files" icon="fav-file.gif" reference="xmlcontent"> <newresource uri="newresource.jsp?page=fav-files" order="2" autosetnavigation="false" autosettitle="false"/> </explorertype> Příprava webfav modulu pro import do OpenCmsNásledující postup předpokládá nainstalovaného řádkového SVN klienta. Je možno použít i ekvivalentní GUI nástroje (např. TortoiseSVN pod Windows)- Checkout modulu ze SVN$svn co https://students.kiv.zcu.cz/svn-fav/cz.zcu.fav-module/trunk/ Aktualizace verze v manifest.xmlOpenCms si verzuje sám moduly; verzování webfav modulu je synchronizované s verzováním v SVN, čili aktuální číslo verze modulu v OpenCms odpovídá revizi modulu z repozitory. Proto je třeba před buildem modulu aktualizova příslušnou část souboru $cd cz.zcu.fav-module/trunk/ $ant update-manifest-version Vytvoření balíku modulu (a odstranění změn)$ant dist $svn revert ./ -R Import webfav modulu do OpenCmsZkopírovat zip vytvořený v minulém kroku do WEB-INF Tomcata $cp build/dist/cz.zcu.fav_1.xx.zip TOMCAT_HOME/webapps/opencms/WEB-INF/packages/modules Importovat modul přes web rozhraní OpenCMS Administration -> Module management -> Import module from server -> cz.zcu.fav_xxx.zip Import obsahu webfavPro import obsahu webu FAV je třeba získat zip soubor s obsahem vyexportovaný z ostrého webu. Tento soubor je třeba nakopírovat do Tomcata: $cp soubor-s-obsahem.zip TOMCAT_HOME/webapps/opencms/WEB-INF/packages Samotný import obsahu se provede ve Workplace OpenCms. Musí být přepnuto v Administration - Database management - Import File from server - soubor-s-obsahem.zip -> Import Přepnout z Administration do Explorer, dát Nastavení po importu
Touchnout a publikovat handlery 404 a 500 v FCKConfig.IncludeLatinEntities = false; a změnit toolbar.append(",'-','SpecialChar','UniversalKey'"); na toolbar.append(",'-','SpecialChar'");
Co zůstalo z minulé verze návodu (aneb "needs review")
>Poznámka: je dobré mít nainstalovaný nějaký operační systém, správce souborů, editory, Jestli ste počas instalace narazili na problém?, tak začněte hledat na fóru oficiálních stránek OpenCMS, nebo Wiki pro OpenCMS, anebo něco málo poradíme? i my. Pokračovat můžete naimportování modulu pro web fav. Doporučení k instalacímUPDATE: Pro OpenCms 7.0.3 zřejmě není třeba, kódování funguje spolehlivě. OpenCMS nativně používa kódování V případě, že už máte instalaci za sebou a tohle ste opoměli, tak do startovacích parametrů Tomceta uveďte Instalace Absolventů
|