POC_install - ceskaexpedice/kramerius GitHub Wiki

#POC - Installation process

#Úvod

Článek popisuje instalaci systému kramerius pro repositáře Jackrabbit a Fedora commons 4 repository. Nejedná se o plnou implementaci ale pouze o Proof of Concept

#Instalace repositářů

1. Je třeba si stáhnout standalone verzi repositáře [fedora 4] (https://github.com/fcrepo4/fcrepo4/releases/download/fcrepo-4.7.0/fcrepo-webapp-4.7.0-jetty-console.jar).
2. Spustit repozitář příkazem java -jar fcrepo-webapp-4.7.0-jetty-console.jar a nastavit port na 18080.

• Pokud chcete provozovat repositář na jiném portu, je třeba změnit standardní nastavení.

1. Stáhněte si standalone verzi repositáře jackrabbit.
2. Vyvtořte prázdný repositář například spuštěním a zastavením repositáře.
3. Zkopírujte soubory [ng_reg.properties] (https://github.com/ceskaexpedice/kramerius/blob/POC/installation/repositories/jackrabbit/ns_reg.properties) do adresáře <jackrabbit_repo>/repository/napespaces.
4. Zkopírujte soubory custom_nodetypes.xml do adresáře <jackrabbit_repo>/repository/nodetypes
5. Spustěte repositář příkazem java -jar jackrabbit-standalone-2.12.5.jar -p 18080 -r <repo_folder>

#Instalace indexu (SOLR)

1. Stáhněte si poslední verzi vyhledávacího enginu [solr] (http://mirror.hosting90.cz/apache/lucene/solr/6.3.0).
2. Spustěte příkazem <solr_home>/bin/solr start

Jádro je určeno pro vyhledávání v aplikaci search a v klientech. Popis instalace:

1. V administračním rozhraní spuštěné instance vyhledávacího enginu solr vytvořte nové vyhledávací jádro pro vyhledávání v aplikacích. Standardní název je kramerius. Pokud je potřeba zvolit jiný název nebo je nutno provozovat solr na jiném portu, je nutno změnit defaultní [konfiguraci] (https://github.com/ceskaexpedice/kramerius/blob/POC/common/src/main/java/res/configuration.properties#L16).
2. Dále je třeba změnit nastavení vyhledávacího jádra. Nejednodužší způsob je zkopírovat vše z instalačního adresáře do adresáře <solr_home>/server/solr/kramerius

Vyhledávací jádro nahrazuje funkcionalitu resource indexu. Každý nově importovaný objekt je nyní popsán v tomto indexu spolu se svými vazbami. Postup instalace je následující:

1. V administračním rozhraní spuštěné instance vytvořte jádro processing. Změna portu nebo názvu jádra je opět možná pomocí možná pomocí [konf. souboru] (https://github.com/ceskaexpedice/kramerius/blob/POC/common/src/main/java/res/configuration.properties#L19).
2. Změňte nastevení jádra zkopírováním [souborů] (https://github.com/ceskaexpedice/kramerius/tree/POC/installation/solr-6.x/processing/) do adresáře <solr_home>/server/solr/processing.

#Instalace tomcatu

Aplikace umožňuje plnit processing index během importu (platné pouze pro repozitář fedora 4). Stačí pouze stáhnout aplikaci fcrepo-message-consumer-webapp-4.3.1-SNAPSHOT a zkopírovat do adresáře <catalina_home>/webapps.

Kramerius aplikace. Postup instalace je stejný jako u předchozí. Zkopírujte soubor search.war do adresáře <catalina_home>/webapps.

Do adresáře <catalina_home>/libs zkopírujte soubor security-core.jar a postgres jdbc driver

Autentizace aplikace je realizována pomocí [JAAS] (http://docs.oracle.com/javase/7/docs/technotes/guides/security/jaas/JAASRefGuide.html). Vytvořte soubor s tímto obsahem

search {
 cz.incad.kramerius.security.jaas.K4LoginModule required debug=true;
};

Před spouštěním tomcatu je nutno nastavit systémouvou proměnnou, která ukazuje na na tento soubor:

Linux:

export JAVA_OPTS="-Djava.security.auth.login.config=<path_to_jaas>/jaas.conf"

Windows:

set JAVA_OPTS="-Djava.security.auth.login.config=<path_to_jaas>\jaas.conf"

#Instalace databáze postgres Instalace databáze je stejná jako u standardní verze. Z vytvářených databází je nutné vytvouřit pouze databázi kramerius4. Pro ni je nutno vytvořit uživatele (standardně fedoraAdmin) a nastavit datasource.

#Testování a testovací monografie

1. V souboru je připravena testovací monografie. Tu je třeba rozbalit do adresáře <user_home>/.kramerius4/import.
2. Spustit tomcat, přihlásit se do aplikace search administrátorským účtem.
3. Importovat vzorovou monografii. Po importu by měl by se měla zobrazit v rozhraní search.