Driftsdokumentasjon NPK v 15.0.0.0 side 1 Driftsdokumentasjon Norsk Pasientklassifisering Versjon 15.0.0.0 INNHOLDSFORTEGNELSE 1 STANDARD INSTALLASJON AV NPK...2 1.1 STANDARD INSTALLASJON AV NPK 15.0.0.0 (NPK 2014)...2 1.2 EVT. MANUELL INSTALLASJON AV SQL DATABASEMOTOR I NPK...3 1.3 EVT. PROBLEMER MED REFERANSEVERDIER - KJØRING AV RAPPORTER...4 2 KONFIGURERINGSMULIGHETER I NPK...5 2.1 GENERELT...5 2.2 BRUKERINNSTILLINGER FRA PROGRAMMET...5 2.3 INNSTILLINGER I KONFIGURASJONSFIL VED HJELP AV REDIGERING I NPKEXE.CONFIG...6 2.3.1 Generelt om konfigurasjonsfilen... 6 2.3.2 Oversikt over de nøkler i NPK.exe.config som kan konfigureres... 7 3 SENTRALISERT INSTALLASJON AV PROGRAMFILER...8 4 INSTALLASJON MED SENTRALISERT SQL-SERVER...12 4.1 SQL-SERVERRETTIGHETER...13 4.2 KONFIGURASJONSENDRINGER I NPK...13 5 TILLEGGSINFORMASJON OM MSSQL: SIKKERHET OG ROLLER I MSSQLSERVER.15 6 NPK SATSVIS KJØRING FRA KOMMANDOLINJE....17 Nirvaco AS Gjerdrums vei 12G 0484 Oslo Tlf. 23 00 60 00 Fax: 23 00 60 01 www.nirvaco.no npk@nirvaco.no For dokumentasjon av databaseinnhold og logikk www.nirvaco.no
Driftsdokumentasjon NPK v 15.0.0.0 side 2 1 Standard installasjon av NPK Leveranse av NPK til institusjoner og foretak er i utgangspunktet beregnet for installasjon på enkeltstående PC-er for å gjøre installasjonen enklere. Imidlertid kan NPK installeres i nettverk med følgende funksjonalitet: At databasen ligger på server og er felles for flere brukere At NPK programvaren ligger på server og er felles for flere brukere (fordel ved endringer m.v. - oppdatering ett sted) I tillegg distribueres filer og komponenter slik at institusjoner og foretak kan tilpasse NPK installasjonen til egne utrullingsrutiner for programvare. NPK er tilpasset XML rapporteringsformatet (NPR Melding) og i bestillingen fra Helsedirektoratet er det krav om database. For effektiv håndtering av XML benyttes Microsofts.NET plattform og for at institusjonen skal slippe å utløse lisenser for SQL database benyttes Microsofts SQLServer Express (2008) som standard. Lisensiert SQL Server 2008 kan selvsagt også benyttes. Installasjon av NPK og disse komponentene krever lokale administratorrettigheter til maskinen og er følsomme for andre servicer som går i maskinen, f.eks viruskontroll. Dersom det oppstår problemer med standardinstallasjonen kikk på www.nirvaco.no - NPK sidene etter kjente installasjonsproblemer. Her beskriver vi likevel noen generelle problemstillinger dersom det er problemer med standardinstallasjonen. 1.1 Standard installasjon av NPK 15.0.0.0 (NPK 2015) Versjon 15.0.0.0 av NPK er teknisk sett lik 2012, 2013 og 2014 versjonene Dersom tidligere versjoner er installert, er det tilstrekkelig å eksekvere.msi-filen NPK.msi. Dersom man ønsker nyinstallasjon på maskin hvor.net Framework ikke har vært installert eller er manuelt avinstallert, må.net Framework først installeres. Dette kan lastes ned fra Microsoft. Dersom NPK er installert fra før vil installasjonsprogrammet for versjon 15.0.0.0 tar vare på eksisterende konfigurasjonsfil (NPK.exe.config) slik at nøkler som er modifisert eller lagt til vil bli bevart også etter oppdatering. Men det er to unntak fra dette: 1. Nøkkelen "DataDir" vil alltid få den verdien som angis ved installasjon. 2. Nøkkelen "Server" vil alltid få den verdien som angis ved installasjon.
Driftsdokumentasjon NPK v 15.0.0.0 side 3 Dette betyr at dersom man har endret verdiene for disse to nøklene i forhold til standard installasjonsforslagene, må man passe på å angi de endrede verdiene også ved reinstallasjon/oppdatering. Dersom man skulle glemme å angi korrekte verdier her (eller ikke husker dem) kan nøklene selvfølgelig endres manuelt i ettertid. Den konfigurasjonsfilen som evt. eksisterte før reinstallasjon/oppdatering vil kunne finnes på maskinens temp-katalog. 1.2 Evt. manuell installasjon av SQL databasemotor i NPK Dette er ikke nødvendig ved standardinstallasjon, men kun ved eventuelle problemer eller ønske om endringer. Dersom en ved oppstart av NPK får skjermbildet: Er det fordi NPK programmet ikke finner eller ikke har tilgang til databasen. Dersom NPK kjøres mot lokal på SQL Express (og ikke på eksisterende SQL Server lokalt eller i nettverket som i såfall har involvert settinger fra bruker eller IT-avdeling utenfor NPKs kontroll) kan dette tyde på at SQL Express motoren ikke har blitt installert korrekt. Kontroll av om SQL Express eller NPKServer går: Gå i kontrollpanel adminstrative oppgaver tjenester (Services) og sjekk om NPKSERVER2008 har startet. (Kan startes ved høyre musetast) Kontroll av om SQL Express motoren eller ordinær SQL Server er installert: Sjekk om Microsoft SQL Express (NPKSERVER) er installert på maskinen gjennom Kontrollpanel - Legg til og fjern programmer
Driftsdokumentasjon NPK v 15.0.0.0 side 4 Dersom den ikke er der er problemet diagnostisert. Årsaken kan være at en ved installasjon av NPK har endret databasebane og da installeres Express automatisk fordi en i disse tilfellene forutsetter at institusjonen har eget opplegg for SQL databasehåndtering. Installasjon av MSDE og NPKSERVER: Installer SQL Express og NPKSERVER manuelt fra SQL Express katalogen Nirvaco`s NPK CD Eller foreta en manuell installasjon med logg: E:\MSDE\setup.exe INSTANCENAME=NPKServer SAPWD=npk SECURITYMODE=MIX /L*V c:\sqllog.txt Husk space før INSTANCENAME, SAPWD og SECURITYMODE Loggen vil da finnes igjen på C rot. Følg installasjonsprogrammets instrukser mht restart. Sjekk evt om SQL Server er startet som anvist ovenfor. Start opp NPK og la det få god til å registrere seg. Last data. 1.3 Evt. problemer med referanseverdier - kjøring av rapporter Første gang NPK kjøres vil den dersom det ikke er gjort før, laste databasen med referanseverdier som f.eks institusjonsnavn osv. Når databasen er skiftet som angitt over kun gjennom config endringen anser NPK programmet som dette utført - da det ikke vet om skiftet. Derfor må følgende foretas i NPK ved første gangs kjøring: Velg Oppgaver - Oppdater fast databaseinformasjon Eller dersom dette ikke foretar korrekt lasting følg denne anvisningen:
Driftsdokumentasjon NPK v 15.0.0.0 side 5 Slett.BAK endringen (BAK vedlegget kommer når NPK legger inn referansedata - nå vil programmet tro at dette ikke er gjort og laste inn på nytt ved neste NPK kjøring) Kjør NPK på nytt - laste data på nytt - vent en god stund slik at en er sikker på at alt er registrert - prøve rapporter igjen 2 Konfigureringsmuligheter i NPK 2.1 Generelt Der er ulike konfigurasjonsmuligheter/innstillinger i NPK. I prinsippet gis to muligheter for å konfigurere programmet: Brukerinnstillinger: Innstillinger som brukeren selv kan sette gjennom programmet. Av slike innstillinger er det to typer; permanente og midlertidige. Permanente innstillinger lagres pr. bruker i det som i.net kalles Isolated Storage. Isolated Storage er en del av brukerprofilen for den enkelte bruker på en gitt maskin (på samme måte som f.eks. skrivebordsinnstillinger). Dette følger brukeren, også ved bruk av såkalte roaming profiles. Midlertidige innstillinger settes gjennom en egen dialog i NPK og vil bare være gjeldende for den sesjonen som kjører i øyeblikket. Går du ut av NPK vil evt. midlertidige innstillinger være slettet og programmet er konfigurert slik konfigurasjonsfilen, de permanente innstillingene og evt. programmets standardverdier tilsier. Innstillinger i konfigurasjonsfil: Konfigurering ved hjelp av en såkalt konfigurasjonsfil (NPK.exe.config finnes i program katalogen). Denne.xml-filen må redigeres manuelt, se nedenfor om standard-installasjon.. 2.2 Brukerinnstillinger fra programmet Tilgang til de permanente innstilligene finnes på menylinjen - Innstillinger. Brukeren kan selv konfigurere permanent: Hvorvidt startdialogen skal vises (Innstillinger Vis intro standard På) Målform (standard bokmål) Fargebruk (standard grå)
Driftsdokumentasjon NPK v 15.0.0.0 side 6 Antall fatale feil før oppgave blir avbrutt (standard 50 - max 200000) Separat eller samlet resultat (standard separat: data som ikke gir ISFrefusjon i egen fil/database) Timeout i minutter angir ventetiden fra en ordre til databasen settes i gang til SQL-serveren rapporterer ferdig til NPK. Standardverdi er satt til 5 min., kan være aktuelt å øke denne for store databaser (med feks. flere institusjoner i samme database). I tillegg kan brukeren for gjeldende sesjon sette flg. midlertidige innstillinger: Antall fatale feil før oppgave blir avbrutt (standard 50 - max 200000) År for ISF refusjonsliste År for DRG grupperingslogikk Produksjonsår Databasenavn Følgende innstillinger er i tillegg tilgjengelige hvis programmet er konfigurert med nprfunction=yes i konfigurasjonsfilen (se senere): Katalog for midlertidige databasefiler (database Backup-filer) Katalog for midlertidige resultatfiler (.xml resultatfiler for databaselasting) Servernavn Bruk av klarert tilkobling ( trusted connection ) eller SQL login Mulighet for å slå av NPK s standardfunksjon ved databaselasting; erstatter datasett i databasen institusjonsvis (standard På) 2.3 Innstillinger i konfigurasjonsfil ved hjelp av redigering i NPKexe.config 2.3.1 Generelt om konfigurasjonsfilen Noen få opplysninger må være angitt i NPKexe.config filen. Disse opplysningene blir som standard lagt inn i konfigurasjonsfilen ved installering: Datakatalog Server Database Klarert tilkobling ( Trusted Connection /Integrated Security ) I tillegg har vi valgt å legge inn nøkkelen for NPR-funksjoner/landsfunksjoner (yes/no) i standard-installasjonen. Ulike egenskaper/parametre kan styres direkte fra konfigurasjonsfilen. Disse parametre betegnes nøkkel (key) i konfigurasjonsfilen og skal tilordnes en verdi (value) NPK.exe.config er en xml-fil der hver opplysning følger mønsteret : <add key="nøkkel" value="verdi" /> NB! Dersom nøkkelen ikke er angitt, benyttes programmets innebygde standardverdier.
Driftsdokumentasjon NPK v 15.0.0.0 side 7 Katalogangivelser skal slutte med backslash, \). Nøklene må staves riktig, men det skilles IKKE mellom store og små bokstaver. 2.3.2 Oversikt over de nøkler i NPK.exe.config som kan konfigureres Nøkkel Forklaring Standard verdi ProgramDir Installasjons-katalog C:\Programfiler\Norsk Pasientklassifisering DataDir Datakatalog C:\NPKData Server Databaseserver, standard angivelse <server>\<instans-navn>. Dersom man ikke benytter instansnavn angis kun servernavn. (local)\npkserver ServerLocked Gjør det mulig å angi alternativ server for <Server> plassering av <DatabaseLocked> Database Databasenavn NPKDb DatabaseLocked TrustedConnection Nprfunction Navn på databasen hvor det foretaes låsing av episoder tilhørende angitt tertial. Benytt klarert tilkobling/integrated security ved database login. Hvis verdien endres til no (eller pålogging med klarert tilkobling ikke lykkes) vil man bli bedt om å angi brukernavn/ passord i egen dialog. NPKDb er i utgangspunktet gitt en sa-bruker med passord npk. Slår av/på såkalte landsfunksjoner /NPRfunksjoner. Endres verdien her til yes, vil man få: <Database>Locked yes no Tilgang til en automat-funksjon som tillater brukeren å angi en spesifikk datakatalog hvor programmet vil behandle de filene som ligger under katalogen i tur og orden uten brukerinngripen. Tilgang til å modifisere flere parametre under Midlertidige innstillinger (se overfor). OutDirISF DBTempDir SkipBackup ResultTempDir Katalog for flatfil /.drg-fil. Navngivningskonvensjon: <Filnavn>_<ext>. drg <Filnavn>_<ext>Alt. drg Katalog for midlertidige databasefiler (dvs. backup-filer fra databasen). Denne katalogangivelsen må være relativ til den maskin SQL-server kjøres på. Gir mulighet for å sløyfe backup av databasen før lasting av ny fil. Vil bedre ytelsen vesentlig ved lasting av mange filer i samme kjøring. Katalog for midlertidige.xml-filer som benyttes ved lasting av NPK-databaser. Filen overskrives <DataDir>\Resultat\ <DataDir>\tempdbfile\ no <DataDir>\tempresult\
Driftsdokumentasjon NPK v 15.0.0.0 side 8 ved hver ny lasting. Navngivingskonvensjon: Resultat.xml ResultatIkkeInkl.xml(dersom separate databaser er valgt) LogDir Katalog for logg-filer <DataDir>\log\ LockedLogDir ResultSchemaEpisode ResultSchemaDiagnose ResultSchemaProsedyre ResultSchemaTakst ReferenceSchema ResultSchemaKVKorre ksjon Referansefiler DRGPath FlatFileOutOldBnnid UseCorrWeightInAggr Katalogangivelse for log-filer produsert ved kjøring i låst-modus. Skjema som benyttes ved lasting av databasetabellen Episodedata. Skjema som benyttes ved lasting av databasetabellen Diagnoser. Skjema som benyttes ved lasting av databasetabellen Prosedyrer. Skjema som benyttes ved lasting av databasetabellen Takster. Skjema som benyttes ved lasting av databasetabellene Ref<xxxxxxx>. Skjema som benyttes ved lasting av databasetabellen KorrVektKorreksjoner Katalog for.csv-filer (semikolonseparerte) som inneholder datagrunnlaget for referansetabellene i databasen (Ref<xxxxxxx>) Katalog for beliggenhet av DRG grupperingslogikk-filer Konverter nye foretaksnummer til gamle bnnnummer ved utskrift til *.drg-filer (gammelt flatfilformat) <Datadir>\Lockedlog <programdir>\schemas\re sultdbepisode.xsd <programdir>\schemas\re sultdbdiagnose.xsd <programdir>\schemas\re sultdbprosedyre.xsd <programdir>\schemas\re sultdbtakst.xsd <programdir>\schemas\ref eransetabeller.xsd <programdir>\schemas\re sultdbkorrvektkorreksjon.x sd <programdir>\referencefile s\ <programdir> no no 3 Sentralisert installasjon av programfiler NB! Det forutsettes at det som er beskrevet nedenfor blir utført av eller i samråd med IT personell, og at sikkerhetspolitikkendringer (security policy), databasetilganger og rettigheter m.v. blir gitt av SQL kompetent personale. Nirvaco kan eventuelt som konsulentoppdrag i samarbeid med institusjonens IT personale utføre tilrettelegging av slik utvidet bruk av NPK.
Driftsdokumentasjon NPK v 15.0.0.0 side 9 Generelt Standardinstallasjonen av NPK tar (som bestilt) utgangspunkt i at NPK, både mht. programfiler og database, installeres på én PC. Det er imidlertid fullt mulig å installere NPK i nettverk med både programfiler, datafiler og database på sentraliserte servere. NPK har rike konfigurasjonsmuligheter (se egen oversikt) som muliggjør lokal tilpasning av nær sagt alle innstillinger. Sentralisert installasjon av programfiler ( fil-server -installasjon) NPK er et.net-basert program. Det forutsettes derfor at.net-plattformen er installert både på server og klientmaskin. Videre er programmet designet for å håndtere.xml-baserte data, både i forhold til rådatafiler fra PAS-systemene og resultatfiler/resultatdatabase. Det er derfor også nødvendig å installere SOAP og XMLSQL-ressursfiler både på server og klient. For å kunne kommunisere med database kreves MDAC v. 2.7 og SQLDMO. For å kunne kjøre rapporter kreves CrystalReport runtime-moduler. OBS! Alle nødvendige installasjonspakker ligger på installasjonscd-en (se under katalogen \Tillegg\...) og kan fritt benyttes enten for manuelle oppsett eller som grunnlag for lokale, automatiserte installasjoner.
Driftsdokumentasjon NPK v 15.0.0.0 side 10 Serverinstallasjon Metode 1 Den enkleste, og sikreste, måten å installere en felles filserver på, er å foreta en såkalt administrativ installasjon av NPK.msi. Denne installasjonen vil også produsere en redusert NPK.msi som kan benyttes for installasjon av nødvendige ressurs-komponenter på klient-maskiner (.Net Framework må i slike sammenhenger installeres separat eller bundles med klientkomponentene) Administrativ installasjon på filserver foretaes ved å kjøre kommandoen: msiexec /a <installasjonskatalog>\npk.msi fra den katalog på filserver som man på forhånd har definert. I eksemplet nedenfor er katalogen npk-admin opprettet på filserveren. Det danner seg ved installasjonen en katalog-/filstruktur som vist nedenfor: Filen NPK.msi som produseres (i overstående eksempel på katalogen npkadmin) vil så kunne benyttes for komponentinstallasjon på klient-pc er.
Driftsdokumentasjon NPK v 15.0.0.0 side 11 Metode 2 Det er også mulig å installere en filserver ved å kjøre installasjonscd en direkte på serveren og kjøre en ren standardinstallasjon. (Start NPK.exe på CD en). Dette vil sørge for at.net-plattform og alle nødvendige komponenter blir korrekt installert. NPK vil da installeres på serverområde c:\programfiler\norsk PasientKlassifisering med et fast sett underkataloger (se egen beskrivelse) hvor nødvendige CR-rapporter, referansefiler og.xsd-skjemaer er korrekt plassert (kan dog hvis ønskelig konfigureres spesielt i konfigurasjonsfilen). Konfigurasjonsfilen har ved standardinstallasjon flg. settinger: <?xml version="1.0" encoding="windows-1252"?> <configuration> <appsettings> <!-- User application and configured property settings go here.--> <!-- Example: <add key="settingname" value="settingvalue"/> --> <add key="datadir" value="c:\npkdata\" /> <add key="server" value = "(LOCAL)\NPKServer"/> <add key="database" value = "NPKDB"/> <add key="trustedconnection" value="yes"/> <add key="nprfunction" value="no"/> </appsettings> </configuration> Dersom NPK-programmet etter en slik standardinstallasjon på server startes fra programområdet på serveren (f.eks. ved hjelp av en snarvei på klienten), vil verdiene i konfigursjonsfilen betraktes som lokale sett fra klientens side. Dette betyr feks. at DataDir-katalogen blir opprettet på klienten hvis den ikke allerede eksisterer som C:\NPKData og at det er forutsatt at en SQL-server med instansnavn NPKServer finnes på klienten, selv om standardinstallasjonen har installert MSDE på serveren. Hvis man ikke ønsker å installere MSDE på serveren (og det ønsker man neppe i et slikt scenarie), stryker man SQLservernavn-angivelsen under installasjon eller skriver inn servernavn for den sentraliserte SQL-server man evnt. ønsker å benytte se senere). OBS! Dersom man strøket SQL-servernavn under installasjonen, må dette redigeres manuelt inn i konfigurasjonsfilen etter installasjon NPK har ingen innebygd standardverdi for SQL-servernavn. Klientinstallasjon I utgangspunktet behøves ingen lokal installasjon av NPK-programvare på klient dersom man ønsker å eksekvere programmet fra en filserver. Det vil være tilstrekkelig å lage en snarvei til NPK.exe på filserverens programkatalog. Dersom man benytter NPK.msi som er produsert ved administrativ installasjon vil de nødvendige ressurskomponenter installeres (.NET Framework (v.1.1 eller 2.0) må være installert på forhånd) Som nevnt finnes på installasjonscd-en alle komponenter som behøves (...\Tillegg\...).
Driftsdokumentasjon NPK v 15.0.0.0 side 12 Hvis man ønsker å lage en egen installasjonsrutine må de ulike komponentene installeres i flg. rekkefølge) (hvis de ikke allerede er installert på klienten): 1..NET-plattform (..\Tillegg\dotNet_2.0\dotnetfx.exe) 2. MDAC (..\Tillegg\MDAC2.7\mdac_typ_en/no.exe velg språkversjon, _no vil antakelig være korrekt for de fleste) 3. SOAP (..\Tillegg\Soap Toolkit\SoapToolkit20.exe) 4. SQLXML (..\Tillegg\SQLXML\sqlxml.msi) 5. CrystalReport komponenter for å kunne kjøre rapporter (..\Tillegg\CrystalReport\*.msm) som må inkorporeres i en vanlig msiinstallasjon. OBS!! OBS!! I.Net Framework er det strammet inn betraktelig på default sikkerhetspolicy i forhold til internt nett/intranett. I utgangspunktet får man ikke eksekvere kode på en annen maskin i nettet (i overnevnte tilfelle filserveren ). Det vil derfor være nødvendig å endre Intranett Security policy på klienten. Dette kan gjøres ved hjelp av vedlagte installerscript (finnes på CD en:..\tillegg\security Policy Change\Intranet_secpol.msi) eller manuelt fra Control Panel\Administrativ Tools\Microsoft.Net Framework 1.1. Wizards (på NT6.0 finner man dette under Programmer/Administrative tools). Velg Adjust.net Security, Next, Local Intranet og sett Level of trust til "Full trust". 4 Installasjon med sentralisert SQL-server (Ta kontakt med Nirvaco AS for lokal tilpasning av SQL Server installasjonen, da denne oppskriften ikke er implementerbar i alle miljøer) NB! Det forutsettes at det som er beskrevet nedenfor blir utført av eller i samråd med IT personell, og at sikkerhetspolitikkendringer (security policy), databasetilganger og rettigheter m.v. blir gitt av SQL kompetent personale. Nirvaco kan eventuelt som konsulentoppdrag i samarbeid med institusjonens IT personale utføre tilrettelegging av slik utvidet bruk av NPK. NPK laster data til en MSSQL-database. Standardinstallasjonen for NPK installerer Microsofts Desktop SQL databasemotor (MSDE) på lokal maskin med instansnavn NPKserver og åpent sa-passord npk. Dersom den bruker som er pålogget maskinen har lokal administrator -rettigheter foretaes en trusted
Driftsdokumentasjon NPK v 15.0.0.0 side 13 pålogging ved standard windows-gruppe BUILTIN\Administrators. Hvis pålogget bruker ikke har slike rettigheter vil NPK automatisk logge på som sa (gitt at nøkkelen TrustedConnection ikke er endret i konfigurasjonsfilen). For institusjoner som ønsker å benytte NPK i et nettverk mot en felles MSSQLserver krever dette enkle endringer i konfigurasjonsfilen når det gjelder selve NPK programvaren. Disse endringer vil bli beskrevet senere. 4.1 SQL-serverrettigheter NPK forutsetter imidlertid at brukerene fritt kan administrere sine databaser, deriblant fritt kreere, ta backup/restore,slette databasen(e) og administrere databasenens tabeller, views og functions. Dersom det benyttes en MSSQL-server som ikke er dedikert NPK, er det sansynligvis forbundet med både driftsmessige og sikkerhetsmessige risiko å gi NPK-brukere administrative rettigheter på servernivå. I SQL-server 2000 (og MSDE) finnes imidlertid faste serverroller som kan med hell kan benyttes uten drifts- eller sikkerhetsmessige risiko. Til orientering vedlegges et notat hvor de ulike rollebegrepene i MSSQL-server er omtalt og kortfattet forklart ( Sikkerhet og Roller i MSSQLServer.doc ). Ved å tildele NPK-brukere serverrollen dbcreator sikrer man at brukerene har tilstrekkelige rettigheter over egne databaser (de får feks. fulle dbo.-rettigheter over alle databaseobjekter) uten at man drifts- eller sikkerhetsmessig utsetter ITavdelinger, serveradministratorer eller øvrige SQL-serverbrukere for risiko eller ulemper. Rollen som dbcreator kan enten tildeles individuelle logins eller ett felleslogin som tilsvarer en Windows brukergruppe hvor NPK-brukere er medlem. Under begge omstendigheter kan man velge å benytte trusted connection/integrated security i forhold til SQLserveren eller såkalt standard SQL-pålogging (som krever pålogging med brukernavn/passord. Dersom man benytter individuelle logins med dbcreator-rolle definert, vil hver enkelt bruker eie egne databaser og andre brukere(logins) må gies eksplisitt tilgang til databasene (User på databasen med ønskede rettigheter). Dersom man ser for seg et bruksmønster hvor det er hensiktsmessig at alle NPKbrukere har tilgang og samme rettigheter til alle NPK-relaterte databaser, kan løsningen med et definert felleslogin (f.eks. NPKUsers) med dbcreator-rollen aktivert, være en fornuftig løsning. Vi anbefaler at det i såfall opprettes en tilsvarende Windows brukergruppe hvor NPK-brukerene eksplisitt må være medlem og så benytter trusted connection-sikkerhet for å hindre uatorisert tilgang. 4.2 Konfigurasjonsendringer i NPK Som nevnt styres konfigureringen av NPK ved hjelp av konfigurasjonsfilen NPK.exe.config. Dersom NPK er installert lokalt på klienten må de endringer som beskrives nedenfor gjennomføres på hver enkelt klient, dersom man benytter en
Driftsdokumentasjon NPK v 15.0.0.0 side 14 sentral filserverinstallasjon (se overfor) er det tilstrekkelig å endre konfigurasjonsfilen på filserverens programområde. Dataområde. Før konfigurasjonsendringer foretaes, må det avgjøres hvorvidt man skal benyttet seg av et felles dataområde ( DataDir ) eller om disse fortsatt skal være individuelle for hver enkelt bruker. Vår erfaring er at det kan være hensiktsmessig å benytte seg av individuelle dataområder. Dette medfører bl.a. at hver enkelt bruker i utgangspunktet kun behøver å finne fram i egne logger og resultatfiler selv om man benytter seg av felles server og database. Dersom man finner det mest hensiktsmessig å benytte felles datakatalog må man huske at DataDir -angivelsen er relativ til den klient som eksekverer programmet. Velger men feks. DataDir = H:\NPKData\, forutsetter dette at alle klienter har en ensartet oppfatning av (samme fysiske mapping) hvor H:\ er lokalisert. Når dataområde er angitt, vil underkatalogene \log, \Resultat, \tempdbfile og \tempresult bli opprettet automatisk dersom annet ikke er angitt i konfigurasjonsfilen. Midlertidig dataområde for SQL-server. Mens de fleste sti- og fil-angivelser som kan konfigureres er relative til eksekverende klient, er nøkkelen DBTempDir relativ til den serveren hvor MSSQL-server er installert. Dette er katalogen hvor SQLServer bl.a. plasserer sine backup-filer. Dersom den stien som er angitt i konfigurasjonsfilens angivelse av dataområde (se overfor) også er anvendbar på serveren, behøver man strengt tatt ikke foreta konfigurasjonsendringer. Dersom man imidlertid ønsker å styre denne katalogen til en bestemt lokasjon på serveren eller dataområde-angivelsen ikke er anvendbar på serveren kan katalog for midlertidig dataområde for SQLserver angies eksplisitt i konfigurasjonsfilen ved hjelp av nøkkelen DBTempDir. Eksempel I nedenforstående eksempel er en felles MSSQL-server installert på en server ved navn BRUTUS hvor den instansen av SQL-server som skal benyttes har instansnavn NPKServer. Midlertidig dataområde for SQL-serveren er satt til D:\Data\NPKtempDBfile hvor D:\ er en gyldig partisjon/share på BRUTUS. Klientene har separate dataområder(\npkdata) på sine respektive hjemmeområder (hos alle mappet til H:\) og alle brukere arbeider i utgangspunktet mot den felles databasen NPKDb. Alle brukere har fått etablert individuelle login på SQL-server med dbcreatorrollen tildelt. Det forlanges at brukerene eksplisitt logger seg på SQL-serveren med brukernavn/passord. (Brukerene må i tillegg ha rettigheter som gjør at de kan aksessere BRUTUS som NT/Windows-server). Under disse forutsetninger vil filen NPK.exe.config se ut som flg.:
Driftsdokumentasjon NPK v 15.0.0.0 side 15 <?xml version="1.0" encoding="windows-1252"?> <configuration> <appsettings> <!-- User application and configured property settings go here.--> <!-- Example: <add key="settingname" value="settingvalue"/> --> <add key="datadir" value="h:\npkdata\" /> <add key="server" value = "BRUTUS\NPKServer"/> <add key="database" value = "NPKDB"/> <add key="trustedconnection" value="no"/> <add key="nprfunction" value="no"/> <add key="dbtempdir" value="d:\data\npktempdbfile\"/> </appsettings> </configuration> For å oppsummere: Dersom man ønsker å benytte en felles SQL-server for NPK, må en bruker med administrative rettigheter på serveren definere logins etter den strategi som velges (individuelle eller gruppe/felles-login) og aktivere rollen dbcreator for de(t) aktuelle login. De ønskede konfigurasjonsendringer gjøres i NPK.exe.config. Deretter vil NPK ta seg den nødvendige administrering av databaser etc. 5 Tilleggsinformasjon om MSSQL: Sikkerhet og Roller i MSSQLServer SQL-Server har flere typer roller: 1. Predefinerte Server-roller roller som er ferdig satt opp i SQLServer og som gjelder for hele SQLServer (for alle databaser). Styrer configurering og drift av hele database-serveren. 2. Predefinerte database-roller roller som finnes som default i alle databaser og som gjelder for den databasen den er definert i. 3. Bruker-definerte database-roller man kan lage sine egne roller i sine databaser. 4. Application-rollen roller som brukes av programmer. Programmene håndterer sikkerheten selv og det kreves ett eget passord for å bruke slike roller. Eksempel på behov for dette er applikasjoner som har avanserte sikkerhetsbehov som SQLServer ikke kan støtte. For eksempel at brukere kun skal ha tilgang til å kjøre rapporter på visse tidspunkter i døgnet. I slike tilfeller vil typisk applikasjonen ha kun en databasebruker for applikasjonen som har de nødvendige rettigheter. Så har applikasjonen ett eget sikkerhetssystem som håndterer alle brukerne og passord og som håndterer når de ulike brukerne kan kjøre rapportene. Databasebrukeren er medlem av en applikasjons-rolle som krever ett eget applikasjonspassord. Dette for å hindre at denne brukeren blir benyttet av andre enn applikasjonen selv. Predefinerte Server-roller. Det finnes 8 predefinerte Server-roller:
Driftsdokumentasjon NPK v 15.0.0.0 side 16 1. SysAdmin denne gir mest rettigheter. Medlemmer av denne rollen kan gjøre ALT på Serveren. 2. SetupAdmin medlemmer av denne rollen administrere likned servere og gjøre endringer rundt oppstart av Serveren. I tillegg kan de konfigurere replikering og installere extended prosedyrer. Dersom man kjører med integrert sikkerhet vil medlemmene av den lokale NT-gruppen BUILTIN\Administrators automatisk bli medlem av denne gruppen. 3. dbcreator medlemmene kan opprette, endre og slette databaser. De kan også modifisere egenskapene til databaser og kjøre prosedyren sp_dboption 4. DiskAdmin medlemmer kan administrere diskfiler som SQLServer bruker for data og log. De kan IKKE kjøre T-SQL-script. De kan kjøre prosedyrene sp_addumpdevice og sp_dropdevice 5. BulkAdmin medlemmene kan kjøre T-SQL-kommandoen BULK INSERT. Brukes gjerne i forbindelse med lasting av datavarehus. 6. ProcessAdmin medlemmer kan administrere prosesser på SQLServeren. For eksempel kjøre T-SQL-kommandoen KILL for å drepe en bestemt prosess i SQL-Serveren. 7. ServerAdmin - medlemmene kan konfigurere server-innstillinger og har også mulighet for å restarte sql-serveren. Kan kjøre prosedyrene sp_configure og T-SQL-kommandoene SHUTDOWN og RECONFIGURE. 8. SecurityAdmin medlemmene kan opprette logins og administrere rettigheter rundt CREATE DATABASE. De kan også lese error-logen og endre passord for alle brukere bortsett fra passordet til medlemmene av SysAdmin-rollen. Prosedyren sp_srvrolepermission viser hvilke rettigheter de ulike predefinerte server-rollene har. Predefinerte databaseroller. Alle databaser har 10 predefinerte databaser-roller: 1. db_owner har alle rettigheter i databasen. 2. db_accessadmin kan slette og legge til brukere i databasen. 3. db_securityadmin kan administrere rettigheter, eierskap til de ulike databaseobjektene samt administrere roller. 4. db_ddladmin kan kjøre alle DDL-kommandoer bortsett fra GRANT, REVOKE og DENY 5. db_backupoperator Kan kjøre DBCC, CHECKPOINT og BACKUP kommandoer. Medlemmene av denne rollen ar ingen andre rettigheter utover dem som de får gjennom medlemskapet i public-rollen. (kan for eksempel ikke kjøre RESTORE). For å kunne kjøre RETORE av databasen må brukeren minst har rettigheter fra server-rollen dbcreator. 6. db_datareader Kan lese alle data fra alle tabeller i databasen 7. db_datawriter kan endre alle data i alle tabeller i databasen. 8. db_denydatareader hindrer lesing fra alle bruker-tabeller i databasen 9. db_denydatawriter hindrer endring i alle bruker-tabeller i databasen. 10. public alle bruker i databaser tilhører rollen public og kan ikke fjernes fra denne rollen. Har lese-rettigheter til alle system-tabellene i databasen.
Driftsdokumentasjon NPK v 15.0.0.0 side 17 Dersom man har spesielle rettigheter som man ønsker at ALLE brukere av databasen skal ha, kan disse rettighetene settes i public-rollen. Prosedyren sp_dbfixedrolepermission viser hvilke rettigheter de ulike predefinerte database-rollene har. Dersom man gjør endringer på rettighetene til brukere som allerede er pålogget serveren/databasen vil de nye rettighetene ikke tre i kraft før brukeren gjør en ny på-logging. Administrasjon av indexer på tabeller For å kunne opprette/slette/oppdatere indexer på tabeller eller views må brukeren være eier av tabellen. Slikt eierskapet kan enten være at brukeren eksplisitt er eier av tabellen eller at den er medlem av en rolle som igjen står som eier av tabellen. Medlemskap i flere ulike roller Brukere kan være medlemmer av flere ulike roller både server-roller og databaseroller. Hvilke rettigheter har brukeren egentlig da? Enkelt sakt vil rettighetene bli totalen av de rettigheter som rollene gir. Dersom det finnes noen hinder (deny) som er satt vil slike overstyre. For eksempel en bruker som er medlem av en admin-rolle og en bruker-rolle hvor admin-rollen gir tilgang til en tabell og bruker-rollen nekter tilgang til den sammen tabellen. Da vil brukeren ikke få tilgang til tabellen. Begrensninger Kan ikke opprette sirkulære medlemskap. For eks. kan ikke rolle A være medlem av rolle B dersom rolle B allerede er medlem av rolle A. Videre kan ikke predefinerte serverroller, predefinerte databaseroller eller brukeren DBO være medlemmer i egendefinerte roller. 6 NPK satsvis kjøring fra kommandolinje. Det er implementert muligheter for å eksekvere NPK fra kommandolinje med eller uten pålogget bruker. Denne egenskapen vil være hensiktsmessig dersom man feks. ønsker å skedulere automatisk satsvis kjøring av programmet (såkalt silent BATCH-mode ). Batch funksjonen er kun aktiv dersom nprfunction i NPK.exe.config er on Nirvaco kan bistå med konsulentbistand for å sette opp disse funksjonene. I denne sammenheng benyttes flg. nøkler/standardverdier i konfigurasjonsfilen NPK.exe.config : Nøkkel Forklaring Standardverdi batchmode Settes verdien til yes vil batchmode no batchdatadir aktiveres Anbefales angitt spesifikt dersom batchmode er aktivert. Forteller DataDir slik denne er spesifisert for NPK generelt.
Driftsdokumentasjon NPK v 15.0.0.0 side 18 batchprodyear batchgrouperlogicyear batchpricelistyear batchdbonly batchfileoutputonly batchjointresult batchappend batchlock batchtertial batchmaxfatal batchfileoutputonly batchextendedresult batchproducecsv programmet i hvilken katalog det forventes at datafilen(e) som skal kjøres er plassert. Programmet vil forsøke å kjøre igjennom alle filer på angjeldende katalog ved oppstart. Produksjonsår kan angis spesifikt for batch-kjøring Årsversjon av grupperings-logikk kan angis spesifikt for batch-kjøring Refusjonslisteår kan angis spesifikt for batch-kjøring Gir muligheter for kun å laste til database, dvs. ikke produsere flatfil /.drg-fil. Settes verdien til yes vil slik fil IKKE bli produsert. Gir mulighet for kun å produsere flatfil /.drg-fil uten å laste til rapportdb. Gir mulighet for å slå sammen resultatene fra vanlig fil/database(refusjonsgrunnlaget) og alternativ fil/database (ikke refusjonsberettiget). Settes verdien til yes vil sammenslåing bli foretatt. Gir mulighet for å slå av programmets standard virkemåte i forhold til databasene, dvs. erstatte data institusjonsvis ved lasting. Dersom denne verdien settes til yes vil data IKKE bli erstattet lasting av nye filer vil bli lagt til databasen. Gir mulighet for å aktivere den tertialvise låsefunksjonen i batchmodus. Benyttes for å angi hvilket tertial som skal låses ved batch-kjøring (dersom batchlocked er satt til yes ). Setter maks. antall fatale feil i batchmodus. Gir mulighet til kun å produsere filbasert output (*.drg-fil) No = Laste til rapportdb Yes = Produser kun fil, dvs. ikke laste til rapportdb Denne funksjonen kan bli slått av selv om denne nøkkelen har verdien yes. Det vil skje dersom vi ikke finner NPRExclusive-nøkkelen. Produserer.csv filer som inneholder resultatet akkurat slik det også blir lastet til databasen. 2004 2004 2004 no no no no no Verdiene 1, 2 eller 3 angir hvilket tertial som ønskes låst. 50 Dersom batch-mode er aktivert og programmet startes fra kommandolinjen av pålogget bruker, vil programmet eksekvere automatisk, men skjermbildene vil vises som ved vanlig manuell kjøring (konfr. Start alle filer i katalog -knappen når Nprfunction er satt til yes ). No No yes
Driftsdokumentasjon NPK v 15.0.0.0 side 19 Dersom kjøring i batchmode er skedulert til å kjøre uten pålogget bruker (userinteractive mode =false), dvs. fra systemkonto, vil skjermbildene ikke vises. Meldinger som til vanlig vises på skjermen vil da bli skrevet til en enkel tekstlig logg-fil NPKbatchmode.log som plasseres på applikasjonenes vanlige logkatalog. Dersom man i kommandolinjen oppgir et (eller flere) filnavn med full path (i anførselstegn dersom filnavn inneholder mellomrom) og kjører i batchmode, vil programmet kjøre gjennom med den eller de filene som er angitt på kommandolinjen i stedet for i de filene som evnt. måtte ligge i katalogen angitt i nøkkelen batchdatadir. Dersom melding/feil forekommer før vi vet hvor logg-katalogen er (mao dersom angitt Datadir mangler) blir logg-filen lagt på C:\. Den blir overskrevet ved hver kjøring. NB! Satsvis kjøring forutsetter at databasen er korrekt konfigurert mht. Views og Functions og referansetabeller. I batchmode kontrolleres IKKE programversjoner og/eller nødvendigheten av å oppdatere databasen ved hjelp av script (ViewFunc.sql) eller *.csv-filer.