Overførsel af data til DBCs Posthus med ftp

Sidst opdateret 21. juni 2012

Hvem skal bruge denne vejledning?

Denne vejledning skal bruges:

  • hvis du ønsker at foretage manuel overførsel af data- og transfiler fra lokalt bibliotekssystem til Dansk Bibliotekscenter ved hjælp af ftp, eller
  • hvis du ønsker at automatisere overførsel af data- og transfiler fra lokalt bibliotekssystem til Dansk BiblioteksCenter ved hjælp af ftp

Vejledningen skal ikke bruges, hvis I anvender DBC Posthus' web-formular, når I overfører data til DBC. Vi anbefaler at I bruger DBCs Posthus' web-formular, hvis det lokale bibliotekssystem ikke indeholder faciliteter til automatisk ftp-overførsel, herunder automatisk dannelse af både data- og transfiler.

Se DBCs posthus web-formular til indberetning af poster - kræver adgangskode til Netpunkt.

Indhold:

Princippet i dataoverførsel til DBC - datafil og transfil

En dataoverførsel fra lokal base til DanBib/DBC sker ved at der fra det lokale system sendes 2 filer ved hjælp af ftp:

  • selve datafilen - indeholder de data der skal behandles (fx poster eller folkebibliotekernes lokaliseringer)
  • en transaktionsfil ('trans-fil') - en lille tekstfil, der i kodet form indeholder oplysninger om datafilen, der overføres, fx om datafilens format, forskellige administrative oplysninger, m.m.

Oplysningerne i transfilen bruges i den automatiske databehandling, der finder sted efter at filen er modtaget på DBCs Posthus.

Selve ftp-overførslen - herunder også automatisk oprettelse af data- og transfiler - kan ske helt automatisk fra det lokale bibliotekssystemet, ved hjælp af dets indbyggede rutiner. Overførslen kan dog også ske helt manuelt, enten fra en PC (med et grafisk ftp-program eller fra en kommandoprompt), eller direkte fra en server (fx en Unix-server). Ved manuel overførsel skal I selv udforme transfil og sørge for korrekt datafil.

Vigtigt: Datafilen sendes først til DBCs Posthus, efterfulgt af transfilen - altid i den rækkefølge!

Til toppen


Opkaldsparametre for ftp-overførsel

Uanset om man laver ftp-overførslen fra en PC eller en server - eller om der kaldes op fra en kommandopromt eller med et grafisk (Windows)-program - skal følgende opkaldsparametre anvendes:

  • ftp-adresse/hostname på DBCs server: ftp.dbc.dk
  • login: ftp
  • password: ftp (fx - der skal mindst være ét tegn, kan også være initialer)
  • transfermode: binary (af hensyn til tegn udover ASCII-tegn i datafilerne)
  • directory på ftp-server: filerne skal placeres i følgende directory: /datain

Hvad sker der når trans- og datafiler ankommer til DBCs Posthus?

DBCs posthus undersøger med ca. 1 minuts interval, om der er kommet nye filer, som behandles på følgende måde:

  • datafiler undersøges for fejl i forhold til det valgte rammeformat - overholder data ikke den angivne protokol, vil hele datafilen blive afvist . En e-mail sendes til afsenderen med besked om fejlens art
  • hvis datafilen/-erne er OK sendes de videre til behandling
  • datafiler med bibliografiske poster: afviste poster samt oplysning om fejlens art lægges i en resultatfil. Denne fil oplyser også antallet af godkendte poster. Filen sendes med e-mail til afsenderen (anvender mailadressen i transfilen) og kan også ses på DBC Posthus.
  • datafiler med bestillinger: bestillingsfiler tjekkes for, om de overholder formatet for bestillinger. Er formatet ikke overholdt sendes en e-mail til afsenderen. Hvis det af tekniske årsager ikke er muligt at sende denne mail, vil biblioteket blive kontaktet af DBC

Vigtigt: Datafiler i datain-kataloget kan overskrives af nye filer med samme navn. Send derfor ikke nye filer med samme navn, før I har modtaget den første e-mail med status OK. Filer der strander i datain-kataloget vil automatisk blive fjernet efter 14 dage.

Til toppen


Eksempel på ftp-overførsel fra kommandoprompt

Nedenstående eksempel på tegnbaseret opkald til DBCs ftp-server kan anvendes både hvis overførslen sker fra tegnbaseret ftp-program på en PC eller fra en server, fx en UNIX-server. De ordrer brugeren skriver, står i eksemplerne sådan her: ftp. En indtastet kommando afsluttes med "Enter" eller "Return". Der sendes i eksemplet følgende filer:

  • datafil: 820020.034hs
  • transfil: 820020.trans

ftp>open ftp.dbc.dk
Connected to pan.dbc.dk.
220 pan FTP server (SunOS 5.7) ready
User (pan.dbc.dk:(none)): ftp
331 Guest login ok, send ident as password:
Password: ftp
230 Guest login ok, access restrictions apply.
ftp>binary
200 Type set to I.
ftp>send 820020.034hs datain/820020.034hs
local: 820020.034hs remote: datain/82002.034hs
200 PORT command successful.
150 Opening BINARY mode data connection for datain/820020.034hs
226 Transfer complete.
24167 bytes sent in 0.01 seconds (2.4e+03 Kbytes/s)
ftp>send 820020.trans datain/820020.trans
local: 820020.trans remote: datain/820020.trans
200 PORT command successful.
150 Opening BINARY mode data connection for datain/820020.trans.
226 Transfer complete.
173 bytes sent in 0.02 seconds (8.4 Kbytes/s)
ftp>quit
221 Goodbye.

Til toppen


Eksempel på automatisk overførsel ved brug af '.netrc'

ftp-overførsler kan automatiseres på mange måder. En af dem er ved hjælp af funktionen '.netrc' fra et UNIX-system.'.netrc' tilbyder at man automatisk, og uden at skulle give password, kan benytte ftp. Man opretter filen .netrc, som er en tekstfil, der skal se således ud:

  • machine ftp.dbc.dk login ftp password ftp

Filen .netrc skal være "read-only" for ejeren. Dette gøres med kommandoen:

  • $chmod 400 .netrc

Nu oprettes - fx i samme directory - en fil: "ftp.ordre" - det er en tekstfil, fx med følgende indhold:

  • binary
  • send 034hs datain/820020.034hs
  • send 820020.trans datain/820020.trans

Herefter kan man overføre filerne ved at skrive:

  • ftp>open ftp.dbc.dk < ftp.ordre

Denne ordre nedlægger også selv forbindelsen. Næste gang der skal overføres, er det kun nødvendigt at skrive ovenstående linie. Denne kommando kan så startes automatisk med et "cron"-job, fx til automatisk overførsel hver dag, hver uge eller hvad man nu ønsker. Nærmere vejledning i ".netrc" findes i online UNIX-manualen under "man netrc".

Til toppen


Kontakt DBC når I sender data første gang

Vi anbefaler at biblioteker (og bibliotekssystemer), der ikke har afleveret data til DBC før, altid kontakter DBC for at aftale testkørsler, inden egentlige dataleverancer går i gang.

Kontakt: