Installasjonsveiledning Magne Rodem og Jan-Erik Strøm 18. juni 2006
Innhold 1 Installasjon av Web Service 3 1.1 Krav........................................... 3 1.2 Installasjon av Sun Java System Application Server.................. 3 1.3 Oppstart av applikasjonstjener............................. 3 1.4 Konfigurer databasetilkobling.............................. 3 1.5 Deploy applikasjon................................... 4 1.6 Problemløsning..................................... 4 2 Installasjon av J2ME-applikasjon 5 2.1 Krav........................................... 5 2.2 Konfigurasjon...................................... 5 2.3 Installasjon og kjøring................................. 5 2
1 Installasjon av Web Service 1.1 Krav Web Service-applikasjonen er implementert som en J2EE-applikasjon. Dette innebærer at applikasjonen er avhengig av en J2EE applikasjonstjener. Det eksisterer flere ulike applikasjonstjenere, men i denne installasjonsveiledningen vil vi forholde oss til Sun Java System Application Server. Applikasjonen benytter en standard databaseimplementasjon som er avhengig av å ha tilgang til en database. Denne databasen må inneholde tabellene som er beskrevet i systemets kravspesifikasjon. Disse tabellene kan opprettes ved å benytte SQL-scriptet create.sql som beskrevet. Applikasjonen og create.sql-scriptet er kun testet mot databasesystemet MySQL, men de aller fleste databasesystemer skal kunne benyttes. 1.2 Installasjon av Sun Java System Application Server Sun Java System Application Server Platform Edition er fritt tilgjengelig for nedlasting fra nettsiden http://java.sun.com/j2ee/1.4/download.html. Kjør installasjonsfilen og følg instruksjonene på skjermen. Underveis i installasjonen vil du bli spurt om å taste inn administratorbruker og passord. Dette vil du få bruk for senere. 1.3 Oppstart av applikasjonstjener Først bør du sørge for at katalogen [appserver-katalog]/bin er lagt til i din PATH-variabel. Katalogen inneholder programmer som blant annet benyttes for starting, stopping og kommunikasjon mot din applikasjonstjener. Start applikasjonstjeneren med kommandoen: asadmin start-domain domain1 Du bør nå få en melding som ligner på denne: Starting Domain domain1, please wait. Log redirected to /usr/local/j2ee1.4/domains/domain1/logs/server.log. Domain domain1 is ready to receive client requests. Additional services are being started in background. 1.4 Konfigurer databasetilkobling Vi går ut fra at du har tilgang til en databasetjener, og at denne kan aksesseres fra maskinen der applikasjonstjeneren kjører. Dersom du ønsker å benytte standard databaseimplementasjon som beskrevet i systemets kravspesifikasjon, kan du benytte SQL-scriptet create.sql som ligger i katalogen applikasjoner på CD en. Ved å kjøre dette vil tabeller og testdata legges inn i databasen for deg automatisk. Du kan 3
selvfølgelig også opprette tabellene manuelt. Etter at tabellene er lagt inn, er det tid for å konfigurere applikasjonstjeneren til å benytte din database. Sun Java System Application Server kan konfigureres via et webgrensesnitt som finnes på adressen: http://[din-ip-adresse]:4848. Her blir du bedt om å taste inn brukernavn og passord for administrator. Dette spesifiserte du da du installerte applikasjonstjeneren. Etter at du har logget inn må du først opprette en databasepool. Velg Resources, JDBC, Connection Pools. Klikk New og tast inn navnet ContactDatabasePool. Velg Resource Type til å være klassen javax.sql.datasource, velg riktig databasesystem og klikk Next. Du blir nå bedt om å taste inn klassenavnet for DataSource-implementasjonen som skal benyttes. Hvis du er usikker på hvilken klasse som skal benyttes, så sjekk API-dokumentasjonen for databasedriverne for å finne ut dette. Klikk Next. Deretter får du mulighet til å spesifisere en rekke innstillinger for databasepoolen. Det viktigste her er Properties-seksjonen som du finner nederst på siden. Her må du taste inn innstillingene for databasen du benytter. Tast inn brukernavn, databasenavn, passord, tjenernavn og eventuelle andre detaljer. Når du er ferdig, klikker du Finish. Du har nå opprettet en databasepool, men du må koble denne opp mot JNDI-navnet som er brukt i applikasjonen. Velg JDBC Resources og klikk New. Web Service-modulen benytter (som standard) JNDI-navnet jdbc/contactdatabase. Tast inn dette, velg databasepoolen du opprettet i sted og klikk OK. Hvis du har gjort alt riktig, vil applikasjonen nå kunne aksessere din database. Merk at applikasjonstjeneren må ha databasedriverne for ditt databasesystem i sin CLASSPATH. Dette kan du enkelt ordne ved å kopiere JAR-filen med databasedriverne inn i [appserver-katalog]/lib og starte tjeneren på nytt. 1.5 Deploy applikasjon Så er tiden inne for å deploy e applikasjonen i applikasjonstjeneren. For å deploy e applikasjonen må du først finne fram til dens EAR-fil. Denne finner du i katalogen applikasjoner/webservice. Kjør så følgende kommando: asadmin deploy --user [adminbrukernavn] WebServiceApplication.ear. Hvis alt gikk bra, vil du få meldingen: Command executed successfully. Applikasjonen er nå deploy et, og Web Service en vil kunne aksesseres fra klientapplikasjonene. 1.6 Problemløsning Hvis applikasjonen ikke fungerer som den skal, og du mener du har fulgt installasjonsveiledningen til punkt og prikke, så kan det være en god idé å sjekke applikasjonstjenerens loggfil. Innholdet i denne gir ofte en god indikasjon på hva som kan være galt. Loggfilen ligger på [appserver-katalog]/domains/domain1/logs/server.log. 4
2 Installasjon av J2ME-applikasjon 2.1 Krav For å kunne kjøre J2ME-applikasjonen, trenger du en mobiltelefon som støtter MIDP 2.0-spesifikasjonen. Applikasjonen er kun testet på K500i og K750i, men skal fungere på alle MIDP 2.0-telefoner. Sjekk spesifikasjonene for din telefon for å finne ut om dette er støttet. Et alternativ er å benytte en emulator på PC. En slik emulator følger med i J2ME Wireless Toolkit som kan hentes fra denne nettsiden: http://java.sun.com/products/sjwtoolkit/download.html. 2.2 Konfigurasjon Vi antar nå at du har deploy et Web Service-applikasjonen som beskrevet i kapittel 1. I katalogen applikasjoner/mobile på CD en ligger JAR- og JAD-filene for J2ME-applikasjonen. JAD-filen inneholder blant annet innstillinger for oppkobling mot Web Service en. I en reell situasjon vil innholdet i denne filen være riktig konfigurert allerede når applikasjonen lastes ned (beskrevet i prosjektets designdokument), men siden dette er en prototyp, må innstillingene legges inn manuelt. Åpne filen ProffKlient.jad i en teksteditor og fyll inn verdier for ProffKlient-phonenumber, ProffKlientpassword og ProffKlient-serverurl. Disse angir henholdsvis brukerens telefonnummer, passord og Web Service ens URL. Telefonnummeret og passordet må tilhøre en kontakt i kontaktdatabasen. Dersom du fulgte veiledningen for installasjon av applikasjonstjeneren, vil Web Service ens URL være på følgende form: http://[serverens-ip]:8080/webservice/contactwebservice?wsdl Nå er applikasjonen klar til bruk. 2.3 Installasjon og kjøring Etter at applikasjonen er konfigurert, kan du overføre den til din mobiltelefon. Du kan f.eks. legge applikasjonen ut på en webtjener og laste den ned derfra, eller du kan overføre applikasjonen til telefonen direkte med f.eks. IR eller en USB-kabel. Du kan også kjøre applikasjonen på din PC ved hjelp av en emulator. I J2ME Wireless Toolkit følger det med en snarvei kalt Run MIDlet application (i Linux kan man bruke scriptet runmidlet). Når du starter dette scriptet, blir du bedt om å angi lokasjon for applikasjonens JAD-fil. Velg applikasjonens JAD-fil og klikk Run. Emulatoren vil nå starte, og du vil få mulighet til å kjøre applikasjonen. Merk: Dersom din telefon ikke har soft buttons, eller hvis disse ikke fungerer, kan du benytte 1- og 3-tastene i stedet. På samme måte kan du benytte 5-tasten dersom din select -tast ikke fungerer eller dersom denne ikke eksisterer. 5