Co je potřeba k provozu?
Zprovoznění programu Alexis je velmi snadné. Potřebujete pouze počítač nebo server a v něm následující programy:
- databáze MySQL
- webový server Apache2
- middleware PHP 5.6 s extenzemi: ctype curl dom filter gd gettext hash iconv json ldap mbstring mysql mysqli opcache openssl pdo pdo_mysql phar posix session simplexml soap tokenizer xml xmlreader xmlwriter zip zlib
Postup instalace
Dle následujících kroků zprovozníte svou vlastní instalaci nástroje pro tvorbu slovníku. Před vlastní instalací je třeba si nejprve stáhnout instalační balík Alexis.
Vytvoření databáze
V databázovém serveru MySQL (ekvivalentně v MariaDB) založme databázi v kódování utf-8 typu innoDB. Databázi pojmenujme například mujslovnik.
create database mujslovnik character set utf8 engine=innodb;
Nyní připravme DB uživatele, např. následovně (předpokládejme, že DB server běží na stejném stroji jako web server; jinak je třeba patřičně upravit příkaz grant). Povolujeme výhradně nezbytná práva select, insert, update, delete.
grant select,insert,update,delete on mujslovnik.* to 'slovnikdbu'@'localhost' identified by 'hesloprodb';
Nezapomeneme na
flush privileges;
Import struktur dat a iniciální plnění DB před prvním spuštěním aplikace
Nejprve si připravme spojení konzole a vyberme svou databázi
set names utf8;
set character set utf8;
use mujslovnik;
Spojení máme připraveno, databáze je vybrána, lze začít importovat
\. struct.sql
\. init.sql.sql
Kód aplikace Alexis
Je třeba rozbalit archiv s aplikací včetně podadresářů a nainstalovat na server do webrootu připraveného v sekci VirtualHost konfigurace webového serveru (viz apache doc).
Další nastavení serveru
- nainstalovat na server program WKHTMLTOPDF
- povolit práva zápisu na adresáři cache pro uživatele, pod kterým běží webový server (typicky www nebo apache)
chown -R www:www cache/
- povolit práva zápisu na soubor „_Text_navodu_pokrocileho_vyhledavani.txt“ pro uživatele, pod kterým běží webový server (typicky www nebo apache)
chown www:www _Text_navodu_pokrocileho_vyhledavani.txt
- přidat custom collations pro DB server
najít soubor .../share/charsets/Index.xml v tomto souboru najít sekci <charset name="utf8">
do tohoto charsetu přidat dvě nové kolace ze souboru „add_utf8_collations.xml“ z instalačního balíku
ověřit, že id (atribut kolace) nově přidaných kolací nekoliduje s existujícími. Pokud ano, je potřeba je změnit tak, aby nekolidovaly.
- po uložení Index.xml restartovat db server
- zkontrolovat nastavení globalni mysql proměnné @@sql_mode. Doporučené nastavení:
@@sql_mode = STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION
proměnná nesmí obsahovat hodnotu 'ONLY_FULL_GROUP_BY'
- zkontrolovat a případně povolit pro virtual host nainstalované aplikace short_open_tags
php_flag short_open_tag On
Nastavení hodnot hlavní konfigurace aplikace
Nakonec je potřeba nastavit několik drobností v hlavním konfiguračním souboru programu v souboru super_common.php
- připojení k vytvořené databázi dle zvolených údajů
- cestu ke generátoru PDF dokumentů: konstantu WKHTMLTOPDF_BINARY
- absolutní cestu k programu: konstantu PROJ_PATH_ABS
Ověření správnosti instalace
Pokud proběhly všechny kroky instalace bez chyb, je program připraven k prvnímu přihlášení a použití.
Přihlášení do aplikace
- přihlaste se do aplikace kontem administrátora (použijte uživatele admin s heslem admin - viz init.sql)
- vytvořte svůj slovník
Další podpora, sdílení zkušeností
Program vznikl v Ústavu pro jazyk český AV ČR, v. v. i. Oceníme, pokud nás informujete o slovníku, který vytvoříte s podporou softwaru Alexis. Můžete nás kontaktovat na kochova (zavináč) ujc.cas.cz