Mihho: dspace oppgradering 1.8 til 3.2

2014-02-03T13:24:16Z

dspace oppgradering 1.8 til 3.2

New page

Når en skal oppgradere en DSpace installasjon, så må en huske på en del ting.

Begynn med å lese her:
* https://wiki.duraspace.org/display/DSDOC3x/Upgrading+From+1.8.x+to+3.x

En antar at en har 2 maskiner. En som er i produksjon, fra nå av kalt: Prod, og en som er satt opp som en testboks, heretter kalt Test.

==Pakk ned PG databasen på Prod==
På Prod:
Kjør vanlig backup script, eller finn aktuell fil fra:
/dspace/pgbackup/
Kopier filen over til Test:
scp YYYYMMDD004001.test.sql brukernavn@test:/opt/sr/

==Importer database dataene inn i postgresql databasen==
På Test maskinen:
psql -U dspace-pg-bruker -f /opt/scr/YYYYMMDD004001.dspace.sql dspace

==Kjør Postgreql oppgraderingsscriptet==
På Test maskinen:
cd /opt/src/.../dspace/etc/postgres psql -U dspace-pg-bruker -f database_schema_18-3.sql dspace
hvor 18 står for versjon 1.8 og 3 står for versjon 3.

===Pakk filer på Prod===
På Prod:
tar -Jcvf dspace.txz bin/ config eksport/ etc/ handle-server lib/ reports/ scripts/ search/ sitemaps/ solr/ uib/ upload/ webapps/

==Flytt dspace.txz filen til Test (test maskin)==
På Prod:
scp dspace.txz brukernavn@test:/opt/src/

==Stopp Tomcat==
Husk at det er på Test boksen du skal stoppe Tomcat tjenesten, ikke i Prod :-)
service tomcat6 stop

==Klargjøre /dspace katalogen==
Om det finnes kataloger fra før under /dspace katalogen, så må disse fjernes. F.eks:
cd /dspace
mkdir OLD-DATA
mv * OLD-DATA/
Deretter pakker en ut dspace.txz ut i /dspace katalogen:
cd /dspace
tar xJvf bora.txz

==Git seksjon==
I og med at konfigurasjonsfiler endrer seg, kan det være lurt å bruke git for å se hvilke endringer som gjøres.
===Lag .gitignore fil===
Ikke alle filer skal med. Dette er en mulige kataloger og filtyper som skal være i en .gitignore fil:
bin
assetstore
lib
log
webapps
*.class
*.jar
*.war

Om en lurer på hvilke filtyper (filer med filendelse) som finnes i en gitt katalog, så kan en kjøre:
find . -type f | sed 's/^\.\/.*\///g' | egrep '\.' | sed 's/^.*\.//g' | sort | uniq | sort

Om har kjørt en test oppgradering, så kan en sjekke hvilke typer filer som er endret ved å kjøre:
find . -type f -name '*.old'

Dermed vet en hvilke filer som blir endret. Nå kan en gjøre følgende:

Finn hvilke filer som ble endret, og som ble kopiert over til en .old fil:
for i in `find . -type f -name '*.old'`; do echo $i|sed 's/\-20131008-103340\.old//g'; done

Lagre listen av filene i en fil
endredefiler.list

Sjekk at filene som ble funnet og hadde .old filendelse faktisk eksisterer:
for j in `cat endredefiler18-32.list`;do ls -al $j;done

Legg filene en og en til git:
for j in `cat endredefiler18-32.list`;do git add -f $j;done
for j in `cat endredefiler18-32.list`;do git commit -m "$j" $j;done

===Legg til filer til git===
git init
git add -f .
git commit -m "Kommentar: nu legger vi til 1.8 versjonen av konfigurasjonsfilene med mer for klargjøring av DSpace oppgradering til versjon 3.2" .

==Klargjøre java==
Husk å sjekke at rett java er valgt som default:
alternatives --config java
Om en bruker samme versjon som oss, så må en velge:
/usr/lib/jvm/jre-1.7.0-openjdk.x86_64/bin/java

===can't find tools.jar===
Løsning:
yum list installed | grep jdk
om devel pakken ikke er installert så:
yum -y install java-1.7.0-openjdk-devel

==Kjør oppgraderingen==
cd /opt/src/bora-3.2-src/dspace/target/dspace-3.2-build
ant update

==.old filene==
Etter oppgraderingen (ant update), så ser en at det er mange .old filer i diverse kataloger. Disse blir laget ved at gamle config filer får nytt navn til .old.
Det betyr at de nye cfg filene som lages, ikke innehar de evt. Endringene som en la inn I forrige versjon.
Det betyr igjen at en må se på de endringene som er gjort, og diff eller git kan være verktøy som en kan bruke.
Dersom en har gjort jobben nevnt over med git, så kan en nå gjøre:
git status
git diff filnavn
for å se hva som er forskjellig i de ulike filene mellom versjon 1.8 og 3.2.

==Konfigurasjonsfiler==
Filer som kan være lurt å se nærmere på, både før og etter en oppgradering fra 1.8 til 3.2. Det er absolutt anbefalt å tracke endringer både før og etter med et versjonkontroll [[git]].
Husk at filer kan endre seg både i /dspace installasjonskatalogen, og i /opt/src/dspace (source katalogen). Mulig at to git repoer kan være nyttig.
config/dspace.cfg
config/modules/authentication-ldap.cfg
config/log4j-handle-plugin.properties
config/log4j.properties
config/modules/authentication.cfg
config/modules/discovery.cfg
config/modules/oai.cfg
config/modules/solr-statistics.cfg

config/item-submission.xml
config/input-forms.xml
config/modules/sword-client.cfg
config/modules/sword-server.cfg
config/modules/swordv2-server.cfg
config/news-xmlui.xml
config/xmlui.xconf

solr/search/conf/solrconfig.xml
solr/statistics/conf/schema.xml

==Vedlikeholds scripts (bash)==
Vedlikeholdsscript kan være nyttig å ha dersom en må gjenta en del kommandoer ved jevne mellom. IT avdelingen ved UiB har 2 script som vi benytter i våre DSpace installasjoner:
* redeploy.sh
* reindex_systemnavn.sh

Når en går over til ny versjon, så er det viktig at en oppdaterer stier m.m i scriptene redeploy.sh og reindex_systemnavn.sh.
Les mer om disse scriptene her: [[DSpace drift]]

[[Kategori:DSpace]]

DSpace oppgradering - Revision history

Mihho: dspace oppgradering 1.8 til 3.2