Asta ingest er et verktøy som eksporterer data fra Asta5 til Asta7. Verktøyet kan hente ut arkivenheter, magasinstruktur, bestillinger (best å gjøre i én operasjon) og filer i hele baser, eller eksportere ut enkeltarkiver.
Ingest konfigureres opp mot en kjørende Oracle-database og Jboss server for å få tilgang til data. For å kunne hente ut filer, må Ingest bruke en tilgjengelig brukers innlogging (se application.yml).
Ingest krever java 17 eller nyere. Dersom en annen versjon av java ligger i java path, må det spesifiseres at ingest skal kjøre i en annen versjon av java som er installert (se run.sh).
Legg godt merke til tekst merket med rødt!
Innhold
Ingest kommer i en .zip-fil som inneholder:
Application.yml
Asta-ingest.versjon.jar
Run.bat
Run.sh
...
Mappen log dukker opp etter første eksport og inneholder loggfiler fra eksportene.
Asta-ingest.versjon.jar
Selve applikasjonen.
Application.yml
Konfigureringsfil, inneholder følgende:
...
Linje 8 settes til enabled : true
Linje 10 er Jboss-serverens adresse og port (kan slås opp i innstillinger.properties i mappen \ASTA5\klient)
Linje 11 endres til en gyldig innlogging dersom det skal hentes ut filer fra fillageret. Syntaks er DEPOTINST:BRUKER:PASSORD
Linje 13 er databasens adresse, og står som @lokal maskin, standardport 1521 og standardnavnet XE.
Hvis basen er en multitenant, bruk : i stedet for / før databasenavnet, f.eks:
/basenavn (standard)
:basenavn (multitenant)
Run.sh
Shell script med referanse til Java.
...
Dersom en eldre versjon enn Java17 eller nyere allerede er installert, og ligger i Java path, må referansen java endres til en annen Java.exe-fil, med full sti:
...
Run.bat
Starter applikasjonen og må kjøre hele tiden så lenge man skal bruke Ingest. Prosessen har startet opp når den nevner at AstaIngestApplication ble startet på X sekunder.
...
Grensesnitt
Når prosessen har startet opp og vinduet til Run.bat viser «Started AstaIngestApplication in X seconds» åpner du en nettleser og går til adresse localhost:7000.
...
Trykk deretter på Export from Asta5.
...
Archive units er arkivenheter på alle nivåer av strukturen (innhold i tabellen ARKIVENHET i Asta5)
Archive units må være på for at repository skal kunne hente ut noe data (grensesnittet tillater at kun repository er skrudd på, men den vil da hente ut tomme XML-filer. Se repository.)
Dersom Archive units er på, og feltet Archive Identifiers er tom, vil Ingest hente ut alle arkivene i basen.
Dersom det fylles inn gyldige identifikatorer, vil Ingest kun hente ut disse. Det må trykkes enter for å legge til en identifikator, slik at det blir en liten boks:
...
Ingest validerer ikke disse, så identifikatorer som ikke finnes i basen vil fremdeles eksporteres, men som XML-filer uten metadata.
NB! Ved eksportering av enkeltarkiver, må modusen Single Archive benyttes. Dette er fordi eksport av enkeltarkiver mangler en referanse til rotnode dersom dette gjøres med Archive units-eksport.
Prepend Institute ID with Archive Identifier legger til depotinstitusjonsID som prefiks på arkivenes identifikator. Arkiv A-1000 i depotinstitusjon ASTA blir da til ASTA-A-1000. Dette er primært for institusjoner som har operert med flere separate depotinstitusjoner i basen.
Single Archive henter ut ett enkeltarkiv man har en identifikator til. I denne modusen går det ikke an å trykke enter for å legge inn identifikator.
...
Files henter ut filer fra fillageret Jackrabbit-2.2. Dersom man ikke har en gyldig innlogging i application.yml, vil forsøkene på å eksportere filene få feilkode 401 Unauthorized from GET. Hvis det er referanser i klienten som er feil, og klienten derfor ikke finner filene, vil heller ikke Ingest kunne hente dem ut. Det vil da gi en annen feilmelding om at det ikke kan opprettes kobling.
Repository henter ut magasinstyringsmodulen. Den legger til feltene Organization Name, Project ID og Asta7 URL. Organization Name og Project ID må fylles ut for å starte eksporten, informasjonen i disse feltene kan overstyres i importen til Asta7. NB! Archive Units må være på for at requisition skal klare å hente ut noe data, ellers genereres det tomme XML-filer.
...
XML-filene for magasinstyringen havner i mappe data\repository i datapakken.
Requisition henter ut bestillinger og aktiverer de samme tilleggsfeltene som repository. Samme regel for utfylling av feltene gjelder her. Dersom Archive Units ikke er på, vil ikke Requisition kunne skrus på.
XML-filene for bestillinger havner i mappe data\requisition i datapakken.
Statusvindu
Vinduet viser prosentvis fremgang, antall eksporterte arkivenheter og totalt antall arkivenheter som eksporteres, samt tidsbruk. Eventuelle feilmeldinger listes opp under Failures. (antallet opplistede feil vil ikke samsvare med telleverket)
Nedlastingsknappen til høyre kopierer alle feilmeldingene til utklippstavle.
...
Når eksport er ferdig, sendes nedlastingsfil med navnet asta7-data.zip til nedlastingsmappe. Hvis eksporten er veldig stor, kan det hende det tar veldig lang tid å få fila sendt til nedlastinger. Den kan da hentes manuelt i temp-mappe for den brukeren man er logget inn som:
C:\Users\BRUKER\AppData\Local\Temp\
Filnavnet er en streng på 18 forskjellige tall:
...
Fila inneholder mapper med XML-filer avhengig av hvilke moduser man har aktivert:
Content inneholder arkivenheter og annen relatert metadata
Digital-file inneholder filer som er hentet ut fra fillageret
Repository inneholder magasinstyringen
Requsition inneholder bestillinger
XML-filene importeres inn i et prosjekt med sys-admin bruker.
Import
...
Installer siste versjon av Asta 7
...
Laste opp siste eksport av alt fra Asta 5 til Asta 7 instansen (på Docker vertsmaskin)
...
Endre passord på sys_admin og admin
...
Slette testbruker
...
Rotere nøkler
...
Endre app secrets
...
Legge inn rett URL for redirects
...
Omstart for å oppdatere secrets
...
Legge inn siste ISAD(G) template
...
Opprett organisasjon - F.eks. Min Organisasjon
...
Opprette isadg prosjekt og kjør init - Prosjekt navn: Min Organisasjon/isadg
...
Importere standard kodetabeller
...
Importer GUI innstillinger
...
Importer innhold
...
Legge inn tilpassede restriksjoner ved behov
...
Importer filer - cp fungerer ikke på stort innhold benytt - sudo rsync -avzh --inplace /data/uploads/data/digital-file/ /data/am-import-folder/am-project/isadg/hot/digital-file/
...
Importere bestillingshistorikk
...
Importere magasinstrying
...
Moved here: Eksportere Asta5-baser med Ingest