Install Guide

This page will be in danish, as the original material was in danish. Will be translated later.

Pakken

Det her er første nyere forsøg på at overdrage doms systemet til drift. Det vi ønsker at overdrage ligger (i flere udgaver) på fedora@alhena:/fedora/TilTom

I den mappe ligger der

1. En doms installer, i zip form
2. En doms installer, unzipped
3. En "package"
4. Et installeret system "installed"

De to sidste ting er nok de mest underlige, så jeg vil lige forklare noget mere om dem.

Doms testbedden har to vigtige setup filer.

1. package.sh
2. install.sh

package.sh gør alt det det der kan gøres, uden at installere en tomcat, eller starte noget. Install.sh installerer så en tomcat, starter den og ingester de basis objekter der skal være der.

Brugen er således ./package.sh /path/to/where/the/doms/should/be

Ud over temp filer, som forhåbentligt bliver ryddet op igen, skriver de IKKE TIL NOGEN ADRESSER UDENFOR DEN ANGIVNE. Dvs. de bibeholder systemet "rent".

install.sh er meget simpel, den installerer en tomcat, kalder package til at gøre alt arbejdet, og afslutter med at ingeste basis objecterne i den nye doms.

package.sh bliver styret fra config/conf.sh, hvor man angiver værdien af de variable der skal sættes overalt i config filerne. Hvis det virkeligt er vigtigt kan jeg godt spore til jer, hvordan alle informationerne i conf.sh bliver distribueret.

Nu til de indeholdte ting, og hvad vi gør og forventer af dem.

TOMCAT

Doms bruger en standard tomcat 6.0.20. Hvis du bruger en anden version, burde de ikke gøre så meget, men det skal helst være en 6'er.

Vi overskriver et par konfig filer fra tomcat, og tilføjer nogen andre.

Det her er dem vi overskriver

1. server.xml (vores version vedhæftet).
2. tomcat-users.xml (ligegyldig, vi har bare haft brug for at være manager i test situationer)
3. setenv.sh (vedhæftet. Sætter en ENV_VAR til fedora, og lidt om memory krav)

Så tilføjer vi nogen flere, fordi vi bruger tomcat/conf/ til config filer for de deployede webservices.

De primære her er

1. context.xml (vedhæftet)
2. log4j.*.xml (log config filer til hver webapp)

Det er context.xml der angiver hvilken af de mange log4j config filer hver webapp skal bruge.

I kan se i "packaged" mappen at der ligger et tomcat dir. Det indeholder præcis de ting vi lægger ind i tomcat, men er ellers tomt. Brug det til at se hvad vi retter ved en tomcat.

ALMINDELIGE WEBAPPS

Der er et antal almindelige webapps, som domsen benytter sig af. Disse har ikke specielle krav. De lever i tomcatten og bliver styret vha. context.xml

Listen er, så vidt jeg husker

1. ecm
2. surveillance
3. pidGenerator
4. authChecker
5. characteriser
6. lowlevel
7. highlevel
8. central
9. updatetracker

10. IpRoleMapper

IPRoleMapper er med, men den forsvinder så snart der er en version i rigtig drift som domsen kan trække på.

FEDORA

Fedora er sjov, eller noget. Den består af to ting.

1. En webapp
2. En datafolder

Udover det forventer fedora også at have en database tilgængelig.

Efter installeren har kørt, har vi pakket en fedora.war til jer, som er sat korrekt op, og som burde kunne redeployes frit. Den ligger i fedora/install/fedora.war. Den er også kopieret over i tomcattens webapps. fedora-original.war er fedora.war uden de ændringer vi har lavet.

Her er de relevante mapper, i forhold til fedora

• fedora/server/logs (fedoras logfiler)
• fedora/server/config (fedoras config filer)
• fedora/data (her gemmes alt data og caches som fedora selv styrer)

Den primære configfil til fedora er fedora/server/config/fedora.fcfg Jeg har vedhæftet en sample, hvor I kan se hvor man skal rette i ting. Det installerede system har også en færdig config fil. Det er bl.a. i denne config fil at man angiver database configurationen.

DATABASEN

Fedora baserer sig bla. på en database. Dette kan for DOMS tilfælde være enten en indbygget derby database, eller en postgresql database. Hvilken type der bruges styres i conf.sh. Hvis fedora er nyinstalleret fylder den databasen ved første opstart. Det er derfor vigtigt at databasen er tom, inden fedora starter op første gang. Man tømmer og opretter databasen med denne kommando.

fedora$ dropdb -h localhost -U doms-test78 doms-test78
fedora$ createdb -h localhost -U doms-test78 -O doms-test78 doms-test78

BASE OBJECTS

Med de her ting, så er systemet faktisk sat op. Nu mangler vi bare at tænde for tomcatten, og tilføje basis objekterne. Dette gøres med denne stump script, som også er det sidste i install.sh

#
# Start the tomcat server
#
echo ""
echo "Starting the tomcat server"
$TESTBED_DIR/tomcat/bin/startup.sh > /dev/null
echo "Sleep 30"
sleep 30

#
# Ingest initial objects
#
echo "Ingesting base objects"
export FEDORA_HOME=$FEDORA_DIR
sh $FEDORA_DIR/client/bin/fedora-ingest.sh dir \
$BASEDIR/data/objects \
'info:fedora/fedora-system:FOXML-1.1' \
localhost:${PORTRANGE}80 $FEDORAADMIN $FEDORAADMINPASS http

Den skulle gerne skrive noget om at 20 objecter er blevet ingested successfully. Hvis det virker, plejer doms systemet at virke.

Så er doms systemet installeret.