BOULEVARDEN 19E 7100 VEJLE LERSØ PARKALLE 101 2100 KØBENHAVN Ø TLF. 76 42 11 00 WWW.UNIK.DK Unik Web Platform Installationsvejledning
Indholdsfortegnelse Indholdsfortegnelse... 1 Introduktion... 2 Nyt fra version 4.4.0 og frem... 2 Opgradering af en eksisterende version... 2 NemID... 2 Nyt fra version 4.6.1 og frem... 4 Installation... 4 Teknisk konfiguration... 14 Rettigheder... 14 Tekniske konfigurationstrin... 15 Administratorkonto... 17 HTTPS / SSL... 17 1 af 22
Introduktion Løsninger der er baseret på denne platform er alle indeholdt i én web applikation og dermed i én installation. Det er modulstyringen, der bestemmer hvilke delløsninger, der kan anvendes. Nyt fra version 4.4.0 og frem Vi har ændret den metode, der bruges til installation af løsningen fra at være et traditionelt setup program til at være en pakke, der skal installeres med Web Platform Installer. Fordelen ved dette er bl.a. at man kan installere løsningen flere gange på samme server (f.eks. til et testmiljø og et driftmiljø), man kan også installere forskellige versioner på samme server. 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 en de efterfølgende. AutoStart kræver lidt manuel konfiguration i IIS. Hvis denne konfiguration ikke foretages fungerer løsningen som tidligere. BEMÆRK! AutoStart funktionen virker kun på en løsning, der er driftklar (dvs. som ikke er i installationstilstand). Hvis løsningen er i installationstilstand, vil AutoStart forhindre den i at fungere. Man skal derfor slå AutoStart fra på websitet, hvis man vi opgradere det med en ny version. 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 installationstrinnene 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. Opgradering af en eksisterende version Hvis du opgraderer fra en version, der er installeret med Web Platform Installer, skal du ikke foretage dig noget særligt. Når du indlæser den nye applikation, bliver du spurgt om indholdet fra den gamle skal fjernes hvilket du altid skal svare ja til. I installationsafsnittet nedenfor er beskrevet alle de trin, du skal igennem for at klargøre en ny server. Er der tale om en opgradering, vil du selvfølgelig ofte kunne springe de fleste over og nøjes med at installere Unik Web Platform applikationen. Hvis du opgraderer fra en version, der er installeret med en MSI installation, skal du starte med at afinstallere den og tømme den mappe, det gamle website blev hostet i. NemID Der kan anvendes NemID 1 som alternativ til standard-login i web-løsningerne. Brugen af NemID kræver en aftale med Nets. For mere information om brugen af NemID se: http://www.nets.eu/dk-da/produkter/sikkerhed/nemid-tjenesteudbyder/pages/default.aspx Der skal laves en enkelt konfiguration på serven, da den aktuelle Application Pool skal opsættes til Load User Profile. 1 OCES personcertifikat. 2 af 22
Al yderligere konfiguration af NemID kan foretages fra website administrationsværktøjet 2 inkl. upload af certifikatfiler modtaget fra Nets, men det kræver, at brugeren, der skal konfigurere NemID, har adgang til certifikatfilerne. Hvis brugeren ikke har adgang til certifikatfiler, så skal disse manuelt uploades til webserveren. Bemærk, at brugeren, der skal konfigurere NemID, fortsat skal have adgang til certifikatpassword. Certifikatfiler modtaget fra Nets skal placeres på serveren i mappen App_Data under webapplikationens installationsmappe. App_Data mappen er beskyttet, så der ikke er adgang via en browser. Man kan vælge manuelt at gemme certifikatfilerne her eller man kan anvende upload funktionen i website administrationsværktøjet. For drift skal certifikatfilen navngives NemIdCertificateProd.pfx og for test skal certifikatfilen navngives NemIdCertificateTest.pfx. Bemærk, at upload af certifikatfilerne skal foretages efter at installationen er afsluttet og website definitionen er opgraderet i administrationsværktøjet, da installation af ny version af Unik Web Platform sletter alle eksisterende certifikatfiler. 2 Se superbrugervejledningen for information om website administrationsværktøjet. 3 af 22
Nyt fra version 4.6.1 og frem Løsningen recycler nu af sig selv dens application pool når man fra administrationsværktøjet i Unik Bolig 4 Windows klient vælger 'Anvend website definition'. For at dette kan lade sig gøre, skal løsningen køre med en konto, der har rettighed til det, f.eks. LocalSystem. Installation Funktion Serverrollen Web server Beskrivelse Serveren skal have tilføjet serverrollen webserver og en række tilhørende features. Vælg rollen Web server IIS. Du skal svare ja til at installere Management Tools, hvis du bliver spurgt om det. 4 af 22
Under features skal du vælge disse: ASP.NET 4.5 HTTP Activation under WCF Services Under Role Services skal du (mindst) vælge disse: 5 af 22
Web Platform Installer Web Platform Installer skal installeres. Hvis ikke IIS Manager selv foreslår det, kan du hente den hos Microsoft: http://www.microsoft.com/web/downloads/platform.aspx Web Platform Installer bruges til at hente en række andre komponenter. Du kan starte den inde fra IIS Manager, ved at klikke på Get New Platform Components. 6 af 22
Web Deploy Man installerer komponenter ved at søge dem frem og vælge add ud for komponenten og så nederst i skærmbilledet vælge Install. Med Web Platform Installer skal du installere Web Deploy 3.5 (ikke nyere indtil videre). 7 af 22
SQL Compact Edition I ovenstående skærmbillede, er Web Deploy allerede installeret. OBS! Web Deploy tilføjer nogle funktioner til IIS Manager, så du skal genstarte denne. Med Web Platform Installer skal du installere SQL Compact Edition. 8 af 22
Application pool I ovenstående skærmbillede er SQL Compact Edition allerede installeret. Opret en ny application pool i IIS Manager. Den skal benytte.net 4.0 og Integrated pipeline. Billede nr. 2 er taget fra Server 2012 R2. Klik på Advanced settings for den nye application pool og slå 32 bit programmer til, samt ændre Identity til 'LocalSystem'. 9 af 22
Unik Web Platform Du skal nu installere Unik Web Platform, der er web applikationen husk den indeholder flere forskellige løsninger (kaldet moduler), f.eks. BestyrelsesWeb, SelskabsWeb osv. og det er modulstyringen i Unik Bolig 4, der bestemmer, hvilke moduler der kan anvendes. Opret et nyt website (eller brug et eksisterende, hvis det ønskes). Sørg for at vælge den application pool du tidligere oprettede. Hvis du opgraderer en eksisterende løsning, skal du ikke gøre noget for at afinstallere eller fjerne den gamle først (medmindre den er installeret på den gamle måde med en MSI installation). Marker websitet og vælge Import Application. 10 af 22
Udpeg pakken, som er en ZIP fil med navnet UnikWebPlatformXXXXXX, hvor XXXXXX er versionsnummeret. Bemærk, det er en ZIP fil, men den skal ikke pakkes ud det gør Web Deploy. Tryk Next indtil du kommer til dette billede: 11 af 22
Tøm feltet for Application Path, så det ser således ud: 12 af 22
Tryk Next og svar OK til denne advarsel: Hvis det website, du installerer applikationen i, ikke er tomt, vil du blive spurgt, om det skal tømmes. Det skal du vælge, at det skal - du skal selvfølgelig sikre dig, at det ikke indeholder noget, du skal bruge. Teknisk konfiguration Du skulle nu kunne browse til websitet og gennemføre de tekniske konfigurationstrin, hvor du bl.a. skal angive databaseserver osv. 13 af 22
Teknisk konfiguration De tekniske konfigurationstrin er en række indstillinger som skal gennemføres for at Unik Web Platform kan fungere. Når denne del er afsluttet, skal løsningen konfigureres med Unik Bolig 4 Windows klienten, hvilket typisk gøres af en Unik konsulent. Rettigheder Løsningen kræver, at den bruger, der afvikler webløsningen, har skriverettigheder til udvalgte mapper og filer. Løsningen gør brug af selv at recycle dens application pool når der anvendes en ny website definition og for at det kan lade sig gøre, skal den køre under en konto, der har rettighed til det, f.eks. LocalSystem. I forbindelse med installationen vil løsningen teste om kontoen har de fornødne rettigheder og man kan så manuelt tildele disse rettigheder undervejs i installationen. Man kan også køre scriptet setperm.cmd, som ligger i websitets rodmappe og dermed sætte rettigheder for alle mapper på en gang. Scriptet skal kaldes med navnet på kontoen, og derfor er det nok lettest først at køre dette når man i installationen kommer til det første trin der oplyser, at rettighederne ikke er i orden, fordi så kan man kopiere kontonavnet. Man kører det lettest ved at starte en kommandoprompt i websitets rodmappe (SHIFT+Højre klik i området hvor der ikke er nogle filer > Open Command Window Here). 14 af 22
Husk at skrive anførselstegn ( ) omkring navnet når du indsætter det. Tekniske konfigurationstrin De tekniske konfigurationstrin afvikles i browseren og er en del af webapplikationen. For at dette kan fungere, skal der være adgang til internettet fra browseren, så hvis du afvikler dette fra serveren hvilket umiddelbart er det letteste kan det være, du skal åbne op for at der hentes filer fra Internettet. Browseren vil i så fald spørge dig for hver fil, den har brug for. 15 af 22
Nogle trin kræver, at du foretager en handling, f.eks. angiver oplysninger om databaseforbindelse eller at nogle rettigheder ikke er tilstrækkelige. Det er når du bliver mødt med den sidste af den slags, at du med fordel kan køre setperm programmet (se tidligere afsnit). Efter du har rettet op på et rettighedsproblem, kan du trykke F5 i browseren, for at få den til at teste igen. Får du undervejs følgende billede: 16 af 22
mangler du at installere Microsoft SQL Server Compact 4.0. Administratorkonto Et af trinnene beder dig angive brugernavn og kodeord for en administratorfunktion i løsningen. Disse oplysninger bør du afstemme med kunden, fordi superbrugerne skal bruge dem, når de skal konfigurere løsningen inde fra Unik Bolig 4 Windows klienten. HTTPS / SSL Det anbefales at der bruges HTTPS på offentlige servere. Denne løsning håndterer selv skiftet til HTTPS på de sider hvor det er krævet, så man skal ikke vælge Require SSL i webserveren, men sørge for, at der er installeret et gyldigt certifikat på serveren og at der er åbnet for både port 80 og 443 i firewallen. Ofte har man ikke dette på plads når løsningen installeres og et trin i installationsprocessen handler om at man kan deaktivere brugen af HTTPS. Man kan efterfølgende aktivere HTTPS igen med administrationsværktøjet i Bolig 4. Det anbefales, at man gennemfører installationen med HTTPS deaktiveret. Tjek desuden at der eksisterer en https binding til websitet. 17 af 22
Websiteadministrationen Når man er kommet til trin 11 bør man ved opgradering til en ny version sætte guiden på pause. Så overtager man den sidste tilpasning i Unik Bolig 4 -> Generelt -> Tilpasning -> Websiteadministration. Ved reinstallation kan man nøjes med at angive den sidst anvendte websitedefinition. Hvis du er i tvivl, så pause den og foretag de sidste tilpasning i Websiteadministrationen. Skærmbilledet skal se ud som følger, før man kan arbejde videre i Websiteadministrationsværktøjet: 18 af 22
I websiteadministrationen kan man konfigurere forbindelsen til serveren og selve websitedefinitionen (selve konfigurationen af siderne). Venstre side af båndet øverst i websiteadministrationen angår server-konfigurationen, højre side angår websitedefinitions-konfigurationen. Hvis ikke der er konfigureret en server-forbindelse, gøres dette ved at trykke på 'Opret' helt til venstre i båndet. Det er webserverens IP eller værtsnavn (f. eks. online.unik.dk), der indtastes i feltet URL. Navn kan vælges frit. Som brugernavn og kodeord vælges de samme, som man har valgt i de grønne trin (trin 7). 19 af 22
Når man har pauset guiden, vil status på serveren være 'Kører (installation ikke afsluttet)'. Installationen afsluttes ved, at man enten opretter en ny Website definition, eller opgraderer en eksisterende website definition, såfremt man (som i de fleste tilfælde) har opgraderet til en nyere version. Er der bare tale om en reinstallation, kan man nøjes med at anvende den sidst benyttet websitedefinition. Mergekonflikter ved opgradering Får man en advarsel efter tryk på 'Opgrader', er det vigtigt, at man følger instrukserne på dialogboksen: Gøres dette ikke, kan der opstå fejl ved brug af websitet. 20 af 22
Som der står i dialogen, håndteres fejlene ved at trykke 'Rediger (Website definitioner)'. Fejlene vil så kunne ses på fanen 'Opgradering' nederst i vinduet. En 'Udgået' fejl kan bare vinges af, en 'Merge' fejl bør håndteres. I kolonnen 'Handling' har man mulighed for at anvende et merge-værktøj (første gang skal det lige downloades). Før siden kan ses, skal websitedefinitionen anvendes. Det gøres ved tryk på 'Anvend website definition': Derefter bør status være: Kører (normal drift). Har man AnsøgerWeb, kan der godt gå nogle minutter, før status'en skifter til (normal drift). Tryk evt. 'Opdater' (knappen til venstre for 'Anvend '), hvis den skifter til 'Ikke tilgængelig'. Vinduet med de 'grønne trin' på webserveren kan nu lukkes og websitet kan tilgås fra en browser. Eksporter/Importer Der er mulighed for at eksportere en website definition til en zip-fil, samt at importere den igen. Det giver specielt meget mening i forhold til at overføre en opsætning fra test-miljøet i drift-miljøet. BEMÆRK: Versionen SKAL dog 100% være den samme i test og i drift, for at denne funktion kan anvendes. Gamle Temporary filer efter opdatering Der kan opstå problemer med gamle temporary filer efter en opgradering. Disse giver mærkelige og uforklarlige fejl og bør slettes på webserveren: C:\Windows\Microsoft.NET\Framework\v2.0.50727\Temporary ASP.NET Files\root C:\Windows\Microsoft.NET\Framework\v4.0.30319\Temporary ASP.NET Files\root 21 af 22
C:\Windows\Microsoft.NET\Framework64\v2.0.50727\Temporary ASP.NET Files\root C:\Windows\Microsoft.NET\Framework64\v4.0.30319\Temporary ASP.NET Files\root Timeout på IIS'en Hvis man i Applikationsloggen kan se, at ApplicationInitialize fejler pga. Timeout, så kan man ændre på ApplicationPoolens 'Timeout for start' til 200: 22 af 22