Realizovaním krokov popísaných v predchádzajúcej kapitole, aplikačný server Tomcat spustí pri svojom štarte aj SmartWeb Java EE aplikáciu. Pri prvom spustení si SmartWeb automaticky pre seba vytvorí štandardný konfiguračný súbor smartweb.json, v prípade ak táto konfigurácia neexistuje. Vytvorený konfiguračný súbor sa nachádza v adresári aplikačného servera Tomcat /conf/applications/<nazov .war súboru aplikácie>/smartweb.json
. Tento konfiguračný súbor je možné meniť kedykoľvek, aj počas behu aplikácie. Zmeny sa ale prejavia až pri reštarte (redeploymente) SmartWeb aplikácie.
Konfiguračný súbor smartweb.json
má nasledovnú štruktúru:
Blok kódu | ||
---|---|---|
| ||
{
"connections": [
/* pole konfigurácií pripojení na D2000 */
],
"listenableConnection": {
/* alternatíva k "connections" - konfigurácia reverzného pripojenia na D2000 kvôli požiadavkám zabezpečenia (spojenie nadväzuje D2Connector.exe smerom z D2000 -> SmartWeb) */
},
"edaConnection": {
/* konfigurácia pripojenia na EDA Server, kvôli sprístupneniu práce s EDA vektormi */
},
"authentication": {
/* objekt s konfiguráciou autentifikácie používateľov */
},
"application": {/* objekt s konfiguráciou aplikačnej časti SmartWebu */
/* počet minút po ktorých je používateľ automaticky odhlásený v prípade, že z pohľadu servera nevykonal žiadnu aktivitu (napr. volanie API na načítanie dát), default hodnota je 30 minút*/
"userSessionMaxInactivePeriod": 30,
/* nastavenie pre užívateľov prihlásených cez prehliadač, definuje počet minút po ktorých je používateľ automaticky odhlásený v prípade že zavrel všetky záložky s aplikáciou v prehliadači, default hodnota je 5 minút*/
"httpSessionMaxInactivePeriod": 5,
/* nastavenie pre užívateľov prihlásených cez prehliadač, definuje počet minút ktorých je používateľ prihlásený po zaškrtnutí Remember Me funkcionality, default hodnota je 0 - t.j. funkcionalita je vypnutá */
"rememberMeTokenTimeout": 0,
"cometApi": {
/* objekt s konfiguráciou univerzálneho Comet API */
},
"restApi": {
/* objekt s konfiguráciou univerzálneho REST API */
},
"odataApi": {
/* objekt s konfiguráciou ODATA API */
},
"tcl" : {
/* objekt s konfiguráciou integrácie SmartWeb aplikácie s tenkým klientom */
},
"webResourceDirectories": {
/* objekt s konfiguráciou adresárov so zdrojmi webovej aplikácie */
},
}
} |
Detaily jednotlivých položiek konfigurácie sú vysvetlené v nasledujúcich kapitolách
Inštalácia a upgrade
Smart Web aplikácia sa inštaluje a upgraduje ako štandardná Java EE aplikácia na aplikačný server Wildfly. Postup je nasledovný:
- Vypnúť aplikačný server Wildfly AS
- Rozbaliť inštalačný balíček
smartWeb.zip
do dočasného adresára. Smart Web sa distribuuje v závislosti na verzii D2000 systému (10.1.39 alebo 11.0.53). Treba sa uistiť že rozbalíme balíček so spravnou verziou. - nakopírovať súbor
smartWeb.war
z inštalačného balíčkasmartWeb.zip
do adresára aplikačného servera Wildfly:/standalone/deployments
- premenovať súbor
smartWeb.war
na <xxx>.war
kde <xxx>
môže byť ľubovolné meno vystihujúce názov aplikácie. Pod týmto menom bude aplikácia dostupná po spustení aplikačného servera: na URL ceste http://<serverDomena.sk>/xxx. - spustiť aplikačný server Wildfly AS
Info |
---|
Premenovaním archívu aplikácie ( Pozor, pre správne fungovanie aplikácie je nevyhnutné názov archívu aplikácie premenovať iba s použitím iba alfanumerických znakov a bez diakritiky. |
Konfigurácia
Realizovaním krokov popísaných v predchádzajúcej kapitole, aplikačný server Wildfly spustí pri svojom štarte aj Smart Web Java EE aplikáciu. Pri prvom spustení Smart Web automaticky nakonfiguruje Wildfly podľa svojich požiadaviek. O túto konfiguráciu sa nemusí správca aplikácie vôbec starať, dokonca ani po realizovaní upgradu - t.j. v rámci konfigurácie aplikačného servera si všetko nevyhnutné na svoj beh aplikácia manažuje sama. Bočným efektom tejto operácie je že server môže urobiť reset (redeploy) aplikácie viac krát kvôli zmenám konfigurácie realizovaným počas štartu. Wildfly uloží tieto zmeny aj do súboru so svojou konfiguráciou standalone.xml
aby sa zachovali aj po reštarte servera.
Popri nevyhnutných zmenách konfigurácie Wildfly servera, Smart Web pri štarte vytvorí aj svoju preddefinovanú konfiguráciu do súboru smartWeb.json, v prípade ak táto konfigurácia neexistuje. Vytvorený konfiguračný súbor sa nachádza v adresári aplikačného servera Wildfly /standalone/configuration/applications/<nazov .war súboru aplikácie>/smartWeb.json
.