INSTALLATIONSVEJLEDNING TIL RAMBØLL MOBILECARE Version 5. - 1. juli 2008 Indhold: Installationsvejledning til rambøll MobileCare... 1 Indledning... 2 Forudsætninger... 2 Hardware... 2 Styresystem... 2 Internet Information Server (IIS)... 3 Windows Server 2003 Service PACKS... 4 Microsoft.NET Framework version 1.1... 4 Microsoft.NET Device Update 4.0... 4 MobileCare.config... 4 Oracle Data Provider for.net (ODP.NET)... 5 Oracle NLS_LANG konfiguration... 9 Oracle TNS konfiguration... 9 Opsætning af ASPNET-account... 10 Installation af MobileCare Applikationen... 11 Konfiguration af skrive-rettigheder til log-filer... 13 Webcare.ini-filen... 16 Afinstallation af MobileCare... 17 Kendte fejl efter endt installation... 19 1
Såfremt man foretager en opdatering af en eksisterende MobileCARE installation kan man gå direkte til afsnittet Installation af MobileCARE-applikationen. INDLEDNING Rambøll MobileCare er en browserbaseret applikation. Dvs. at de mobile enheder (fx PDA er eller Communicators) benytter deres indbyggede browser til at afvikle applikationen. Al MobileCare-programmel findes derfor centralt på webserveren (undtagen databasen, der ligger på en særskilt database-server), og ikke lokalt på de mobile enheder. Der foregår ingen caching af websider og der skal ikke installeres noget hjælpeprogrammel på de mobile enheder. FORUDSÆTNINGER Denne vejledning beskriver, hvordan man installerer MobileCare på en webserver. Det forudsættes, at teleudbyderen har etableret et lukket netværk ( Secure-Mobil ), samt at webserveren er placeret således på netværket, at den kan tilgå database-serveren. Installationerne skal udføres i den opførte rækkefølge. HARDWARE Rambøll Informatik anbefaler, at der dedikeres en webserver specifikt til MobileCare, hvorpå der ikke kører andre krævende applikationer. De vigtigste parametre ved valg af server er RAM, CPU og driftssikkerhed. Harddisk plads er af mindre betydning. Et realistisk eksempel på en velfungerende konfiguration er en kommune med op til 500 brugere af MobileCare, hvor der anvendes Proliant DL3XX med dual 3,4 GHZ processorer samt ca. 3GB RAM. Da det kan være vanskeligt præcist at definere hvor meget RAM/CPU-kraft der kræves til et givent antal brugere, og da antallet af brugere ikke er en statisk størrelse, anbefales det, at den indkøbte server har mulighed for RAM-udvidelse. STYRESYSTEM MobileCARE forudsætter anvendelse af Windows Server 2003 som styresystem på den anvendte internet-server. Installationsvejledning til Rambøll MobileCARE - v.5. s. 2
INTERNET INFORMATION SERVER (IIS) Internet Information Services (IIS) skal være installeret/aktiveret. Her vist for IIS version 6.0 som er den version der ligger på Windows Server 2003: Vælg Control Panel >> Add or Remove Programs >> Add/Remove Windows Components. Følgende skærmbillede vises: Sæt et kryds ud for Application Server hvis det ikke er der i forvejen. Marker Application Server. Og klik Details. Følgende skærmbillede vises: Der skal som minimum være kryds ud for ASP.NET og Internet Information Server. Gennemfør en evt. ændret konfiguration ved at klikke Ok i dette billede og derefter Næste i forrige billede som man returnerer til. Installationsvejledning til Rambøll MobileCARE - v.5. s. 3
WINDOWS SERVER 2003 SERVICE PACKS Installer alle de seneste service packs og patches til Windows Server 2003. MICROSOFT.NET FRAMEWORK VERSION 1.1 Installer Microsoft.NET Framework version 1.1. Microsofts.NET Framework v. 1.1 Redistributable Package kan downloades på følgende URL: http://www.microsoft.com/downloads/details.aspx?familyid=262d25e3-f589-4842-8157-034d1e7cf3a3&displaylang=en til harddisken. Dobbelt-klik på filen, der derefter vil installere frameworket. Frameworket bruges til at afvikle programmer, der er udviklet inden for Microsofts.NET-platform. Installer også de seneste Service Packs til.net Framework. I skrivende øjeblik er det service pack 1..Net Framework 1.1 Service Pack 1 kan downloades her: http://www.microsoft.com/downloads/details.aspx?familyid=a8f5654f-088e-40b2-bbdb- A83353618B38&displaylang=en MICROSOFT.NET DEVICE UPDATE 4.0 Download Microsoft.NET Device Update 4.0 (eller nyere) på følgende URL: http://www.microsoft.com/downloads/details.aspx?familyid=02fa15fe-40d9-4dce-9bb1-4dd61a5b7ccb&displaylang=en Dobbelt-klik på filen, der derefter vil installere device update 4. Microsoft udsender nu og da nye device updates til deres framework. En device update er en instruksfil til frameworket om at behandle en given mobil enhed på en bestemt måde (fx om enheden understøtter en bestemt teknisk feature). MOBILECARE.CONFIG I forlængelse af installationen af Device Update 4.0 er det nødvendigt at installere en applikationsspecifik fil kaldet MobileCare.config, der ligger som en del af den udpakkede installationsfil. Fx vil en Qtek 2020 ikke kunne ringe automatisk op til telefonnumre i applikationen, hvis dette ikke er gjort. Filen skal placeres i samme mappe som filen machine.config, der typisk ligger i C:\WINDOWS\Microsoft.NET\Framework\v1.1.4322\CONFIG. Følgende vejledning kan først følges efter installation af Device Update 4 Start med at kopiere MobileCare.config ind i denne CONFIG-mappe. Åben filen machine.config i en teksteditor som fx Notepad. Søg efter ordet deviceupdate4. Resultatet er en række referencer til de netop installerede device update filer (1,3 og 4). Kopier strengen <file src="deviceupdate4.config" /> Paste strengen ind umiddelbart efter den eksisterende streng, og ændr filnavn til MobileCare.config vær opmærksom på, at der er forskel på store og små bogstaver. Resultatet skal se således ud, hvor den gule markering viser tilføjningen: ---------------------------- <klip> -------------------------------- <file src="deviceupdate3.config" /> <file src="deviceupdate4.config" /> <file src="mobilecare.config" /> ---------------------------- <klip> -------------------------------- Gem filen og luk den. Installationsvejledning til Rambøll MobileCARE - v.5. s. 4
ORACLE DATA PROVIDER FOR.NET (ODP.NET) Download filen ODAC1020221.exe fra følgende URL: http://www.oracle.com/technology/software/tech/windows/odpnet/utilsoft.html Link til filen ses under afsnittet Oracle 10g Release 2 ODAC. Filen fylder 206 MB. Filen er gratis at hente, men Oracle kræver, at man opretter en brugerkonto (hvilket også er gratis og går hurtigt). Data Provideren (ODP.NET) er nødvendig for at.net-baserede applikationer kan kommunikere med en Oracle-database. ODP.NET installerer bl.a. en Oracle 10-klient på maskinen. Det er vigtigt, at der ikke kører andre Oracle-afhængige applikationer på web-serveren, da Oracle 10-klienten er meget hårdhændet overfor ældre drivere. Følg installationsvejledningen fra Oracles hjemmeside for at installere ODP.NET: http://www.oracle.com/technology/software/tech/windows/odpnet/install10202.html Kør filen ODAC1020221.exe for at udpakke installationsfilerne. Kør installations-programmet ved at køre filen setup.exe i underfolderen \Install Skærmbilleder fra installationsprocessen er vist nedenfor. Klik "Next" Installationsvejledning til Rambøll MobileCARE - v.5. s. 5
Vælg "Oracle Data Access Components 10.2.02 xx" (som er default) og klik "Next". Vælg et navn for Oracle-Home og en installations-sti. Giv ODP.NET sit eget Oracle Home. Hvis der allerede eksisterer et Oracle10-home på serveren, så benyt et andet navn, fx Oracle10net Klik "Next" Installationsvejledning til Rambøll MobileCARE - v.5. s. 6
Vælg kun Oracle Data Provider for.net 1.x 10.2.02.20 Klik "Next" Klik "Install" Installationsvejledning til Rambøll MobileCARE - v.5. s. 7
Installationen kører... Installationen er færdig. Klik "Exit" Installationsvejledning til Rambøll MobileCARE - v.5. s. 8
ORACLE NLS_LANG KONFIGURATION Det er vigtigt at den installerede Oracle Provider ODP.NET anvender den rigtige sprogkonfiguration. Konkret skal man sørge for at Oracle-parameteren NLS_LANG er sat til DANISH_DENMARK.WE8ISO8859P1. Oracle anviser forskellige måder man kan indstille denne Oracle-Parameter på. F.eks. kan man sætte den direkte i registry på maskinen: Gå ind i Registry (kommandoen REGEDIT) og vælg HKEY_LOCAL_MACHINE -> SOFTWARE -> ORACLE. Find alle de steder (også underfoldere) hvor parameteren NLS_LANG forekommer og kontroller at værdien er sat til DANISH_DENMARK.WE8ISO8859P1. ORACLE TNS KONFIGURATION For at MobileCARE kan finde den Oracle-database der skal hentes og gemmes data fra, skal der defineres et såkaldt TNS-navn for database-forbindelsen. Dette skal angives i filen tnsnames.ora der ligger i underfolderen..\network\admin\ i den folder man har valgt at installere ODP.NET softwaren i. Dette bør konfigureres af en database-administrator eller en person med kendskab til konfiguration af TNSnavne og beskrives derfor ikke yderligere her. Det vigtige her, er adet valgte TNS-navn for databaseforbindelsen angives i filen WebCARE.ini som er beskrevet senere i denne vejledning. Installationsvejledning til Rambøll MobileCARE - v.5. s. 9
OPSÆTNING AF ASPNET-ACCOUNT Efter installation af.net framework er der lagt en ny lokal brugerkonto (ASPNET) ind i systemet. Denne bruger skal have følgende rettigheder til Rod-websitet (eks. C:\inetpub\wwwroot) og underbiblioteker. Read & execute list folder contents read (Note ang. Windows Server 2003: Hvis der ikke findes nogen brugerkonto ved navn ASPNET på computeren, er det fordi ASP.NET ikke er aktiveret endnu. Gør følgende: Controlpanel >> Add/remove programs >> Add/remove Windows components >> Marker Application Server >> Tryk Details >> Sæt kryds i ASP.NET >> Klik OK >> Klik Next. Serveren har nu tilføjet ASPNET-kontoen.) Desuden skal kontoen have read & execute rettigheder til Oracle-folderens bin-bibliotek (navnet på Oraclefolderen valgte du selv under installationen af ODP.NET.). Bin biblioteket skal derudover være i maskinens path - dette burde ODP.NET installeren dog selv sørge for. Efter at disse rettigheder er sat, skal maskinen genstartes. Installationsvejledning til Rambøll MobileCARE - v.5. s. 10
INSTALLATION AF MOBILECARE APPLIKATIONEN Download MobileCARE leveres som en ZIP-fil der kan downloades fra InterCARE (under menupunktet Versioner ). Vær opmærksom på at vælge den version af MobileCare, som passer til den anvendte version af CARE. Når ZIP-filen er udpakket vil man se en filmappe med navnet MobileCARE_xxxxx_RTM (hvor xxxx er versionsnummeret). Installation Den udpakkede filmappe skal kopieres med alt indhold til Internet Serverens rodwebsite (c:\inetpub\wwwroot\). Såfremt man foretager en opdatering af en eksisterende MobileCARE installation skal man først afinstallere denne, som beskrevet i afsnittet Afinstallation af MobileCARE. Man skal dog huske at gemme en kopi af den eksisterende version af filen WebCare.INI, som indeholder navnet på CARE-databasen og andre konfigurations-indstillinger. Efter at den nye version af MobileCARE er kopieret og navngivet, kan man så kopiere den gamle WebCare.INI fil til den nye installation. Navngivning Det anbefales at man omdøber filmappens navn til en navngivning efter eget ønske. Man kan f.eks. blot kalde filmappen MobileCARE. Bemærk at man godt kan have flere MobileCARE applikationer på den samme InternetServer de skal blot installeres i hver sin filmappe med hvert sin filmappenavn. F.eks. kunne man også installere en MobileCARE applikation til sit uddannelsesmiljø og navngive filmappen MobileCARE_UDV. Konfiguration Derefter skal applikationen konfigureres som en IIS-applikation på følgende måde: Åbn IIS Manager programmet (ved at vælge Start-menu >> Run >> skriv INETMGR og tryk OK) og klik som vist i følgende figur frem til Default Web Site-mappen. Herunder skal man finde den filmappe som man har kopieret og navngivet. Højreklik på folderen (i dette eksempel navngivet MobileCARE ) og vælg Properties i menuen. Følgende skærmbillede vises: Installationsvejledning til Rambøll MobileCARE - v.5. s. 11
Klik på Create. Nu er applikationen aktiveret. Konfigurer derefter en default start side på følgende måde. Vælg fanebladet Documents som vist i skærmbilledet nedenfor. Klik på Remove 3-5 gange for at fjerne alle de eksisterende linier. Klik på Add og indtast LoginUI.aspx i den popup der vises. Klik Ok. Skærmbilledet skal nu se ud som vist ovenfor. Klik til sidst på Ok for at afslutte. Figur 1: MobileCare er aktiv på IIS Installationsvejledning til Rambøll MobileCARE - v.5. s. 12
KONFIGURATION AF SKRIVE-RETTIGHEDER TIL LOG-FILER MobileCARE-applikationen placerer sine log-filer i filfolderen Log under folderen MobileCARE. Applikationen skal tildeles skriverettigheder til denne folder. I IIS-manager programmet vælges folderen Log og man højre-klikker på denne, for at få vist en menu. Vælg Permissions så du ser følgende skærmbillede: Bemærk at brugeren IIS_WPG allerede star på listen med nedarvede rettigheder (uden skriverettighed) fra et niveau højere oppe. Klik på Advanced. Følgende billede vises: Klik på Add. Følgende billede vises: Installationsvejledning til Rambøll MobileCARE - v.5. s. 13
Indtast det fulde navn på brugeren IIS_WPG dvs.: <servernavn>\iis_wpg. Klik Ok. Følgende skærmbillede vises: Sæt kryds I kolonnen Allow ud for de fire rettigheder: Create Files / Write Data Create Folders / / Append Data Write Attributes Write Extended Attributes Klik på Ok Man returnerer til følgende skærmbillede: Installationsvejledning til Rambøll MobileCARE - v.5. s. 14
Klik ok Man returnerer til følgende skærmbillede: Klik på Ok Man er nu tilbage i IIS Manager programmet og kan lukke dette. Installationsvejledning til Rambøll MobileCARE - v.5. s. 15
WEBCARE.INI-FILEN I MobileCare-mappen ligger filen webcare.ini. I den skal kommunen anføre nogle kommunespecifikke indstillinger. Se vejledningen MobileCARE kommunespecifik konfiguration.pdf for en beskrivelse af de parametre, der er indeholdt i webcare.ini. Installationsvejledning til Rambøll MobileCARE - v.5. s. 16
AFINSTALLATION AF MOBILECARE Såfremt MobileCare afinstalleres i forbindelse med en opdatering til en nyere version, starter man med at gemme en kopi af filen WebCare.INI. Åbn IIS Manager programmet (ved at vælge Start-menu >> Run >> skriv INETMGR og tryk OK) og klik som vist i følgende figur frem til Default Web Site-mappen. Herunder skal man finde den filmappe som repræsenterer den MobileCARE-applikation som man vil afinstallere. Højreklik på folderen (i dette eksempel navngivet MobileCARE ) og vælg Properties i menuen. Følgende skærmbillede vises: Klik på Remove for at fjerne aktiveringen af applikationen. Afslut med at klikke på Ok. Installationsvejledning til Rambøll MobileCARE - v.5. s. 17
Nu kan de fysiske filer som MobileCARE-applikationen består af fjernes. Find den filmappe hvor MobileCARE-applikationen ligger. Filfolderen skal findes under Internet Serverens rodwebsite, dvs i filmappen c:\inetpub\wwwroot\. Det kunne f.eks. være folderen MobileCARE (med den fulde sti c:\inetpub\wwwroot\mobilecare\). Slet filmappen og alt dens indhold. Såfremt man får en besked om at man ikke kan slette en eller flere filer, kan det være nødvendigt at genstarte Internet Serveren ved at vælge Start-menu >> Run >> skrive IISRESET og klikke på OK. Derefter kan man forsøge at slette filerne igen. Installationsvejledning til Rambøll MobileCARE - v.5. s. 18
LOGINUI.ASPX KAN IKKE VISES KENDTE FEJL EFTER ENDT INSTALLATION Beskrivelse: Når man forsøger at få vist loginui.aspx hænger browseren længe og når aldrig frem til at få vist siden. Muligvis forekommer der er en time-out fejlmeddelelse. Årsag: Hver gang en bruger forsøger at tilgå en fil ved navn *.aspx bliver serverens machine.config læst igennem. Hvis der er nogen fejl i denne config-fil, vil serveren ikke returnere derfra. Procedure: machine.config er blevet redigeret af systemadministrator ved tilføjelsen af linket til MobileCare.config. Undersøg, at den tilføjede tekst er absolut korrekt, og at der ikke er blevet slettet noget af det eksisterende ved redigeringen. Et eksempel på en korrekt tilføjelse er vist i afsnittet MobileCare.config. Installationsvejledning til Rambøll MobileCARE - v.5. s. 19