Hotfix-patchning

Generellt

Hotfixar är mindre uppdateringar innehållande kritiska buggfixar och eventuellt även ny och/eller ändrad funktionalitet. En hotfix-release innehåller inte nödvändigtvis buggfixar och uppdateringar för samtliga komponenter. Installation av hotfix kallas även för "patchning" eller "hotfix-patchning".

Leverantören tillhandahåller nya versioner av flexite som installationspaket vid avtalat intervall.

Merparten av arbetet med patchning utförs direkt på servrarna, undantaget de fall där flexiteCLIENT även installerats lokalt på en administratörs dator. Inget arbete behöver göras på klientdatorerna.

Installation av hotfix kan utföras av leverantören, av beställaren eller av beställaren utsedd tredje part. Installation av hotfix kräver god kännedom om den tekniska plattformen; flexite, databas, webbserver, operativsystem, etcetera.

Handhavande av hotfix-patchning

Leverantören informerar beställaren om kommande hotfixar. Vid de fall funktionaliteten i installerat system hos beställaren kan komma att påverkas av en hotfix informerar leverantören även om detta. Leverantören kommer även med förslag på utbildnings- och informationsinsatser som kan komma att krävas innan och/eller efter genomförd patchning.

Installationspaket för nya versioner och nya hotfixar distribueras av leverantören.

Backup av befintlig installation bör alltid genomföras i samband med uppgradering och hotfix-patchning, vilket även poängteras i guiden.

Det finns inga krav från leverantören att först applicera en uppgradering eller hotfix-patch i en testmiljö innan den tillämpas i produktionsmiljön. Om det ändå finns önskemål om detta från beställarens sida kan detta förfarande tillämpas utan extra krav på licensbehov.

Krav för patchning

Följande kriterier behöver uppfyllas för att kunna genomföra installation av hotfix för flexite:

• Filpaket med senaste hotfix för installerad version av flexite.
• Åtkomst till applikationsserver.
• Åtkomst till databasserver.
• Användaruppgifter till befintlig installation av flexite.

Genomförande av patchning

Detta kapitel beskriver proceduren för installation av en hotfix på en standardinstallation av flexite utan kundspecifika inställningar. I denna guide förutsätter vi att hotfix-paketet innehåller uppdateringar för samtliga produkter.

En patchning av en standardinstallation består av följande grundläggande moment:

1. Hämta hotfix-paket.
2. Läs readme i hotfix-paket.
3. Stoppa tjänster.
4. Ta backup.
5. Patcha databas.
6. Patcha flexiteCLIENT.
7. Patcha flexiteWEB.
8. Patcha flexiteAdmin.
9. Patcha flexiteProcessEngine.
10. Starta tjänster.
11. Verifiera funktionalitet (se avsnitt Verifiera funktionalitet).

Sökvägar

I detta kapitel förutsätter vi att sökvägarna är som följer:

• Databas — sqlserver.company.com:flexite
• flexiteCLIENT — C:\flexite\flexiteCLIENT
• Apache Tomcat — C:\tomcat
• flexiteProcessEngine — C:\tomcat\flexite\flexiteProcessEngine
• flexiteWEB — C:\tomcat\webapps\flexite
• flexiteAdmin — C:\tomcat\webapps\flexiteAdmin

Deklaration

I detta dokument används '{ ... }' för att ange variabler. Det aktuella värdet för dessa variabler varierar beroende på systemkonfiguration.

• {tomcatPath} — Sökväg för installationen av Apache Tomcat. Standard: C:\tomcat
• {tomcatPort} — Port för Apache Tomcat webbserver. Standard: 8080
• {webappName} — Katalognamn för flexites webbapplikationer, flexiteWEB respektive flexiteAdmin. Standard: ' flexite' respektive ' flexiteAdmin'.
• {dbServer} — Namn eller IP-adress på databasserver.
• {dbName} — Namn på flexite databas. Standard: flexite
• {dbUserName} — Användarnamn för databasanvändare med åtkomst till flexite databas. I detta exempel: flexite
• {dbUserPassword} — Lösenord för databasanvändare med åtkomst till flexite databas. I detta exempel: flexite123
• {webServer} — Namn eller IP-adress på webbserver. Apache Tomcat kan som standard nås lokalt (från samma server) på http://localhost:8080.

Hämta hotfix-paket

Hotfixar för flexite levereras i kompletta hotfix-paket som innehåller patchar för samtliga berörda flexiteprodukter. En ny hotfix-version innehåller även samtliga tidigare hotfixar för samma build. Kontakta Flexite AB för tillgång till installationspaket.

Packa upp hotfix-paket

Packa upp hämtat hotfix-paket till valfri temporär katalog ({temp:hotfix}).

Stoppa tjänster

För att undvika databaskorruption och andra problem är det kritiskt att flexiteProcessEngine inte körs under patchningsprocessen. Det är även rekommenderat att stänga ner samtliga flexiteCLIENT anslutna till databasen samt stoppa Apache Tomcat för att fullständigt stänga ner och blockera åtkomst till webbapplikationerna.

1. På applikationsservern, öppna Windows Services.
   • Stoppa tjänsten för flexiteProcessEngine. Verifiera att samtliga av flexiteProcessEngines tjänster stoppas; AlarmSvc, DBLinkSvc, ExExtData, LeadTimesSvc, MailSvc, OnHoldSvc, StatisticsSvc, SubstituteSvc.
   • Om Apache Tomcat inte används till andra webbapplikationer än det flexite-system som ska uppgraderas är det också starkt rekommenderat att denna tjänst stoppas. Detta för att förhindra att Tomcat låser filer i flexiteWEB.
2. Om Apache Tomcat även används till annat är det möjligt att låta tjänsten för Apache Tomcat fortsätta köra och enbart stoppa webbapplikationerna för flexiteWEB och flexiteAdmin. Denna åtgärd utförs på applikationsservern.

   • Öppna en webbläsare och navigera till Tomcats översiktssida. I en standardinstallation är adressen för denna http://localhost:8080.

   • Klicka på 'Manager App' och logga in med admin-kontot för Tomcat. I en standardinstallation är det följande kontouppgifter:

     Användarnamn: admin
     Lösenord: flexite321

   • Stoppa applikationen för flexiteWEB. I en standardinstallation är det ' flexite'.

   • Stoppa applikationen för flexiteAdmin. I en standardinstallation är det ' flexiteAdmin'.

3. Stäng ner samtliga installationer av flexiteCLIENT som är anslutna till den aktuella databasen.

Backup

Innan patchning utförs är det kritiskt att ta backup på den befintliga installationen.

• Backup av databas — Utförs med fördel i Microsoft SQL Server Management Studio.
  • Anslut till databasservern ({dbServer}) och navigera till den befintliga databasen för flexite ({dbServer}/Databases/flexite).
  • Ta en full databasbackup (Tasks > Backup...). Spara backupen i valfri temporär katalog.
• Backup av flexiteCLIENT — Kopiera samtliga filer och kataloger från installationskatalogen för flexiteCLIENT (som standard 'C:\flexite\flexiteCLIENT') till valfri temporär katalog ({backup:flexiteClient}).
• Backup av flexiteProcessEngine — Kopiera katalogen för flexiteProcessEngine (som standard 'C:\tomcat\flexite\flexiteProcessEngine') till valfri temporär katalog ({backup:flexiteProcessEngine}). Notera att loggfilerna kan vara stora, det är därför rekommenderat att komprimera dem i backup för att spara diskutrymme.
• Backup av flexiteWEB — Kopiera katalogen för flexiteWEB (som standard 'C:\tomcat\webapps\flexite') till valfri temporär katalog ({backup:flexiteWeb}).
• Backup av flexiteAdmin — Kopiera katalogen för flexiteAdmin (som standard 'C:\tomcat\webapps\flexiteAdmin') till valfri temporär katalog ({backup:flexiteAdmin}).

Patcha databas

Det första steget är att patcha databasen. För detta krävs tillgång till databasservern.

1. Verifiera att tjänsterna för flexiteProcessEngine och Apache Tomcat, alternativt webbapplikationen, är stoppade. Det är även rekommenderat att samtliga flexiteCLIENT kopplade till databasen är stängda.
2. Verifiera att backup har tagits i enlighet med avsnitt Backup.
3. Om hotfix finns för versionen, packa upp hotfix-paketet till valfri temporär katalog ({temp:hotfix}).

   • Navigera till {temp:hotfix} och läs igenom readme för installationsinstruktioner.

   • Navigera till {temp:hotfix}\hotfixDBUpdate och kör hotfixDBUpdate.exe.

     • Steg 1

       Database — Namn eller IP-adress för databasserver följt av databasnamn, separerat med kolon ({dbServer}:{dbName}). Exempel: sqlserver.company.com:flexite
       DB user — Användarnamn för databasåtkomst. Standard: flexite
       DB password — Lösenord för databasåtkomst. Standard: flexite123

     • Steg 2

       Updater's name — Namn på den person som utför uppdateringen. Sparas till logg i databasen. Obligatoriskt fält.
       Current DB version — Aktuell version på databasen. Ifylls av applikationen.
       Update up to version — Ange till vilken hotfix-version som uppdatering ska ske. Det är möjligt att ange en version upp till och med version för aktuellt hotfix-paket.
       Notes — Notering för uppdatering. Sparas till logg i databasen. Obligatoriskt fält.

   • Logg för applikationen hotfixDBUpdate sparas till hotfixDBUpdate.log.

Patcha flexiteCLIENT

Det är starkt rekommenderat att patcha och starta flexiteCLIENT innan flexiteProcessEngine, flexiteWEB och flexiteAdmin. Detta för att verifiera att både flexiteCLIENT och databasen uppdaterats korrekt, samt för att verifiera databaskopplingen mellan flexiteCLIENT och databasservern.

Det finns två tillvägagångssätt för att patcha flexiteCLIENT; det går antingen att köra installationsprogrammet för flexiteCLIENT, eller att manuellt kopiera filerna från hotfix-paketet. För att säkerställa att registrerad information om kritiska bibliotek uppdateras är det rekommenderat att alltid nyttja installationsprogrammet.

Obs!

Det är kritiskt att säkerställa att samtliga installationer av flexiteCLIENT som är kopplade till den aktuella databasen patchas.

Patcha med installationsprogram

1. Verifiera att backup har tagits i enlighet med avsnitt Backup.
2. Kör fx_{version:hotfix}_install.exe från hotfix-katalogen. Exempelvis 'fx_1.2.3.04_install.exe'.
3. Följ instruktionerna i installationsprogrammet. För de flesta miljöer fungerar det att använda sig utav standardinställningarna. Det är dock kritiskt att välja att INTE skriva över befintliga filer, då det resulterar i försvunna inställningar.
4. Jämför följande filer i installationskatalogen med de i backup-katalogen. Kontrollera att samtliga inställningar finns kvar. Om nödvändigt, kopiera konfigurerade parametrar från backup-filerna till de nya filerna:
   • flexite.ini
   • rbuilder.ini

Patcha med filpaket

1. Verifiera att backup har tagits i enlighet med avsnitt Backup.
2. Kopiera samtliga filer och kataloger från {temp:hotfix}\flexite\flexiteCLIENT till installationskatalogen för flexiteCLIENT och skriv över destinationsfilerna.
   • För att nyttja språkpaketet 'Company' behöver inga ändringar göras, eftersom det redan ligger i rotkatalogen (C:\flexite\flexiteCLIENT). Om annat språkpaket önskas, kopiera istället filerna från önskat paket under C:\flexite\flexiteCLIENT\Languages till rotkatalogen.
3. Jämför följande filer i installationskatalogen med de i backup-katalogen. Kopiera konfigurerade parametrar från backup-filerna till de nya filerna:
   • flexite.ini
   • rbuilder.ini

Obs!

I hotfix-paket levereras filer för språkpaketet 'Company' direkt i rotkatalogen för flexiteCLIENT. Detta betyder att språkfilerna under katalogen 'flexiteCLIENT\Languages\Company\' inte uppdateras i och med hotfix. För att uppdatera filerna i denna katalog måste språkfilerna kopieras från rotkatalogen.

Registrera bibliotek för att skicka e-post

Om aktuell hotfix innehåller en uppdatering för ActiveX-biblioteket EASendMailObj.dll måste detta bibliotek registreras på nytt för att erhålla full funktionalitet.

Detta bibliotek behöver registreras en gång per maskin som huserar flexiteCLIENT och/eller flexiteProcessEngine. Detta betyder att biblioteket behöver registreras en gång på applikationsservern samt en gång på varje maskin där flexiteCLIENT är installerad.

Notera att registreringen sker med absolut sökväg, vilket betyder att om filen flyttas måste den registreras på nytt. Det är således rekommenderat att på applikationsservrar registrera biblioteket i flexiteProcessEngine istället för i flexiteCLIENT (se avsnitt Registrera bibliotek för e-post).

Registrera bibliotek i flexiteCLIENT

1. Öppna en kommandoprompt med administratörsrättigheter.
2. Navigera till C:\flexite\flexiteCLIENT\.
3. Kör filen EASendMailObj.cmd. Detta registrerar den absoluta sökvägen för det lokala biblioteket, EASendMailObj.dll, på maskinen.

Radering av förlegade bibliotek

Bibliotek som blivit ersatta och därmed inte längre nyttjas av flexiteCLIENT raderas som standard av flexiteCLIENT vid uppstart.

I och med att flexiteCLIENT är en applikation som körs med aktuell Windows-användares rättigheter för filsystemet kan det uppstå situationer där rättigheter saknas för att radera dessa filer. I dessa fall visas ett felmeddelande vid uppstart med en lista på filer som måste raderas manuellt för att applikationen ska kunna starta. Använd ett Windows-konto med fulla rättigheter till flexiteCLIENT-katalogen för att radera dessa filer.

Starta flexiteCLIENT

Innan patchning av övriga applikationer utförs är det rekommenderat att starta och logga in i flexiteCLIENT. Detta för att verifiera att både flexiteCLIENT och databasen uppdaterats korrekt, samt för att verifiera databaskopplingen mellan flexiteCLIENT och databasservern:

1. Starta flexiteCLIENT med C:\flexite\flexiteCLIENT\flexite.exe.

2. Det ska nu vara möjligt att logga in i klienten med admin-kontot för flexiteCLIENT.
   I en standardinstallation är det följande kontouppgifter:

   Användarnamn: realboss
   Lösenord: Flux.123!

3. Om inloggningen lyckas fungerar databaskopplingen.

Patcha flexiteWEB

flexiteWEB är en webbapplikation och för patchning krävs därmed tillgång till applikationsservern.

Det grundläggande tillvägagångssättet för att patcha flexiteWEB är att manuellt kopiera filer från hotfix-paketet och skriva över de i den befintliga installationen.

Ersätt filer i flexiteWEB

Ersätt filer i befintlig installation av flexiteWEB med nya versioner.

1. Verifiera att tjänsten för flexiteProcessEngine är stoppad. Verifiera att tjänsten för Apache Tomcat, alternativt aktuell webbapplikation, är stoppad.
2. Verifiera att backup har tagits i enlighet med avsnitt Backup.
3. Ta bort samtliga filer och kataloger i Catalina Work för applikationen; C:\tomcat\work\Catalina\localhost\flexite.
4. Navigera till {temp:hotfix} och läs igenom readme för särskilda installationsinstruktioner.
5. Kopiera samtliga filer och kataloger från {temp:hotfix}\flexiteWEB\webapps\standard till C:\tomcat\webapps\flexite och skriv över destinationsfilerna. Om särskilda instruktioner är angivna i readme, följ dessa.
6. Radera gamla filer som ej längre nyttjas i och med hotfix. Detta utförs genom att köra C:\tomcat\webapps\flexite\WEB-INF\clean.cmd med administratörsrättigheter.
   • Om tjänsten för Tomcat inte stoppats kan det uppstå tillfällen då Tomcat låser filer i webbapplikationen, vilket förhindrar borttagning. I dessa fall måste tjänsten för Tomcat stoppas för att låsningen ska upphöra.

Återställ konfiguration

Återställ följande filer från {backup:flexiteWeb}:

• [rotkatalog]
  Jämför innehåll i följande filer och återställ parametrar som skräddarsytts i aktuell installation:
  • flexite.jsp
  • index.jsp
• [customer]
  Återställ de filer som nyttjas.
• [WEB-INF\classes\settings]
  Jämför innehåll i följande filer och återställ parametrar som skräddarsytts i aktuell installation:
  • customer.conf
  • flexite.conf
  • pool.conf
• [WEB-INF\classes\integration\eid]
  Om E-ID nyttjas, återställ samtliga filer.
• [WEB-INF\classes\integration\ext-identity]
  Om E-ID ext-identity nyttjas, återställ samtliga filer.
• [WEB-INF\classes\integration\initiate1177ws]
  Om denna integration med 1177 nyttjas, återställ samtliga filer.
• [WEB-INF\classes\integration\ldap]
  Om LDAP SSO nyttjas, återställ samtliga filer.
• [WEB-INF\classes\integration\mm]
  Om denna integration med Mina Meddelanden nyttjas, återställ samtliga filer.
• [WEB-INF\classes\integration\mondido]
  Om integration med Mondido nyttjas, återställ samtliga filer.
• [WEB-INF\classes\integration\saml]
  Om SAML nyttjas, återställ samtliga filer.

Anpassade språkfiler

Om anpassade språkfiler nyttjas och uppgraderingen innefattat förändringar av språkfiler är det kritiskt att gå igenom samtliga anpassade termer, jämföra dem med termerna i de nya språkfilerna, och utföra eventuella nödvändiga förändringar.

De anpassade språkfilerna är belägna under {backup:flexiteWeb}\WEB-INF\classes\language\customer.

För information om anpassning av språkfiler, se avsnitt Anpassning — Språktermer.

För mer information om anpassade språktermer i språkfiler, vänligen kontakta Flexite AB Helpdesk.

Patcha flexiteAdmin

flexiteAdmin är en webbapplikation och för patchning krävs därmed tillgång till applikationsservern.

Det grundläggande tillvägagångssättet för att patcha flexiteAdmin är att ersätta den befintliga installationen med den i hotfix-paketet, och därefter återställa konfigurationer från backup.

Ersätt installation av flexiteAdmin

Ersätt befintlig installation av flexiteAdmin med ny version.

1. Verifiera att tjänsten för flexiteProcessEngine är stoppad. Verifiera att tjänsten för Apache Tomcat, alternativt aktuell webbapplikation, är stoppad.
2. Verifiera att backup har tagits i enlighet med avsnitt Backup.
3. Ta bort samtliga filer och kataloger i C:\tomcat\webapps\flexiteAdmin.
   • Om tjänsten för Tomcat inte stoppats kan det uppstå tillfällen då Tomcat låser filer i webbapplikationen, vilket förhindrar borttagning. I dessa fall måste tjänsten för Tomcat stoppas för att låsningen ska upphöra.
4. Ta bort samtliga filer och kataloger i Catalina Work för applikationen; C:\tomcat\work\Catalina\localhost\flexiteAdmin.
5. Kopiera samtliga filer och kataloger från {temp:hotfix}\flexiteWEB\webapps\admin till C:\tomcat\webapps\flexiteAdmin. Om särskilda instruktioner är angivna i readme, följ dessa.
6. Kopiera följande filer och kataloger från C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\default_conf till C:\tomcat\webapps\flexiteAdmin\WEB-INF\classes\settings:
   • [integration]
   • flexiteAdmin.conf
   • grandId.json
   • locales.json
   • themes.json

Återställ konfiguration

Återställ följande filer från {backup:flexiteAdmin}:

• [WEB-INF\classes\settings]
  • Jämför innehåll i flexiteAdmin.conf och återställ parametrar som skräddarsytts i aktuell installation.
  • Om E-ID nyttjas, återställ grandId.json.
  • Om skräddarsydda språk nyttjas, återställ locales.json.
  • Om skräddarsydda teman nyttjas, återställ themes.json.
• [WEB-INF\classes\settings\integration\saml]
  Om SAML nyttjas, återställ samtliga filer.

Anpassade språkfiler

Om anpassade språkfiler nyttjas och uppgraderingen innefattat förändringar av språkfiler är det kritiskt att gå igenom samtliga anpassade termer, jämföra dem med termerna i de nya språkfilerna, och utföra eventuella nödvändiga förändringar.

De anpassade språkfilerna är belägna under {backup:flexiteAdmin}\WEB-INF\classes\languages\custom.

För information om anpassning av språkfiler, se avsnitt Anpassning — Språktermer.

För mer information om anpassade språktermer i språkfiler, vänligen kontakta Flexite AB Helpdesk.

Patcha flexiteProcessEngine

Patchning av flexiteProcessEngine kräver tillgång till applikationsservern.

Det grundläggande tillvägagångssättet för att patcha flexiteProcessEngine är att manuellt kopiera filer från hotfix-paketet och skriva över de i den befintliga installationen.

Ersätt filer i flexiteProcessEngine

1. Verifiera att tjänsten för flexiteProcessEngine är stoppad.
2. Verifiera att backup har tagits i enlighet med avsnitt Backup.
3. Navigera till {temp:hotfix} och läs igenom readme för särskilda installationsinstruktioner.
4. Kopiera samtliga filer och kataloger från {temp:hotfix}\flexiteWEB\flexite\flexiteProcessEngine till C:\tomcat\flexite\flexiteProcessEngine och skriv över destinationsfilerna*.* Om särskilda instruktioner är angivna i readme, följ dessa.

Återställ konfiguration

Verifiera och återställ konfigurationer från backup.

1. Om Extern Data–integrationer används, jämför nyttjade filer i C:\tomcat\flexite\flexiteProcessEngine\ExtData med motsvarande standardfiler i {temp:flexiteProcessEngine}\ExtData. Kopiera nya filer till installationskatalogen och återställ konfigurationer från backup.

   SQL-skript för att lista de DLL-filer som nyttjas av Extern Data–komponenter:

   SELECT DATASOURCE
   FROM   REG_EXTDATA_ATTR;

2. Om flexiteDB-link uppgifter används, jämför nyttjade filer i integrations-katalogerna under C:\tomcat\flexite\flexiteProcessEngine\DBLinkData med motsvarande standardfiler i {temp:flexiteProcessEngine}\DBLinkData. Kopiera nya filer till installationskatalogen och återställ konfigurationer från backup.

   SQL-skript för att lista de kataloger och filer som nyttjas av flexiteDB-link uppgifter:

   SELECT IMP_FILE,
          IMP_FILE_UNIT
   FROM   DBLINK_TASK;

3. Jämför flexiteProcessEngine.ini från backup med den i C:\tomcat\flexite\flexiteProcessEngine och återställ om nödvändigt konfigurerade parametrar till filen i installationskatalogen.

4. Ta bort filen flexiteProcessEngine.dat under C:\tomcat\flexite\flexiteProcessEngine.

Registrera bibliotek för e-post

Bibliotek för att hämta e-post

Om aktuell hotfix innehåller en uppdatering för ActiveX-biblioteket EAGetMailObj.dll måste detta bibliotek registreras på nytt för att erhålla full funktionalitet.

Detta bibliotek behöver registreras en gång per maskin som huserar flexiteProcessEngine.

Notera att registreringen sker med absolut sökväg, vilket betyder att om filen flyttas måste den registreras på nytt.

Bibliotek för att skicka e-post

Om aktuell hotfix innehåller en uppdatering för ActiveX-biblioteket EASendMailObj.dll måste detta bibliotek registreras på nytt för att erhålla full funktionalitet.

Detta bibliotek behöver registreras en gång per maskin som huserar flexiteCLIENT och/eller flexiteProcessEngine. Detta betyder att biblioteket behöver registreras en gång på applikationsservern samt en gång på varje maskin där flexiteCLIENT är installerad.

Notera att registreringen sker med absolut sökväg, vilket betyder att om filen flyttas måste den registreras på nytt. Det är således rekommenderat att på applikationsservrar registrera biblioteket i flexiteProcessEngine istället för i flexiteCLIENT.

Registrera bibliotek i flexiteProcessEngine

1. Öppna en kommandoprompt med administratörsrättigheter.
2. Navigera till C:\tomcat\flexite\flexiteProcessEngine\.
3. Kör filen EAGetMailObj.cmd. Detta registrerar den absoluta sökvägen för det lokala biblioteket, EAGetMailObj.dll, på maskinen.
4. Kör filen EASendMailObj.cmd. Detta registrerar den absoluta sökvägen för det lokala biblioteket, EASendMailObj.dll, på maskinen.

Radering av förlegade bibliotek

Bibliotek som blivit ersatta och därmed inte längre nyttjas av flexiteProcessEngine raderas som standard av flexiteProcessEngine vid uppstart.

Det kan uppstå situationer där det Windows-konto som nyttjas för att köra flexiteProcessEngine saknar rättigheter att radera dessa filer. I detta fall stoppas flexiteProcessEngine, och loggfilen flexiteProcessEngine.log uppdateras med en lista på filer som måste raderas manuellt för att applikationen ska kunna starta. Använd ett Windows-konto med fulla rättigheter till flexiteProcessEngine-katalogen för att radera dessa filer, antingen manuellt eller via scriptet clean.cmd.

Obs!

Det är kritiskt att samtliga integrationer uppdateras för att säkerställa att inget beroende till de förlegade biblioteken kvarstår.

Starta tjänster

Med applikationerna patchade är det dags att starta dem och verifiera korrekt uppstart. Det är kritiskt att applikationerna startas i korrekt ordning:

1. Apache Tomcat
2. flexiteWEB, flexiteAdmin
3. flexiteProcessEngine

Starta flexiteWEB och flexiteAdmin

Verifiera att patchningen av flexiteWEB utförts korrekt.

1. Verifiera att katalogerna för Catalina Work är tomma:

   • C:\tomcat\work\Catalina\localhost\flexite
   • C:\tomcat\work\Catalina\localhost\flexiteAdmin

2. Om tjänsten för Apache Tomcat stoppats, öppna Windows Services och starta tjänsten.

3. Verifiera korrekt uppstart av Tomcat genom att starta en webbläsare och navigera till Tomcats översiktssida.
   I en standardinstallation är adressen för denna http://localhost:8080.

4. Klicka på 'Manager App' och logga in med admin-kontot för Tomcat.
   I en standardinstallation är det följande kontouppgifter:

   Användarnamn: admin
   Lösenord: flexite321

5. Kontrollera att applikationerna ' flexite' och ' flexiteAdmin' körs.

6. Öppna flexiteWEB genom att antingen klicka på länken för applikationen ' flexite' eller manuellt skriva in adressen; http://localhost:8080/flexite/. Notera att denna URL kringgår eventuell Windows SSO (Single Sign-On).

   • Om installationen genomförts korrekt ska en inloggningsruta för flexiteWEB visas.

7. Öppna flexiteAdmin genom att antingen klicka på länken för applikationen ' flexiteAdmin' eller manuellt skriva in adressen; http://localhost:8080/flexiteAdmin/. Notera att denna URL kringgår eventuell Windows SSO (Single Sign-On).

   • Om installationen genomförts korrekt ska en inloggningsruta för flexiteAdmin visas.

Starta flexiteProcessEngine

Starta flexiteProcessEngine och verifiera att samtliga tjänster startat genom att kontrollera loggarna.

1. Öppna Windows Services och starta tjänsten för flexiteProcessEngine. Verifiera att versionsnumret uppdateras och stämmer överens med versionsnumret på installationspaketet.

2. Kontrollera att samtliga tjänster har initierats korrekt: C:\tomcat\flexite\flexiteProcessEngine\flexiteprocessengine.log

   Starting service initialization
   Checking connection to db: "{dbServer}:{dbName}" user: "flexite" password: 
   "***" - OK
   Current server name: FLEXINT01
   [0] Main server for OnHoldSvc: FLEXINT01
   [0] Main server for AlarmSvc: FLEXINT01
   [0] Main server for StatisticsSvc: FLEXINT01
   [0] Main server for LeadTimesSvc: FLEXINT01
   [0] Main server for SubstituteSvc: FLEXINT01
   [0] Main server for MailSvc: FLEXINT01
   ----- External data service initialization -----
   Starting server on port 25020 - OK
   Starting server on port 35020 - OK
   External data service is initialized successfully
   ----- Starting webservice initialization -----
   Starting server on port 9000 - OK
   Webservice is initialized successfully
   Service is initialized successfully

3. Under C:\tomcat\flexite\flexiteProcessEngine\Logs sparas loggfiler för de separata tjänsterna. I en standardinstallation är det alarm.log, dblink.log, leadtimes.log, mail.log, mail_prepare.log, mail_send.log, onhold.log, statistics.log och substitute.log.

   Eventuella flexiteDB-link uppgifter i systemet sparar loggar i filnamn som följer formatet dblink_X.log, där 'X' är det unika ID:t för uppgiften. Vilken uppgift som har vilket ID kan utläsas i dblink.log.

   Kontrollera att samtliga tjänster har anslutit till databasen:

   db: "{dbServer}:{dbName}" user: "flexite" password: "***" - OK

Patchning av tilläggsprodukter

Flexites produktsvit innehåller en uppsättning applikationer som inte omfattas av en standardinstallation. Dessa applikationer kan användas till att utöka funktionaliteten i flexite.

Detta kapitel beskriver proceduren för installation av hotfix för tilläggsprodukter i en standardinstallation av flexite utan kundspecifika inställningar.

Versionsstöd

Det är kritiskt att säkerställa att de tilläggsprodukter som installeras stödjer den version av flexite som är installerad.

Generellt stöds applikationer inom samma build, men funktionsförändringar kan även förekomma i hotfixar. Vänligen kontakta Flexite AB för detaljerad information om versionsstöd.

Patcha flexitePortal

flexitePortal är en webbapplikation och för patchning krävs därmed tillgång till applikationsservern.

Det grundläggande tillvägagångssättet för att patcha flexitePortal är att ersätta den befintliga installationen med den nya versionen, och därefter återställa konfigurationer från backup.

Installationspaket för flexitePortal tillhandahålles av Flexite AB.

Procedur

En patchning av en standardinstallation består av följande grundläggande moment:

1. Hämta hotfix-paket.
2. Läs eventuell readme i hotfix-paket.
3. Stoppa flexitePortal.
4. Ta backup.
5. Patcha flexitePortal.
6. Starta flexitePortal.
7. Verifiera funktionalitet (se kapitel Verifiera funktionalitet).

Stoppa tjänster

För att undvika problem är det kritiskt att flexitePortal inte körs under patchningsprocessen.

1. Öppna en webbläsare och navigera till Tomcats översiktssida.
   I en standardinstallation är adressen för denna http://localhost:8080.

2. Klicka på 'Manager App' och logga in med admin-kontot för Tomcat.
   I en standardinstallation är det följande kontouppgifter:

   Användarnamn: admin
   Lösenord: flexite321

3. Stoppa applikationen för flexitePortal. I en standardinstallation är det 'flexitePortal'.

Backup

Innan patchning utförs är det kritiskt att ta backup på den befintliga installationen.

• Backup av flexitePortal — Kopiera katalogen för flexitePortal (som standard C:\tomcat\webapps\flexitePortal) till valfri temporär katalog ({backup:flexitePortal}).

Ersätt installation av flexitePortal

Ersätt befintlig installation av flexitePortal med ny version.

1. Verifiera att webbapplikationen för flexitePortal är stoppad.

2. Verifiera att backup har tagits i enlighet med avsnitt Backup.

3. Ta bort samtliga filer och kataloger i C:\tomcat\webapps\flexitePortal.

4. Packa upp filpaketet flexitePortal.zip till valfri temporär katalog ({temp:flexitePortal}). Om särskilda instruktioner är angivna i readme, följ dessa.

5. Kopiera följande filer och kataloger från {temp:flexitePortal}\WEB-INF\classes\default_conf till {temp:flexitePortal}\WEB-INF\classes\settings:

   • [saml]
   • flexitePortal.conf
   • grandId.json
   • locales.json
   • themes.json

6. Kopiera samtliga filer och kataloger från {temp:flexitePortal} till 'C:\tomcat\webapps\flexitePortal'.

Återställ konfiguration

Återställ följande filer från {backup:flexitePortal}:

• [WEB-INF\classes\settings]
  • Jämför innehåll i flexitePortal.conf och återställ parametrar som skräddarsytts i aktuell installation.
  • Om E-ID nyttjas, återställ grandId.json.
  • Om skräddarsydda språk nyttjas, återställ locales.json.
  • Om SAML nyttjas, återställ saml.json.
  • Om skräddarsydda teman nyttjas, återställ themes.json.
• [saml]
  Om SAML nyttjas, återställ samtliga filer och kataloger.

Starta flexitePortal

1. Säkerställ att tjänsten för Apache Tomcat körs.

2. Starta en webbläsare och navigera till Tomcats översiktssida.
   I en standardinstallation är adressen för denna http://localhost:8080.

3. Klicka på 'Manager App' och logga in med admin-kontot för Tomcat.
   I en standardinstallation är det följande kontouppgifter:

   Användarnamn: admin
   Lösenord: flexite321

4. Kontrollera att applikationen 'flexitePortal' körs.

5. Öppna flexitePortal genom att antingen klicka på länken för applikationen 'flexitePortal' eller manuellt skriva in adressen; http://localhost:8080/flexitePortal/.

   • Om installationen genomförts korrekt ska en inloggningsruta för flexitePortal visas.