Skip to content

Provozování DK s DNNT

smallcubes edited this page Jul 21, 2023 · 36 revisions

Aprobované verze pro zpřístupňování NDK-DNNT:

Popis verzí a historie verzí aprobovaných NK ČR pro provoz vlastní digitálni knihovny s licencí pro DNNT:

Produkční verze

  1. Kramerius 5.72,release: 18.7.2021, aprobace: 19.7.2021 Kramerius klient 2.1.2

Minimální verze:

  1. Kramerius 5.72,release: 18.7.2021, aprobace: 19.7.2021, Kramerius klient 2.1.2

Testy

  1. Netestuje se

Legacy verze

Jadro

  1. Kramerius 5.71, prerelease: 28.6.2021, test bez aprobace
  2. Kramerius 5.6, release: 14.4.2021, test bez aprobace
  3. Kramerius 5.4.8-dnnt, release: 1.3.2021, aprobace 30.3.2020, dop. klient
  4. Kramerius 5.4.7-dnnt, release: 29.1.2021, test bez aprobace
  5. Kramerius 5.4.6-dnnt, release: 3.11.2020, aprobace 3.11.2020
  6. Kramerius 5.4.5-dnnt, release: 18.1.2019, aprobace 1.4.2019, platnost: 3.11.2020
  7. Kramerius 5.4.3-dnnt (beta), release: 18.1.2019, aprobace 1.4.2019

Klient

  1. Kramerius klient 2.0.5

Informace a podmínky provozu DK s DNNT

1. Administrativní podmínky: Registrace partnerské smlouvy s NK

  • revize technického checklistu (viz níže)
  • nahlášení provozních kontaktů (Jméno, Příjmení, mail, telefon) na adresu [email protected]
    • Administrativní kontakt
    • Technický správce 1 a 2 (Kramerius + Service Provider)
    • Hlavní obsahový správce
  • schválení podkladů ze strany NK
  • uzavření smlouvy s NK

Technický Checklist připravenosti DK

Tyto technické parametry je nutné splnit a připřavit si interně informace před podáním žádosti o administrativní registraci. NK následně ověrí připřavenost instituce v testovací verzi DK:

  • nainstalovaný nejnovější aprobovaný systém Kramerius pro použití v DK pro DNNT)
    • mít připřavenou dostupnou testovací verzi DK
    • mít postavenou automatickou synchronizaci se Seznamem SDNNT pro označování děl DNNT licenčními příznaky.
    • ověření aktuální tvorby statistik na testovací verzi DK
  • mít připraveného registrovaného Service Providera u federace EduID.cz pro účely poskytování služby. Viz implementace řešení
    • Ověřit nastavení rozsahu požadovaných metadat - musí obsahovat požadované hodnoty:
      • eduPersonUniqueId - unikátní ID uživatele
      • eduPersonAffiliation - musí obsahovat: member
      • eduPersonEntitlement - u aktivního uživatele (uživatel bez prohřešků) musí obsahovat řetězec: urn:mace:dir:entitlement:common-lib-terms
  • být v instituci kapacitně připřaven denně přebírat konfigurace a rekonfigurace pro systém DK a sledovat aktivitu uživatelů

2. Označování licence děl v DK

Všechna díla je nutné označit licencí - značek-> viz níže. Všechna díla, mimořádně zpřístupňovaná na základě kolektivních licencí budou muset být označena tzv. licenčním labelem, resp. značkou

  1. Díla pro takovéto označení jsou vybrána do seznamu UUID (co řádek to kořenové UUID nebo jenom UUID nejvyššího uzlu)
  2. Předpokladem je zavést rozšírené schéma SOLR
  3. Spuštění procesu přidělování značky, resp. licence nad tituly je řízeno v rámci Administrátorského rozhraní nebo API jádra
    1. Proces je možno spustit i via API, napr. z příkazové řádky
  4. Povinná nomeklatura značek pro kolektivní licence:
  • dnntt - pro díla dostupné na terminálu
  • dnnto - pro díla dostupné online a na terminálu

Historické označení

  • covid - pro díla jinak nedostupná, dočasné nastavení pro specifickou licenci do 30.6.2021 NDK

3. Konfigurace klienta pro licenční režimy a hlášky

  1. Konfigurace v assets

4. Konfigurace jádra pro poskytování DNNTT

  1. Nutné nakonfigurovat IP pravidlo pro DNNTT + s ověřovaním přihlašovacích údajů čtenáře

5. Generování statistik

  1. Od verze 5.72 jde statistiky generovat z přímo z administrátorského rozhraní a via API endpoint v doporučeném formátu.
    1. Zpřístupňovaní děl je podmíněno jejich označením správnou licencí
  2. Denně je dodávat specifikovaným způsobem NK včetně dat veřejných přístupů.

Interní provoz

  1. V souvislosti s provozováním DK s DNNT nebo COVID je nutné z aprobované verze generovat interní statistiky počtu užití jednotlivých stránek jednotlivými přihlášenými uživateli
  2. V tomcatu je to podmíněno nastavením rozšíření loggera v conf/logging.properties s názvem kramerius.access
  3. Takto tvořené logy dle citovaného nastavení se objevují samostatně jako denní statistics.YYYY-MM-DD a obsahují nezbytné údaje pro rozúčtování kolektivních licencí
  4. Tyto statistiky je nutné zabezpečit a uchovávat po dobu 1 roku ode dne vzniku
  5. V součastnosti do verze Kramerius 5.6, jenom aprobované verze umožňují generování statistik v požadovaném tvaru. Jde o specifické logy.
  6. Statistiky musí být ošetřeny pro sdělení potřeb vykazování anonymizací
  7. Obecní informace k statistikám a způsobu jejich nastavení:
    1. Logování
    2. DNNT
  8. Monitorovat uživatele a mít možnost banovat "zneužívající uživatele" + pravidelně aktualizovat seznam zabanovaných uživatelů na sdíleném repozitáři

Poznámka: Bez zavedení příznaku pro licence v rámci setu děl (viz níže) se nedají cíleně specificky zpřístupňovat díla a nejsou odlišené v statistikách jinak než na základě příznaku private

Formáty:

Primární log:

{"date":"2021-03-23T20:34:41.83","session_eppn":"xy@instituce","rootTitle":"Etika Nikomachova. Česky","dcTitle":"264",
"pid":"uuid:db496160-8ca5-11e5-b433-5ef3fc9bb22f","rootPid":"uuid:233b1a90-7987-11e5-99af-005056827e52","type":"validuser","models_path":["/monograph/page"],
"rootModel":"monograph",
"providedByDnnt":false,
**"dnnt_user":"xy@instituce",**"publishers":["P. Rezek"],"publishedDate":"1996","pids_path":["/uuid:233b1a90-7987-11e5-99af-005056827e52/uuid:db496160-8ca5-11e5-b433-5ef3fc9bb22f"],
"remoteAddr":"IP","username":"xy@provider","policy":"private","authors":["Aristotelés","Kříž, Antonín"]} 

Alternativni log:

1616527772318 I access {"date":"2021-03-23T20:29:32.318","session_eppn":"xy@instituce","rootTitle":"Mateřídouška: časopis pro
 malé čtenáře","dcTitle":"2","pid":"uuid:a8b41830-0ce1-11e8-8485-5ef3fc9ae867","rootPid":"uuid:82258550-b58e-11e7-91d5-005056825209","type":"validuser","models_path":
["/periodical/periodicalvolume/periodicalitem/page"],"rootModel":"periodical",
"providedByDnnt":false,
**"dnnt_user":"",**"publishers":["Mladá fronta","Mladá fronta"],"publishedDate":"05.03.1968","pids_path":["/uuid:82258550-b58e-11e7-91d5-005056825209/uuid:57cdc970-00f2-11e8-b1a1-005056827e52/uuid:7c2b9281-0bfa-11e8-8485-5ef3fc9ae867/uuid:a8b41830-0ce1-11e8-8485-5ef3fc9ae867"],
"remoteAddr":"IP","username":"xy@provider","policy":"private"}

Rozcestník dokumentace - Wiki

  1. Nastavení labelů, práva
  2. Systém oprávnění
Clone this wiki locally