BOULEVARDEN 19E 7100 VEJLE LERSØ PARKALLE 101 2100 KØBENHAVN Ø TLF. 76 42 11 00 WWW.UNIK.DK Webservices Installationsvejledning
Indholdsfortegnelse Indholdsfortegnelse... 1 Formål... 2 Nyt fra version 4.4.0 og frem... 2 Forudsætninger... 2 Installation... 3 Installation af Windows Server 2012... 3 Program Installation af Unik WebServices... 9 Caching... 24 1 af 25
Formål Dette dokument indeholder oplysninger vedrørende installation af Unik webservices. Du bør gennemlæse dette dokument, inden du installerer webservice applikationen. Der findes en generel vejledning med information, der er fælles for alle webløsningerne, samt webservice applikationen. Nyt fra version 4.4.0 og frem Fra version 4.4.0 understøtter vi AutoStart funktionen i ASP.NET 4 og IIS 7.5. AutoStart funktionen gør den første sidevisning, efter applikationen er startet, langt hurtigere, fordi applikationen foretager en lang række initialiseringsopgaver så snart den starter og dermed før den første forespørgsel. I tidligere versioner blev disse initialiseringsopgaver først udført i forbindelse med den første forespørgsel, hvilket kunne gøre, at den tog væsentlig længere tid end de efterfølgende. AutoStart kræver lidt manuel konfiguration i IIS. Hvis denne konfiguration ikke foretages, fungerer løsningen som tidligere. Fra version 4.4.0 har vi lavet et værktøj, der hedder Tema Designer, som typisk bruges af webdesignere. Når man gennemgår installationstrinene bliver man nu spurgt om hvilket applikationsmodul, løsningen skal bruge. Ved en normal installation skal man vælge "Unik Bolig 4 Web Applikation". IIS 6 Management Compatibility er ikke længere krævet. Forudsætninger Programmet Unik Bolig 4 Opdateringskontrol kan kontrollere om en server er klar til at køre Unik Bolig 4 webservice applikationen og herunder kontrollere om de krævede udvidelser til Microsoft Windows er installeret. Fra Unik Bolig 4 Opdateringskontrol er der link til alle krævede udvidelser. For yderligere information om Unik Bolig 4 Opdateringskontrol henvises til vejledningen for Unik Bolig 4 Opdateringskontrol. Følgende tabeller lister specifikke tekniske krav for installationen. Teknologi Version Operativ system Windows Server 2008 R2 eller Windows Server 2012. Nyeste service packs skal være installeret..net Framework 4.5 ASP.NET 4 IIS Server 2008 R2: 7.5 eller nyere Server 2012: 8.0 eller nyere 2 af 25
Installation Installation af Windows Server 2012 Log på serveren. Sæt serveren op som Application Server Du skal være logget på som lokal administrator. Bemærk! Hvis du bruger Remote Desktop, skal du sørge for at tilslutte med parameteren /console: mstsc.exe /console Med.NET Framework 4.5 og Web Server (IIS) Support (installed) 3 af 25
Sæt også serveren op som Web Server (IIS) 4 af 25
Check at IIS 6 metabase er installeret og II6 compabilitet er slået til Vis Start siden Flyt musen ned i venstre hjørne og klik på pop-up --- eller --- Flyt musen op i øverste højre hjørne og klik på Start når baren viser sig. Ser du server vinduet i fuldskærm kan du også bruge short-cutten Windows+C 5 af 25
Vælg Control Panel/Kontrolpanel Check sprog. Serveren skal køre dansk. Tilen (knappen) kan være placeret forskellige steder Det vil sige med danske indstillinger: 6 af 25
Check at ASP.NET 4 er tilladt 7 af 25
Indstil sikkerhedsniveau for administrator kontoen til laveste Åben regedit, f.eks. fra en Command Prompt Flyt musen op i øverste højre hjørne og klik på Search når baren viser sig. Ser du server vinduet i fuldskærm, kan du også bruge short-cutten Windows+C. Skriv command i søgefeltet og højre-klik på den fundne app og kør den som administrator. Kør regedit fra command prompten 8 af 25
Disable LUA Genstart serveren I regedit naviger til HKEY_LOCAL_MACHINE/SOFTWARE/Microsoft/Windows/CurrentVersion/policies/system og rediger værdien til 0 Har du foretaget ændringer i sikkerhedsniveau eller LUA, skal du genstarte serveren for at sikre at ændringerne træder i kraft. Program Installation af Unik WebServices Hvis webløsningen allerede er installeret i en version før 4.4.0, skal den først fjernes i kontrolpanelet under Add or Remove Programs. Svar ja, hvis en dialogboks spørger om at genstarte serveren. Herefter fortsætter opgraderingen som en almindelig installation. 9 af 25
Hvis webløsningen er installeret i version 4.4.0 eller nyere skal den fjernes i kontrolpanelet under Programs and Features Klik uninstall 10 af 25
Tøm eksisterende installationsmappe Kopier setup mappen til C: Pak zip filen ud Det er vigtigt, at den eksisterende installationsmappe (er som standard placeret i C:\inetpub\wwwroot\UnikWcfService) tømmes eller slettes. Kopier UnikWCFServiceInstall<version>.zip til en folder på C drevet (eller et andet ikkenetværksdrev på serveren). 11 af 25
Kør installationspakken Det anbefales at køre installation som Run as administrator 12 af 25
Klik Install på velkomstbilledet Delkomponenter installeres Følgende nødvendige komponenter installeres automatisk Unik Common Unik DbSetup Unik SetupHelper 13 af 25
Ok til at fortsætte Vælg virtuel mappe eller tom for rodmappen. Vælg en ASP.NET 4 Application Pool. Vælg en, der kører i classic mode. 14 af 25
OK til at gå videre. Produktet installeres. 15 af 25
Afslut med Udfør efterfulgt af Close Start SetupHelper fra start menuen (Windows Server 2008) 16 af 25
Start SetupHelper fra start siden (Windows Server 2012) I Virtuel folder vælg UnikWcfService eller hvad du kaldte den virtuelle folder, da du installerede. 17 af 25
I kommandofil vælges WebserviceSetup- HelperTasks 18 af 25
Udfør opgaverne i Setup Helper ved at klikke på "Udfør alle". Nogle opgaver kræver at du indtaster oplysninger. F.eks. databasekonfigurationen. Husk at afprøve forbindelsen. 19 af 25
BEMÆRK: Benytter du Digital Underskrift skal servernavn være identisk med opsætningen for Bolig 4 klienten. Se billede nedenfor hvordan du finder aktuelt servernavn i Bolig 4: En af grundene til at servernavn kan være forskelligt er, hvis computerne med Bolig 4 og webserveren ikke ligger på samme net, så eksempelvis navnet på databaseserveren 20 af 25
Følg instrukser. benyttes for Bolig 4 klienterne og IP adressen benyttes for Unik services. Det kan så løses ved enten at lade Bolig 4 klienterne benytte IP adressen, eller ved at lade Unik services serveren genkende navnet på databaseserveren ved at tilføje en række til maskinens hosts fil: Naviger til C:\Windows\System32\drivers\etc\ Åbn hosts filen i Notepad som administrator Tilføj en række nederst i filen med først IP adressen på databaseserveren, så et mellemrum og så navnet på databaseserveren. Gem filen. Benyt nu i stedet databaseservernavnet i ovenstående konfiguration fremfor IP adressen. Kontroller at alle opgaver er udført korrekt. Luk Setup Helper. Ud for hver opgave vises en status: Opgaven er ikke startet. Opgaven kan (og skal) ikke køres på denne maskine. Opgaven kører. Opgaven er afsluttet korrekt. Genstart serveren. Opgaven er fejlet. Ved at klikke på opgavens linje, kan du se yderligere information om fejlen. Se afsnittet "Fejlfinding" om hvad du kan gøre, hvis en opgave fejler. 21 af 25
Test web servicene. WcfStorm Solutions (www.wcfstorm.com) har en gratis lite klient, der kan bruges til at håndkøre/-teste webservices. Download og installér WcfStorm Lite. Navigér til roden af den installerede ASP.NET løsning. Dette svarer til at gå ind på startsiden af en almindelig webløsning. Man får et billede, der ligner følgende billede. Hver *.svc fil repræsenterer en service. Vælg fx generelt servicen ved at klikke på den. Klik på det angivne link: 22 af 25
Dette bør give dig et omfattende og komplekst XML dokument: Kopier adressen fra adresselinien. Start WcfStorm Lite. Vælg Add og indsæt den netop kopierede adresse. Herefter fortsættes ved at klikke på Go! : 23 af 25
Herefter vælges en servicemetode. Metoden udføres ved at klikke på den grønne knap og resultatet vises endeligt til højre i kassen Response, og andre detaljer vises i loggen i bunden:. Caching For yderligere information om hvordan man bruger WcfStorm Lite til at teste services og hvordan man fx kan udfylde inputparametrene henvises til www.wcfstorm.com. Der gælder det samme som for Unik Boligs øvrige webløsninger, hvor koder, indstillinger, forretningsgange og et par ting mere caches. Der er dog ikke noget admin interface i webservice applikationen til at genindlæse disse 24 af 25
data. Men det kan gøres ved at recycle application poolen i IIS en. Dette vil også ske af sig selv når IIS en selv recycler application pool en. 25 af 25