• Požadavky na server
• Instalace
• PostgreSQL
• Fedora Commons
• SOLR
• Tomcat
• ProArc
• Upgrade na AKUBRU

• OS *NIX 64 bit
• RAM doporučeno 16 GB
• Disk min. OS + aplikace + RDBMS data + uživatelský prostor pro import digitalizovaných dat a exporty

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

Vytvoření systémové složky a uživatele pod kterým poběží aplikační server.

• Vytvořit složku “data” v rootu
• Založit uživatele “proarc” a nastavit mu home do složky “/data” + pridat ho do sudo users
• Dát tomuto uživateli heslo
• Vytvoření složky “install” ve složce “/data”
• Vytvoření složky “proarc” ve složce “/data”
• Vytvoření složky “java” ve složce “/data/proarc”

Přidat systémové proměnné

• Nastavit proměnné

  export JAVA_HOME=/data/proarc/java/jdk1.8.0_231
  export CATALINA_HOME=/data/opt/tomcat
  export FEDORA_HOME=/data/fedora
  export JAVA_OPTS=" -Djava.awt.headless=true -XX:+HeapDumpOnOutOfMemoryError"
  export PATH=$PATH:$FEDORA_HOME/server/bin:$FEDORA_HOME/client/bin:$CATALINA_HOME/bin:$JAVA_HOME/bin
  export PROARC_HOME=$HOME/.proarc

List nezbytných aplikací:

• Java Oracle JDK 1.8 nejnovější verzi (jdk-8u231-linux-x64)
• Databáze PostgreSQL 9 nebo novější
• Úložiště Fedora Commons 3.8.1
• Aplikační server Apache Tomcat (volitelné)
• Kakadu
  • Manuálně zkopírovat složku KDU7A2 do /data/proarc

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

Postup instalace viz. https://www.postgresql.org.

• konfigurovat pg_hba.conf a nastavit všechny oveřovací metody na 'trust'
• vytvořit usera 'fedoraAdmin', heslo 'fedoraAdmin'
• vytvorit databázi 'fedora3', vlastník 'fedoraAdmin'
• vytvořit usera 'proarcAdmin', heslo 'proarcAdmin'
• vytvorit databázi 'proarc', vlastník 'proarcAdmin'

Postup instalace viz. https://wiki.duraspace.org/display/FEDORA38/Installation+and+Configuration.

Parametry instalace:

• Installation type => custom

  • Fedora administrator password => fedoraAdmin
  • SSL required for API-M => false
  • Keystore file => included
  • Database => postgresql
  • Database username => fedoraAdmin
  • Database password => fedoraAdmin
  • Enable Resource Index => true
  • Deploy local services and demos => false

• pokuď při instlaci fedory dojde u kroku zadávání db k této chybe: “Unable to connect to Postgres DB due to the authentication type 10 is not supported” tak se musí udělat úpravy v pg_hba.conf, postgresql.conf a po těchto upravách restartovat server a udělat update hesel pro uživatele fedoraAdmin a proarcAdmin:

  ALTER ROLE “fedoraAdmin” WITH PASSWORD 'fedoraAdmin';
  ALTER ROLE “proarcAdmin” WITH PASSWORD 'proarcAdmin';

• spustit a zastavit tomcat aby se vytvořila složka 'data' a její obsah

Po instalaci je nutné dokonfigurovat:

• Změnit nebo zrušit pravidlo $FEDORA_HOME/data/fedora-xacml-policies/repository-policies/default/deny-unallowed-file-resolution.xml tak, aby Fedora umožnila import FOXML souborů z uživatelského prostoru ProArcu. Deaktivaci lze provést buď editací XACML pravidel v souboru nebo jeho prostým odstraněním. Editace XACML pravidel je popsána v dokumentaci úložiště Fedora Commons.

• Přidat org.apache.cxf.jaxrs.impl.WebApplicationExceptionMapper/addMessageToResponse=true do <jaxrs:providers> v souboru $FEDORA_HOME/server/config/spring/web/jaxrs/objects-jaxrs.xml

  <jaxrs:providers>
    ...
    <!-- Add the following bean to fix error messages! -->
    <bean class="org.apache.cxf.jaxrs.impl.WebApplicationExceptionMapper">
      <property name="addMessageToResponse" value="true" />
    </bean>
    ...
  </jaxrs:providers>

• Zkontrolovat, jestli $FEDORA_HOME/server/config/mime-to-extensions.xml obsahuje MIME registraci Vámi používaných souborů. Registrace ovlivňuje pouze přidání správné koncovky názvu souboru, v případě stažení a uložení obsahu prohlížečem. Nutno doplnit např. image/jp2 pro JPEG2000:

  <mime-mapping>
    <mime-type>image/jp2</mime-type>
    <extension>jp2</extension>
  </mime-mapping>

• Otestovat, jestli fedora běží -> http://hostname:8080/fedora

Nejdříve je nutné stáhnout SOLR (vyvíjeno proti verzi 8.11) jako stamostatný server. (Možnost mít SOLR jako vedlejší webovou aplikaci v rámci jednoho tomcatu už není podporována. Viz: https://wiki.apache.org/solr/WhyNoWar

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/search

Otevřte administrační prostředí http://localhost:8983/.

* V administračním prostředí vytvořte nové jádro search. (name uveďte proarc, instanceDir rovnež)
* Ostatní může zůstat jak je implicitně předdefinováno.

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

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

Tomcat verze 7 je součástí instalačního balíku Fedora 3.8. Použít lze ale i samostatnou instalaci. 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.

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. (např.: postgresql-42.6.0.jar)

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 https://server/proarc v sekci Uživatelé nebo ve formuláři po kliknutí na jméno uživatele na začátku stránky.

1. Nainstalovat Javu verze 1.8
2. Nainstalovat úložiště Fedora Commons 3.8.1
   • Zde je doporučení jak přejít z verze 3.5 na verzi 3.8.1
   • Dokončit konfiguraci podle instrukcí
3. V případě samostatné instalace Tomcat
   • verze 7 a novější: smazat obsah adresáře $CATALINA_HOME/endorsed, který se kopíroval z původního proarc-version-release.zip/tomcat/endorsed/*
   • verze 6: instalovat Tomcat 7 nebo novější
4. Nový proarc.war uložit do $CATALINA_HOME/webapps. Pokud se původní war rozbalil do adresáře, tak smazat adresář.
5. V $PROARC_HOME/proarc.cfg aktualizovat nastavení podle provedené instalace. Více zde.
6. V případě upgrade z verze 1.* je možno po prvním úspěšném spuštění nové verze odstranit <Realm className="org.apache.catalina.realm.JDBCRealm" .../> v souboru $CATALINA_HOME/conf/server.xml. Nadále se nevyužívá.

Vzhledem k tomu, že od verze 3.5.18 jsou v náhledu vyhledávání nové informace (stavy jednotlivých exportů, status objektu, organizace) je nutné provést update všech objektů, který doplní do objektů elementy, které v nižších verzích nejsou.

1. Spustit aplikaci
2. Přihlásit se do aplikace pod uživatelem proarc
3. Ve správě uživatelů přiřadit role (user, admin a superAdmin) a organizaci všem uživatelům.
4. Pod uživatelem proarc vytvořit jakýkoli objekt (není potřeba u něj cokoli vyplňovat).
5. Přepnout se do obrazovky Hledat (zde by nyní nemělo být nic k vyhledání kromě nově vytvořeného objektu).
6. Najít nově vytvořený objekt, kliknout na liště na tlačítko Administrace a vybrat možnost Update všech objektů.
   • Updatuje se rychlostí přibližně 100 000 objektů/hodinu.
7. Během updatu se postupně zobrazují již updatované objekty objekty.

V případě vypnutí/spadnutí serveru/aplikace během updatu je možné po opětovném stratu serveru/aplikace pokračovat od bodu 1.

ProArc podporuje od verze 3.9 uložiště AKUBRA a k indexování SOLR. Je to nastavené tak, že si uživatel při instalaci zvolí, jaké uložiště chce používat. Aplikace podporuje obě varianty.

Konfigurace:

1. v souboru proarc.cfg je potřeba nakonfigurovat typ uložiště na AKUBRU. Popis konfigurace
2. Instalovat SOLR a nakonfigurovat ho. Popis instalace

V aplikaci:

1. Spustit aplikaci
2. Přihlásit se do aplikace pod uživatelem s právy superadmin.
3. V části hledat objekt v menu Administrace -> Spustit funkci Indexovat všechny objekty do SOLRu.
4. Během indexování se postupně objevují data v SOLRu.

V případě vypnutí/spadnutí serveru/aplikace během indexování je možné po opětovném stratu serveru/aplikace pokračovat od bodu 1.