Installasjon av FINALE Årsoppgjør og FINALE Rapportering i ASP-miljø Dette dokumentet beskriver en del momenter i forbindelse med installasjon av FINALE Årsoppgjør og FINALE Rapportering (Periodisering). Første del er en generell gjennomgang av filstrukturer i en normal installasjon på for eksempel en arbeidsstasjon. Denne delen er ment å gi en forståelse av applikasjonens struktur, og danner grunnlaget for delt to som omhandler konfigurering for kjøring i ASP-miljø. Sammen danner videre disse to første delene grunnlag for forståelse av del tre om flerkundeløsninger hvor flere kunder benytter samme installasjon av programmet. DEL 1 - BESKRIVELSE AV APPLIKASJONENS FIL- OG KATALOG-STRUKTUR...2 1.1 INSTALLASJONSKATALOGEN...2 1.2 FILER I INSTALLASJONSKATALOGEN SOM KREVER SKRIVETILGANG...2 1.3 KLIENTKATALOGEN...3 1.4 ARBEIDSKATALOG...3 DEL 2 INSTALLASJON I TERMINAL SERVER MILJØ...4 2.1 INSTALLASJON AV PROGRAMMET...4 2.2 INSTALLASJON AV RUNTIME.EXE...4 2.2.1 Utenom Terminal Server...4 2.2.2 På Terminal Server...5 DEL 3 - KONFIGURASJON FOR INSTALLASJON AV FLERKUNDELØSNING I ASP-MILJØ...6 3.1. DEFINISJONER:...6 3.2 REGISTERNØKLER...6 3.2.1 Registernøkler for FINALE Årsoppgjør...6 3.2.2 Registernøkler for FINALE Rapportering (Periodisering)...6 3.2.3 Rekkefølge på registernøkler...7 3.2.4 Verdier i registernøklene...7 3.2.5 KonfigKatalog...7 3.2.6 TempKatalog...8 3.3 AUTOMIGRERING...8 3.3.1 Oppdatere AutoMigrering ved installasjon og installasjon av programoppdateringer...8 3.3.2 Automigrering og kundespesifikke filer...9 3.3.3 Automigrering av logg-filer...9 3.3.4 Automigrering av programmets ini-fil...10 Finale Systemer as 13.11.2007 Side 1 av 10
Del 1 - Beskrivelse av applikasjonens fil- og katalogstruktur En installasjon består av følgende tre hovedområder: 1) Installasjon (programfiler, maler, etc) 2) Klientkatalog (katalog hvor hver kunde har sine klient-data) 3) Arbeidskatalog (katalog som programmet benytter under arbeid med klientdata) 1.1 Installasjonskatalogen Installasjonskatalogen inneholder følgende struktur (eksemplet under viser programmet installert til C:\Programfiler\Finale): C:\Programfiler\Finale C:\Programfiler\Finale\Felles C:\Programfiler\Finale\Felles\$fff$ C:\Programfiler\Finale\Felles\$fff$\Konfig C:\Programfiler\Finale\Felles\$Import$ C:\Programfiler\Finale\Felles\$mal$ C:\Programfiler\Finale\Felles\Moduler C:\Programfiler\Finale\Finale C:\Programfiler\Finale\Finale\Data C:\Programfiler\Finale\Finale\Data\Excel C:\Programfiler\Finale\Finale\Data\Fri_Rapp C:\Programfiler\Finale\Finale\Data\not_std C:\Programfiler\Finale\Finale\Data\ORMaler C:\Programfiler\Finale\Finale\Data\ORMaler\Forsider C:\Programfiler\Finale\Finale\Data\ORMaler\Noter C:\Programfiler\Finale\Finale\Data\ORMaler\StyrBer C:\Programfiler\Finale\Finale\Data\Tpl C:\Programfiler\Finale\Finale\Runtime C:\Programfiler\Finale\Klienter C:\Programfiler\Finale\Klienter\Demo Mapper som er uthevet er mapper som det kreves skrivetilgang til under kjøring av programmet (plassering av disse kan konfigureres ved hjelp av registernøkler) 1.2 Filer i installasjonskatalogen som krever skrivetilgang Det kreves skrivetilgang til følgende filer i installasjonskatalogen (Katalogene her viser programmet installert til C:\Programfiler\Finale): C:\Programfiler\Finale\Felles\FinApp.ini C:\Programfiler\Finale\Finale\ByraOppl.ini C:\Programfiler\Finale\Finale\Debug.log C:\Programfiler\Finale\Finale\ExcMagic.log C:\Programfiler\Finale\Finale\Finale.lic Finale Systemer as 13.11.2007 Side 2 av 10
Hvilke filer er dette? FinApp.ini ByraOppl.ini Debug.log ExcMagic.log Finale.lic Programmets INI-fil. Filen inneholder byråopplysninger. Feil-logg. Feil-logg. Lisenskoder. For hver bruker opprettes en fil som inneholder brukerens egne valg (Katalogen her viser programmet installert til C:\Programfiler\Finale): C:\Programfiler\Finale\Felles\<username>.ini (<username> er her brukerens logon-navn) 1.3 Klientkatalogen Brukeren kan selv bestemme hvor klientene skal ligge. Dette settes i funksjonen åpne klient. Normalt vil alle brukere for en kunde ha alle klienter liggende i samme katalog, men det er fult mulig at hver bruker har sine klienter i en egen mappe. Oppsett av klientkatalog lagres i filen <username>.ini, se del 1.2 Filer i installasjonskatalogen som krever skrivetilgang. 1.4 Arbeidskatalog Under arbeid med en klient benytter programmet seg av en arbeidskatalog. Alle filer som tilhører den aktive klienten kopieres til denne katalogen under kjøring. Når klienten lagres, vil filene kopieres tilbake til klienkatalogen. Når klienten lukkes, slettes alle filer fra arbeidskatalogen. I en vanlig installasjon (uten konfigurering ved hjelp av registernøkler) er denne katalogen en underkatalog (FinTemp) under klientkatalogen. Oppsett av arbeidskatalog lagres i C:\Programfiler\Finale\Felles\<username>.dat Finale Systemer as 13.11.2007 Side 3 av 10
Del 2 Installasjon i Terminal Server miljø 2.1 Installasjon av programmet Installasjonene til Finales programmer inneholder som regel en standard installasjonsfil install.exe. Denne installeres i vanlig installasjonsmodus på Terminal Server (Add / Remove). Ved fullendt installering vil det bli plassert en fil med navn runtime.exe under det området hvor programmet ble installert. Denne filen inneholder systemkomponenter som Finale er avhengig av for å fungere. 2.2 Installasjon av runtime.exe 2.2.1 Utenom Terminal Server Ved oppstart vil Finale sjekke versjonen på runtime.exe mot siste versjon installert på systemet (se fig. 2.1). Om installert versjon er for gammel starter den automatisk en installasjon av runtime.exe på systemet. Oppstart av Finale (Årsoppgjør, Skatt, Driftsmidler osv.) runtime.exe nyere enn installert versjon? nei ja Kjør runtime.exe Finale fortsetter vanlig oppstart av program met Fig. 2.1 Programmets sjekk av installerte systemkomponenter (runtime.exe) ved oppstart. Finale Systemer as 13.11.2007 Side 4 av 10
2.2.2 På Terminal Server På Terminal Server gjelder ikke dette, og det er viktig at programmet ikke selv starter dette systemoppsettet, men at den derimot blir manuelt utført i installasjonsmodus. Dette må altså skje før man starter programmet første gang etter endt installasjon av install.exe. (se fig. 2.2) En del systemkomponenter (COM-dll er osv) må plasseres i registeret til Windows, for at disse innstillingene skal bli tilgjengelig for alle brukere på en Terminal Server er det viktig at installasjonen (og dertil registreringen av disse) blir utført i installasjonsmodus. Aktiver installasjonsmodus Avslutt installasjonsmodus installer install.exe runtime.exe blir lagt ut på installert område installer runtime.exe Fig. 2.2 installasjonsprosedyre for Terminal Server installasjon. Finale Systemer as 13.11.2007 Side 5 av 10
Del 3 - Konfigurasjon for installasjon av flerkundeløsning i ASP-miljø 3.1. Definisjoner: Kunde: Med kunde menes en gruppe med brukere innen samme brukergruppe. En kunde kan være for eksempel en enkeltkunde (for eksempel et regnskapskontor) eller for eksempel en avdeling innen et regnskapskontor. En kunde vil ha samme lisenskode for alle brukere, og samme byråopplysninger for alle brukere. Bruker: En bruker er en bruker hos en kunde. 3.2 Registernøkler En forutsetning for at flere kunder kan kjøre på samme installasjon er at hver kunde har sitt private filområde (med kunde menes for eksempel et regnskapsbyrå med flere brukere). På dette filområdet plasseres: 1) De deler av installasjonen som krever skrivetilgang under kjøring (KonfigKatalog) a. Katalogen som nevnt i del 1.1 Installasjonskatalogen b. Filer nevnt i del 1.2 Filer i installasjonskatalogen som krever skrivetilgang c. Registernøkkel som nevnt i del 3.2.5 KonfigKatalog 2) Klientkatalogen a. Katalogen som nevnt i del 1.3 Klientkatalogen 3) Arbeidskatalogen a. Katalogen som nevnt i del 1.4 Arbeidskatalog b. Registernøkkel som nevnt i del 3.2.6 TempKatalog Dette styres av et sett med verdier fra følgende registernøkler 3.2.1 Registernøkler for FINALE Årsoppgjør HKEY_LOCAL_MACHINE\Software\FINALE\Aarsoppgjoer eller HKEY_CURRENT_USER\Software\FINALE\Aarsoppgjoer 3.2.2 Registernøkler for FINALE Rapportering (Periodisering) Registernøkkelen er felles for FINALE Årsoppgjør og FINALE Rapportering. HKEY_LOCAL_MACHINE\Software\FINALE\Aarsoppgjoer eller HKEY_CURRENT_USER\Software\FINALE\Aarsoppgjoer Finale Systemer as 13.11.2007 Side 6 av 10
3.2.3 Rekkefølge på registernøkler Programmet sjekker først i HKEY_CURRENT_USER og deretter i HKEY_LOCAL_MACHINE, og bruker den verdien som finnes først. NB: Alle verdier må ligge i samme nøkkel. Det er altså ikke mulig på ha noen verdier i HKCU og noen i HKLM. 3.2.4 Verdier i registernøklene Følgende verdier må registreres: 1) KonfigKatalog 2) TempKatalog 3) AutoMigrering 3.2.5 KonfigKatalog Verdien KonfigKatalog angir katalog som skal inneholde de mapper og filer som det kreves skrivetilgang til under kjøring (se del 1.1 Installasjonskatalogen og Del 1 - Beskrivelse av applikasjonens fil- og katalog-struktur for en oversikt over dette) For eksempel: KonfigKatalog=G:\Finale\Konfig Det er mulig å benytte miljøvariabler som for eksempel %USERNAME% KonfigKatalog=G:\Finale\%USERNAME%\Konfig KonfigKatalog kan med fordel være samme parameter for alle brukere hos en kunde, for eksempel ved at KonfigKatalog peker på en katalog på kundens private filområde der alle kundens brukere har både lese- og skrivetilgang, men der andre kunder ikke har tilgang. Dersom kunden har flere lokaliseringer (for eksempel flere adresser) uten at kundens installasjoner er delt opp i flere kunder på terminalserveren, kan der være nødvendig å sette opp KonfigKatalog som er brukeravhengig. Dersom dette gjøres, vil hver enkelt bruker måtte registrere lisensnøkkel (Finale.lic) og byråopplysninger (byraoppl.ini). Finale Systemer as 13.11.2007 Side 7 av 10
3.2.6 TempKatalog Verdien TempKatalog angir katalognavnet til Arbeidskatalogen (se del 1 for beskrivelse). For eksempel: TempKatalog=G:\Finale\Arbeidskatalog Det er mulig å benytte miljøvariabler som for eksempel %USERNAME%, for eksempel slik: TempKatalog=G:\Finale\%USERNAME%\Arbeidskatalog Det sikreste er at arbeidskatalogen ikke er felles for alle brukere, for eksempel ved at %USERNAME% inngår i registernøkkelen, eventuelt kan arbeidskatalogen peke mot en privat mappe for den enkelte bruker, og ikke mot en mappe som er felles for alle brukere hos en kunde. Dette sikrer at brukere som åpner klienter med samme klientnummer fra forskjellige klientkataloger ikke får fildelingsproblemer. 3.3 AutoMigrering Programmet kan konfigureres til å automatisk kopiere filer og kataloger som krever skrivetilgang under kjøring. Filene/katalogene kopieres ved oppstart til katalogen angitt i KonfigKatalog. Dette gjør det enklere å oppgradere applikasjonen da en normal installasjon på serveren vil fungere som en referanse-installasjon for hver kunde. AutoMigrering kan ha to verdier: 1) AutoMigrering=Alltid Filer som er nye eller er av nyere dato i installasjonskatalogen kopieres til KonfigKatalog hver gang programmet startes. 2) Automigrering=Ja Filer som er nye eller er av nyere dato i installasjonskatalogen kopieres til KonfigKatalog første gang programmet startes (etter at denne verdien er satt). Etter kopieringen nullstilles verdien i AutoMigrering. 3.3.1 Oppdatere AutoMigrering ved installasjon og installasjon av programoppdateringer Følgende oppskrift benyttes for første gangs installasjon evt. oppgradering av eksisterende installasjon: 1) Installer programmet til installasjonskatalogen 2) Legg inn verdier for KonfigKatalog og TempKatalog i kundens registernøkkel tilhørende programmet. Det er viktig at programmet har skrive/lese-tilgang til nøkkelens verdier. 3) Legg inn ja i verdien AutoMigrering. Finale Systemer as 13.11.2007 Side 8 av 10
Et eksempel på verdier kan være: HKEY_LOCAL_MACHINE\Software\FINALE\Aarsoppgjoer\KonfigKatalog =G:\Finale\Konfig HKEY_LOCAL_MACHINE\Software\FINALE\Aarsoppgjoer\TempKatalog =G:\FINALE\%USERNAME%\Arbeidskatalog HKEY_LOCAL_MACHINE\Software\FINALE\Aarsoppgjoer\AutoMigrering=Ja (i eksemplet over er G:\Finale\Konfig og G:\%USERNAME%\Arbeidskatalog kataloger på kundens private filområde). Når en bruker hos kunden starter opp programmet for første gang kopieres nødvendige kataloger fra installasjonskatalogen over til kundens private område. Deretter nullstilles AutoMigrering, slik at dette ikke skjer ved neste gangs oppstart. (Dersom Automigrering er satt til Alltid, vil automigrering ikke nullstilles, men alltid bli kjørt). Det er en fordel for ytelsen at Arbeidskatalogen ligger på samme maskin som programmet kjører på, da en slipper filaksess over nettet mens brukeren arbeider med klientdata. Netttrafikken reduseres da til åpning og lagring av klientdata. 3.3.2 Automigrering og kundespesifikke filer Det er visse filer som er kundespesifikke i et flerkundemiljø. Dette gjelder følgende filer: ByraOppl.ini Finale.lic Om plassering av filen, se del 1.1 Installasjonskatalogen. Disse 2 filene inneholder byråopplysninger og lisenskoder, se også del 1.2 Filer i installasjonskatalogen som krever skrivetilgang. Det er viktig at disse filene ikke finnes på installasjonsområdet for programmet på terminalserveren, slik at ikke disse filene blir kopiert til alle kunder og alle brukere. Disse 2 filene blir ikke opprettet ved installasjon, og opprettes kun ved registrering av lisensnøkkel eller registrering av byråopplysninger ved kjøring av programmet. 3.3.3 Automigrering av logg-filer Følgende filer er loggfiler, og det er en fordel om disse filene ikke finnes på serverens installasjonskatalog: Debug.log ExcMagic.log Disse filene anvendes under bruk til logging av eventuelle programavbrudd og feilmeldinger i programmet. Disse filene blir ikke opprettet under installasjon av programmet. Finale Systemer as 13.11.2007 Side 9 av 10
3.3.4 Automigrering av programmets ini-fil Følgende filer er programmets ini-fil, og det er anbefales at filen ikke finnes på serverens installasjonskatalog: FinApp.ini Denne filen kan inneholde visse felles brukeroppsett på klienten, som for eksempel filter i kontoplanen som en bruker angir skal være felles for alle brukere. Denne filen blir ikke opprettet under installasjon av programmet. Finale Systemer as 13.11.2007 Side 10 av 10