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. | |
reject anonymous changes' | Ei | Hylätäänkö operaattoritunnuksettomat muutokset (0=ei, 1=kyllä) | 1 |
skip on cat match | Ei | Ei 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 | |
sru server | Kyllä | Alephin SRU-serverin osoite |
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ä.