4. Experior - rich test editor for FitNesse -
4.1. Forord Denne rapporten inneholder installasjonsveiledning for Experior. Experior er tilpasset for installasjon i oppdragsgivers utviklingsmiljø. Det er likevel mulig å installere utenfor oppdragsgivers miljø, ut fra vedlagte CD, men det krever visse forberedelser. Dette er forklart i denne rapporten. en er primært beregnet på de som ønsker å prøve ut produktet utenfor oppdragsgivers utviklingsmiljø. Det forutsettes at leseren er kjent med grunnleggende bruk av PC og internett som verktøy. Det er også en fordel om han er vant til å gi tekstlige kommandoer via et terminalvindu. For å få utnyttet alt av Experiors funksjonalitet må nettleseren Mozilla Firefox benyttes. 2
4.2. Innhold 4.1. Forord... 2 4.2. Innhold... 3 4.3. Installasjon... 4 4.3.1.Installasjon av Maven på Windows... 4 4.3.2.Installasjon av Maven på Linux... 9 4.3.3.Installasjon av FitNesse og Experior... 9 3
4.3. Installasjon Som nevnt i øvrig dokumentasjon er selve Experior bygget ved hjelp av Apache Maven, som også benyttes hos oppdragsgiver. For å gjøre bruk av Experior i den versjonen som ligger på vedlagte CD er det derfor nødvendig at Maven installeres på den maskinen hvor Experior skal brukes. Hvordan dette gjøres er trinnvis forklart nedenfor. 4.3.1. Installasjon av Maven på Windows Filene som behøves av Maven ligger på vedlagte CD. Det forutsettes at Java Development Kit (JDK) er installert på maskinen. Dersom dette ikke er tilfelle kan den lastes ned og installeres fra http://java.sun.com/javase/downloads/index.jsp 1. Kopier mappen apache-maven-2.1.0 fra CD-en til en fritt valgt mappe på din PC. I dette eksemplet benyttes D:\Maven. Hvis du benytter deg av en annen mappe må du bruke denne alle steder det er nevnt D:\Maven i denne rapporten. Noter deg gjerne stien til mappen hvor du plasserte Maven. Denne får du bruk for senere. 2. Windows Vista: Klikk på Windows-symbolet nederst til venstre. Høyreklikk deretter på Datamaskin. Velg Egenskaper. Figur 1: Velg Windows-tasten, Datamaskin og Egenskaper på Windows Vista 4
Windows XP: Windows-symbolet er erstattet med Start-menyen, og Datamaskin med Min datamaskin, ellers tilsvarende. Figur 2: Velg Start-menyen, Min datamaskin og Egenskaper på Windows XP 3. Windows Vista: I vinduet som nå vises velger du Avanserte systeminnstillinger i menyen til venstre. Figur 3: Velg avanserte systeminnstillinger Windows XP: Hopp over dette punktet. 4. Windows Vista/Windows XP: Vinduet Systemegenskaper vises nå. Se figur 4. Trykk nå på knappen Miljøvariabler nederst til høyre. Figur 4: Velg Avansert og Miljøvariabler 5
5. Windows Vista/Windows XP: Vinduet Miljøvariabler, som nå vises, er delt i to deler. Se figur 5. Figur 5: Vinduet Miljøvariabler I den øverste delen, Brukervariabler, trykker du knappen Ny. Skriv inn følgende i vinduet som nå vises: Figur 6: Fyll inn verdiene. Bytt eventuelt ut det som står i Variabelverdi med navnet på din egen mappe, dersom du har valgt noe annet i punkt 1 Trykk OK. 6. Windows Vista/Windows XP: Gjør punkt 5 om igjen, men denne gangen med følgende verdier: 6
Figur 7: Fyll inn verdiene. 7. Windows Vista/Windows XP: Nederste del av vinduet Miljøvariabler, nevnt i punkt 5, består av Systemvariabler. Let deg frem i listen til du finner Path. Figur 8: Velg Path Velg Path og trykk på Rediger. 8. Windows Vista/Windows XP: I vinduet som nå vises, trykk i feltet Variabelverdi. Her står det antageligvis tekst fra før. Trykk med piltastene på tastaturet til markøren står helt til slutt i teksten som står der fra før. Skriv inn følgende: ;D:\Maven\apache-maven-2.1.0\bin Semikolonet før D brukes for å skille de ulike verdiene som står i feltet fra hverandre. Dersom feltet var tomt før du begynte å skrive kan dette fjernes. Trykk OK. 7
Figur 9: Skriv inn verdien i feltet Variabelverdi 9. Windows Vista/Windows XP: For at Maven skal virke riktig må JAVA_HOME finnes i samme liste som du fant Path i punkt 7. Dersom den ikke finnes må du legge den til. Dette er forklart i neste punkt. Dersom den finnes er installasjonen av Maven nå fullført. 10. Windows Vista/Windows XP: Finn ut hvor din JDK er installert. Typisk er dette i C:\Program Files<eventuelt Programfiler>\Java. Foreta ellers et søk på din maskin. 11. I Systemvariabler, nevnt i punkt 7, trykk Ny. I vinduet som vises skriver du inn følgende: Figur 10: Ny systemvariabel Bytt eventuelt ut det som står i Variabelverdi til det som passer din installasjon av JDK. 12. Maven er nå ferdig installert! Sjekk at alt fungerer ved å åpne opp et terminalvindu, med for eksempel Windows-symbolet (Start-meny for Windows XP) -> Alle programmer -> Tilbehør -> Ledetekst. Skriv følgende kommando: mvn --version Tilsvarende bekreftelse som i figur 11 skal nå vises. 8
Figur 11: Bekreftelse på at Maven er korrekt installert 4.3.2. Installasjon av Maven på Linux Åpne et terminalvindu og kjør kommandoen sudo apt-get install maven2. Fyll inn evntuelt root-passord dersom du blir bedt om det. Figur 12: Installasjons av Maven på Linux Sjekk at Maven ble korrekt installert ved å kjøre kommandoen mvn --version. 4.3.3. Installasjon av FitNesse og Experior FitNesse og Experior kan installeres i en og samme operasjon. Samme fremgangsmåte gjelder for både Windows Vista, Windows XP og Linux. 1. Kopier mappen experior fra CD-en til fritt valgt mappe på din PC. I dette eksemplet benyttes C:\Documents and Settings\Bruker. 2. Åpne opp et terminalvindu. På Windows kan dette gjøres med for eksempel Windows-symbolet (Start-meny for Windows XP) -> Alle programmer -> Tilbehør -> Ledetekst. Det forutsettes at Linux-brukere er kjent med hvordan man åpner et terminalvindu på sin egen Linux-distribusjon. 3. Naviger deg frem til mappen der du plasserte mappen experior med kommandoen cd og ønsket mappe. Eksempel: Du har åpnet et 9
terminalvindu og dette viser at du står i mappen C:\Documents and Settings. Naviger deg da til mappen experior med kommandoen cd Bruker\experior. Du kan flytte deg til mappen over der du nå befinner deg med kommandoen cd.. Kontroller at du er i riktig mappe med kommandoen dir. Tilsvarende som i figur 13 skal da vises. Figur 13: Kontroller at du befinner deg i riktig mappe 4. Kjør kommandoen mvn clean install Maven setter da i gang med bygging av prosjektet. Dette kan ta noen minutter og tekst vil skrives til vinduet. 5. Flytt deg inn i mappen experior-testapp med kommandoen cd experiortestapp 6. Kjør kommandoen mvn test -P fitnesse Maven starter nå opp prosjektet og en del tekst vil skrives ut i vinduet. Når alt er fullført vil følgende vindu dukke opp øverst til venstre på skjermen: Webserveren i FitNesse er nå i gang, og FitNesse kjører. Denne knappen kan benyttes til å stoppe serveren. 7. Åpne opp nettleseren Mozilla Firefox. Skriv inn adressen http://localhost:8080/kravtester.addisjontest Du vil da komme inn i FitNesse og det vil vises et eksempel som er laget for å illustrere Experiors funksjonalitet. For en innføring i hvordan Experior kan benyttes henviser vi til brukerveiledningen. 10
11