flexite | Hjälpcenter

Appearance

Uppgradering ​

Generellt ​

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

Merparten av arbetet med uppgraderingen 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 uppgradering kan utföras av leverantören, av beställaren eller av beställaren utsedd 3:e part. Installation av uppgradering kräver god kännedom om den tekniska plattformen; flexite, databas, webbserver, operativsystem, etcetera.

Handhavande av uppgraderingar ​

Leverantören informerar beställaren om kommande uppgraderingar. Vid de fall funktionaliteten i installerat system hos beställaren kan komma att påverkas av uppgraderingen informerar även leverantören 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 uppgradering.

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 uppgradering ​

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

  • Installationspaket med senaste versionen av flexite inklusive eventuell Hotfix.
  • Åtkomst till applikationsserver.
  • Åtkomst till databasserver.
  • Användaruppgifter till befintlig installation av flexite.

Drivrutin för databasanslutning ​

Från och med flexite version 9.11.1.2 kräver flexiteCLIENT, flexiteProcessEngine (inklusive integrationer), flexiteDBUpdate samt hotfixDBUpdate att drivrutinen 'Microsoft OLE DB Driver' version 19 eller senare är installerad för att kunna ansluta till databasen. Denna drivrutin måste installeras på samtliga maskiner som ska köra någon av applikationerna i fråga.

'Microsoft OLE DB Driver' tillhandahålles av Microsoft:

https://learn.microsoft.com/en-us/sql/connect/oledb/download-oledb-driver-for-sql-server?view=sql-server-ver16

Det är rekommenderat att använda sig av den senaste versionen som publicerats av Microsoft. Vid tidpunkten för publiceringen av denna manual var flexites programvaror funktionstestade med version 19.3.5.

WebView2 Runtime ​

Från och med flexite version 9.13.1.0 kräver flexiteCLIENT och flexiteProcessEngine att 'WebView2 Runtime' är installerad för att applikationerna ska fungera. WebView2 Runtime inkluderas som standard tillsammans med applikationen Microsoft Edge, men måste installeras manuellt på de maskiner där denna saknas.

  • Windows Server levereras som standard utan Microsoft Edge, och kräver därmed som standard installation av 'WebView2 Runtime'.
  • Windows 10/11 levereras som standard med Microsoft Edge, och kräver därmed som standard inte installation av 'WebView2 Runtime'.
Installera WebView2 Runtime ​

Ett fristående paket för 'Microsoft Edge WebView2 Runtime' (x64) kan laddas ner från Microsoft:

https://developer.microsoft.com/en-us/microsoft-edge/webview2/

Det är starkt rekommenderat att nyttja 'Evergreen Standalone Installer' för att säkerställa att applikationen hålls uppdaterad.

Obs!

'Microsoft Edge WebView2 Runtime' måste installeras som administratör för att kunna nyttjas av flexite.

Genomförande av uppgradering ​

Detta kapitel beskriver proceduren för en uppgradering av en standardinstallation av flexite utan kundspecifika inställningar.

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

  1. Hämta installationspaket och eventuellt hotfix-paket.
  2. Läs readme i installationspaket och eventuellt hotfix-paket.
  3. Stoppa tjänster.
  4. Ta backup.
  5. Uppgradera databas.
  6. Uppgradera flexiteCLIENT.
  7. Uppgradera Apache Tomcat (baserat på versionsstöd).
  8. Uppgradera flexiteWEB.
  9. Uppgradera flexiteAdmin.
  10. Uppgradera flexiteProcessEngine.
  11. Starta tjänster.
  12. 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

Stegvis uppgradering av flexite ​

Det är rekommenderat att uppgradera flexite stegvis för att underlätta eventuell felsökning av processkonfiguration på grund av förändringar av funktionalitet i ny version. Exempelvis bör flexite version 9.12 först uppgraderas till version 9.13, och efter att full funktionalitet säkerställts i version 9.13 kan uppgradering fortsätta till version 9.14.

Versionsstöd för Apache Tomcat och Java ​

flexite version 9.13 och senare kräver Apache Tomcat 10 och kan därmed inte samköra med äldre versioner av flexite på samma Tomcat.

I det fall samma applikationsserver huserar flera installationer av flexite version 9.12 eller äldre är det rekommenderat att sätta upp en ny Windows-server för att husera de nya versionerna av Tomcat, Java och flexite.

För information om versionsstöd, se avsnitt Versionsstöd för Apache Tomcat och Java.

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 installationspaket ​

Installationspaketen för flexite levereras som individuella självextraherande filpaket för varje separat produkt.

Hotfixar för flexite levereras i kompletta hotfix-paket som innehåller patchar för samtliga berörda flexite-produkter. En ny hotfix-version innehåller även samtliga tidigare hotfixar för samma build.

Kontakta Flexite AB för tillgång till installationspaket.

Stoppa tjänster ​

För att undvika databaskorruption och andra problem är det kritiskt att flexiteProcessEngine och flexiteWEB inte körs under uppgraderingsprocessen. 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 webbapplikationen.

  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 installerad Apache Tomcat och Java inte är samma versioner som det senaste installationspaketet måste tjänsten för Apache Tomcat stoppas för uppgradering.
    • Om installerad Apache Tomcat och Java är av samma versioner som det senaste installationspaketet och 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 webbapplikationerna.
  2. Om installerad Apache Tomcat och Java är av samma versioner som det senaste installationspaketet samt används till andra webbapplikationer är det möjligt att låta tjänsten för Apache Tomcat fortsätta köra och enbart stoppa applikationen för flexiteWEB. 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 uppgradering 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}).

Uppgradera databas ​

Versionsstöd för Microsoft SQL Server ​

Från och med flexite version 9.11 kräver flexites databas SQL Compatibility Level 150. Detta betyder att databasservern måste köra Microsoft SQL Server 2019 eller senare.

För mer information om systemkrav, se avsnitt Systemkrav.

Uppgradera databas ​

Det första steget är att uppgradera standarddatabasen. 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 starkt rekommenderat att samtliga flexiteCLIENT kopplade till databasen är stängda.

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

  3. Packa upp filpaketet flexiteDBUpdate.zip till valfri temporär katalog och kör flexiteDBUpdate.exe.

    • Konfigurera 'Database connection':

      Database server type: Typ av databasserver (standard: SQLServer)
      Database name: {dbServer}:{dbName} Exempel: sqlserver.company.com:flexite
      Login: {dbUserName} (standard: flexite)
      Password: {dbUserPassword} (standard: flexite123)

    • Under 'Version' finns möjlighet att manuellt ange från och till vilken version uppgradering ska ske. 'Current version' fylls automatiskt med nuvarande databasversion och 'Update to version' fylls med senaste versionen för uppgraderingspaketet.

      Nuvarande databasversion kan kontrolleras med följande SQL-script:

      sql
      SELECT *
FROM   [FX_SETTINGS]
WHERE  [SKEY] = 'Version';

  4. 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.

Uppgradera flexiteCLIENT ​

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

Det finns två tillvägagångssätt för att uppgradera flexiteCLIENT; det går antingen att köra installationsprogrammet för flexiteCLIENT, eller att manuellt kopiera filerna från filpaketet. 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 uppgraderas.

Uppgradera med installationsprogram ​

  1. Verifiera att backup har tagits i enlighet med avsnitt Backup.
  2. Om hotfix finns för versionen, kör fx_{version:hotfix}_install.exe från hotfix-katalogen. Exempelvis 'fx_1.2.3.04_install.exe'.
  3. Om ingen hotfix finns, kör fx_{version:build}_install.exe. Exempelvis 'fx_1.2.03.00_install.exe'.
  4. 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 kommer resultera i försvunna inställningar.
  5. 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

Uppgradera med filpaket ​

  1. Verifiera att backup har tagits i enlighet med avsnitt Backup.
  2. Packa upp filpaketet flexiteCLIENT.zip till befintlig installationskatalog för flexiteCLIENT och skriv över destinationsfilerna.
  3. Till skillnad från installationsprogrammet måste språkfilerna kopieras manuellt vid användning av filpaketet.
    • För att nyttja språkpaketet 'Company', kopiera samtliga filer från katalogen C:\flexite\flexiteCLIENT\Languages\Company\ till rotkatalogen för flexiteCLIENT (C:\flexite\flexiteCLIENT). Om annat språkpaket önskas, kopiera istället filerna från önskat paket under C:\flexite\flexiteCLIENT\Languages.
  4. Om hotfix finns för versionen, packa upp hotfix-paketet till valfri temporär katalog ({temp:hotfix})
    • Kopiera samtliga filer från {temp:hotfix}\flexite\flexiteCLIENT till C:\flexite\flexiteCLIENT och skriv över destinationsfilerna.
    • Språkpaketet 'Company' levereras i rotkatalogen av hotfix-paket. Förfarandet för att välja språkpaket är således lite annorlunda än för grundversionen.
      • 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.
  5. 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 ​

För att e-post ska kunna skickas från flexite måste ett ActiveX-bibliotek registreras på den eller de maskiner som kör flexiteCLIENT respektive flexiteProcessEngine. Biblioteket är detsamma för båda applikationerna och har namnet EASendMailObj.dll.

Om befintlig installation innehåller biblioteket EASendMailObj.dll och aktuell version för uppgradering innehåller en uppdatering av detta bibliotek måste biblioteket 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 installera 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 uppgradering 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 uppgraderats 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.

Uppgradera Apache Tomcat ​

Det är starkt rekommenderat att hålla Apache Tomcat, inklusive tillhörande Java, uppdaterad med den senaste versionen som stöds av den flexite-version som nyttjas.

För information om specifika versionsstöd, vänligen kontakta Flexite AB.

Uppgradering från flexite version 9.12 och äldre ​

flexite version 9.13 och senare kräver Apache Tomcat 10 tillsammans med Java 17. Om äldre versioner av Tomcat och Java används på applikationsservern måste de gamla versionerna avinstalleras och de nya installeras.

Backup ​

Ta backup på befintlig konfiguration av Tomcat och Java.

  1. Verifiera att tjänsten för Apache Tomcat är stoppad.
  2. Ta backup på konfigurationen i befintlig Tomcat.
    • Kopiera filen C:\tomcat\jdk\lib\security\cacerts till valfri temporär katalog ({temp:Tomcat}). Denna fil innehåller betrodda CA-certifikat och nyttjas av flexiteWEB för att verifiera certifikat hos fjärrservrar.
    • Kopiera katalogen C:\tomcat\conf till valfri temporär katalog ({temp:Tomcat}).
    • Kör C:\tomcat\bin\tomcat9w.exe.
      • Navigera till fliken 'Logging' och notera inställningar för 'Log path', 'Redirect Stdout' samt 'Redirect Stderror'.
      • Navigera till fliken 'Java' och notera inställningar för 'Initial memory pool', 'Maximum memory pool' samt innehållet i 'Java Options'.

Avinstallera befintlig Tomcat ​

Avinstallera befintlig version av Tomcat.

  1. Verifiera att tjänsten för Apache Tomcat är stoppad.
  2. Avinstallera servertjänst för befintlig Tomcat genom att köra C:\tomcat\bin\uninst.cmd.
  3. Radera följande mappar, inklusive filer, för befintlig Tomcat:
    • C:\tomcat\bin
    • C:\tomcat\conf
    • C:\tomcat\jdk
    • C:\tomcat\lib
    • C:\tomcat\temp
    • C:\tomcat\webapps\docs
    • C:\tomcat\webapps\examples
    • C:\tomcat\webapps\host-manager
    • C:\tomcat\webapps\manager
    • C:\tomcat\webapps\ROOT
    • C:\tomcat\work

Installera ny Tomcat ​

Efter att befintlig äldre version av Tomcat har avinstallerats kan vi fortsätta med att installera den nya versionen.

  1. Packa upp installationspaketet till valfri temporär katalog ({temp:Tomcat}). Filerna packas som standard upp till en underkatalog med datumstämpel och versionsnummer enligt formatet YYMMDD_Tomcat-{version}_OpenJDK-{version}. Exempel: 250131_Tomcat-10.0.1_OpenJDK-17.0.1 Vi definierar denna sökväg som {temp:Tomcat}.
  2. Kopiera samtliga filer och kataloger från {tomcatPath} till C:\tomcat.
  3. Registrera Apache Tomcat som servertjänst:
    • Om inte standardsökväg för Tomcat används (C:\tomcat), ändra sökvägarna i {tomcatPath}\bin\inst.cmd.
    • Kör {tomcatPath}\bin\inst.cmd.
    • Öppna Windows Services och verifiera att 'Apache Tomcat 10' nu finns med i listan.
    • Öppna 'Apache Tomcat 10', sätt 'Startup type' till 'Automatic'.

Återställ backup ​

Återställ konfiguration från backup:

  1. Importera eventuella manuellt betrodda certifikat till aktuell Java keystore 'cacerts'. För information om certifikathantering, se avsnitt Certifikathantering.
  2. Kopiera uriworkermap.properties från {temp:Tomcat} till C:\tomcat\conf.
  3. Jämför innehåll i server.xml — Se till att ny Tomcat använder samma Connector port för HTTP/1.1 respektive AJP/1.3 som i backup.
  4. Jämför innehåll i workers.properties — Se till att ny Tomcat använder samma namn och port för workers som i backup. Standard: worker.ajp13.port=8009
  5. Kör C:\tomcat\bin\tomcat10w.exe.

    • Navigera till fliken 'Logging' och återställ inställningar för 'Log path', 'Redirect Stdout' samt 'Redirect Stderror' från backup.

    • Navigera till fliken 'Java' och återställ inställningar för 'Initial memory pool' samt 'Maximum memory pool' från backup.

    • Rensa eventuellt innehåll i 'Java Options', och ange följande rader, där värdena för -Xms och -Xmx återställs från backup:

      -Dfile.encoding=UTF-8
-Djava.util.logging.manager=org.apache.juli.ClassLoaderLogManager
-XX:+UseG1GC
-XX:MaxGCPauseMillis=500
-Xms10g
-Xmx10g

Uppgradera flexiteWEB ​

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

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

Om uppgradering av Apache Tomcat krävs är det starkt rekommenderat att utföra denna innan uppgradering av flexiteWEB. Procedur för uppgradering av Apache Tomcat tas upp i avsnitt Uppgradera Apache Tomcat.

Ersätt installation av flexiteWEB ​

Ersätt befintlig installation av flexiteWEB 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\flexite.

    • 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\flexite.

  5. Packa upp filpaketet flexiteWEB.zip till valfri temporär katalog ({temp:flexiteWeb}).

  6. 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 särskilda installationsinstruktioner.
    • Kopiera samtliga filer och kataloger från {temp:hotfix}\flexiteWEB\webapps\standard till {temp:flexiteWeb} och skriv över destinationsfilerna*.* Om särskilda instruktioner är angivna i readme, följ dessa.
    • Radera gamla filer som ej längre nyttjas i och med hotfix. Detta utförs genom att köra {temp:flexiteWeb}\WEB-INF\clean.cmd med administratörsrättigheter. Observera att denna inte ska köras när en hotfix inte installeras.

  7. Kopiera följande filer från {temp:flexiteWeb}\WEB-INF\default_conf till {temp:flexiteWeb}\WEB-INF\classes\settings:

    • customer.conf
    • flexite.conf
    • pool.conf

  8. Kopiera samtliga filer och kataloger från {temp:flexiteWeb} till C:\tomcat\webapps\flexite.

Å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.

Uppgradera flexiteAdmin ​

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

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

Om uppgradering av Apache Tomcat krävs är det starkt rekommenderat att utföra denna innan uppgradering av flexiteAdmin. Procedur för uppgradering av Apache Tomcat tas upp i avsnitt Uppgradera Apache Tomcat.

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. Om hotfix INTE FINNS för versionen, packa upp filpaketet flexiteAdmin.zip till valfri temporär katalog ({temp:flexiteAdmin}).

  6. 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 särskilda installationsinstruktioner.
    • Kopiera samtliga filer och kataloger från {temp:hotfix}\flexiteWEB\webapps\admin till {temp:flexiteAdmin}. Om särskilda instruktioner är angivna i readme, följ dessa.

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

    • [integration]
    • flexiteAdmin.conf
    • grandId.json
    • locales.json
    • themes.json

  8. Kopiera samtliga filer och kataloger från {temp:flexiteAdmin} till C:\tomcat\webapps\flexiteAdmin.

Å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.

Uppgradera flexiteProcessEngine ​

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

Det grundläggande tillvägagångssättet för att uppgradera flexiteProcessEngine är att manuellt kopiera filer från installations-/hotfix-paketet, skriva över de i den befintliga installationen, och därefter återställa konfigurationer från backup.

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. Packa upp filpaketet flexiteProcessEngine.zip till valfri temporär katalog; {temp:flexiteProcessEngine}.
  4. 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 särskilda installationsinstruktioner.
    • Kopiera samtliga filer och kataloger från {temp:hotfix}\flexiteWEB\flexite\flexiteProcessEngine till {temp:flexiteProcessEngine}\flexiteProcessEngine och skriv över destinationsfilerna*.* Om särskilda instruktioner är angivna i readme, följ dessa.
  5. Kopiera samtliga filer och kataloger från {temp:flexiteProcessEngine}\flexiteProcessEngine till C:\tomcat\webapps\flexite\flexiteProcessEngine och skriv över äldre destinationsfiler.

Å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:

    sql
    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:

    sql
    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 ​

För att e-post ska kunna hämtas till flexite måste ett ActiveX-bibliotek registreras på den eller de maskiner som kör flexiteProcessEngine. Detta bibliotek har namnet EAGetMailObj.dll.

Om befintlig installation innehåller biblioteket EAGetMailObj.dll och aktuell version för uppgradering innehåller en uppdatering av detta bibliotek måste biblioteket registreras på nytt för att erhålla full funktionalitet.

Detta bibliotek behöver installeras 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 ​

För att e-post ska kunna skickas från flexite måste ett ActiveX-bibliotek registreras på den eller de maskiner som kör flexiteCLIENT respektive flexiteProcessEngine. Biblioteket är detsamma för båda applikationerna och har namnet EASendMailObj.dll.

Om befintlig installation innehåller biblioteket EASendMailObj.dll och aktuell version för uppgradering innehåller en uppdatering av detta bibliotek måste biblioteket registreras på nytt för att erhålla full funktionalitet.

Detta bibliotek behöver installeras 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 installera 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 uppgraderade ä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 (startas som standard automatiskt tillsammans med Apache Tomcat)
  3. flexiteProcessEngine

Starta flexiteWEB och flexiteAdmin ​

Verifiera att uppgradering 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.

    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:

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

Microsoft IIS och errorhantering ​

Från och med flexite version 9.13 nyttjas flexite-specifika errorsidor för att visa information om kommunikationsfel som kan uppstå i våra webbapplikationer.

I det fall Microsoft IIS nyttjas som webbserver måste IIS konfigureras att visa dessa errorsidor. För information om denna konfiguration, se avsnitt Konfiguration av Microsoft IIS.

Uppgradering 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 uppgradering av 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.

Uppgradera flexitePortal ​

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

Det grundläggande tillvägagångssättet för att uppgradera 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 uppgradering av en standardinstallation består av följande grundläggande moment:

  1. Hämta installationspaket alternativt eventuellt hotfix-paket.
  2. Läs eventuell readme i installationspaket eller hotfix-paket.
  3. Stoppa flexitePortal.
  4. Ta backup.
  5. Uppgradera 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 uppgraderingsprocessen.

  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 uppgradering 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
    • saml.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.