Appearance
Felsökning
flexiteProcessEngine stoppas på grund av prefixet CHANGE- i URL
flexite har ett skydd mot förändring av databasanslutning i flexiteProcessEngine. Vid varje uppstart av flexiteProcessEngine jämförs strängen för ConnectDatabaseName från flexiteProcessEngine.ini med samma information i databasen. Denna sträng innehåller sökvägen till databasen.
Om informationen saknas i databasen skrivs strängen från ini-filen till databasen.
Om informationen existerar i databasen men skiljer sig från strängen ini-filen skrivs prefixet CHANGE- till URL:er (exempelvis CHANGE-https://flexite.company.com/flexite/), strängen från ini-filen skrivs till databasen och flexiteProcessEngine stoppas.
För att kunna starta flexiteProcessEngine igen måste samtliga URL:er redigeras i flexiteCLIENT så att de inte längre innehåller prefixet CHANGE-.
Scenarion
Orsaker till att strängen för ConnectDatabaseName ändras i flexiteProcessEngine.ini och inte längre stämmer överens med den i databasen kan bero på:
- Flytt av databas till ny databasserver. Detta resulterar oftast i en ny adress för databasservern.
- Ändring av
ConnectDatabaseNamefrån att nyttja IP till att nyttja FQDN eller vice versa.
Kontroll av databasanslutning samt URL-konfiguration
Vid varje uppstart av flexiteProcessEngine utförs en jämförelse mellan ConnectDatabaseName i flexiteProcessEngine.ini och informationen som är sparad i databasen. Därtill utförs en kontroll av konfiguration av URL-inställningar.
- Om
ConnectDatabaseNamesaknas i databasen:- Skriv värde från
flexiteProcessEngine.initill databasen. - Starta flexiteProcessEngine.
- Skriv värde från
- Om
ConnectDatabaseNameiflexiteProcessEngine.iniINTE stämmer överens med databasen:- Skriv värde från
flexiteProcessEngine.initill databasen. - Lägg till prefixet
CHANGE-till följande URL:- E-posthantering > Länkar > flexiteWEB > Peka länk mot (När Peka mot standardplats inte används)
- E-posthantering > Länkar > flexitePortal > Peka länk mot
- Webbinställningar > Länkar > flexiteWEB URL
- Webbinställningar > Länkar > flexiteWEB Webservice (När Använd flexiteWEB inte används)
- Webbinställningar > Länkar > flexiteDMS URL
- Webbinställningar > Länkar > flexiteAdmin URL
- Webbinställningar > Extern server > Extern URL
- Processmotor > Alarm > URL till webservice (När Använd URL från globala inställningar inte används)
- Processmotor > DB-link > URL till webservice (När Använd URL från globala inställningar inte används)
- Processmotor > Statistik > URL till mapp för publicering (När Använd URL från globala inställningar inte används)
- Stoppa flexiteProcessEngine.
- Skriv värde från
- Om
ConnectDatabaseNameiflexiteProcessEngine.inistämmer överens med databasen:- Om prefixet
CHANGE-finns angivet på någon URL:- Stoppa flexiteProcessEngine.
- Om prefixet
CHANGE-inte finns angivet på någon URL:- Starta flexiteProcessEngine.
- Om prefixet
Loggar
När flexiteProcessEngine stoppas på grund av att ConnectDatabaseName inte matchar databasen, eller på grund av att någon URL innehåller prefixet CHANGE-, loggas det på följande vis i flexiteProcessEngine.log:
log
2026-01-31 08:12:34 [sql.company.com:flexite] Change global settings in flexiteCLIENT to be able to start services:
Web Settings > flexiteWEB: 'CHANGE-https://flexite.company.com/flexite/'
Web Settings > flexiteWEB Web Service: 'CHANGE-https://flexite-services.company.com:4043/flexite/services/'
Web Settings > flexiteAdmin: 'CHANGE-https://flexite.company.com/flexiteadmin/'
E-mail Managment > Links > Login to flexitePortal: 'CHANGE-https://flexite.company.com/flexiteportal/'
Process Engine > Statistics > Web publish folder URL: 'CHANGE-https://flexite.company.com/flexite/customer/ps/'
2026-01-31 08:12:35 Service failed to initialize and can't continueÅtgärd
För att flexiteProcessEngine ska kunna starta måste samtliga URL som benämnts i flexiteProcessEngine.log ändras så att de inte längre innehåller prefixet CHANGE-.
Denna operation utförs i flexiteCLIENT utav ett konto som är Databasadministratör. Observera att flexiteCLIENT måste startas med kommandot /services (flexite.exe /services) för att inställningar för flexiteProcessEngine ska vara tillgängliga.
Inställningar
Följande inställningar behöver åtgärdas:
- E-posthantering > Länkar > flexiteWEB > Peka länk mot (När Peka mot standardplats inte används)
- E-posthantering > Länkar > flexitePortal > Peka länk mot
- Webbinställningar > Länkar > flexiteWEB URL
- Webbinställningar > Länkar > flexiteWEB Webservice (När Använd flexiteWEB inte används)
- Webbinställningar > Länkar > flexiteDMS URL
- Webbinställningar > Länkar > flexiteAdmin URL
- Webbinställningar > Extern server > Extern URL
- Processmotor > Alarm > URL till webservice (När Använd URL från globala inställningar inte används)
- Processmotor > DB-link > URL till webservice (När Använd URL från globala inställningar inte används)
- Processmotor > Statistik > URL till mapp för publicering (När Använd URL från globala inställningar inte används)
När flera flexiteProcessEngine används i samma installation
Det är möjligt att nyttja flera flexiteProcessEngine i samma installation, exempelvis vid nyttjande av separat extern server eller för lastbalansering.
I det fall flera flexiteProcessEngine ansluter mot samma databas så är det kritiskt att konfiguration av ConnectDatabaseName är densamma i samtliga flexiteProcessEngine.ini.
flexiteProcessEngine stoppas på grund av annan flexiteProcessEngine som kör samma tjänster
flexite har stöd för att köra flera instanser av flexiteProcessEngine och flexiteWEB mot samma databas. Dessa flera instanser måste vara fördelade på separata servrar för att kommunikationsportarna inte ska kollidera med varandra.
Detta scenario kan exempelvis nyttjas för att lastbalansera tjänster i större organisationer med stor informationshantering.
Det kritiskt att följande tjänster enbart körs på en enskild flexiteProcessEngine:
- Alarm Service (AlarmSvc)
- LeadTimes Service (LeadTimesSvc)
- Mail Service (MailSvc)
- On Hold Service (OnHoldSvc)
- Statistics Service (StatisticsSvc)
- Substitute Service (SubstituteSvc)
För att säkerställa detta utförs vid varje uppstart av flexiteProcessEngine en kontroll av vilken server som dessa tjänster är registrerade för i databasen. Om ingen server är angiven skrivs det aktuella servernamnet till databasen och flexiteProcessEngine startas. Om det registrerade servernamnet skiljer sig från det aktuella servernamnet stoppas flexiteProcessEngine.
Detaljerat förfarande
Uppstart av flexiteProcessEngine
Vid varje uppstart av flexiteProcessEngine utförs en jämförelse mellan servernamnet för den aktuella servern samt servernamn angivet i databasen för de tjänster som är aktiverade i aktuell flexiteProcessEngine.
Aktiva tjänster anges i flexiteProcessEngine.ini. Som standard är samtliga tjänster aktiva.
I detta exempel har vi inaktiverat tjänsterna Alarm Service, Mail Service samt Substitute Service på den aktuella flexiteProcessEngine:
ini
OnHoldSvc=1
AlarmSvc=0
StatisticsSvc=1
DBLinkSvc=1
LeadTimesSvc=1
SubstituteSvc=0
MailSvc=0Procedur vid uppstart
- Om servernamn saknas för samtliga aktiva tjänster i databasen:
- Skriv aktuellt servernamn till databasen för samtliga aktiva tjänster.
- Starta flexiteProcessEngine.
- Om aktuellt servernamn INTE stämmer överens med angivet servernamn i databasen för någon av de aktiva tjänsterna:
- Stoppa flexiteProcessEngine.
- Om aktuellt servernamn stämmer överens med angivet servernamn i databasen för samtliga aktiva tjänster:
- Starta flexiteProcessEngine.
Körning av individuella tjänster
Under drift utförs en kontinuerlig kontroll av servernamnet för den aktuella servern samt servernamnet angivet i databasen för den aktuella tjänsten. Denna kontroll utförs vid varje schemalagd start av respektive tjänst.
- Om servernamn saknas i databasen för aktuell tjänst:
- Skriv INTE aktuellt servernamn till databasen för aktuell tjänst. I detta fall lämnas servernamnet fortsatt tomt i databasen.
- Kör aktuell tjänst.
- Om aktuellt servernamn INTE stämmer överens med angivet servernamn i databasen för aktuellt tjänst:
- Kör inte aktuell tjänst.
- Om aktuellt servernamn stämmer överens med angivet servernamn i databasen för aktuell tjänst:
- Kör aktuell tjänst.
Loggar
När flexiteProcessEngine stoppas på grund av att det aktuella servernamnet inte matchar servernamnet i databasen loggas det på följande vis i flexiteProcessEngine.log:
log
2021-01-01 01:00:00 Current server name: CURRENT_SERVER
2021-01-01 01:00:00 Main server for AlarmSvc: OTHER_SERVER
2021-01-01 01:00:00 Main server for SubstituteSvc: OTHER_SERVER
2021-01-01 01:00:00 Main server for MailSvc: OTHER_SERVER
2021-01-01 01:00:00 Service stopped
2021-01-01 01:00:00 flexiteProcessEngine cannot be started. Another flexiteProcessEngine is already configured to run the same service(s) against the same database.
2021-01-01 01:00:00 ------------------------------
2021-01-01 01:00:00 Service failed to initialize and can't continue
2021-01-01 01:00:00 ------------------------------I detta exempel har flexiteProcessengine stoppats på grund av att tjänsterna för Alarm Service, Substitute Service samt Mail Service redan är konfigurerade att köras från en annan server (OTHER_SERVER).
Identifiera orsak
För att åtgärda detta krävs det att man först identifierar orsaken till varför flexiteProcessEngine larmar att tjänster är registrerade till en annan server än den aktuella. Orsaker kan delas upp i två huvudsakliga kategorier; enskild flexiteProcessEngine och flera flexiteProcessEngine.
Enskild flexiteProcessEngine
- Aktuell flexiteProcessEngine är den enda flexiteProcessEngine som ansluter till databasen, och den har flyttats till ny server med nytt servernamn.
Flera flexiteProcessEngine
- En parallell instans av flexiteProcessEngine har installerats på separat server för prestandamässig lastbalansering.
- En parallell instans av flexiteProcessEngine och flexiteWEB har installerats på en isolerad server för publik åtkomst.
Åtgärd — Enskild flexiteProcessEngine
När enbart en enskild flexiteProcessEngine nyttjas beror detta problem oftast på ett namnbyte på den server som huserar flexiteProcessEngine, vilket exempelvis kan uppstå vid ett serverbyte. I dessa fall är det att betrakta som säkert att åter registrera aktuell flexiteProcessEngine som huvudsaklig server för samtliga tjänster.
- Öppna Windows Services och verifiera att tjänsten för flexiteProcessEngine inte körs. Om flera flexiteProcessEngine körs på samma server är det kritiskt att verifiera att aktuell flexiteProcessEngine inte körs.
- Starta Windows kommandotolk (CMD) som Administratör.
- Navigera till
C:\tomcat\flexite\flexiteProcessEngineoch kör kommandotflexiteProcessEngine.exe /mainDetta kommando registrerar aktuell server för samtliga aktiva tjänster iflexiteProcessEngine.ini.
- Navigera till
- Verifiera i
flexiteProcessEngine.logatt aktuellt servernamn är angivet för tjänsterna och att samtliga tjänster har startat. - Öppna Task Manager och navigera till fliken Details.
- Leta rätt på processen för flexiteProcessEngine. Om flera flexiteProcessEngine körs på samma server är det kritisk att leta fram processerna för aktuell flexiteProcessEngine. Detta kan exempelvis utföras genom att kontrollera sökvägen i egenskaperna för processerna.
- Stoppa samtliga processer för aktuell flexiteProcessEngine.
- Öppna Windows Services och starta aktuell flexiteProcessEngine.
- Verifiera i
flexiteProcessEngine.logatt samtliga tjänster har startat.
Åtgärd — Flera flexiteProcessEngine
När flera flexiteProcessEngine nyttjas mot samma databas är det kritiskt att ange vilken instans av flexiteProcessEngine som ska köra vilken tjänst.
I detta exempel har vi följande scenario::
- SERVER-A — Huvudserver och används för tjänsterna Alarm Service, DBLink Service, Leadtimes Service, Mail Service, OnHold Service samt Statistics Service.
- SERVER-B — Används för lastbalansering för tjänsten Substitute Service.
Detta ger följande åtgärder:
På SERVER-A och SERVER-B, öppna Windows Services och verifiera att flexiteProcessEngine inte körs. Om flera flexiteProcessEngine körs på samma server är det kritiskt att verifiera att aktuell flexiteProcessEngine inte körs.
Konfigurera tjänster i
flexiteProcessEngine.ini:På SERVER-A, ange följande tjänster:
iniOnHoldSvc=1 AlarmSvc=1 StatisticsSvc=1 DBLinkSvc=1 LeadTimesSvc=1 SubstituteSvc=0 MailSvc=1På SERVER-B, ange följande tjänster:
iniOnHoldSvc=0 AlarmSvc=0 StatisticsSvc=0 DBLinkSvc=0 LeadTimesSvc=0 SubstituteSvc=1 MailSvc=0
Registrera tjänster mot databasen för SERVER-A:
- Starta Windows kommandotolk (CMD) som Administratör.
- Navigera till
C:\tomcat\flexite\flexiteProcessEngineoch kör kommandotflexiteProcessEngine.exe /mainDetta kommando registrerar aktuell server för samtliga aktiva tjänster iflexiteProcessEngine.ini.
- Navigera till
- Verifiera i
flexiteProcessEngine.logatt aktuellt servernamn är angivet för tjänsterna och att samtliga aktiverade tjänster har startat. - Öppna Task Manager och navigera till fliken Details.
- Leta rätt på processen för flexiteProcessEngine. Om flera flexiteProcessEngine körs på samma server är det kritisk att leta fram processerna för aktuell flexiteProcessEngine. Detta kan exempelvis utföras genom att kontrollera sökvägen i egenskaperna för processerna.
- Stoppa samtliga processer för aktuell flexiteProcessEngine.
- Starta Windows kommandotolk (CMD) som Administratör.
Registrera tjänster mot databasen för SERVER-B med samma procedur som för SERVER-A.
Starta flexiteProcessEngine på SERVER-A respektive SERVER-B:
- På respektive server, öppna Windows Services och starta aktuell flexiteProcessEngine.
- På respektive server, verifiera i
flexiteProcessEngine.logatt samtliga tjänster har startat.
Integration kan ej hantera okrypterad XML
Som standard krypterar flexite idag innehållet i XML-filer som genereras för integrationer. Vidare kräver de flesta integrationer i flexite idag att XML-filer genererade av flexite som ska hanteras av integrationen är krypterade.
I äldre versioner av flexite fanns inte detta krav på kryptering, varpå XML-filer kunde genereras och hanteras i okrypterat format.
Mot bakgrund av detta kan det efter uppgradering från en äldre version av flexite uppstå situationer där XML-filer som genererats i den äldre versionen men ej hunnits hanteras innan uppgradering inte kan hanteras av den nya versionen.
För att lösa denna situation är det möjligt att ta hjälp av flexiteProcessEngine för att kryptera utvalda XML-filer.
Exempel på scenario
I detta exempel används den påhittade integrationen ExtSysExport.dll för att exportera information från flexite till ett externt system. Denna export sker genom att information först exporteras till temporära XML-filer, varpå de sedan hanteras av ExtSysExport.dll för att skickas till det externa systemet.
- I en äldre version av flexite exporteras information till temporära, okrypterade, XML-filer för vidare hantering av
ExtSysExport.dll. - Innan
ExtSysExport.dllhinner köras enligt schemaläggning stoppas systemet för planerad uppgradering. - Uppgradering genomförs och systemet startas upp igen.
- I den nya versionen av flexite exporteras nu information till temporära, krypterade, XML-filer för vidare hantering av
ExtSysExport.dll. - Den nya versionen av
ExtSysExport.dllaccepterar enbart krypterade XML-filer. Exporter från aktuell version hanteras utan problem eftersom de krypteras som standard. De kvarliggande exporterna från den äldre versionen kan däremot inte längre hanteras utav integrationen eftersom de är i okrypterat format.
Kryptera XML-filer med flexiteProcessEngine
Det är möjligt att ta hjälp av flexiteProcessEngine för att kryptera okrypterade XML-filer i en utvald katalog. Detta utförs genom att köra flexiteProcessEngine med tilläggskommandot /encrypt.
Detta kommando är framtaget för att kunna köras under normal drift och kommer således inte påverka övrig funktionalitet. Operationen använder den aktuella krypteringsnyckeln för systemet för att kryptera samtliga okrypterade XML-filer i en angiven katalog med undantag för filer med namnet sample.xml.
Den instans av flexiteProcessEngine som startats för att utföra krypteringen avslutas efter kommandot utförts.
Kommando
cmd
flexiteProcessEngine.exe /encrypt:{path_to_folder}- {path_to_folder} — Fullständig sökväg till den katalog som innehåller de XML-filer som ska krypteras. I det fall någon av katalogerna i sökvägen innehåller mellanslag måste den fullständiga sökvägen inneslutas i citationstecken.
Exempel
Exempel med sökväg utan mellanslag:
cmd
flexiteProcessEngine.exe /encrypt:C:\absolute\path\to\xml\folderExempel med sökväg innehållande mellanslag:
cmd
flexiteProcessEngine.exe /encrypt:"C:\absolute\path with spaces\to\xml\folder"Loggning
Utförande och resultat av detta kommando loggas till ordinarie loggfil för flexiteProcessEngine; flexiteProcessEngine.log.
Exempel
Exempel på loggning av lyckad kryptering av tre XML-filer:
log
2024-01-31 08:59:52 Encryption of XMLs in folder is started
2024-01-31 08:59:59 File C:\path\to\xml\20240001.xml will be encrypted using active key (ID: ABCD1234-1234-ABCD-1234-ABCD1234ABCD)
2024-01-31 08:59:59 File C:\path\to\xml\20240002.xml will be encrypted using active key (ID: ABCD1234-1234-ABCD-1234-ABCD1234ABCD)
2024-01-31 08:59:59 File C:\path\to\xml\20240003.xml will be encrypted using active key (ID: ABCD1234-1234-ABCD-1234-ABCD1234ABCD)
2024-01-31 08:59:59 Encryption of XMLs in folder is finishedMultipla databaser
I en standardinstallation, med en databas, använder kommandot encrypt krypteringsnyckeln från den enda konfigurerade databasen. I system där en flexiteProcessEngine är kopplad mot multipla databaser måste databas-ID anges för att deklarera från vilken databas krypteringsnyckeln ska hämtas:
cmd
flexiteProcessEngine.exe /encrypt:{path_to_folder} /db:{database_id}- {database_id} — Det numeriska ID:t för den databaskoppling från vilken krypteringsnyckeln ska hämtas. Detta ID återfinns i konfigurationsfilen för flexiteProcessEngine,
flexiteProcessEngine.inii formatet[Database.X].
Exempel
Exempel där krypteringsnyckel hämtas från databasanslutningen [Database.1].
cmd
flexiteProcessEngine.exe /encrypt:C:\absolute\path\to\xml\folder /db:1