Ongelmatilanteita ja niiden ratkaisuja - KohaSuomi/Koha GitHub Wiki

Pääkäyttäjät/Kehittäjät:

• Jos ongelma ilmenee varsinkin silloin kun tehdään palautuksia, lainauksia tai uusintoja:
  • Tarkista ettei kirjastoja ole "suljettu" kalenterin kautta (kirjasto aina ja ikuisesti kaikkina päivinä kiinni). Tämä voi aiheuttaa sen, että Koha jää ikuisesti etsimään lainalle seuraavaa mahdollista eräpäivää.
  • Kalenterin aiheuttama ongelma laajenee yleensä nopeasti häiritsemään koko kimppaa, koska eräpäivien etsintä varaa kaikki kimpan käytettävissä olevat Plack workerit. Koha-suomi-utilityn misc-hakemistossa on syndrooman mukaan nimetty 'askola-reaper.sh' skripti, joka siivoaa roikkumaan jääneet renew, returns ja circulation prosessit pois ja estää koko kimpan jumimisen. Skripti täytyy käynnistää kimpan kontissa tmux:issa roottina.

Kehittäjät:

• Tietokannan taulussa on mahdollisesti table lock
• Tietokannassa on käynnissä jumiin jäänyt kysely
  • Tarkista löytyykö kannasta jokin pitkään kestänyt kysely
  • Pysäytä kysely ajamalla komento kill
• Plack on mahdollisesti alhaalla
  • Tarkista koskeeko ongelma vain tietyllä nodella olevia kontainereita vai niitä kaikkia
  • Jos ongelma koskee vain tietyn noden kontainereita, sulje niiden plackit yhtäaikaa ja käynnistä ne sitten yksitellen uudestaan
  • Vastaavasti jos ongelma koskee useampaa eri nodeilla sijaitsevaa kontaineria tai niitä kaikkia, sulje plackit ja käynnistä yksitellen uudestaan.

• Tarkista onko tietue tuplana biblio- ja deletedbiblio-tauluissa: Tietoja Kohasta -> Järjestelmätiedot

• Sivulla näytetään pop-up 500 virheestä, muttei syytä virheelle:
  • Varmista kannasta, että niteiden nidetyyppi on oikein

• Nide voi olla tuplana items- ja deleteditems-tauluissa
  • poista tietue jommasta kummasta taulusta
• Jos niteen poisto ei onnistu vieläkään, se voi olla kiinni jossain toisessa taulussa, josta se ei poistu automaattisesti
  • tällainen taulu on muun muassa collections_tracking-taulu

• Tämä saattaa näkyä Kohan lokeissa seuraavana virheilmoituksena
  • DBIC result _type isn't of the _type BiblioMetadata at /home/koha/Koha/Koha/BiblioUtils.pm line 149.
• Tarkista onko biblio- ja deletedbiblio-tauluissa tupla-arvoja
• Tarkista tietueen MARC (jos tarkka tietue ei ole tiedossa, tiedustele sitä Finnalta)
  • Tietueelta saattaa puuttua esim. 942-kentän osakentät
• Tarkista ettei nidetaulussa ole niteitä, joiden biblionumberina on 0. Tämä voi aiheuttaa Koha lokeihin virheilmoituksen:
  • Can't locate object method "rethrow" via package "Can't call method "metadata" on an undefined value at /home/koha/Koha/Koha/OAI/Server/Repository.pm line 188.

• Ilmenee seuraavasti:
  • Salasanan voi näennäisesti vaihtaa Asiakkaan tiedot-> Vaihda salasana toiminnolla
  • Uusi salasana ei kuitenkaan tule voimaan, kirjautuminen onnistuu edelleen vanhalla salasanalla
• Mahdollinen ratkaisu:
  • Tarkista mikä on käyttäjän ilmoitusten kieli
  • Tarkista löytyykö kielelle viestipohjaa "PASSWORD_CHANGE"
  • Tarvittaessa joko vaihda käyttäjän ilmoitusten kielen arvoa tai lisää vastaava viestipohja
  • Kehittäjille:
    • Tällainen virhe ilmenee lokeissa seuraavana herjana: No members PASSWORD_CHANGE letter transported by email at /home/koha/Koha/C4/Letters.pm line 585.

• Ilmenee seuraavasti:

  • Kirjautumissivulle tulee ilmoitus Virhe: Tili on lukittu jo ennen kirjautumista

    

• Ongelman syy:
  • Todennäköisesti jollain tunnuksella on cardnumber/userid tyhjä ('') ja kyseisen tunnuksen epäonnistuneiden kirjautumisten määrä on ylittänyt sallitun maksimin.
• Mahdolliset ratkaisut:
  • Tunnukselle vaihdetaan tietokannassa jokin muu cardnumber/userid. Vaihto ei onnistu käyttöliittymän kautta sen valittaessa jo käytössä olevasta userid-arvosta.
  • Tunnus poistetaan.
• Liittynee järjestelmäasetukseen AutoSelfCheckID

• Asiakkaan lainat eivät lataudu taulukkoon asiakkaan Perustiedot-näytöllä
• Jos lokeilla näkyy seuraava virheilmoitus:
  • Can't call method "notforloan" on an undefined value at .... (tämä voi viitata usempaan riviin Kohan koodissa)
  1. jossakin asiakkaalle lainatussa niteessä on virheellinen nidetyyppi
  2. TAI asiakkaalle lainatu niteen tietueeseen liittyy virheellisen nidetyypin sisältävä nide
• Hae virheelliset niteet seuraavalla rimpsulla ja korjaa ne Kohaan: SELECT * FROM items WHERE itype NOT IN(SELECT itemtype FROM itemtypes);

• Finna antaa tämän tyyppisen ilmoituksen: "Kirjastojärjestelmään ei saatu yhteyttä. Tietoja, jotka liittyvät tiliisi kirjastossa, ei voida näyttää. Jos ongelma jatkuu, ota yhteyttä kirjastoon." Vika on todennäköisesti varatun teoksen niteen päivämääräkentissä. Tarkista kyselyllä, onko jollain niteellä päivämääräkentissä arvo 0000-00-00 ja korjaa mahdolliset virheelliset arvot.

select itemnumber,biblionumber,dateaccessioned, replacementpricedate, datelastborrowed, datelastseen, damaged_on, itemlost_on, withdrawn_on, deleted_on, onloan 
FROM items
WHERE 
dateaccessioned LIKE '0000-00-00%' OR 
replacementpricedate LIKE '0000-00-00%' OR 
datelastborrowed LIKE '0000-00-00%' OR 
datelastseen LIKE '0000-00-00%' OR 
damaged_on LIKE '0000-00-00%' OR 
itemlost_on LIKE '0000-00-00%' OR 
withdrawn_on LIKE '0000-00-00%' OR 
deleted_on LIKE '0000-00-00%' OR 
onloan LIKE '0000-00-00%'

• Tietueen niteeltä puuttuu signum. Hyllyvarausraportti tarkistaa pakollisena tietona signumin ja jos se puuttuu, tietue ei tule listalle.
• Varaus on vanhempi kuin mitä HoldsToPullStartDate-järjestelmäasetukseen on määritetty haettavia päiviä.

• Haku saattaa palauttaa niteen, jonka signumin perässä on ylimääräinen välilyönti.
  • Tarkista löytyykö kannasta tällaisia ajamalla raportti Niteet, joiden signumin perässä on ylimääräinen välilyönti.
• Haku voi myös palauttaa niteen, jonka tietueen nimekkeessä on ongelmallisia merkkejä, esim. 'J.V.J,..\ /
  • Tietueen nimeke on muutettava.