BOULEVARDEN 19E 7100 VEJLE LERSØ PARKALLE 101 2100 KØBENHAVN Ø TLF. 76 42 11 00 WWW.UNIK.DK isyn Installationsvejledning
Indholdsfortegnelse Indholdsfortegnelse... 2 Formål... 2 Teknisk niveau... 2 1 Definitioner... 3 2 Forudsætninger... 3 3 Struktur af installation... 3 3.1 Application Pools... 3 3.2 Websites... 5 3.3 Klar til installation... 6 4 Installation af isyn... 6 4.1 Konfiguration af DNS... 7 4.2 Konfiguration af sti til Applikationsserveren... 8 5 Test af installation... 8 5.1 Test af isyn... 9 5.2 Test af Applikationsserveren... 10 5.3 Test af LM Connectoren... 11 Formål Dette dokument har til formål at vejlede i standardopsætningen af isyn, og hvordan de forskellige dele en isyn opsætning består af bør struktureres. Der er mange måder isyn kan sættes op på, men konstaterer I at jeres opsætning ikke følger standardanbefalingerne heri, vil vi anbefale at ændre disse, så opgradering fremadrettet bliver så enkel som mulig. Teknisk niveau Dette dokument er målrettet teknikere der har viden om virksomhedens webserver, da isyn skal installeres på denne. Det er også forventet at læseren kender til IIS konfigurationen i lille grad. 2 af 11
1 Definitioner Fulde navn Beskrivelse Omtalt som Unik.BoligX.iSyn.WCF.Client Kerneproduktet i isyn løsningen isyn Unik.BoligX.WCF.Service Applikationsserveren som isyn benytter sig af Applikationsserver Usd.EA.LogicmediaConnector Nyt kerneprodukt til nye LM services LM Connector 2 Forudsætninger Teknologi Operativ system.net Framework Applikationsserver Version Windows Server 2008 R2 eller Windows Server 2012 (evt. R2). Nyeste service packs skal være installeret. 4.5.1 (3.5 sp 1 skal også være installeret) Unik.BoligX.WCF.Service.Installer.msi version 4.7.0 se særskilt installationsvejledning samt afsnit 3 med input til struktur for installationen. Installationssæt Unik.BoligX.iSyn.WCF.Client.Installer.msi UnikWCFServiceInstall.exe UnikBolig4InstallerStandard.exe Bemærkninger Dette er det primære installationssæt denne vejledning beskæftiger sig med. Brugen af dette installationssæt er der særskilt vejledning for, men det er en forudsætning at denne også installeres for at isyn kan installeres korrekt. Brugen af dette installationssæt er der særskilt vejledning for, men det er en forudsætning at LM Connector heri også installeres for at isyn vil fungere korrekt. 3 Struktur af installation Alle komponenter (isyn, Applikationsserver og LM Connector) skal installeres på samme maskine, hvorpå der skal være en IIS, og det anbefales at strukturere installationen at de første to komponenter således: 3.1 Application Pools Opret 3 Application Pools så du opnår følgende: 1. Oprettes via Add Application Pool : 3 af 11
a. unikwebservices.ditdomæne.dk Denne er blot til et tomt website, og denne behøver derfor heller ikke noget.net framework. b. unikwebservices.ditdomæne.dk_isynwcfclient Denne er til isyn servicen, og skal derfor køre.net v4.0 Application poolen skal desuden tillade 32 bit applikationer: 4 af 11
3.2 Websites c. unikwebservices.ditdomæne.dk_unikwcfservice Samme opsætning som isyn ovenfor. 1. Opret ét website unikwebservices.ditdomæne.dk og sørg for at det ikke ligger i wwwroot, men f.eks. i C:\inetpub\ unikwebservices.ditdomæne.dk : 5 af 11
3.3 Klar til installation Du har nu den opbygning der skal til, for at kunne installere isyn korrekt. Følger din installation ikke denne opsætning anbefaler vi derfor at du retter det til, dog ikke uden at involvere Logicmedia, da det kan betyde at deres integration med jeres server skal omkonfigureres. 4 Installation af isyn isyn installeres med følgende opsætning: Kører du ikke installationen som lokal administrator vil isyn installationen ikke blive komplet! For at køre det korrekt, kan du starte en kommandoprompt som administrator (Åben startmenuen, skriv CMD og så enten tryk CTRL + SHIFT + ENTER, eller højreklik og vælg Run as administrator ), og starte installationen af msi pakken derfra: 6 af 11
Bemærk at cmd vinduet så vil have Administrator: som præfiks i titlen: 4.1 Konfiguration af DNS isyn er nu sat op til at lytte på unikwebservices.ditdomæne.dk/isynwcfclient, men for at det kald når frem til maskinen skal der sættes DNS opsætning op for subdomænet. Det er imidlertid uden for scopet af denne vejledning, men kan jeres DNS records opsættes så subdomænet unikwebservices peger på jeres webserver, vil det klart være en fordel (hvis ikke I allerede har en wildcard opsætning der sikrer dette). 7 af 11
Alternativt kan det opsættes ved hjælp af en rettelse i hosts filerne (C:\Windows\System32\drivers\etc\hosts) på de maskiner der skal kunne tilgå unikwebservices.ditdomæne.dk (det gælder også maskinen selv hvis du vil teste det direkte derfra). Du indsætter blot den IP adresse som maskinen kan tilgås via, efterfulgt af dit domæne, hvilket også fremgår af eksemplerne der er i hosts filen. 4.2 Konfiguration af sti til Applikationsserveren Efter hver opdatering skal isyn desuden konfigureres til at pege på applikationsserverens url. Derfor anbefales det at der ikke ændres på standarden, så indstillingen kan kopieres fra gang til gang. Indstillingen ændres således: 1. Åben Application Settings for isyn applikationen: 2. Indtast den fulde url til Applikationsserveren (er den url du åbner i punkt 5.2): 5 Test af installation Når installationen er færdiggjort bør din opsætning se således ud: 8 af 11
5.1 Test af isyn For at sandsynliggøre at isyn er korrekt sat op, har isyn en startside med test af forbindelse. 1. Åben websitet: 2. Der bliver du mødt af et testsite, og har du f.eks. ikke fulgt punkt 4.2, vil du blive mødt af følgende fejl: 3. Er det hele korrekt opsat, ser det i stedet således ud: Er der en af de 3 ovenstående der fejler, vil du ikke kunne starte isyn. Her lige en kort forklaring af de 3 punkter: 9 af 11
1) Som allerede nævnt, har du ikke ændret URL en som punkt 4.2 beskriver, får du denne fejl. 2) Er der fejl i URL en fordi du har tastet eller kopieret forkert, fejler denne. Sørg for at kopiere url en direkte fra punkt 5.2. 3) Er der problemer med forbindelsen til Applikationsserveren fejler dette punkt. Se særskilt installationsvejledning til denne for at fejlsøge. Tilbage er der konfigurationen i Bolig 4, som falder uden for formålet af denne installationsvejledning. 5.2 Test af Applikationsserveren Applikationsserveren har særskilt installationsvejledning, men for at sandsynliggøre at denne er sat korrekt op, gøres følgende: 1. Åben websitet (bemærk: det er denne url du skal indtaste i punkt 4.2): 2. Klik på Generelt.svc 10 af 11
3. Får du ovenstående skærmbillede kan Applikationsserveren starte op. 5.3 Test af LM Connectoren LM Connectoren som også er væsentlig for isyn, kan du teste ved at tilgå <url til LM Connector>/api/services : Her vises en liste over installerede services. Vil du lave yderligere tjek kan du tilgå <url til LM Connector>/api/server/health der returnerer en tom side når der ikke er konstateret fejl, og som printer fejlene ud hvis der bliver fundet nogen: Se særskilt vejledning for yderligere fejlfinding heraf. 11 af 11