Replikointi tarvitsee toimiakseen asetustiedoston, joka on oletusarvoisesti nimeltään replication.config .

Asetustiedosto sisältää kolme sektiota (stanzaa): general = yleiset asetukset, aleph = alephiin liittyvät asetukset ja voyager = voyageriin liittyvät asetukset, sekä versiosta 3.4 eteenpäin käytettävien filtteröintipluginien määritykset.

Asetukset kirjoitetaan kukin omalle rivilleen, ensin asetuksen nimi, sitten yhtäsuuruusmerkki ja asetuksen arvo. Esimerkki:

[general]
working directory=/m1/voyager/xxxdb/local/replication
scratch directory=/m1/voyager/xxxdb/local/replication/scratch

[aleph]
vst server=alina.csc.fi:5221

Sektiot

general

Asetus

Pakollisuus

Selitys

Esimerkki

working directory

Kyllä

Hakemisto, josta muut tiedostot (asetukset ym.) löytyvät

/m1/voyager/xxxdb/local/replication

scratch directory

Kyllä

Hakemisto, johon työtiedostot kirjoitetaan (esim. bulk importille välitettävät tietueita sisältävät tiedostot)

/m1/voyager/xxxdb/local/replication/scratch

log file

Kyllä

Lokitiedosto

replication.log

pid file

Kyllä

pid-tiedosto (prosessin ID, jota käynnistysskripti tarvitsee

replication.pid

sequence file

Kyllä

Tiedosto, johon tallennetaan nykyinen sekvenssinumero. Seuraavat muutokset pyydetään Alephilta sekvenssinumerolla

sequence.id

interval

Kyllä

(sekunteja) Kuinka usein muutoksia kysytään Alephilta

10

debug

Ei

Tulostetaanko jatkuvaa lokia replikoinnin toiminnasta (0=ei, 1=kyllä)

1

add filter

Ei

Pilkulla eroteltu RegExp-lista, joka määrittelee, minkä operaattoritunnuksien tekemät tietueiden lisäykset (LOW-tagin lisäys) otetaan vastaan

XX\d+,KK.*

change filter

Ei

Pilkulla eroteltu RegExp-lista, joka määrittelee, minkä operaattoritunnuksien tekemät tietueiden muutokset otetaan vastaan

XXX\d+,KK.*

primary operator mask

Ei

Pilkulla eroteltu RegExp-lista, joka määrittelee, mitkä operaattoritunnukset ovat primaareja (esim. oman kirjaston henkilökunta)

XXX\d+

email recipients

Ei

Jos muutosta ei hyväksytä add filterin tai change filterin takia, tieto muutoksesta voidaan lähettää näihin pilkulla eroteltuihin sähköposoitteisiin. Käytännössä käyttökelvoton.

[email protected],[email protected]

reject anonymous changes'

Ei

Hylätäänkö operaattoritunnuksettomat muutokset (0=ei, 1=kyllä)

1

skip on cat matchEiEi replikoida tietueita jotka on tehty listattujen luetteloijien toimesta. Asennettu kaikkien kirjastojen config-tiedostoon. Käytetään replikoinnin hyytymiseen estämiseen erilaisten massa-loadien yhteydessä. Esimerkiksi unohdetaan kaikki LOAD- alkuisten automaattiluettelijoiden tekemättä muutokset, paitsi ne, jotka on tehnyt LOAD-FENNI tai LOAD-HELKA. Formaatti on Perl:in regular expression syntaksi, ja on hyvin herkkä kirjoitusvirheille.LOAD-(?!FENNI|HELKA)

aleph

Asetus

Pakollisuus

Selitys

Esimerkki

vst server

Kyllä

VST-palvelimen osoite

alina.csc.fi:5221

vst username

Kyllä

Käyttäjätunnus VST-palvelimelle

repli

vst password

Kyllä

Salasana VST-palvelimelle

repli

library

Kyllä

Aleph-kirjasto, jonka muutoksia pyydetään

FIN01

low id

Kyllä

Kirjaston LOW-tunnus

HELKA

original sid

Kyllä

Alkuperäisen ID:n sisältämän kentän (SID) tunnus. Normaalisti sama kuin low id, mutta pienellä

helka

x server

Kyllä

Alephin X-Serverin osoite

http://alina.csc.fi:8991/X?

sru server

Kyllä

Alephin SRU-serverin osoite

http://alina.csc.fi:210/fin01?

voyager

Asetus

Pakollisuus

Selitys

Esimerkki

add command

Kyllä

Komento, joka suoritetaan uuden tietueen lisäämiseksi tietokantaan. $filename korvataan käsiteltävän tiedoston nimellä. Voidaan käyttää suoraan bulk importia. Jos halutaan omia jatkojalostustoimenpiteitä, voidaan käyttää myös erillistä käsitelyskriptiä, joka kutsuu bulk importia itse tehtyään tarpeelliset toimenpiteet.

/m1/voyager/xxxdb/sbin/Pbulkimport -f$filename -iALEPH -oALEPH

primary change command

Kyllä

Komento, joka suoritetaan primaarioperaattorin (esim. oman kirjaston henkilökunta) muuttaman tietueen päivittämiseksi tietokantaan. $filename korvataan käsiteltävän tiedoston nimellä. Voidaan käyttää suoraan bulk importia. Jos halutaan omia jatkojalostustoimenpiteitä, voidaan käyttää myös erillistä käsitelyskriptiä, joka kutsuu bulk importia itse tehtyään tarpeelliset toimenpiteet.

/m1/voyager/helkadb/sbin/Pbulkimport -f$filename -iALEPH -oALEPH

secondary change command

Vain jos primary operator mask on määritelty

Komento, joka suoritetaan sekundaarioperaattorin (esim. toisen kirjaston henkilökunta) muuttaman tietueen päivittämiseksi tietokantaan. $filename korvataan käsiteltävän tiedoston nimellä. Voidaan käyttää suoraan bulk importia. Jos halutaan omia jatkojalostustoimenpiteitä, voidaan käyttää myös erillistä käsitelyskriptiä, joka kutsuu bulk importia itse tehtyään tarpeelliset toimenpiteet.

/m1/voyager/helkadb/sbin/Pbulkimport -f$filename -iALEPH -oALEPH

delete command

Kyllä

Komento, joka suoritetaan tietueen poistamiseksi tietokannasta. $filename korvataan käsiteltävän tiedoston nimellä. Voidaan käyttää suoraan bulk importia. Jos halutaan omia jatkojalostustoimenpiteitä, voidaan käyttää myös erillistä käsitelyskriptiä, joka kutsuu bulk importia itse tehtyään tarpeelliset toimenpiteet.

/m1/voyager/helkadb/sbin/Pbulkimport -r -x -f$filename -iALEPH -oALEPH

stripped fields in add

Ei / Ei käytössä filtteröintiplugineja käytettäessä

Lista kentistä, jotka poistetaan lisättävistä tietueista ennen add commandin suorittamista

050,051,052,055,060

stripped fields in primary change

Ei / Ei käytössä filtteröintiplugineja käytettäessä

Lista kentistä, jotka poistetaan primaarioperaattorin muokkaamista tietueista ennen add commandin suorittamista

050,051,052,055,060

stripped fields in secondary change

Ei / Ei käytössä filtteröintiplugineja käytettäessä

Lista kentistä, jotka poistetaan sekundaarioperaattorin muokkaamista tietueista ennen add commandin suorittamista

050,051,052,055,060,061,070,071,072,074,080,082

Filtteröintipluginien asetukset (v. 3.4->)

Tietuetta replikoitaessa voidaan käyttää erillisiä filtteröintipluginejä tietueiden muokkaamiseen. Käytettävät pluginit määritellään replikoinnin asetustiedostossa erikseen kullekin replikoinnin suorittamalle toiminnolle (uuden tietueen lisäys, primääri- ja sekundäärioperaattorin suorittamat tietuemuutokset ja tietueen poisto.)

Suoritettavaksi haluttavien pluginien nimet (ilman .pm -päätettä) kirjoitetaan kukin omalle rivilleen halutussa suoritusjärjestyksessä. Esimerkki:

[plugins_add]
plugin_strip_fields
plugin_handle_579

[plugins_mod1]
plugin_strip_fields
plugin_handle_579

Suurimmalla osalla plugineista on käytössään oma asetustiedosto. Oletuksena plugin käyttää asetustiedostoa, jonka nimi vastaa sen omaa nimeä, mutta sille voidaan replikoinnin asetustiedostossa  määritellä myös poikkeavan niminen asetustiedosto, esimerkiksi, jos samaa pluginia halutaan eri toiminnoissa ajaa eri asetuksilla. Tällöin pluginin nimen jälkeen asetusriville kirjoitetaan välilyönti ja käytettävän asetustiedoston nimi ilman .conf -päätettä. Esimerkki:

[plugins_add]
plugin_strip_fields plugin_strip_fields_add
plugin_handle_579

[plugins_mod1]
plugin_strip_fields plugin_strip_fields_mod1
plugin_handle_579

plugins_add

Tietuetta lisättäessä käytettävät filtteröintipluginit

plugins_mod1

Tietuetta muokattaessa käytettävät filtteröintipluginit.

Jos general/primary operator mask on määritelty, primäärioperaattorin muokatessa tietuetta käytettävät filtteröintipluginit.

plugins_mod2

Tietuetta sekundäärioperaattorina muokattaessa käytettävät filtteröintipluginit. Jos general/primary operator mask ei ole määritelty, tähän osioon ei tarvita pluginien määrityksiä.

plugins_del

Tietuetta poistettaessa käytettävät filtteröintipluginit. Ei yleensä tarvitse määrityksiä.

  • No labels