[cristin-ws.git] / README.txt

README.txt

Layout:
=======


Forutsetninger for å bygge kildekoden:
======================================

A) maven må være installert:
   http://maven.apache.org/download.html#Installation

B) - Kall $ mvn --version for å se at installasjonen var vellykket.

  NB! JAVA_HOME må kanskje referere til en 1.5-java

  Maven konfigureres to steder:
   - M2_HOME/conf/settings.xml (se linken ovenfor)
   - ${user.home}/.m2/settings.xml (user.home er brukers hjemmeområde)

   Felles konfigurasjon kan legges i M2_HOME/conf/settings.xml, mens
   konfigurasjon for en bruker bør legges inn i
   user.home/.m2/settings.xml

   (Hvis bare du bruker datamaskinen, står du fritt til å legge følgende hvor du vil)

C)  Legg til flg. under elementet <settings><profiles>:

    <profile>
      <id>frida</id>
      <activation>
        <activeByDefault>true</activeByDefault>
        </activation>
      <properties>
        <!-- 
	 sett jboss.home og jboss.server.config 
         slik at det passer din datamaskin 
        -->
        <frida.jboss.home>
	  /usr/local/jboss/jboss-5.0.1.GA-jdk6
	</frida.jboss.home>
        <frida.jboss.server.config>
	  default
	</frida.jboss.server.config>
        <!-- bruk jboss42x for jboss-4.2.3 og 4.3 -->
        <frida.jboss.containerId>jboss5x</frida.jboss.containerId>
      </properties>
    </profile>

D) kall "mvn" fra mappen som denne filen ligger i:
$ mvn package   // bygg war-fila
$ mvn install   // installer war-fila i lokalt repositorie
$ mvn cargo:deploy  // deploy til jboss

Du kan oppgi flere såkalte "maven goals" for en invokasjon:
$ mvn clean package cargo:deploy


Installasjon av Maven-plugin i Eclipse
======================================

Det finnes flere maven-plugins for Eclipse. Så vidt Leiv veit, er den
beste m2eclipse (http://m2eclipse.codehaus.org/)

Maven-pluginsene gjør forskjellig automatiske greier, så jeg anbefaler
å bruke kommandoen "mvn" fra kommandolinjen (det har i hvertfall Leiv
mest erfaring med :)

a) Naviger til Help -> Software Updates
b) velg tab "Available Software", klikk "Add Site"
c) Bruk URL: http://m2eclipse.sonatype.org/update/

Du skal nå få opp en ny tilgjengelig site med navnet "Maven
Integration for Eclipse Update Site". Ekspander denne og installer alt
som er Required. (Du må gjerne installere mer.)
Commit	Line	Data
af548221	1	README.txt
	2
	3	Layout:
	4	=======
	5
	6
	7
	8	Forutsetninger for å bygge kildekoden:
	9	======================================
	10
	11	A) maven må være installert:
	12	http://maven.apache.org/download.html#Installation
	13
	14	B) - Kall $ mvn --version for å se at installasjonen var vellykket.
	15
	16	NB! JAVA_HOME må kanskje referere til en 1.5-java
	17
	18	Maven konfigureres to steder:
	19	- M2_HOME/conf/settings.xml (se linken ovenfor)
	20	- ${user.home}/.m2/settings.xml (user.home er brukers hjemmeområde)
	21
	22	Felles konfigurasjon kan legges i M2_HOME/conf/settings.xml, mens
	23	konfigurasjon for en bruker bør legges inn i
	24	user.home/.m2/settings.xml
	25
	26	(Hvis bare du bruker datamaskinen, står du fritt til å legge følgende hvor du vil)
	27
	28	C) Legg til flg. under elementet <settings><profiles>:
	29
	30	<profile>
	31	<id>frida</id>
	32	<activation>
	33	<activeByDefault>true</activeByDefault>
	34	</activation>
	35	<properties>
	36	<!--
	37	sett jboss.home og jboss.server.config
	38	slik at det passer din datamaskin
	39	-->
	40	<frida.jboss.home>
	41	/usr/local/jboss/jboss-5.0.1.GA-jdk6
	42	</frida.jboss.home>
	43	<frida.jboss.server.config>
	44	default
	45	</frida.jboss.server.config>
	46	<!-- bruk jboss42x for jboss-4.2.3 og 4.3 -->
	47	<frida.jboss.containerId>jboss5x</frida.jboss.containerId>
	48	</properties>
	49	</profile>
	50
	51	D) kall "mvn" fra mappen som denne filen ligger i:
	52	$ mvn package // bygg war-fila
	53	$ mvn install // installer war-fila i lokalt repositorie
	54	$ mvn cargo:deploy // deploy til jboss
	55
	56	Du kan oppgi flere såkalte "maven goals" for en invokasjon:
	57	$ mvn clean package cargo:deploy
	58
	59
	60	Installasjon av Maven-plugin i Eclipse
	61	======================================
	62
	63	Det finnes flere maven-plugins for Eclipse. Så vidt Leiv veit, er den
	64	beste m2eclipse (http://m2eclipse.codehaus.org/)
65
66	Maven-pluginsene gjør forskjellig automatiske greier, så jeg anbefaler
67	å bruke kommandoen "mvn" fra kommandolinjen (det har i hvertfall Leiv
68	mest erfaring med :)
69
70	a) Naviger til Help -> Software Updates
71	b) velg tab "Available Software", klikk "Add Site"
72	c) Bruk URL: http://m2eclipse.sonatype.org/update/
73
74	Du skal nå få opp en ny tilgjengelig site med navnet "Maven
75	Integration for Eclipse Update Site". Ekspander denne og installer alt
76	som er Required. (Du må gjerne installere mer.)
77
78