Appearance
flexite — Flera instanser på samma server
Det är möjligt att köra flera instanser av flexite på samma applikationsserver. I detta kapitel beskriver vi två lösningar:
- Flera unika installationer — Varje instans av flexite nyttjar en unik installation av samtliga applikationer. Detta är den rekommenderade lösningen.
- Flera databaser i samma installation — En gemensam installation av flexiteProcessEngine och flexiteWEB nyttjas av flera databaser. Unika installationer av flexiteCLIENT och flexiteAdmin nyttjas för att administrera de individuella databaserna.
Det är kritiskt att de individuella instanserna använder sig av unika kommunikationsportar för samtliga systemtjänster.
Flera unika installationer
Den rekommenderade lösningen för att köra flera instanser av flexite på samma applikationsserver är att nyttja flera unika installationer av samtliga applikationer. Detta säkerställer att instanserna är fristående och inte påverkar varandra.
Databas
När flera system ska köras på samma databasserver krävs det att databaserna utöver unika namn använder unika sökvägar för filerna. Detta kan uppnås genom att antingen ge dem unika filnamn eller att lagra dem i unika kataloger. Denna konfiguration sker enklast under installationsprocessen.
I detta exempel lagrar vi filerna i samma katalog, och måste därmed ge dem unika filnamn:
- Välj databas för återställning och ange önskat, unikt, databasnamn.
- Navigera till Files och se till att filnamnen för samtliga filer under Restore As är unika.
- Slutför återställning samt konfiguration av databas i enlighet med instruktionerna för en standardinstallation.
flexiteProcessEngine
Den vanligaste lösningen för flera instanser av flexiteProcessEngine är att köra flera unika installationer på samma applikationsserver. Detta kräver att en ny instans av flexiteProcessEngine installeras i en unik katalog; C:\tomcat\flexite\{flexiteProcessEngine}. Den grundläggande installationsproceduren är densamma som för en standardinstallation, med skillnaden att unika namn, sökvägar och portar måste nyttjas för varje instans.
Ange unikt namn samt unika portar för samtliga instanser av flexiteProcessEngine i C:\tomcat\flexite\{flexiteProcessEngine}\flexiteProcessEngine.ini:
Ange unikt namn:
ini[Service] Name=flexiteProcessEngine {processName} DisplayName={displayName} %versionNamemåste inledas medflexiteProcessEngine, och följas av en unik benämning.DisplayNameär det namn som visas i Services.Ange unika kommunikationsportar:
ini[ExternalData] DLLInfoPort={dllInfoPort} (default: 25020) DLLDataPort={dllDataPort} (default: 35020)
Bibliotek för att skicka och hämta e-post
Biblioteken för att skicka och hämta e-post, EASendMailObj.dll respektive EAGetMailObj.dll, registreras globalt för varje server i Windows register. Detta betyder att samtliga flexite-applikationer på servern nyttjar samma bibliotek. Om sökvägen för det registrerade biblioteket ändras måste det registreras på nytt.
Detta har som effekt att uppdateringar till det registrerade biblioteket påverkar samtliga flexite-applikationer på samma server. På samma vis betyder det även att uppdateringar till bibliotek som inte är registrerade inte har någon inverkan på någon flexite-applikation.
Kontrollera registrerade sökvägar
Det är möjligt att ta reda på sökvägarna för nuvarande registrerade bibliotek med följande CMD-kommandon:
cmd
reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\" /f EASendMailObj.dll /d /s
reg query "HKEY_LOCAL_MACHINE\SOFTWARE\Classes\CLSID\" /f EAGetMailObj.dll /d /sDessa kommandon returnerar en lista med nycklar för respektive DLL där den fullständiga sökvägen går att utläsa.
flexiteWEB
Den vanligaste lösningen för flera instanser av flexiteWEB är, precis som för flexiteProcessEngine, att köra flera unika installationer på samma applikationsserver. Detta kräver att en ny instans av flexiteWEB installeras i en unik katalog; C:\tomcat\webapps\{flexiteWEB}. Den grundläggande installationsproceduren är densamma som för en standardinstallation, med skillnaden att unika sökvägar måste nyttjas för varje instans.
Ange unika sökvägar för samtliga instanser av flexiteWEB:
C:\tomcat\webapps\{flexiteWEB}\WEB-INF\classes\settings\flexite.confconf### Tomcat settings base-dir=/{flexiteWEB}/ mobile-dir=/{flexiteWEB}/m/ log-file=c:/tomcat/flexite/log/{flexiteWEB}/flexite.log ... theme-dir=/{flexiteWEB}/theme/modern/C:\tomcat\webapps\{flexiteWEB}\WEB-INF\classes\settings\pool.confconflogfile=c:/tomcat/flexite/log/{flexiteWEB}/pool.log
Skapa den katalog som angivits för
log-file:C:\tomcat\flexite\log\{flexiteWEB}
flexiteAdmin
Till skillnad från flexiteWEB stödjer flexiteAdmin enbart en databaskoppling per installation. Detta betyder att en ny instans av flexiteAdmin måste installeras i en ny katalog; C:\tomcat\webapps\{flexiteAdmin}. Den grundläggande installationsproceduren är densamma som för en standardinstallation, med skillnaden att unika sökvägar måste nyttjas för varje instans.
Ange unika sökvägar för samtliga instanser av flexiteAdmin:
C:\tomcat\webapps\{flexiteAdmin}\WEB-INF\classes\settings\flexiteAdmin.confconfbase-dir=/{flexiteAdmin}/ log-file=c:/tomcat/flexite/log/{flexiteAdmin}/flexiteAdmin.log
Skapa den katalog som angivits för
log-file:C:\tomcat\flexite\log\{flexiteAdmin}
flexiteCLIENT
Det är tekniskt möjligt att nyttja en och samma flexiteCLIENT-installation till att administrera två flexite-system, designerade Skarp respektive Test under konfiguration av databaskopplingar. Det är dock starkt rekommenderat att undvika detta eftersom det kräver att båda systemen alltid kör samma version, inklusive hotfix-version.
Det rekommenderade förfarandet är att installera och nyttja individuella flexiteCLIENT för varje flexite-system. Den grundläggande installationsproceduren är densamma som för en standardinstallation.
I flexiteCLIENT måste konfiguration utföras för att matcha inställningarna gjorda i flexiteWEB och flexiteProcessEngine. För att komma åt inställningarna för Processmotor krävs att flexiteCLIENT körs med kommandot flexite.exe /services.
Navigera till Inställningar > Webbinställningar > Länkar och ange unika sökvägar:
- flexiteWEB — URL för flexiteWEB.
Exempel:https://flexite.company.com/{flexiteWEB}/ - flexiteWEB Webservice — URL för flexiteWEB Web Service. Placerad under
servicesi webbapplikationen. Exempel:https://flexite.company.com/{flexiteWEB}/services/ - flexiteAdmin URL — URL för flexiteAdmin.
Exempel:https://flexite.company.com/{flexiteAdmin}/ - Extern URL — URL för flexiteWEB i e-post till externa mottagare. Enbart tillgänglig om Extern server är aktiverad.
Exempel:https://ext.company.com/{flexiteWEB}/ - URL för manual / URL för metodisk manual — URL för flexiteWEB respektive flexiteCLIENT manual. Som standard är de placerade under
manuali webbapplikationen.
Exempel:https://flexite.company.com/{flexiteWEB}/manual/flexiteWEB_manual_sve.pdf - URL för flexiteAdmin manual — URL för flexiteAdmin manual.
Exempel:https://flexite.company.com/{flexiteAdmin}/res/manual/flexiteAdmin_manual.html
- flexiteWEB — URL för flexiteWEB.
Navigera till Inställningar > Processmotor > flexiteProcessEngine och ange unika kommunikationsportar samt sökvägar:
- Extern data, Kontroll port:
{dllInfoPort} - Extern data, Data port:
{dllDataPort} - Webservice, Port:
{webservicePort}
Kontroll och Data måste stämma överens med portarna angivna i
flexiteProcessEngine.ini.- Extern data, Kontroll port:
Integration med Microsoft IIS
Om integration med IIS nyttjas (se kapitel Microsoft IIS som webbserver) måste en pekare läggas till för de nya webbapplikationerna i ISAPI-integrationen:
Öppna filen C:\tomcat\conf\uriworkermap.properties, och ange sökvägar för de nya webbapplikationerna enligt följande format:
properties
/{webappName}/*=ajp13
/{webappName}/servlet/*=ajp13Flera databaser i samma installation
Det är möjligt att koppla flera databaser till en och samma installation av flexiteProcessEngine och flexiteWEB. Denna typ av lösning är mindre resurskrävande än flera individuella installationer, men kan leda till ökade svarstider för tjänster eftersom de flera databaskopplingarna hanteras seriellt av flexiteProcessEngine. Denna lösning rekommenderas därmed enbart för mindre, icke-kritiska, miljöer.
Ett exempel på användningsområde är en utbildningsmiljö som regelbundet behöver underhållas i form av nollställning av databaser och rensning av temporära filer. I detta fall kan tidsåtgången för det återkommande underhållet premieras framför prestanda och svarstider.
I detta exempel använder vi standardkonfigurationen avseende kommunikationsportar och sökvägar för flexiteProcessEngine och flexiteWEB.
flexiteCLIENT och flexiteAdmin
flexiteCLIENT och flexiteAdmin stödjer inte flera databaser och kräver därmed individuella installationer per databas.
Databas
När flera system ska köras på samma databasserver krävs det att databaserna utöver unika namn använder unika sökvägar för filerna. Detta kan uppnås genom att antingen ge dem unika filnamn eller att lagra dem i unika kataloger. Denna konfiguration sker enklast under installationsprocessen.
I detta exempel lagrar vi filerna i samma katalog, och måste därmed ge dem unika filnamn:
- Välj databas för återställning och ange önskat, unikt, databasnamn (
{dbName}). - Navigera till Files och se till att filnamnen för samtliga filer under Restore As är unika.
- Slutför återställning samt konfiguration av databas i enlighet med instruktionerna för en standardinstallation.
flexiteProcessEngine
För denna lösning används en instans av flexiteProcessEngine för flera databaser. Den grundläggande installationsproceduren är densamma som för en standardinstallation, med skillnaden att unika uppgifter måste anges för varje databas.
Ange databaskopplingar i C:\tomcat\flexite\flexiteProcessEngine\flexiteProcessEngine.ini. Konfiguration för databasanslutning anges under sektionerna [Database.X], där X är en nummerserie med start på 0.
Exempel: [Database.0]; [Database.1]; [Database.2] ...
ini
[Database.0]
ConnectServerType=SQLServerOLE
ConnectDatabaseName={dbServer}:{dbName.001}
ConnectUserName={dbUserName.001}
ConnectUserPassword={dbUserPassword.001}
OnHoldSvc=1
AlarmSvc=1
StatisticsSvc=1
DBLinkSvc=1
LeadTimesSvc=1
SubstituteSvc=1
MailSvc=1
[Database.1]
ConnectServerType=SQLServerOLE
ConnectDatabaseName={dbServer}:{dbName.002}
ConnectUserName={dbUserName.002}
ConnectUserPassword={dbUserPassword.002}
OnHoldSvc=1
AlarmSvc=1
StatisticsSvc=1
DBLinkSvc=1
LeadTimesSvc=1
SubstituteSvc=1
MailSvc=1
...Här är det även möjligt att per databas styra vilka tjänster som hanteras av aktuell flexiteProcessEngine.
flexiteWEB
För denna lösning används en instans av flexiteWEB som webbapplikation för flera databaser. Varje individuell databaskoppling konfigureras som ett individuellt Projekt i webbapplikationen. Den grundläggande installationsproceduren är densamma som för en standardinstallation, med skillnaden att unika databaskopplingar och sökvägar måste anges för varje Projekt.
Navigera till
C:\tomcat\webapps\flexite\.Kopiera
index.jsptill en ny fil för varje databas som ska kopplas. Det är via anrop mot dessa filer som inkommande trafik dirigeras till de individuella Projekten. Filnamnen MÅSTE följa formatetindex*.jsp, och det är rekommenderat att de enbart innehåller gemener. För att förenkla underhåll kan det vara en god idé att döpa filerna efter respektive databas.
Exempel:indexdbname.jspAnge Projektnamn individuellt för varje kopia av
index.jsp. För att förenkla underhåll kan det vara en god idé att döpa projekten till samma namn som respektive databas.javaString ProjectID = "{dbName}";
Navigera till
C:\tomcat\webapps\flexite\WEB-INF\classes\settings\.Kopiera
flexite.conftill en ny fil för varje databas som ska kopplas. Dessa filer utgör konfigurationsfilerna för de individuella Projekten. Filnamnen för dessa filer måste motsvara det individuella Projektnamnet angivet i respektive kopia avindex.jsp.
Exempel:{dbName}.confAnge sökvägar för logg- och tempfiler samt databaskoppling individuellt för varje kopia av
flexite.conf(varje Projekt).conf### Tomcat settings log-file=c:/tomcat/flexite/log/{dbName}.log ### Database settings db-service-name={dbServer}:{dbName} db-user-name={dbUserName} db-user-password={dbUserPassword} db-server-url=jdbc:sqlserver://{dbServer}:{dbPort};databaseName={dbName}Ange samtliga aktiva projekt för webbapplikationen i
pool.conf. I denna fil anges namnen på projekt-filerna i formatet{PROJEKT_I_VERSALER}.conf={projekt_i_gemener}.conf
Exempel:DBNAME.conf=dbname.confconf# Configuration file that contains additional project parameters. {DBNAME}.conf={dbname}.conf
Hantering av ordinarie index.jsp
Ordinarie index.jsp pekar mot projektet flexite, och därmed via pool.conf mot filen flexite.conf med dess databaskoppling. Utöver att svara på anrop direkt mot filen svarar denna fil även på anrop mot rotkatalogen för flexiteWEB.
Om det inte finns något behov av att nå flexiteWEB direkt via rotkatalogen är rekommendationen att ta bort ordinarie index.jsp.
En annan möjlighet är att konfigurera och nyttja index.jsp och flexite.conf till ett utav de aktuella Projekten.
flexiteCLIENT
För denna lösning krävs en unik installation av flexiteCLIENT för varje databas. Den grundläggande installationsproceduren är densamma som för en standardinstallation.
I varje individuell flexiteCLIENT måste konfiguration utföras för att matcha inställningarna gjorda i flexiteWEB och flexiteProcessEngine. För att komma åt inställningarna för Processmotor krävs att flexiteCLIENT körs med kommandot flexite.exe /services.
- Navigera till Inställningar > Webbinställningar > Länkar och ange unika sökvägar för flexiteWEB:
- flexiteWEB — URL för flexiteWEB, inklusive
index*.jsp.
Exempel:https://flexite.company.com/flexite/indexdbname.jsp
- flexiteWEB — URL för flexiteWEB, inklusive
- Navigera till Inställningar > Processmotor. Det är rekommenderat att Periodiciteten för de individuella tjänsterna är densamma för varje databas. Därtill bör nästa körning beräknas utifrån de individuella tjänsternas sluttid.
flexiteAdmin
För denna lösning krävs en unik installation av flexiteAdmin för varje databas. Den grundläggande installationen är densamma som för en standardinstallation.
Rekommendationer
För att underlätta administration är det rekommenderat att nyttja individuella kataloger för resurser för varje databas.
flexiteWEB
- Skapa individuella kataloger för resurser som ska vara tillgängliga direkt på webbservern. Detta innefattar exempelvis filer som ska nyttjas som Slut URL i E-services samt Informationssida på första formuläret i flexiteWEB.
Exempel:C:\tomcat\webapps\flexite\customer\{dbName} - Skapa individuella kataloger för publicering av Periodisk Statistik.
Exempel:C:\tomcat\webapps\flexite\customer\{dbName}\ps
flexiteCLIENT
- I flexiteCLIENT, navigera till Inställningar > Processmotor/ Statistik och ange individuella sökvägar för Periodisk Statistik:
- Använd URL från globala inställningar — Måste vara inaktiv.
- Mapp för publicering — Lokal sökväg för publicerad statistik. Måste matcha sökvägen till den katalog som skapats för Periodisk Statistik i flexiteWEB.
Exempel:C:\tomcat\webapps\flexite\customer\{dbName}\ps - URL till mapp för publicering — URL för publicerad statistik. Måste matcha sökvägen till den katalog som skapats för Periodisk Statistik i flexiteWEB.
Exempel:https://flexite.company.com/flexite/customer/{dbName}/ps
Uppgradering och patchning
För ett system kopplat mot flera databaser är det kritiskt att de kopierade filerna jämförs med ordinarie filer efter varje utförd uppgradering och patchning. Detta för att säkerställa att uppdateringar även överförs till kopiorna.
flexiteWEB
\index.jspJämför med kopior belägna i rotkatalogen.\WEB-INF\default_conf\flexite.confJämför med kopior belägna i\WEB-INF\classes\settings\.