minwintid Oppgradering versjon 11.8.1 HRM
Innholdsfortegnelse 1. OM DOKUMENTET... 3 1.1 DOKUMENTETS MÅLSETNING... 3 1.2 HVEM ER DOKUMENTET SKREVET FOR?... 3 1.3 OPPBYGNING OG OPPBEVARING... 3 1.4 ANSVARLIG FOR VEDLIKEHOLD AV DOKUMENTET... 3 2. FØR DU GÅR I GANG... 4 2.1 KAN DU BENYTTE MINWINTID_SETUP_11.8.1.MSI?... 4 2.3 TA BACKUP AV DATABASEN... 4 2.4 TA KOPI AV ALLE FILER OG MAPPER... 4 2.5 TA BACKUP AV WEB.CONFIG... 4 2.6 KARTLEGGE GJELDENDE INSTALLASJON... 4 3. STARTE OPPGRADERING... 5 3.1 INSTALLERE NY VERSJON... 5 3.2 OPPDATERE DATABASEN FRA VERSJON 9.5.6 ELLER ELDRE... 6 3.2.1 MSSQL... 6 3.2.2 Oracle... 6 3.3 OPPDATERE DATABASEN FRA VERSJON 10.0.0 ELLER NYERE... 7 3.3.1 MSSQL... 7 3.3.2 Oracle... 7 3.4.NET FRAMEWORK 4.6.1... 7 3.4.1 Oppgradering fra 11.7.0 eller 11.7.1... 8 3.4.2 Oppgradering fra 11.6.3 eller eldre... 9 3.5 TIL SLUTT... 12 WinTid minwintid - oppgradering Side 2
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
2. Før du går i gang 2.1 Kan du benytte minwintid_setup_11.8.1.msi? Følgende krav må være oppfylt eller oppfylles før du kan oppgarderer minwintid versjon 11.8.1 slik denne veiledningen beskriver: 1. Versjonen du oppgraderer fra, må ikke være eldre en 5.0.0 2. Maskinen du installerer på må ha.net framework 4.6.1 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 2.5. 2.5 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
3. Starte oppgradering 3.1 Installere ny versjon 1. Kjør installasjonsfilen MinWinTid_setup_11.8.1.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
3.2 Oppdatere databasen fra versjon 9.5.6 eller eldre 3.2.1 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 3.2.2 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
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 11.8.1 er det viktig at du ikke kjører dem en gang. 3.3 Oppdatere databasen fra versjon 10.0.0 eller nyere 3.3.1 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 3.3.2 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 11.8.1 er det ikke nødvendig å kjøre det igjen. 3.4.net Framework 4.6.1 Dersom dere oppgraderer fra en tidligere versjon enn 11.8.0 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
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 11.7.0/11.7.1 eller om dere oppgraderer fra en eldre versjon. 3.4.1 Oppgradering fra 11.7.0 eller 11.7.1 Hvis dere har versjon 11.7.0 eller 11.7.1 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="2.0.0.0" /> <add key="webpages:version" value="3.0.0.0" /> 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=4.0.0.1, Culture=neutral, PublicKeyToken=31BF3856AD364E35" /> <add assembly="system.web.mvc, Version=5.2.3.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" /> Endre linjen <machinekey validationkey="f671f5799028250f093b50d10c4d512dbaaa097709d52507af1828be532f 1E2A80ACCF6289B7D1D4675CBAB022C03AACA8EDD8CBC7425FB15B82883A9CC1F6CA,IsolateApps" decryptionkey="1f80a7c7c2633937e66e8c83c6bf1ea05d927aaf6277c10d,isolateapps" validation="sha1" decryption="aes" /> <machinekey validationkey="f671f5799028250f093b50d10c4d512dbaaa097709d52507af1828be532 F1E2A80ACCF6289B7D1D4675CBAB022C03AACA8EDD8CBC7425FB15B82883A9CC1F6 WinTid minwintid - oppgradering Side 8
CA" decryptionkey="1f80a7c7c2633937e66e8c83c6bf1ea05d927aaf6277c10d" validation="sha1" decryption="aes" /> (fjern,isolateapps) Endre linjen <pages controlrenderingcompatibilityversion="4.0" validaterequest="false"> <pages controlrenderingcompatibilityversion="4.0"> (fjern validaterequest="false") 3.4.2 Oppgradering fra 11.6.3 eller eldre Hvis dere har versjon 11.6.3 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=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" /> <section name="system.identitymodel.services" type="system.identitymodel.services.configuration.systemidentitymodelservicessection, System.IdentityModel.Services, Version=4.0.0.0, Culture=neutral, PublicKeyToken=B77A5C561934E089" /> Under <appsettings>, endre linjen <add key="webpages:version" value="2.0.0.0" /> <add key="webpages:version" value="3.0.0.0" /> 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=4.0.0.0, 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
<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=4.0.0.1, Culture=neutral, PublicKeyToken=31BF3856AD364E35" /> <add assembly="system.web.mvc, Version=5.2.3.0, Culture=neutral, PublicKeyToken=31BF3856AD364E35" /> Endre linjen <machinekey validationkey="f671f5799028250f093b50d10c4d512dbaaa097709d52507af1828be532f 1E2A80ACCF6289B7D1D4675CBAB022C03AACA8EDD8CBC7425FB15B82883A9CC1F6CA,IsolateApps" decryptionkey="1f80a7c7c2633937e66e8c83c6bf1ea05d927aaf6277c10d,isolateapps" validation="sha1" decryption="aes" /> <machinekey validationkey="f671f5799028250f093b50d10c4d512dbaaa097709d52507af1828be532 F1E2A80ACCF6289B7D1D4675CBAB022C03AACA8EDD8CBC7425FB15B82883A9CC1F6 CA" decryptionkey="1f80a7c7c2633937e66e8c83c6bf1ea05d927aaf6277c10d" 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="0.0.0.0-4.1.1.0" newversion="4.1.1.0" /> WinTid minwintid - oppgradering Side 10
<!-- 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="0.0.0.0-9.0.0.0" newversion="9.0.0.0" /> <assemblyidentity name="webgrease" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion="0.0.0.0-1.6.5135.21930" newversion="1.6.5135.21930" /> <assemblyidentity name="system.web.helpers" publickeytoken="31bf3856ad364e35" /> <bindingredirect oldversion="1.0.0.0-3.0.0.0" newversion="3.0.0.0" /> <assemblyidentity name="system.web.webpages" publickeytoken="31bf3856ad364e35" /> <bindingredirect oldversion="0.0.0.0-3.0.0.0" newversion="3.0.0.0" /> <assemblyidentity name="system.web.mvc" publickeytoken="31bf3856ad364e35" /> <bindingredirect oldversion="0.0.0.0-5.2.3.0" newversion="5.2.3.0" /> <assemblyidentity name="system.web.http" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion="0.0.0.0-5.2.3.0" newversion="5.2.3.0" /> <assemblyidentity name="system.net.http.formatting" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion="0.0.0.0-5.2.3.0" newversion="5.2.3.0" /> <assemblyidentity name="system.web.http.webhost" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion="0.0.0.0-5.2.3.0" newversion="5.2.3.0" /> <assemblyidentity name="microsoft.owin.security" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion="0.0.0.0-3.0.1.0" newversion="3.0.1.0" /> <assemblyidentity name="microsoft.owin" publickeytoken="31bf3856ad364e35" culture="neutral" /> <bindingredirect oldversion="0.0.0.0-3.0.1.0" newversion="3.0.1.0" /> <assemblyidentity name="microsoft.aspnet.signalr.core" publickeytoken="31bf3856ad364e35" culture="neutral" /> WinTid minwintid - oppgradering Side 11
<bindingredirect oldversion="0.0.0.0-2.2.1.0" newversion="2.2.1.0" /> <assemblyidentity name="antlr3.runtime" publickeytoken="eb42632606e9261f" culture="neutral" /> <bindingredirect oldversion="0.0.0.0-3.5.0.2" newversion="3.5.0.2" /> </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