Krav på ditt system

Du måste ha Suns SDK 1.3 (tidigare kallat JDK), Windows NT/2000 och Microsofts IIS 4/5 installerat. Resin ska även fungera med Windows 9x/ME och PWS (Personal Web Server) men denna beskrivning bygger på Windows NT/2000. Du behöver (antagligen) även ett nätverkskort (även om du inte har ett nätverk) - jag har inte provat utan nätverkskort!

Installera mjukvaran

1. Packa upp ZIP-filen och kopiera till en mapp under t.ex. C:\PROGRAM (t.ex. RESIN - refereras till som <rotmapp> i resten av beskrivningen).
    
2. Starta programmet HTTPD.EXE i mappen <rotmapp>\BIN. Två fönster öppnas: ett med själva servern (teckenbaserat) och ett som visar status (på/av) för servern. Med det andra fönstret kan man starta och stoppa server samt stänga av server-applikationen.
    
3. Starta en webbläsare och öppna URL:en
    
   http://localhost:8080/
    
   En välkomstsida med bl.a. texten "Welcome to Resin" ska visas.
    
4. När du är klar stänger du server-applikationen genom att klicka på knappen Quit (i det mindre av de två fönstren som öppnades då applikation startades).

| Till början på sidan |

Installera servern som plug-in till IIS

Orsaken att man vill installera Resin-servern som en plug-in till en annan webbserver är att man då slipper behöva ange port (8080) när man vill exekvera en JSP-sida eller servlet. Alla begäran om JSP-sidor och servlets skickas vidare, av ordninarie webbserver, till servlet- och JSP-servern.

1. Kör SETUP.EXE i mappen <rotmapp>\BIN.
    
2. Kontrollera att sökvägen till Resin-serverns mjukvara och till mappen SCRIPT under dokumentroten för IIS/PWS stämmer.
    
3. Klicka på OK för att stänga programmet. Du får då frågan om du vill starta om IIS för att ändringarna ska gälla. Svara Ja på den frågan. Programmet stängs.
    
4. Kontrollera att servern fungerar som en plug-in genom att öppna en webbläsare och öppna URL:en
    
   http://localhost/servlet/HelloServlet och
   http://localhost/examples/basic/hello.jsp
    
   En sida med texten "Hello, world!" ska visas (servleten brukar ha en lila bakgrundsfärg).
    
5. När du är klar stänger du server-applikationen genom att klicka på knappen Quit (i det mindre av de två fönstren som öppnades då applikation startades).

Om du inte kan öppna URL:erna ovan så bör du kontrollera att IIS startats om (eller rent utav att den startats igen, inte bara stängts av av SETUP.EXE). Tjänsten heter "World Wide Web Publishing Service" under Tjänster i Kontrollpanelen.

| Till början på sidan |

Installera servern som en tjänst

Fördelen med att använda tjänster i Windows NT/2000 är att de kan startas automatiskt då Windows startas, d.v.s. man behöver inte logga på datorn och starta applikationen. (Man kan ändra så att tjänsten måste startas manuellt om man inte vill ha igång den hela tiden - ändra tjänstens startmetod från Automatiskt till Manuellt.) En annan fördel är att man slipper de två fönstren som öppnas när man kör HTTPD.EXE.

1. Öppna en kommandotolk och byt till mappen <rotmapp>\BIN.
    
2. Skriv HTTPD -install för att installera tjänsten. En dialogruta med texten "Installed ResinSrun as an NT service" visas. Klicka på OK för att stänga dialogrutan. (Med äldre versioner av Resin så skrev man SRUN -install.)
    
3. Öppna Tjänster i Kontrollpanelen och starta tjänsten. Tjänsten heter "Resin Servlet Runner".
    
4. Testa servern genom att starta en webbläsare och öppna URL:erna i punkt 4 ovan.
    
5. Eftersom servern är startad som en tjänst behöver du varken starta eller stoppa servern mer. Om du inte vill att tjänsten ska vara igång hela tiden (den använder ju primärminne!) kan du ändra tjänstens startmetod till Manuellt i Tjänster i Kontrollpanelen. Då kan du starta tjänsten (när du vill använda servern) i Tjänster eller genom att skriva
    
   NET START RESIN
    
   i kommandotolken (eller under Kör... på Start-menyn). För att stoppa tjänsten ersätter man START med STOP i kommandotolken. (Med äldre versioner av Resin så hette tjänster RESINRUN.)

| Till början på sidan |

Konfigurera en egen web-app under dokumentroten på IIS

För att placera en webbapplikation (web-app eller servlet context) under IIS:s dokumentrot måste vi skapa en mapp där JSP-sidor och klassfiler med servlets ska ligga. I beskrivningen nedan använder vi en mapp som heter JAVA och som ligger direkt i dokumentroten.

Konfigurationsfilen är skriven i XML-format, d.v.s. syntaxen måste vara riktig för att servern ska starta. Filen finns i <rotmapp>\CONF och heter RESIN.CONF.

1. Öppna konfigurationsfilen. Filen är inte skapad enligt "Windows-standard" vilket leder till att en del program inte visar radbrytningar som de bör, t.ex. Anteckningar (Notepad) visas ibland radbrytningarna som ihåliga rektanglar. (Själv använde jag JCreator att redigera filen med - ett mycket mångsidigt program. :-)
    
2. Leta upp avslutande taggen </host> (nära slutet på filen) och lägg till koden med fet stil nedan.
    
   <web-app id='/examples/login'/>
    
   <!-- START TILLÄGG: Lägg till nedanstående rader --->
    
   <web-app id='/java' app-dir='C:\Inetpub\wwwroot\java'>
     <servlet-mapping url-pattern='/servlet/*'
         servlet-name='invoker'/>
   </web-app>
    
   <!-- SLUT TILLÄGG -->
    
   </host>
    
3. Skapa en mapp WEB-INF i mappen JAVA och sen en mapp CLASSES i mappen WEB-INF.
    
4. Spara filen och starta om servern (antingen genom att klicka på Stop och sen Start i server-applikationen eller genom att starta om tjänsten).
    
5. Prova genom att placera klassfilen för en servlet i mappen CLASSES och öppna URL:en
    
   http://localhost:8080/java/servlet/ServletNamn

| Till början på sidan |

Övrigt

Servern kan, bortsett från JSP-sidor och servlets, även "visa" vanliga HTML-sidor (dock inte lika effektivt som andra webbservrar!). Du behöver m.a.o. inte installera IIS/PWS om du nöjer dig med bara Resin. Kom då bara ihåg att alltid ange porten 8080 i alla sökvägar! (t.ex. http://localhost:8080/MinSida.html).

Dokumentroten för webbservern är som standard i mappen DOC under "huvudmappen" (<rotmapp>) för mjukvaran. Om du inte vill använda en vanlig webbserver kan du m.a.o. placera alla dina filer i denna mapp (samt skapa undermappar till den).

Tänker du använda Java Beans med Resin så måste du använda direktivet import för att importera klassen för dina Java Beans!

| Till början på sidan | Tillbaka till Java |

Skapad av: Björn G D Persson. Uppdaterad: 2005-05-07.