minwintid Oppgradering til versjon HRM

Transkript

1 minwintid Oppgradering versjon HRM

2 Innholdsfortegnelse 1. OM DOKUMENTET DOKUMENTETS MÅLSETNING HVEM ER DOKUMENTET SKREVET FOR? OPPBYGNING OG OPPBEVARING ANSVARLIG FOR VEDLIKEHOLD AV DOKUMENTET FØR DU GÅR I GANG KAN DU BENYTTE MINWINTID_SETUP_ MSI? TA BACKUP AV DATABASEN TA KOPI AV ALLE FILER OG MAPPER TA BACKUP AV WEB.CONFIG KARTLEGGE GJELDENDE INSTALLASJON STARTE OPPGRADERING INSTALLERE NY VERSJON OPPDATERE DATABASEN FRA VERSJON ELLER ELDRE MSSQL Oracle OPPDATERE DATABASEN FRA VERSJON ELLER NYERE MSSQL Oracle NET FRAMEWORK Oppgradering fra eller Oppgradering fra eller eldre TIL SLUTT WinTid minwintid - oppgradering Side 2

3 1. Om dokumentet 1.1 Dokumentets målsetning Dette dokumentet beskriver hvordan en oppgradering av minwintid skal gjennomføres. Dokumentet skal bidra at oppgraderingen foretas på en sikker og hensiktsmessig måte. 1.2 Hvem er dokumentet skrevet for? Dokumentet er skrevet for teknikere og kunder som skal utføre oppgraderingen, eller andre som ønsker å orientere seg om hvordan CGI ønsker at dette produktet skal oppgraderes. 1.3 Oppbygning og oppbevaring Dokumentet oppbevares hos CGI. 1.4 Ansvarlig for vedlikehold av dokumentet CGI er ansvarlig for at dokumentet som mal blir vedlikeholdt. WinTid minwintid - oppgradering Side 3

4 2. Før du går i gang 2.1 Kan du benytte minwintid_setup_ msi? Følgende krav må være oppfylt eller oppfylles før du kan oppgarderer minwintid versjon slik denne veiledningen beskriver: 1. Versjonen du oppgraderer fra, må ikke være eldre en Maskinen du installerer på må ha.net framework installert. 3. Dersom WinTid databasen kjører på Oracle, må både server og klient ha versjon 9.2 eller høyere. 2.2 Avslutte alle WinTid programmer Alle brukere må være utlogget fra databasen og ingen WinTid-filer må være i bruk under oppgradering. - Sørg for at ingen brukere benytter WinTid g2 (Dashboard.exe). - Stopp IIS på serveren der minwintid kjører. - Stopp følgende WinTid tjenester: o WinTidServer Denne modulen er ikke alltid installert. o WinTidDataCollection Denne modulen er installer dersom dere benytter stemplingsterminaler. o WinTidScheduler 2.3 Ta backup av databasen For å sikre at data ikke går tapt i felle oppgraderingen feiler, er det viktig at du tar en komplet backup av databasen. 2.4 Ta kopi av alle filer og mapper I felle noe går galt under installasjonen anbefaler vi at du tar kopi av alle filer og mapper. Hele strukturen som vist i avsnitt Ta backup av web.config Oppgraderingen vil erstatte web.config med en standardfil. Dersom du har gjort endringer i autentisering eller lignende er det viktig at du tar backup av eksisterende web.config fil i minwintid-mappen. 2.6 Kartlegge gjeldende installasjon For å sikre at oppgraderingen blir utført riktig, må du sjekk hvor installasjonsfilene for gjeldende installasjon er plassert. Vanligvis ligger filene installert på en lokal disk med følgende struktur: Installasjonsmappe Dersom eksisterende installasjon ligger under C:\WinTid. Blir installasjonsmappen C:\WinTid. WinTid minwintid - oppgradering Side 4

5 3. Starte oppgradering 3.1 Installere ny versjon 1. Kjør installasjonsfilen MinWinTid_setup_ msi 2. Gjør dine valg og trykk Next fram følgende skjermbilde: Når du oppgraderer en eksisterende installasjon så er AspNet MVC3 Tools allerede installert, så den trenger ikke installeres. 3. Klikk Next neste skjermbilde: Bla deg fram installasjonsmappen som ble kartlagt i avsnitt 2.5. Når du oppgraderer en eksisterende installasjon skal det ikke krysses av for Opprette website eller Opprette application pool 4. I de resterende skjermbildene velger du Next helt installasjonen er ferdig WinTid minwintid - oppgradering Side 5

6 3.2 Oppdatere databasen fra versjon eller eldre MSSQL Dersom WinTid-basen hos dere kjører på en MSSQL databaseserver, gjør følgende: 1. Start SQL Server Management Studio 2. Logg på med SA 3. Velg riktig database Kjør scriptet 1_WinTidNetMS.SQL 4. Åpne scriptet 1_WinTidNetMS.SQL Scriptet ble installert som en del av installasjonen (3.1) og ligger under <Installasjonsmappe>\Script\MS 5. Kjør scriptet 6. Sjekk at loggen er fri for feilmeldinger Kjør scriptet UpdateDBForMultiplePos.sql 7. Åpne scriptet UpdateDBForMultiplePos.sql Scriptet ble installert som en del av installasjonen (3.1) og ligger under <Installasjonsmappe>\Script\MS 8. Kjør scriptet 9. Sjekk at loggen er fri for feilmeldinger. Det vil være noen advarsler der, men så lenge det ikke er feilmeldinger kan dette ignoreres Kjør scriptet WinTid_Update_100_AndNewer_MSS.sql 10. Åpne scriptet WinTid_Update_100_AndNewer_MSS.sql Scriptet ble installert som en del av installasjonen (3.1). Og ligger under <Installasjonsmappe>\Script\MS 11. Kjør scriptet 12. Sjekk at loggen er fri for feilmeldinger 13. Ferdig Oracle Dersom WinTid basen hos dere kjører på en Oracle databaseserver, gjør følgende: 1. Oppdater alle scriptene som skal kjøres, med riktig variabelverdi INDX_TS. Denne ligger øverst i alle sciptene og angir navn på tabellområde hvor indekser skal ligge. 2. Start Sqlplus fra dos prompt (Det er svært viktig at du kjører fra dos). 3. Kjør scriptet 8_WinTidNetORA.SQL Dersom alt er ok, gå videre neste punkt 4. Kjør scriptet 9_WinTidNetORA_Data.SQL Dersom alt er ok, gå videre neste punkt 5. Kjør scriptet 10_WinTidNetORA_SEQ.SQL Dersom alt er ok, gå videre neste punkt 6. Kjør scriptet 11_WinTidNetORA_TRIGGER.SQL Dersom alt er ok, gå videre neste punkt 7. Kjør scriptet UpdateDBForMultiplePosOra.sql WinTid minwintid - oppgradering Side 6

7 Det kan komme advarsler når dette scriptet er kjørt, men så lenge det ikke er noen feilmeldinger, gå videre neste punkt 8. Kjør scriptet WinTid_Update_100_AndNewer_ORA.sql Dersom alt er ok er du ferdig Dersom noen av disse scriptene allerede er kjørt i forbindelse med oppgradering av WinTid g2, WinTidServer, WinTidDataCollection eller WinTidScheduler versjon er det viktig at du ikke kjører dem en gang. 3.3 Oppdatere databasen fra versjon eller nyere MSSQL Dersom WinTid-basen hos dere kjører på en MSSQL databaseserver, gjør følgende: 1. Start SQL Server Management Studio 2. Logg på med SA 3. Velg riktig database Kjør scriptet WinTid_Update_100_AndNewer_MSS.sql 4. Åpne scriptet WinTid_Update_100_AndNewer_MSS.sql Scriptet ble installert som en del av installasjonen (3.1) og ligger under <Installasjonsmappe>\Script\MS 5. Kjør scriptet 6. Sjekk at loggen er fri for feilmeldinger 7. Ferdig Oracle Dersom WinTid basen hos dere kjører på en Oracle databaseserver, gjør følgende: 1. Oppdater alle scriptene som skal kjøres, med riktig variabelverdi INDX_TS. Denne ligger øverst i alle sciptene og angir navn på tabellområde hvor indekser skal ligge. 2. Start Sqlplus fra dos prompt (Det er svært viktig at du kjører fra dos). 3. Kjør scriptet WinTid_Update_100_AndNewer_ORA.sql Dersom alt er ok, er du ferdig. Dersom scriptet allerede er kjørt i forbindelse med oppgradering av WinTid g2, WinTidServer, WinTidDataCollection eller WinTidScheduler versjon er det ikke nødvendig å kjøre det igjen. 3.4.net Framework Dersom dere oppgraderer fra en tidligere versjon enn må det gjøres noen endringer i web.config, enten manuelt eller ved å erstatte eksisterende web.config med ny.config-fil (anbefales på det sterkeste). Det kan gjøres på to måter: WinTid minwintid - oppgradering Side 7

8 1. Det enkleste er å ta utgangspunkt i web.config-filen som blir kopiert inn av installasjonspakken. Fjern read only-flagg fra filen først, slik at det er mulig å lagre endringer i den. Skru på single sign-on igjen i IIS dersom dere benytter det, og legg inn eventuelle endringer som er gjort i deres web.config under appsettings, for eksempel helplinkpath 2. For å endre manuelt, ta en backup av web.config-filen som ble lagt inn av installasjonspakken, og kopier bake web.config-filen du tok backup av før du startet oppgraderingen. Hva som må endres avhenger av om dere tidligere har oppgradert / eller om dere oppgraderer fra en eldre versjon Oppgradering fra eller Hvis dere har versjon eller i dag og ønsker å endre web.config manuelt, må følgende endringer gjøres i web.config: Under <appsettings>, endre linjen <add key="webpages:version" value=" " /> <add key="webpages:version" value=" " /> På linjen over </system.webserver>, legg inn følgende: <handlers> <remove name="extensionlessurlhandler-integrated-4.0" /> <remove name="optionsverbhandler" /> <remove name="traceverbhandler" /> <add name="extensionlessurlhandler-integrated-4.0" path="*." verb="*" type="system.web.handlers.transferrequesthandler" precondition="integratedmode,runtimeversionv4.0" /> </handlers> Endre linjen <httpruntime enableversionheader="false" requestvalidationmode="2.0" /> <httpruntime enableversionheader="false" targetframework="4.6.1" requestvalidationmode="2.0" /> Under <assemblies>, endre linjen <add assembly="system.web.mvc, Version= , Culture=neutral, PublicKeyToken=31BF3856AD364E35" /> <add assembly="system.web.mvc, Version= , Culture=neutral, PublicKeyToken=31BF3856AD364E35" /> Endre linjen <machinekey validationkey="f671f f093b50d10c4d512dbaaa097709d52507af1828be532f 1E2A80ACCF6289B7D1D4675CBAB022C03AACA8EDD8CBC7425FB15B82883A9CC1F6CA,IsolateApps" decryptionkey="1f80a7c7c e66e8c83c6bf1ea05d927aaf6277c10d,isolateapps" validation="sha1" decryption="aes" /> <machinekey validationkey="f671f f093b50d10c4d512dbaaa097709d52507af1828be532 F1E2A80ACCF6289B7D1D4675CBAB022C03AACA8EDD8CBC7425FB15B82883A9CC1F6 WinTid minwintid - oppgradering Side 8

9 CA" decryptionkey="1f80a7c7c e66e8c83c6bf1ea05d927aaf6277c10d" validation="sha1" decryption="aes" /> (fjern,isolateapps) Endre linjen <pages controlrenderingcompatibilityversion="4.0" validaterequest="false"> <pages controlrenderingcompatibilityversion="4.0"> (fjern validaterequest="false") Oppgradering fra eller eldre Hvis dere har versjon eller eldre i dag og ønsker å endre web.config manuelt, må følgende endringer gjøres i web.config: Under <configsection>, legg følgende linjer: <section name="system.identitymodel" type="system.identitymodel.configuration.systemidentitymodelsection, System.IdentityModel, Version= , Culture=neutral, PublicKeyToken=B77A5C561934E089" /> <section name="system.identitymodel.services" type="system.identitymodel.services.configuration.systemidentitymodelservicessection, System.IdentityModel.Services, Version= , Culture=neutral, PublicKeyToken=B77A5C561934E089" /> Under <appsettings>, endre linjen <add key="webpages:version" value=" " /> <add key="webpages:version" value=" " /> Over <system.webserver>, legg følgende: <location path="account/externallogin"> <system.web> <authorization> <allow users="*" /> </authorization> </system.web> </location> Under <system.webserver>, erstatt <modules runallmanagedmodulesforallrequests="true" /> med <modules runallmanagedmodulesforallrequests="true"> <add name="sessionauthenticationmodule" type="system.identitymodel.services.sessionauthenticationmodule, System.IdentityModel.Services, Version= , Culture=neutral, PublicKeyToken=b77a5c561934e089" precondition="managedhandler" /> </modules> Over </system.webserver>, legg følgende: <handlers> <remove name="extensionlessurlhandler-integrated-4.0" /> WinTid minwintid - oppgradering Side 9

10 <remove name="optionsverbhandler" /> <remove name="traceverbhandler" /> <add name="extensionlessurlhandler-integrated-4.0" path="*." verb="*" type="system.web.handlers.transferrequesthandler" precondition="integratedmode,runtimeversionv4.0" /> </handlers> Under <system.web> endre <httpruntime enableversionheader="false" /> <httpruntime enableversionheader="false" targetframework="4.6.1" requestvalidationmode="2.0" /> Endre linjen <compilation debug="false" targetframework="4.0"> <compilation debug="false" targetframework="4.6.1"> Under <assemblies>, endre linjen <add assembly="system.web.mvc, Version= , Culture=neutral, PublicKeyToken=31BF3856AD364E35" /> <add assembly="system.web.mvc, Version= , Culture=neutral, PublicKeyToken=31BF3856AD364E35" /> Endre linjen <machinekey validationkey="f671f f093b50d10c4d512dbaaa097709d52507af1828be532f 1E2A80ACCF6289B7D1D4675CBAB022C03AACA8EDD8CBC7425FB15B82883A9CC1F6CA,IsolateApps" decryptionkey="1f80a7c7c e66e8c83c6bf1ea05d927aaf6277c10d,isolateapps" validation="sha1" decryption="aes" /> <machinekey validationkey="f671f f093b50d10c4d512dbaaa097709d52507af1828be532 F1E2A80ACCF6289B7D1D4675CBAB022C03AACA8EDD8CBC7425FB15B82883A9CC1F6 CA" decryptionkey="1f80a7c7c e66e8c83c6bf1ea05d927aaf6277c10d" validation="sha1" decryption="aes" /> (fjern,isolateapps) Endre linjen <pages> <pages controlrenderingcompatibilityversion="4.0"> Erstatt ALT fra <runtime> </runtime> med følgende: <runtime> <assemblybinding xmlns="urn:schemas-microsoft-com:asm.v1"> <assemblyidentity name="autofac" publickeytoken="17863af14b0044da" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> WinTid minwintid - oppgradering Side 10

11 <!-- This is introduced because Mobile project is using old version of Newtonsoft.Json while ExternalProjectsIntegration library is using newer one --> <assemblyidentity name="newtonsoft.json" publickeytoken="30ad4fe6b2a6aeed" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="webgrease" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="system.web.helpers" publickeytoken="31bf3856ad364e35" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="system.web.webpages" publickeytoken="31bf3856ad364e35" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="system.web.mvc" publickeytoken="31bf3856ad364e35" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="system.web.http" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="system.net.http.formatting" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="system.web.http.webhost" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="microsoft.owin.security" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="microsoft.owin" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="microsoft.aspnet.signalr.core" publickeytoken="31bf3856ad364e35" culture="neutral" /> WinTid minwintid - oppgradering Side 11

12 <bindingredirect oldversion=" " newversion=" " /> <assemblyidentity name="antlr3.runtime" publickeytoken="eb e9261f" culture="neutral" /> <bindingredirect oldversion=" " newversion=" " /> </assemblybinding> </runtime> Merk at <runtime> og </runtime> kun skal stå en gang hver. 3.5 Til slutt Husk å starte IIS. WinTid minwintid - oppgradering Side 12