Informasjonssystem for den kommunale sosialtjenesten Konverteringsveiledning Versjon: 5.1x 5.2x Før du starter konverteringsprosessen anbefaler vi at du sjekker at du har siste tilgjengelige versjon av både konverteringsveiledning og konverteringsprogram Sist endret: 31.10.2006 Av: Bjørn Erik Glomsrud
Konverteringsveiledning Socio 5.2x Side 2 1 FØR DU KONVERTERER:... 3 2 HVOR BØR PROGRAMMET LIGGE?... 4 2.1 Klargjøring av ny database...4 2.1.1 Oracle...4 2.1.2 MS SQL...4 3 INSTALLASJON... 4 4 OPPGRADERINGEN... 5 4.1 Forarbeid...5 4.1.1 Oracle...5 4.1.2 MS SQL...5 4.2 Arkivtabeller...6 4.2.1 Oracle...6 4.2.2 MS SQL...6 4.3 Klargjøring til oppstart av konverteringsprogram...6 4.3.1 Oracle...6 4.3.2 MS SQL...6 4.4 Oppstart av konverteringsprogram...7 4.5 Forarbeid til konverteringen...9 4.6 Selve konverteringen...10 4.7 Under konverteringen...10 4.8 Etter konverteringen...10 5 ETTER OPPGRADERINGEN... 12 5.1 Nye kodeverksgrupper...12 5.2 Nye faner/felter i parameteroppsettet...12 5.3 Oppstart av Socio 5.2x for første gang...13 5.4 Konfigurering av Socio 5.2...13 6 FERDIG?... 13
Konverteringsveiledning Socio 5.2x Side 3 1 Før du konverterer: NB! Ta alltid sikkerhetskopi av eksisterende database før du konverterer eller installerer en ny versjon. I forbindelse med konvertering av et driftskritisk system er det som regel en god del ting man skal passe på. For de som ikke har erfaring med oppgraderinger av slike systemer, kan det være klokt å kontakte leverandør for å få en konsulent som kjenner systemet godt til å foreta oppgraderingen for dere. For de som likevel velger å foreta oppgraderingen selv, anbefaler vi å lese igjennom resten av dette dokumentet grundig før man begynner oppgraderingen. Hvis noe er uklart i denne veiledningen, kan det tyde på at kommunen er bedre tjent med å få en konsulent fra systemleverandøren til å gjøre konverteringen. Sørg for at ingen er pålogget Socio 5.1x / Socio 5.2x mens oppgraderingen foregår.
Konverteringsveiledning Socio 5.2x Side 4 2 Hvor bør programmet ligge? Det anbefales på det sterkeste å installere Socio 5.2x i en egen katalog og holde den nye versjonen adskilt fra Socio 5.1x. Under installasjon av Socio 5.2x vil konverteringsprogrammet med tilhørende filer bli installert i en underkatalog til Socio 5.2. Underkatalogen heter Convert. Gjeldende versjon av konverteringsprogrammet kan sees i tittellinjen når programmet startes. Sjekk at dette er nyeste versjon før konverteringen startes. 2.1 Klargjøring av ny database 2.1.1 Oracle Opprette nytt tablespace Anbefalt navnekonvensjon for TableSpace: SOC522TS Vi anbefaler at størrelsen på det nye tablespacet settes til samme som reelt dataforbruk i gammelt tablespace. Opprette ny bruker Anbefalt navnekonvensjon for UserName: SOC522US Den nye brukeren skal ha SOC522TS som default tablespace. Den nye brukeren må også under konverteringsprosessen ha minimum SELECT rettigheter til objekter eiet av SOC512US. Opprette ny tom tabellstruktur Se punkt 4.1.1 nedenfor. 2.1.2 MS SQL Opprette ny database Anbefalt navnekonvensjon for database: SOC523 Vi anbefaler at størrelsen på den nye databasen settes til samme som reelt dataforbruk i gammel database. Opprette ny bruker Anbefalt navnekonvensjon for UserName: soc523us Den nye brukeren skal ha SOC523 som default database. Den nye brukeren må også under konverteringsprosessen ha minimum db_datareader rettigheter til gammel database. Opprette ny tom tabellstruktur Se punkt 4.1.2. 3 Installasjon Installasjonsprogrammet heter henholdsvissoc522xx.exe for Oracle versjonen ogsoc523xx.exe for MS SQL versjonen. Tallet xx i filnavnet kan variere ettersom hvilken revisjon av Socio som installeres. Etter å ha startet installasjonen vil programmet lede igjennom hele installasjonsprosessen.
Konverteringsveiledning Socio 5.2x Side 5 4 Oppgraderingen 4.1 Forarbeid Anbefaler at Socio 5.1 settes i nedkoblet modus før konverteringsprosessen starter. Gå inn i driftsverktøyet, velg drift og systemtigang. Her velges nedkoblet, man kan også legge inn en melding som brukerne vil få når de forsøker å starte Socio. Ikke start selve oppgraderingen dersom ikke installasjonen var vellykket. Konverteringen kan ikke skje fra andre versjoner enn Socio 5.1. Dersom dere ikke har oppgradert til Socio 5.1, vennligst ta kontakt med systemleverandør for å fremskaffe gamle konverteringsprogram fra tidligere versjoner av Socio. Det kan heller ikke gjøres kryssoppgradering mellom ulike plattformer (f.eks fra TopSpeed plattform til Oracle plattform) samtidig som en konverterer fra Socio 5.1 til Socio 5.2. Dette må gjøres i to operasjoner, og det anbefales å ta kontakt med systemleverandør dersom dere ønsker å gjøre dette. Socio 5.2 foreligger ikke på TopSpeed-plattform. Det betyr at det må gjøres plattformskifte på Socio 5.1 før konvertering til Socio 5.2 kan finne sted. Ta kontakt med systemleverandør dersom dette er aktuelt for dere. En tabell må konverteres via eksport/import i driftsverktøyet i Socio 5.1. Dette gjelder tabellen LEVHEAD. Eksporter denne i driftsverktøyet til Socio 5.1. Denne skal importeres i Socio 5.2 etter konverteringen. Husk hvor du har lagret eksportfilen. 4.1.1 Oracle Dersom det konverteres mot en Oracle database, må alle tabeller bygges opp før konverteringsprogrammet startes. Det anbefales å lage tom tabellstruktur uten indekser. Dette gjør at konverteringen går raskere. Indeksene bygges så etter at konverteringen er ferdig. Opprettelse av tabeller uten indekser gjøres ved å kjøre scriptet SOC522_TABLES.SQL. Dersom konverteringsprogrammet av en eller annen grunn skal kjøres en gang til, må samme script kjøres. Scriptet ligger i katalogenscript under programkatalogen Socio 5.2 ble installert i (f.eks. C:\Socio52\Script) Dersom anbefalt navnekonvensjon ikke er fulgt, må alle scriptene liggende i katalogenscript tilpasses før bruk. NB! Dette scriptet vil slette eventuelle eksisterende data. 4.1.2 MS SQL Ved konvertering mot MS SQL må alle tabeller opprettes før konverteringsprogrammet startes. Åpne SQL Query Analyzer og logg inn på ny database. Dra så alle scriptfiler som er på formen???_mss.sql over i Query Analyzer og kjør hver enkelt av dem. Det spiller ingen rolle i hvilken rekkefølge scriptene kjøres i. Når alle scriptene er kjørt uten feil, er databasen klar. Det skal være 24 SQL-script som skal kjøres. Dersom konverteringsprogrammet av en eller annen grunn skal kjøres en gang til, må alle scriptene kjøres igjen. Legg merke til at scriptetsoc523init.sql IKKE skal kjøres. Scriptene finnes i katalogenscript under programkatalogen Socio 5.2 ble installert i (f.eks C:\Socio52\Script) NB! Disse scriptene vil slette eventuelle eksisterende data, så de må ikke kjøres etter at databasen er konvertert og i drift.
Konverteringsveiledning Socio 5.2x Side 6 4.2 Arkivtabeller Socio 5.2 har, som Socio 5.1, mulighet for å legge klienter med underliggende tabeller over i arkivtabeller. Nå er tiden inne for å opprette arkivtabeller for å klargjøre for denne funksjonaliteten. 4.2.1 Oracle I oracle må det kjøres et script som oppretter arkivtabellene. Scriptet heter SOC522_ARCHIVE_TABLES.SQL, og ligger på samme sted som alle andre script etter installasjonen. 4.2.2 MS SQL For MS SQL må det også kjøres et script som oppretter de aktuelle arkivtabellene. Scriptet heter SOC523_ARCHIVE_MSS.SQL, og ligger på samme sted som alle andre script etter installasjonen. 4.3 Klargjøring til oppstart av konverteringsprogram Under installasjon av Socio 5.2 ble konverteringsprogrammet med tilhørende filer installert i en underkatalog til Socio 5.2. Underkatalogen heter Convert. Før konverteringsprogrammet kan startes, må filenzzz.ini redigeres. Denne filen ligger også i katalogenconvert. 4.3.1 Oracle ZZZ.INI skal minimum se ut som følger: [ZZZ] STANDALONE=1 ORA_USERNAME=soc522us ORA_HOSTSTRING=develop ORA_ENCRYPT=0 ORA_COUNTRY=47 ORA_PASSWORD=soc522pass Som det fremgår må brukernavn, passord og hoststring angis som normalt isocio.ini for Socio. Dette må redigeres før oppstart av konverteringsprogrammet. Videre er det veldig viktig at det kjøres et script før konverteringsprogrammet startes. Scriptet som skal kjøres ligger sammen med de scriptene som ble benyttet under opprettelsen av databasen, og hetercopyora_512_522.sql. Dette scriptet kopierer data fra tabeller i Socio 5.1 som ikke trenger å konverteres. Kontroller loggkatalog for dette scriptet. Scriptet må redigeres dersom ikke standard navnekonvensjon for brukernavn til ny og gammel database er benyttet (hhv SOC522US og SOC512US). Kjør scriptet innlogget mot ny database. Dersom dokumenter er lagret i basen, kan ikke disse kopieres på vanlig måte. Ta kontakt med systemleverandør dersom dere har lagret dokumenter i basen. Da må vi bruke et eget konverteringsprogram på disse dokumentene. Om dere har lagret dokumenter i basen, kan enklest kontrolleres via vinduet databasestatus i driftsverktøyet i Socio 5.1. Sjekk tabellen DOCPART. Dersom denne har 0 i antall poster, finnes det ingen dokumenter lagret i databasen. 4.3.2 MS SQL ZZZ.INI skal minimum se ut som følger: [ZZZ] STANDALONE=1 MSS_SERVER=EDMUND\DEVELOP MSS_USERNAME=soc523us MSS_PASSWORD=soc523pass MSS_ENCRYPT=0
Konverteringsveiledning Socio 5.2x Side 7 Som det fremgår må brukernavn, passord og SQL-server angis som normalt isocio.ini for Socio. Dette må redigeres før oppstart av konverteringsprogrammet. Videre er det veldig viktig at det kjøres et script før konverteringsprogrammet startes. Scriptet som skal kjøres ligger sammen med de scriptene som ble benyttet under opprettelsen av databasen, og hetercopymss_513_523.sql. Dette scriptet kopierer data fra tabeller i Socio 5.1 som ikke trenger å konverteres. Scriptet må redigeres dersom ikke standard navnekonvensjon for gammel database og gammelt brukernavn er benyttet (hhv SOC513 og soc513us). Legg merke til at brukernavn og database er case-sensitive. Scriptet kjøres innlogget mot ny database. 4.4 Oppstart av konverteringsprogram NårZZZ.INI er oppdatert ihht. punkt 4.3 ovenfor, er det klart til å starte konverteringsprogrammet. I underkatalogenconvert finnes det en snarvei som hetersocio konvertering. Denne kan nå startes. Under oppstart av konverteringsprogrammet vil det kunne fremkomme en eller flere meldinger om at det automatisk er opprettet en post i ulike tabeller (se Figur 1). Dette er meldinger som kan overses, idet disse dataene uansett vil bli overskrevet under konvertering. Videre kan også melding i Figur 2 overses dersom denne fremkommer. Figur 1: Melding om automatisk opprettelse av post. Figur 2: Feilmelding ved oppstart. Selve oppstarten av konverteringsprogrammet kan ta noe tid. Når programmet har startet, vises vinduet i Figur 3. Konverteringen til Socio 5.2 er lagret som en prosjektfil som følger installasjonssettet til Socio. For å hente inn denne prosjektfilen, gå til fane Handlinger og velg knappen
Konverteringsveiledning Socio 5.2x Side 8 Importer konverteringsprosjekt (se Figur 4 nedenfor). Velg filen som har filnavn er på formen Socio_51x_52x.cpj (erstatt x med plattformkode - 2 eller 3). Installasjonsprogrammet vil da innhente alle operasjonene som skal utføres for å konvertere fra Socio 5.1x til Socio 5.2x. Figur 3: Konverteringsprogrammet etter oppstart. Her vises konvertering til Oracle. Figur 4: Importer konverteringsprosjekt
Konverteringsveiledning Socio 5.2x Side 9 Konverteringen utfører kun en standard konvertering som oppdaterer dataene til bruk i Socio 5.2x. Det er ingen innstillinger til konverteringen denne gangen. Det avhenger av hvilken plattform som benyttes hvorvidt den aktive fanen er Oracle eller MS SQL. De plattformene som ikke er aktuell vises heller ikke. Tabellene nedenfor angir de ulike parametrene som må fylles ut for hver av plattformene for å få konverteringen til å kjøre. Oracle Felt Beskrivelse Gammel database Brukernavn SOC512US (Brukernavn til versjon 5.12) Gammel database Databasealias til Oracle-server der gammel baser ligger (der SOC512TS ligger) Hoststring/service name Gammel database Passord Passord til versjon 5.12 (SOC512US) Ny database Brukernavn SOC522US (Brukernavn til versjon 5.22) Ny database Databasealias til Oracle-server der ny baser ligger (der SOC522TS ligger) Hoststring/service name Ny database Passord Passord til versjon 5.22 (SOC522US) Tabell 1: Hva som må oppgis for å kunne kjøre en konvertering på Oracle MS SQL Felt Beskrivelse Gammel database Servernavn Servernavn og evt. basenavn til MS SQL server Socio 5.13 database. Referansefelt tilsocio.ini er MSS_SERVER Gammel database Database Kan være tom, kan inneholde databasenavn til MS SQL server Socio 5.13 database. Dersom databasenavn er angitt sammen med Servernavn, må denne parameteren være tom. Referansefelt til SOCIO.INI er MSS_DATABASE Gammel database Brukernavn soc513us (Brukernavn til versjon 5.13). Referansefelt tilsocio.ini er MSS_USERNAME Gammel database Passord Passord til versjon 5.13. Referansefelt tilsocio.ini er MSS_PASSWORD Ny database Servernavn Servernavn og evt. basenavn til MS SQL server Socio 5.23 database Referansefelt tilsocio.ini er MSS_SERVER Ny database Database Kan være tom, kan inneholde databasenavn til MS SQL server Socio 5.23 database. Dersom databasenavn er angitt sammen med Servernavn, må denne parameteren være tom. Referansefelt til SOCIO.INI er MSS_DATABASE Ny database Brukernavn soc523us (Brukernavn til versjon 5.23). Referansefelt tilsocio.ini er MSS_USERNAME Ny database Passord Passord til versjon 5.23. Referansefelt tilsocio.ini er MSS_PASSWORD Tabell 2: Hva som må oppgis for å kunne kjøre en konvertering på MS SQL 4.5 Forarbeid til konverteringen I Socio 5.2 er det utvidelser på klientkortet. Det er blant annet lagt inn en til-dato for integreringstilskudd. Innholdet i denne datoen kan styres automatisk av kodeverkselementer på kodeverksgruppen 10041 Oppholdsstatus. For å fylle ut denne samtidig som konverteringen kjøres, må elementene i denne kodeverksgruppen konfigureres før konverteringen av KLIENT kjøres. Kodeverket vil finnes i konverteringsprogrammet under menyvalget Socio Kodeverk, eller hurtigtast CTRL+O. Det er 2 elementer som må konfigureres for hver post i kodeverksgruppen Oppholdsstatus. Disse 2 er: 1. Grunnlag for integreringstilskudd (Ja/Nei) 2. Familiegjenforening med spesielle unntak (Ja/Nei) Element nr. 1, Grunnlag for integreringstilskudd brukes for å si om de som bruker denne oppholdsstatusen oppfyller grunnlag for integreringstilskudd. I Socio 5.2 vil integreringstilskudd fra og
Konverteringsveiledning Socio 5.2x Side 10 til-datoer være utkoblet dersom oppholdsstatus angir et valg som ikke gir grunnlag for integreringstilskudd. Element nr. 2, Familiegjenforening med spesielle unntak brukes for å angi om den aktuelle oppholdsstatusen går inn under de personer som, basert på bosetningsdato i 1. kommune, har 5, 3 eller 0 år med integreringstilskudd (5 år for de som er bosatt før 07.01.2005, 0 år for de som er bosatt mellom 07.01.2005 og 31.12.2005, og 3 år for de som er bosatt etter 31.12.2005). Dersom en person ikke har rettigheter etter oppsettet i kodeverket, vil også Integreringstilskudd fra-dato tømmes under konvertering hvis det har en verdi fra Socio 5.1. Dersom det ikke er ønskelig at konverteringsrutinen automatisk beregner integreringstilskudd til-dato i henhold til reglene over, skal konverteringsopsjonen Int.tilsk.fra/til basert på oph.status kodeverk stå til Nei. Hvis en ønsker en slik endring som nevnt ovenfor settes opsjonen til Ja. 4.6 Selve konverteringen Fanen Handlinger inneholder en liste over de handlingene som skal utføres av konverteringsprogrammet. Alle handlingene må utføres uten feil før konverteringen kan anses som vellykket. De tabellene som ønskes konvertert markeres med en hake (V) i kolonnen lengst til venstre. Det anbefales alltid å kjøre en fullstendig gjennomgang av alle handlinger samtidig. I spesielle tilfelller kan imidlertid enkeltelementer kjøres. Markering av enkelthandlinger gjøres med mellomromtasten. Marker alle handlinger og Fjern markering av alle handlinger -knappene over listen kan også benyttes. Rekkefølgen på elementene i listen angir rekkefølgen handlingene utføres i. For å starte selve oppgraderingsrutinen, trykk på Start-knappen med det grønne lynet. De merkede handlingene vil da bli utført. 4.7 Under konverteringen Sjekk at konverteringen starter. Når konverteringen er i gang, vises en fremdriftsindikator i et eget vindu. Dette vinduet forteller hvor mange poster som skal konverteres og hvor mange som er konvertert. Avhengig av størrelsen på databasen, ta en kopp kaffe, en lunsj, en joggetur eller gjør noe annet 4.8 Etter konverteringen Konverteringsprogrammet lager en loggfil mens konverteringen foregår. Denne loggfilen legger seg i Convert-katalogen. Filnavnet til denne loggfilen er på formen ConvertLog_YYYYMMDD_HHMMSS.TXT. Loggfilen inneholder tidsangivelser for når hver enkelt handling starter og stopper, samt informative meldinger om hva som evt. har gått galt under konverteringen. Kontroller loggfilen for mer info dersom en eller flere handlinger feiler. Rett opp feilen og kjør konvertering på nytt. Tabellene må i så fall tømmes igjen før ny konvertering. Dette gjelder kun for Oracle-installasjoner: Hvis konverteringen er vellykket, må indekser opprettes. Dette gjøres ved å kjøre scriptet SOC522_INDEXES.SQL. Scriptet ligger i katalogenscript under programkatalogen Socio 5.2 ble installert i (f.eks. C:\Socio52\Script) Tilsvarende må scriptetsoc522_archive_indexes.sql kjøres for opprettelse av indekser til arkivtabellene. Dersom anbefalt navnekonvensjon ikke er fulgt, må alle scriptene liggende i katalogenscript tilpasses før bruk. Dette gjelder for alle installasjoner:
Konverteringsveiledning Socio 5.2x Side 11 Når konverteringsprogrammet er ferdig og evt. indekser er bygget opp (for Oracle), er det tid for å kjøre script som får Socio oppdatert på bokstavversjon (tallene etter siste punktum). Det konverteres nå mot Socio 5.2x.09, og det må således kjøres script for å komme opp til Socio 5.2x.10. Scriptene som skal kjøres er: SOC52x09_10.SQL, som ligger i scriptkatalogen.
Konverteringsveiledning Socio 5.2x Side 12 5 Etter oppgraderingen Det er svært viktig at man sjekker de nye konverterte dataene så nøye som overhodet mulig etter en konvertering. Socio må ikke under noen omstendigheter brukes i drift før denne rutinesjekken er utført. Oppdater snarveien til brukerne av systemet så den peker til det nye området av Socio. Anbefaler å endre navnet på den gamle Socio katalogen så man er helt sikker på at ingen får kommet inn og jobbet i den gamle databasen. Eventuelle feil bør meldes til leverandør umiddelbart. Leverandør vil i slike tilfeller avgjøre om produksjon på systemet kan anbefales. 5.1 Nye kodeverksgrupper versjon tas i bruk. Det er dog selvsagt mulig å oppdatere disse kodeverksgruppene på et senere tidspunkt. Tabell 3 viser de nye kodeverksgruppene. Kodegruppe Navn Brukes i 24001 (Ny) Fravær Annullert årsak Fravær 24002 (Ny) Fravær Annen dokumentasjon Fravær Tabell 3: Nye kodeverksgrupper 5.2 Nye faner/felter i parameteroppsettet Parameter/lisens-bildet har fått enkelte utvidelser i forhold til Socio 5.1x. Det er verdt å merke seg at parameteroppsett stadig utvides, også mellom bokstavoppgraderinger. Fane Felt Beskrivelse Fravær 26 felter Grenseverdier for fravær. Disse brukes for å vise grenseverdier ved summering av fravær i fraværskartoteket. Det skiller på grenseverdier og varslingsverdier. Dersom de ikke ønskes brukt, skal -1 settes inn som verdi. Klient Integreringstilskudd voksne Brukes for at systemet skal vite hvilken kravtype som er integreringstilskudd for voksne. Benyttes ved innlesing av fil fra UDI mot ny kravmodul. Klient Integreringstilskudd barn Brukes for at systemet skal vite hvilken kravtype som er integreringstilskudd for voksne. Benyttes ved innlesing av fil fra UDI mot ny kravmodul. Nivå Utfør kontroll før endring av kommunenr (hindrer ikke operasjon) Det er mulig å utføre kontroll før endring av nivå 1/2 på en klient. Kontrollen ble introdusert i Socio 5.1h. Denne kontrollen kan også utføres ved endring av kommunenummer for en klient. Dette hindrer likevel ikke operasionen, men kjøres bare som info. Det er mulig å trekke fravær automatisk ved anvisning i Socio 5.2 Utbetaling Automatisk trekk for fravær ved anvisning Utbetaling Trekk for fravær som ikke Socio kan enten trekke bare fravær som er låst eller bare fravær som ikke er låst i anvisning er låst ved anvisning. Utbetaling Varsle om fravær som ikke Socio varsler ved anvisning der det er fravær som ikke er låst (godkjent) på er låst ved anvisning anvisningstidspunktet. Denne gir ingen mening sammen med trekk for fravær som ikke er låst i anvisning (se over). Kommunikasjon Nye NAV-felter Socio 5.2 vil kjøres mot NAV. Dette konfigurerer Socio mot NAV. Tabell 4: Nye faner/felter i parameteroppsettet
Konverteringsveiledning Socio 5.2x Side 13 5.3 Oppstart av Socio 5.2x for første gang Første oppstart av Socio 5.2x bør utføres kontrollert av en systemansvarlig. Første oppstart av Socio 5.2x vil være tregere enn senere oppstart. Dette på grunn av at systemet må kontrollere og oppdatere enkelte systemtabeller. Dette er en engangsjobb. 5.4 Konfigurering av Socio 5.2 Du skal ha eksportert tabellen LEVHEAD fra Socio 5.1 via import/eksport i driftsverktøyet. Nå er det tid for å importere denne i Socio 5.2. Start driftsverktøyet og importer denne. Videre skal tabellen CRATHEAD importeres. Denne ligger i import-katalogen under Socio-katalogen. Se også nye elementer i parameteroppsettet. 6 Ferdig? Dermed skulle programmet være klart til bruk. TietoEnator håper dette gir et brukbart utgangspunkt for de som velger å utføre konverteringen selv. Skulle det være noe du er usikker på så hører vi gjerne fra deg. Ta i så fall kontakt med support på telefon 41 42 05 00. Er du usikker på noe er det bedre å spørre før man eventuelt gjør noe uklokt!! TietoEnator AS avd Velferd.