BOULEVARDEN 19E 7100 VEJLE LERSØ PARKALLE 101 2100 KØBENHAVN Ø TLF. 76 42 11 00 WWW.UNIK.DK Ansøger og Venteliste Installationsvejledning
Indholdsfortegnelse Indholdsfortegnelse... 1 Formål... 2 Forudsætninger... 2 Installation... 3 Server Installation... 3 SSL certifikat... 3 NemID certifikat... 3 Installation på Windows Server 2008... 3 Installation af Windows Server 2012... 8 Application pool på 64-bit systemer... 14 Program Installation af Unik Ansøger og Venteliste... 16 SMTP server... 30 Tilrettet layout... 31 Fjern elementer fra sider... 31 Links... 31 Nye Unik versioner... 31 1 af 33
Formål Dette dokument indeholder oplysninger vedrørende installation af webløsningen UnikVenteliste til ansøgere. Du bør gennemlæse dette dokument, inden du installerer webløsningerne. Der findes en generel vejledning med information, der er fælles for alle webløsningerne. Forudsætninger Programmet Unik Bolig 4 Opdateringskontrol kan kontrollere om en server er klar til at køre Unik Bolig 4 Web Applikationer 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 Operativ system.net Framework 4.5 ASP.NET 4 IIS Version Windows Server 2008 R2 eller nyere. Nyeste service packs skal være installeret. Server 2008 R2: 7.5 eller nyere med IIS 6 Management Compatibility Server 2012: 8.0 eller nyere 2 af 33
Installation I det følgende beskrives hvordan webløsningen installeres på de forskellige versioner og system typer (32/64 bit) af Windows Server. Server Installation SSL certifikat Det er vigtigt, at indstillingen i forretningsgangen vedr. anvendelse af SSL kun er slået til, hvis der er installeret et certifikat på webserveren. I modsat fald vil man ikke kunne se bla. login siden og man vil ikke få nogen fejlbeskeder. NemID certifikat Løsningen understøtter login med NemID, hvis der er købt adgang til modulet 29015 Login med NemID. Login med NemID forudsætter opsætning af certifikat på serveren. For mere information om brugen af NemID se: http://www.nets.eu/dk-da/produkter/sikkerhed/nemid-tjenesteudbyder/pages/default.aspx Forretningsgangsopsætningen Web Venteliste Almen indeholder to grupper til opsætning af NemID. Installation på Windows Server 2008 Log på serveren. Check.NET Framework version. 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 /admin: mstsc.exe /admin Kontrollér, at du har installeret det fulde.net 4.0 Framework. Hvis du er i tvivl om det er installeret, kan du følge Microsofts vejledning her: http://msdn.microsoft.com/enus/kb/kbarticle.aspx?id=318785, eller du kan prøve en af de alternative metoder beskrevet her: http://www.techrena.net/windows/check-net-framework-version-installedwindows-pc/. 3 af 33
Check at Applikation Server og Web Server (IIS) er valgt til. 4 af 33
ASP.NET vælges til. Check at IIS 6 metabase er installeret og II6 compabilitet er slået til 5 af 33
Check sprog. Serveren skal køre dansk. Det vil sige med danske indstillinger: Og dansk tastatur: Check at ASP.NET 4 er "allowed". 6 af 33
Fortsæt med program installation Gå til dette afsnit Program Installation af Unik Ansøger og Venteliste 7 af 33
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 /admin: mstsc.exe /admin Med.NET Framework 4.5 og Web Server (IIS) Support (installed) 8 af 33
Sæt også serveren op som Web Server (IIS) 9 af 33
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 10 af 33
Vælg Control Panel Check sprog. Serveren skal køre dansk. Tilen (knappen) kan være placeret forskellige steder Det vil sige med danske indstillinger: 11 af 33
Check at ASP.NET 4 er tilladt 12 af 33
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 13 af 33
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. Application pool på 64-bit systemer Ved installation på Windows 2003/2008 Server 64-bit skal Application Pool tilrettes, så den anvender 32-bit (lige som Classic.NET AppPool) for at kunne køre. Dette gøres ved at vælge Application Pool en -> avancerede indstillinger og sætte Enable 32-bit Applications til true. 14 af 33
Endvidere skal der huskes at sætte bruger identity. 15 af 33
Program Installation af Unik Ansøger og Venteliste BEMÆRK! Hvis webløsningen allerede er installeret i version 4.3.3 eller ældre, skal den først fjernes i kontrolpanelet under Programs and Features. Bemærk, at det er vigtigt at foretage en backup af mappen PagesAlmen\Pages (eller PagesKollegie\Pages for kollegieløsningen), hvis der benyttes tilrettet layout. Hvis webløsningen er installeret i version 4.4.0 eller nyere skal den fjernes i kontrolpanelet under Programs and Features Svar ja, hvis en dialogboks spørger om at genstarte serveren. Herefter fortsætter opgraderingen som en almindelig installation. 16 af 33
Tøm eksisterende installationsmappe Kopier setup mappen til C: Pak zip filen ud Klik uninstall Det er vigtigt, at den eksisterende installationsmappe (er som standard placeret i C:\inetpub\wwwroot) tømmes eller slettes. Kopier UnikVentelistInstall<version>.zip til en folder på C drevet (eller et andet ikkenetværksdrev på serveren). 17 af 33
Kør installationspakken Det anbefales at køre installationen som Run as administrator. 18 af 33
Klik Install på velkomstbilledet Delkomponenter installeres Følgende nødvendige komponenter installeres automatisk: Unik Common Unik DbSetup Unik SetupHelper Unik Layout Updater 19 af 33
Ok til at fortsætte Vælg virtuel mappe eller tom for rodmappen. For 64 bit se også afsnit Application pool på 64-bit systemer. 20 af 33
OK til at gå videre. Tryk Installer. Produktet installeres. 21 af 33
Afslut med Udfør efterfulgt af Close Udfør installationen af Mercurial. Acceptér licensbetingelserne og forslaget til placering af installationen. Svar ja til at overskrive filen Mercurial.ini, hvis du bliver spurgt. 22 af 33
Det er vigtigt, at den viste markering ikke fjernes. Start SetupHelper fra start menuen (Windows Server 2008) 23 af 33
Start SetupHelper fra start siden (Windows Server 2012) I Virtuel folder vælg UnikVenteliste 24 af 33
I Kommandofil vælges VentelisteSetupHelpe rtasks Udfør opgaverne i Setup Helper ved at klikke på "Udfør alle". 25 af 33
Nogle opgaver kræver at du indtaster oplysninger. F.eks. databasekonfigurationen. Husk at afprøve forbindelsen. 26 af 33
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. 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. Opdatering af tilrettet layout. Hvis du vil opdatere tilrettet layout, så kan du gøre det nu. Se brugervejledningen for dette værktøj for yderligere hjælp. Alternativt kan du trykke nej og køre programmet en anden gang fra genvejen, der installeres under Unik System Design i Start -> Programmer. 27 af 33
Genstart serveren 28 af 33
Afprøv webløsningen. Bemærk! Dette kræver ofte, at løsningen på forhånd er konfigureret med Unik Bolig 4 Windows klienten. Webløsningen kan også startes direkte fra IIS en. 29 af 33
SMTP server Løsningen benytter SMTP til afsendelse af emails. http://support.microsoft.com/kb/323350 beskriver hvordan forbindelsen til SMTP-serveren kan testes fra en kommandolinieprompt. Unik anbefaler at man bruger sin udbyders mail server. 30 af 33
Tilrettet layout Dette afsnit forudsætter at man har kendskab til IT på mindst medium niveau, samt har en lille smule kendskab til HTML eller god flair for IT. I web venteliste er det muligt at benytte tilrettet layout. Tilretning foretages i praksis ved at kopiere indholdet af mappen PagesAlmen\PagesDefault til PagesAlmen\Pages. For kollegieløsningen er det indholdet af PagesKollegie\PagesDefault, der kopieres til PagesKollegie\Pages. I det følgende beskrives processen for den almene løsning, men processen for kollegieløsningen er identisk med mappenavnene som eneste undtagelse. Herefter kan der frit redigeres i filerne i Pages mappen. Det anbefales, at man løbende tester sine rettelser. Hvis man får lavet en rettelse, der får webløsningen til at fejle, kan man manuelt tilbageføre de pågældende ændringer. Kan dette ikke lade sig gøre, så kan man i stedet blot kopiere den aktuelle fil fra PagesDefault mappen og således overskrive sine rettelser i Pages mappen. Der findes primært følgende filtyper: Filtype *.ascx og *.aspx Billedfiler *.css *.js Indeholder webform kode, som ligner HTML en del. En stor del af indholdet er ren HTML. Billeder. Fx *.jpg, *.gif og *.png. Stylesheet filer. Javascript filer. Der henvises til generel litteratur vedr. webteknologi mht. tilretning af layout. Dog beskrives et par specifikke ting i de følgende underafsnit. Fjern elementer fra sider HTML kan med ganske få undtagelser frit redigeres. Til gengæld kan serverelementer ikke frit redigeres. Serverelementer er elementer (tags) med attributten runat. Fx: <asp:label ID="Status" runat="server" /> Disse elementer kan ikke fjernes eller omdøbes (attributten ID). Ønsker man ikke se dem på siden gør man det ved at tilføje attributten Visible= false. Eksempel: Links <asp:label ID="Status" runat="server" Visible= false /> Links bør være relative som fx Login.aspx og ikke fx https://www.mydomain.dk/login.aspx. Links (også til billeder) bør ikke indeholde stien PagesAlmen\Pages eller PagesAlmen\PagesDefault, da det vil bryde med konceptet for tilretning af layout. Nye Unik versioner Man kan købe Unik til at foretage opdateringer af layoutet eller man kan gøre det selv. Problemstillingen ved installation af nye Unik versioner er, at i forhold til den oprindelige version, vil der normalt være foretaget uafhængige ændringer i henholdsvis jeres installation og i Uniks nye version. 31 af 33
Disse forskellige ændringer kan i værste fald konflikte, hvilket vil ske en gang i mellem. Jo flere ændringer der er foretaget i layoutet og jo flere ændringer Unik har lavet, jo større vil risikoen være. Unik har udviklet et værktøj, som i mange tilfælde vil kunne sammenflette layouttilretningerne fra den gamle version med Uniks ændringer i den nye version. Brugervejledningen for dette værktøj installeres på web serveren ifm. installation af web venteliste. Der henvises til den brugervejledning for konkret anvisning vedrørende anvendelsen af det værktøj. Det er vigtigt at være klar over, at der altid vil kunne være ændringer i nye versioner, der giver konflikter. Det gælder også mellem fx betatest 1 og betatest 2, eller mellem betatest 2 og den endelige release version. Unik anbefaler derfor, at man, for ikke at bruge for mange ressourcer på at opdatere layout af flere omgange, altid kun gør det i forbindelse med installation af den endelige og gennemtestede version, man ønsker at gå i drift på. Tag altid backup af alt indholdet af tilretningerne fra PagesAlmen\Pages mappen. 32 af 33