Instalace - proarc/proarc GitHub Wiki

Obsah

Požadavky na server

  • OS *NIX 64 bit
  • RAM doporučeno 32 GB
  • Disk min. OS + aplikace + RDBMS data + uživatelský prostor pro import digitalizovaných dat a exporty (alespoň 1 TB)

Instalace

Instalační balík je k dispozici zde.

Před instalací aplikace je nutné instalovat následující komponenty:

  • Java Oracle JDK 21 nejnovější verzi
  • Databáze PostgreSQL 13 nebo novější
  • Aplikační server Apache Tomcat 10.1 nejnovější verzi

a vytvořit systémového uživatele pod kterým poběží aplikační server.

Do připraveného aplikačního serveru se nainstaluje ProArc.

PostgreSQL

Postup instalace na stránkách postgresu.

  1. a uživatele proarcAdmin s přístupem k databázi proarc.

SOLR

Nejdříve je nutné stáhnout SOLR (vyvíjeno proti verzi 8.11, provozováno je i na solr 9.6, 9.7) jako stamostatný server.

Nainstalujte server dle návodu

Stáhněte si konfigurační soubory a slovníky buď z instalačního balíčku nebo přímo z git repozitáře. Stáhnuté soubory umístěte do adresáře <solr_home>/server/solr.

Otevřte administrační prostředí http://localhost:8983/. V záložce core-admin vyberte odpovídající jádro a zmáčkněte tlačítko reload.

Do adresáře $PROARC_HOME nakopírujte konfigurační soubor SOLRu a nastavte proměnné dle konfigurace;

Průběh indexování je popsán v bodě Upgrade na AKUBRU

Tomcat

Zprovoznit Tomcat 10.1 nejnovější verze. Z bezpečnostních důvodů by uživatelé neměli přistupovat přímo na aplikační server a komunikace by měla probíhat s využitím HTTPS. Záleží na konkrétní instalaci.

Konfigurace Tomcat

  1. Do souboru $CATALINA_HOME/conf/context.xml přidat definici úložiště:

    <Resource name="jdbc/proarc" auth="Container"
        type="javax.sql.DataSource" initialSize="3"
        maxActive="100" maxIdle="30" maxWait="10000"
        username="proarcAdmin" password="FIXME"
        driverClassName="org.postgresql.Driver"
        url="jdbc:postgresql://localhost/proarc"/>

  2. Do souboru $CATALINA_HOME/conf/server.xml přidat URIEncoding:

    <Connector port="8080" protocol="HTTP/1.1"
               connectionTimeout="20000" URIEncoding="UTF-8"
               redirectPort="8443" />

  3. Do adresáře $CATALINA_HOME/lib zkopírovat JDBC ovladač podle verze instalované databáze.

  4. Přidat systémové proměnné:

export JAVA_HOME=/usr/java/java-8
export CATALINA_HOME=$HOME/tomcat
export JAVA_OPTS=" -Djava.awt.headless=true -XX:+HeapDumpOnOutOfMemoryError"
export PATH=$PATH:$CATALINA_HOME/bin:$JAVA_HOME/bin

ProArc

  1. Nastavit umístění konfigurace pomocí systémové proměnné. Pokud proměnná nebude definována, použije se:

    export PROARC_HOME=$HOME/.proarc

  2. Zpřístupnit adresář $PROARC_HOME/users, do kterého se budou ukládat data uživatelů (exporty, dávkové importy). Adresář by měl být dostupný jak pro systémového uživatele, pod kterým poběží Tomcat, tak pro uživatele ProArcu (např. pomocí Samba, FTP, ...). Adresář je vytvořen při prvním spuštění.

  3. proarc.war uložit do $CATALINA_HOME/webapps

  4. V $PROARC_HOME/proarc.cfg aktualizovat nastavení podle provedené instalace. Více zde.

Login administrátora po instalaci je proarc/proarcAdmin. Heslo lze změnit v aplikaci v sekci Profil nebo ve formuláři po kliknutí na jméno uživatele na začátku stránky.

Upgrade Schematu SOLRu

Při určitých releasech (vždy označeno v Releasu) je potřeba udělat update SOLR schematu. Seznam všech verzí zde. a aktuální balíčky dostupné zde.

V takovém případě je postup následující:

  1. Stáhněte si konfigurační soubory a slovníky buď z instalačního balíčku nebo přímo z git repozitáře.
  2. Stáhnuté soubory umístěte do adresáře <solr_home>/server/solr.
  3. Otevřte administrační prostředí http://localhost:8983/.
  4. V záložce core-admin vyberte odpovídající jádro a zmáčkněte tlačítko reload.
  5. Poté spusťte aplikaci ProArc s novým warkem
  6. V aplikaci ProArc spustit funkci Indexaci objektů do SOLRu

Může se updatovet schema

Vývojové issues mohou mít novější schema, než na které jsou odkazy, ale v takových issues je napsaáno, jaká verze, se má používat.

⚠️ **GitHub.com Fallback** ⚠️