Jupiter Server IIS del 1 — Rebnis Kunskapsbank

1. Jupiter ServerJupiter Server är samlingsnamnet på våra webbtjänster och består av följande komponenter:Tjänst BeskrivningArenaWeb ArenabokningManagementTool Verktyg för att städa bort döda sessioner mm. för Jupiter ServerOwnerWeb ÄgarwebbReservation Vår egen webbokning (kalendern)Server.Console Jupiter Server - Console version - för SPA samt Byos och CitybreakServer.IIS Jupiter Server - IIS version - för SPA samt Byos och CitybreakPartHotel.Console Jupiter Server - Console version - för PartHotelPartHotel.IIS Jupiter Server - IIS version - för PartHotelWebReservation.Console Jupiter Server - Console version - för vår egen webbokningWebReservation.IIS Jupiter Server - IIS version - för vår egen webbokningTestApp Testapplikation för Jupiter ServerArenabokning och ägarwebben är fristående och kan installeras separat.Jupiter Server är ett API som används av vår egen webbokning samt av Byos och Citybreak.Jupiter Server behövs även för att kunna köra SPA-modulen i Jupiter.Det finns tre varianter av Jupiter Server, en som används för SPA och Byos/Citybreak, en för PartHotel och en för vår egen webbokning.Detta dokument beskriver grundinstallationen som behövs för Jupiter Server, de specifika delarna som behöver konfigureras för respektive tjänst beskrivs i separata guider.2. Förberedelse Skicka förberedelsemailet till kunden (finns i mappen JupiterServer under [email protected] i Outlook).De tekniska kraven finns med i förberedelsemailet samt information hur man installerar IIS och .NET.Om kunden inte klarar av att installera det som krävs får vi naturligtvis göra det åt dem istället.Om inte kunden redan har en adress som pekar på servern får man skapa ett DynDNS konto åt dem. DynDNS är gratis och konto skapas på: www.dyndns.orgAnvändarnamn: hotellnamn.Lösenord: telefonnummer.E-post: Ta reda på lämplig adress, t.ex. tekniskt ansvarig, annars deras info-adress.URL: hotellnamn.dnsalias.netDenna URL kommer att användas för att nå tjänsterna utifrån, t.ex. av Byos och/eller Citybreak eller om kunden vill bädda in tjänsten på sin hemsida.Notera all information enligt ovan i CRM. 3. Tekniska krav 3.1 OperativsystemMicrosoft Windows XP ProfessionalMicrosoft Windows Vista Business/UltimateMicrosoft Windows 7 Professional/UltimateMicrosoft Windows Server 2003/20083.2 Komponenter och övrigtInternetanslutning och att datorn alltid är påslagen.Internet Information Services (IIS)Microsoft .NET Framework 3.5Arenabokning kräver även ASP .NET MVC Framework3.3 Installation av Internet Information Services (IIS)Gå in på Kontrollpanelen > Administrationsverktyg, där ska det finnas en ikon som heter "Internet Information Services (IIS) Hanteraren". Om den inte finns där måste IIS installeras, se nedan.3.3.1 Windows XPKontrollpanelen > Lägg till eller ta bort program > Lägg till/ta bort WindowskomponenterMarkera "Internet Information Services" och klicka på Nästa för att installera.3.3.2 Windows Vista och Windows 7, Windows 8Kontrollpanelen > Program och funktioner > Aktivera eller inaktivera Windows-funktioner Kryssa i "Internet Information Services" och gå in i undermenyn "World Wide Web-tjänster" > Programutvecklingsfunktioner och kontrollera att .NET-utbyggbarhet, ASP och ASP.NET är ikryssade.Kryssa i ”Windows Communication Foundation” som finns under ”Microsoft .NET Framework 3.0”.Windows 8Kryssa i ”Windows Communication Foundation” som finns under ” .NET Framework 3.5”.3.3.3 Windows Server 2003Kontrollpanelen > Lägg till eller ta bort program > Lägg till/ta bort Windowskomponenter Markera Programserver (Application Server) och klicka på Information, se till att ASP.NET och"Internet Information Services (IIS)" är ikryssat, klicka på Ok. Klicka på Nästa för att installera.3.3.4 Windows Server 2008Server Manager > Roles > Add roles. Klicka på Next och kryssa i "Web Server (IIS)"Lägg till ASP.NET: Klicka på Roles > "Web Server (IIS)" och sedan på "Add Role Services".Kryssa i ASP.NET och .NET Extensibility under "Application Development"Aktivera WCF: Klicka på Features och kontrollera att ".NET Framework 3.0 Features" är ikryssat och under den att "WCF Activation" är ikryssat.3.4 Installation av .NET FrameworkKör dotnet.vbs för att kontrollera vilka versioner som är installerade, installera .NET 3.5 om någon saknas, den innehåller alla versioner med senaste Service Pack.Ladda ner >>Arenabokningen kräver även ASP .NET MVC Framework:http://www.asp.net/mvc/download/4. Jupiter, Firebird och installation av filer 4.1 Uppdatering av JupiterJupiter måste uppdateras till senaste version4.2 FirebirdJupiter Server använder Firebirds aliases.conf för att hitta sökvägen till databasen.Aliases.conf återfinns vanligen under C:\Program Files\Firebird\Firebird_2_0.Lägg till en rad i den enligt: jupiter = D:\Rebnis\Data\Jupiter_Hotell.FDB4.3 Lägga upp mappar och kopiera in filerFör att få ett enhetligt upplägg på alla installationer samt göra det enklare att uppdatera och att installera nya versioner och flera tjänster bör en standardstruktur för namngivning användas.En grundmapp, JupiterServer, innehåller en mapp för varje service/tjänst som kunden har.Med service/tjänst avses: arena, byos, citybreak, owner, js-web, spa och web (reservation).Varje sådan servicemapp innehåller en versionsmapp, x.x.x.4.3.1 Skapa mappstrukturSkapa mappen JupiterServer i Rebnis-katalogen.Skapa en mappstruktur i JupiterServer mappen enligt följande:JupiterServer\serviceJupiterServer\service\x.x.xJupiterServer\virtual-rootService ersätts med: arena, byos, citybreak, owner, js-web, spa eller web beroende på tjänst. Rebnis Webbokning kräver Jupiter Server för att fungera och med js-web avses här en instans av Jupiter Server och web är själva bokningskalendern (om den läggs på samma server).4.3.2 Kopiera in filerFilerna som ska användas är de som finns under Jupiter Server på Products.Filer ska endast kopieras till versionsmappen, övriga mappar ska vara tomma.Tjänst FilerAPI för Byos, Citybreak Rebnis.Jupiter.Server.IISAPI för Rebnis webbokning Rebnis.Jupiter.Server.WebReservation.IISArenabokning Rebnis.Jupiter.ArenaWebRebnis webbokning Rebnis.Jupiter.ReservationÄgarwebb Rebnis.Jupiter.OwnerWeb4.3.3 Sätta behörigheterLägg till följande användare och behörigheter för JupiterServer mappen i Windows (fliken Säkerhet)Network Service, standardbehörighetIUSR_datornamn, se bildIWAM_datornamn, se bilOm man har FAT32 som filsystemfinns inte fliken Säkerhet.Windows 8/Server 2012Network service Behöver inte vara med i 2012 server utan man lägger till fullständiga rättigheter för IIS AppPool\JupiterServerPool (se avsnitt 5) i JupiterServer mappen.För att kunna sätta säkerhets behörighet så välj ”Visa avancerade behörigheter” uppe till höger i rutan för behörighetspost för JupiterServer. Glöm sedan inte att ändra ”Typ:” neka.5. Internet Information Services5.1 Skapa programpoolProgrampoolen är det som ”driver” webbplatsen. Skapa en egen för Jupiter Server. (Går ej på XP).5.1.1 Windows Server 2003Högerklicka på Programpooler och välj Nytt > ProgrampoolProgrampool-ID: JupiterServerPoolAnvänd standardinställningar5.1.2 Windows Vista, Windows 7 och Windows Server 2008, Windows 8Högerklicka på Programpooler och välj Lägg till programpool.(Windows 8: kom ihåg att ändra till en app pool som kör .net 2.0 för den ställer sig på 4.0 automatiskt)Namn: JupiterServerPool.NET Framework-version: .NET Framework 2.0.50727OBS: Numera är det .NET Framework 4.0 som ska anges härPipelineläge: IntegreradAktivera 32-bitars program under avancerade inställningar på Programpoolen.5.2 Skapa webbplatsSkapa en ny webbplats i IIS och kalla den JupiterServer. Använd port 81 för http och port 8443 för https för att lämna standardportarna lediga till andra applikationer.5.2.1 Windows XPI Windows XP går det endast att ha en webbplats och man får där förlita sig helt på virtuella mappar.Högerklicka på Standardwebbplats och välj Nytt > Virtuell katalog.Döp den till JupiterServer och peka till mappen JupiterServer\virtual-root.Tilldela Läs- och Skriptkörningsbehörighet.5.2.2 Windows Server 2003Högerklicka på Webbplatser > Nytt > Webbplats > NästaBeskrivning: JupiterServerTCP-port: 81Värdhuvud: Lämna tom tillsvidare för att kunna testa installationen.Ange sökvägen till mappen JupiterServer\virtual-root.Tilldela Läs- och Skriptkörningsbehörighet.JupiterServer -> egenskaper-fliken home Directory-> application pool =JupiterserverpoolASP.NET=2.055.2.3 Windows Vista, Windows 7 och Windows Server 2008Högerklicka på Webbplatser > Lägg till webbplatsNamn: JupiterServerProgrampool: Välj > JupiterServerPoolAnge sökvägen till mappen JupiterServer\virtual-root.Bindning – Port: 81Värdnamn: Lämna tom tillsvidare för att kunna testa installationen.5.3 Skapa virtuella mapparVirtuella mappar och applikationer används för att tillåta olika versioner/instanser av JupiterServer att köras på samma webbplats. För arena, owner, js-web och web räcker det med en virtuell huvudmapp men för Byos och Citybreak ska man även skapa virtuella undermappar med versionsnummer. Byos vill kunna förbereda den nya versionen innan den går live och i Citybreaks fall kan de bara köra en version, vilket innebär att alla kunder måste byta exakt samtidigt, man kan då förbereda alla kunder och sedan be Citybreak peka om alla. Virtuella mappar påverkar också den url som används för att nå tjänsten.5.3.1 Upplägg för virtuella mapparurl/ i tabellen nedan avser hela sökvägen t.ex. https://anläggningsnamn.dnsalias.net:8443/Namn Ska peka på URL för att nå tjänstenarena arena\x.x.x url/arenabyos virtual-rootbyos\x.x.x. byos\x.x.x url/byos/x.x.xcitybreak virtual-rootcitybreak\x.x.x citybreak\x.x.x url/citybreak/x.x.xowner owner\x.x.x url/ownerjs-web js-web\x.x.x url/js-webspa spa\x.x.x url/spaweb web\x.x.x url/webUrl för Byos och Citybreak ska enbart meddelas till dem, skall inte användas av kund, går till API.Url för js-web skall inte användas av kund. Ska anges i web.config för vår webbokning, går till API.Url för spa är det som ska anges i Jupiter för att nå tjänsten, http://servernamn:81/spaUrl för arena, owner och web är det kunderna ska använda för att nå de sidorna.Vid uppdatering lägger man bara upp en ny mapp för version under respektive servicemapp och om kunden har Byos eller Citybreak meddelar man dem det nya versionsnumret så att de kan ändra och för övriga tjänster pekar man bara om den virtuella mappen i IIS så förblir url samma som innan.5.3.2 Windows XPHögerklicka på den virtuella mappen JupiterServer och välj Nytt > Virtuell katalog.Döp den till tjänstens namn och peka till angiven mapp enligt tabellen.Tilldela Läs- och Skriptkörningsbehörighet.Lägg vid behov till en undermapp om det krävs enligt tabellen ovan.5.3.3 Windows Server 2003Högerklicka på webbplatsen JupiterServer och välj Nytt > Virtuell katalog.Döp den till tjänstens namn och peka till angiven mapp enligt tabellen.Tilldela Läs- och Skriptkörningsbehörighet.Lägg vid behov till en undermapp om det krävs enligt tabellen ovan.5.3.4 Windows Vista, Windows 7 och Windows Server 2008Högerklicka på webbplatsen JupiterServer och välj ”Lägg till program” om tjänsten enbart kräver en huvudmapp, välj annars ”Lägg till virtuell katalog”. Döp den till tjänstens namn och peka till angiven mapp enligt tabellen.Om tjänsten kräver en undermapp, välj ”Lägg till program” under den virtuella mappen.5.4 Aktivera ASP.NET (XP och Server 2003)För Windows XP och Server 2003 måste man aktivera ASP.NET på webbplatsen och på servern.Gå in på Egenskaper för webbplasten och fliken ASP.NET, se till att 2.0 är valt.Gå även in på Webbtjänsttilägg (Web Service Extensions) och välj Tillåt på ”ASP.NET v2.0.50727”Om ”ASP.NET v.2.0. 50727” inte finns i listan så är inte .NET 2.0 installerat eller så har man installerat IIS efter att man installerade .NET 2.0.Lösningen: starta cmd och gå in i följande katalog:C:\WINDOWS\Microsoft.NET\Framework\v2.0.50727och kör kommandot: aspnet_regiis -i -enableWindows VistaKontrollpanelen > Program och funktioner > Aktivera eller inaktivera Windows-funktioner > Internet Information Services > World Wide Web-tjänster > Programutvecklingsfunktioner > ASP.NET5.5 Aktivera WCF (Vista, Win 7 och Server 2008)Om du precis installerat IIS bör dessa steg redan vara klara (finns med ovan för installation av IIS), om IIS var installerat sen tidigare måste dessa inställningar kontrolleras.5.5.1 Windows Vista och Windows 7 5.5.1.1Via kommandopromptenOvanstående går även att göra via kommandoprompten.Gå in i: C:\Windows\Microsoft.NET\Framework\v3.0\Windows Communication Foundation.Kör: servicemodelreg -r -y5.5.2 Windows Server 2008 Server Manager > Features > .NET Framework 3.0 Features > WCF Activation 6. Brandvägg / Router Se till att öppna nödvändiga portar i brandväggen och göra forward i eventuell router.Visa routrar kan kräva att man både öppnar porten i den inbyggda brandväggen och gör en forward.7. Testning För testning av en specifik tjänst, se installationsanvisningen för den tjänsten.Generellt gäller det att kontrollera om tjänsten fungerar internt samt externt.7.1 Testning i webbläsare För att underlätta felsökning i webbläsare kan man kryssa ur ”Visa egna http-felmeddelanden” längst ner i listan under Internetalternativ > Avancerat. Kan även heta ”Visa vänliga felmeddelanden”. Testa följande adress i webbläsaren: http://localhost:81/servicenamn/x.x.x/reservationservice.svchttp://localhost:81/jupiterserver/js-web/reservationservice.svc (för windows XP) Man ska då få upp en bild enligt följande om: 7.1.1 HTTP Error 404.3 – add a MIME map Får man fel 404.3 och att den vill ha en MIME karta måste man aktivera skript mappning för WCF.Se ”Aktivera WCF” ovan. 0x800700327.1.2 Page can not be foundSe punkten ”Aktivera ASP.NET” ovan. 7.1.3 Server error in application – Det gick inte att komma åt IIS-metabasen Se punkten ”Aktivera ASP.NET” ovan. 7.1.4 Server Application Unavailable / Servertillämpningen är inte tillgänglig Körs JupiterServer i en egen programpool? Om inte, fixa det. Om den gör det och det är många tjänster (arena, citybreak, spa osv.) som körs i den kan det vara läge att skapa en ny programpool och köra några av tjänsterna mot den istället. 7.1.5 Det gick inte att hitta en basadress som matchar schema https Man kan få detta fel när man avkommenterat https i web.config men inte har https inställt i IIS. 7.1.6 HTTP Error 500.19 Felkod: 0x80070021 = Installera ASP.NET för IISFelkod: 0x80070005 = Felaktiga behörigheter för mappen JupiterServerFelkod: 0x8007007e = WSUS (Windows Server Update Services) is installed on the server. It enables 64-bit compression that causes any 32-bit applications running in IIS to fail. 0x80070021HTTP Error 500.19 i Windows server 2025 (Detta gäller vid Citybreak koppling, vet inte hur Jupiter web på verkas)Kommentera bort detta i web.config för att få det att fungera. WCF – Error 500.21 Handler "svc-Integrated" has a bad module "ManagedPipelineHandler" in its module list https://blogs.msdn.microsoft.com/keithmg/2010/11/08/wcf-error-500-21-handler-svc-integrated-has-a-bad-module-managedpipelinehandler-in-its-module-list/Leta rätt på "aspnet_regiis.exe" under c: Öppna filens sökväg.Starta sedan cmd och cd till mappen sökväg. Kör sedan aspnet_regiis.exe-i Felkod: 0x8007007eKör kommando på servern för att deaktivera komprimeringen:%windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/httpCompression /-[name='xpress']Ska få resultat i stil med: Konfigurationsändringarna tillämpades på avsnitt "system.webServer/httpCompression" för "MACHINE/WEBROOT/APPHOST" i konfigurationssökvägen "MACHINE/WEBROOT/APPHOST" Vill du aktivera komprimeringen igen så kör kommando: %windir%\system32\inetsrv\appcmd.exe set config -section:system.webServer/httpCompression /+[name='xpress',doStaticCompression='false',dll='%windir%\system32\inetsrv\suscomp.dll']7.2 Testning via testapp 7.2.1 Det fanns inte någon slutpunkt som lyssnade på url - 404 Kontrollera att det är rätt adress. Om adressen är korrekt, avkommentera https i web.config om det är https.Om adress är korrekt och https är korrekt är det problem med brandvägg eller DNS-uppslag.8. Appendix 8.1 Övriga felmeddelanden 8.1.1"Unexpected Error 0x8ffe2740 occurred" i IIS Detta fel kan uppstå om en annan applikation än IIS använder den port man tilldelat webbplatsen.Åtgärd: Byt port för webbplatsen i IIS. 8.2 IIS versioner Operativsystem IIS version NoteringarWindows 2000 IIS 5 Stöds ej då Windows 2000 ej klarar .NET 3.5Windows XP Pro IIS 5.1Windows XP Pro x64 IIS 6Windows Server 2003 IIS 6Windows Vista IIS 7 Business, Enterprise, UltimateWindows Server 2008 IIS 7Windows 7 IIS 7.5 Professional, UltimateWindows Server 2008 R2 IIS 7.58.3 Diverse kommandon 8.3.1 Hitta lyssnande portar netstat -an | find /i "listening"8.3.2 Se vilket certifikat som är knutet till en viss port (IIS 7) netsh http show sslcert Jupiter Server IIS del 2 || Jupiter Server IIS del 3