Siwenoid Wiki - User contributions [en]

Config file parameters

2010-09-25T07:57:27Z

91.82.214.70:

'''Szerver parancssori paraméterei'''

A szerver indításához minimálisan a '''java -jar Siwenoid.jar''' parancs szükséges. A további paramétereket a '''java''' és a '''-jar''' közé kell megadni. Főbb beállítási lehetőségek:
*-Dsiwenoid.registry.port=1099 A szerver saját magát menedzselő RMI portja, ezen keresztül tudja például ellenőrizni induláskor, hogy fut-e már másik példány a számítógépen. Alapértelmezetten: 1099.
*-Dhajdbc.home=..path.. Ezzel a beállítással lehet befolyásolni, hogy a HA-JDBC modul hol keresse a konfigurációs fájlját. (Általában nem kell megváltoztatni az alapértelmezettet.)
*-Xms128m A szerver induláskor ennyi memóriát foglaljon le.
*-Xmx1024m A szerver a futása során legfeljebb ennyi memóriát használhat. Az 1024m azt jelenti, hogy maximum 1024 MB. A javasolt beállítás kisebb rendszereknél -Xmx512m nagyobbaknál -Xmx1024m.

További parancssori argumentumok (a parancs után kell írni őket szóközzel elválasztva):
*-start Elindítja a szervert (ez az alapértelmezett).
*-stop Leállítja a futó szervert.
*-restart Újraindítja a futó szervert.
*-version Kiírja a szerver verziószámát.

'''Szerver oldali XML konfiguráció'''

*Siwenoid Gyökér elem, az XML szabvány szempontjából fontos, minden dokumentumnak pontosan egy gyökere van.
**Services A szerver által használt szervízek sorrendhelyes felsorolása. Ez alatt minden egyes elem Tag-je a szervíz osztályának egyszerű neve, tartalma pedig az osztály teljes (minősített) neve. Pl.: <CacheService>hu.siwena.services.cache.CacheService</CacheService> <DatabaseService>hu.siwena.services.database.DatabaseService</DatabaseService> 
...
**LoggerService A logolásért felelős szervíz konfigurációja, a log4J modulnak megfelelően.1 Legegyszerűbb konfigurációja például:
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="root_fileappender" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="log/siwenoid.log"/>
<param name="Append" value="true"/>
<param name="ImmediateFlush" value="true"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d] - %m%n"/>
</layout>
</appender>
<logger name="hu.siwena">
<level value="info"/>
<appender-ref ref="root_fileappender"/>
</logger>
<appender name="dbappender" class="hu.siwena.services.database.synchronization.DatabaseErrorAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%m%n"/>
</layout>
</appender>
<logger name="net.sf.hajdbc">
<level value="debug"/>
<appender-ref ref="dbappender"/>
</logger>
<root>
<level value="error"/>
</root>
</log4j:configuration>
DatabaseService
Az adatbázist kezelő szervíz konfigurációja.
database (Attribútumok: id=”str” host=”str” port=”num” )
Ilyen Tag-ekkel kell felsorolni a rendszerhez kapcsolódó adatbázisokat, az id tetszőleges, de egyedi kell legyen.
torque
A Torque modul konfigurációját tartalmazza a szabványnak megfelelően.2
Több adatbázis esetén ez a rész nem szükséges, csak a ha-jdbc.
<applicationRoot>.</applicationRoot>
Az alkalmazás gyökere, mindig “.” az értéke.
defaults
Alapértelmezett értékek, konfigurációs beállítások.
pool
Szálakkal kapcsolatos beállítások.
<maxWait>10000</maxWait>
Maximum várakozási idő, mielőtt egy kapcsolódás meghiúsulna (milliszekundum).
<maxIdle>20</maxIdle>
Várakozó szálak maximális száma.
<maxActive>50</maxActive>
Aktív szálak (kapcsolatok) maximális száma.
<timeBetweenEvictionRunsMillis>300000</timeBetweenEvictionRunsMillis>
<minEvictableIdleTimeMillis>3600000</minEvictableIdleTimeMillis>
connection
Az adatbázis kapcsolat beállításai.
driver
Az adatbáziskezelőhöz tartozó Java Driver.
MySQL: com.mysql.jdbc.Driver�PostgreSQL: org.postgresql.Driver
url
Az adatbáziskezelő JDBC URL-je.
MySQL: jdbc:mysql://host:port/adatbazisnev�PostgreSQL: jdbc:postgresql://host:port/adatbazisnev
user
Az adatbázishoz csatlakozó felhasználó neve.
password
Az adatbázishoz csatlakozó felhasználó jelszava.
database
Adatbázis tulajdonságai.
default
Az alapértelmezett adatbázis (logikai) neve
[az_előző_pontban_megadott_név]
adapter
Az adatbázist kezelő adapter neve, keresd a Torque dokumentációjában. Leggyakrabban a mysql vagy postgresql adaptereket használjuk.
dsfactory
DataSourceFactory - A Torque használja, javasolt az alább Factory használata.
[alapértelmezett_adatbazis_neve]
<factory>org.apache.torque.dsfactory.SharedPoolDataSourceFactory</factory>
<idbroker.clever.quantity>true</idbroker.clever.quantity>
<manager.useCache>true</manager.useCache>
ha-jdbc (Attríbutuma: cluster=”str” )
Több adatbázis együttes kezelésekor szükséges, a cluster paraméter egy tetszőleges logikai név, pl.: SiwenoidDbCluster. Egy adatbázis esetén ez a rész nem szükséges, de ha ez nincs beállítva, akkor a torque résznek kell megfelelőnek lennie.
<sync id="tetszőleges" class="hu.siwena.services.database.synchronization.CustomDifferentialSynchronizationStrategy"/>
Adatbázisok szinkronizálását végző osztály konfigurálása.
cluster
Az adatbázis cluster konfigurálása.
Attribútumai:
balancer="simple"
default-sync="fentebb megadott sync id attribútumának értéke"
dialect="mysql" lehet pl. postgresql is, lásd a HA-JDBC dokumentációját 3
meta-data-cache="lazy"
transaction-mode="parallel"
max-threads="5"
auto-activate-schedule="0 0/1 * * * ?"
Az adatbázisok aktiválását végző Cron ütemező futási idő konfigurációja.4
failure-detect-schedule="0/15 * * * * ?"
Az adatbázisok kiesését vizsgáló Cron ütemező futási idő konfigurációja.4
Gyerek elemek:
database (Attribútuma: id=”a fentebb megadott id-k egyike” )
Egy-egy adatbázist reprezentáló elem.
driver
Lásd torque.defaults.connection.driver.
url
Lásd torque.defaults.connection.url.
user
Lásd torque.defaults.connection.user.
password
Lásd torque.defaults.connection.password.
database
....
DataPointService
Az adatpontokkal kapcsolatos szervíz konfigurációja, ez definiálja a használandó adatpont kezelőket is.
rootcontainername
A gyökér konténer neve, alapértelmezetten root.
systemcontainername
A rendszer konténer neve, alapértelmezetten system.
pre-cache
Töltse-e be az adatpontokat és gyerek listáikat automatikusan a cache-be induláskor. Az alapértelmezett érték: false. Lehetséges értékek: true vagy false.
import-memory-opts
Az adatpont importáló alkalmazás indításakor használandó memóriaszabályzó paraméter. Pl. -Xmx512m azt jelenti, hogy az alkalmazás max. 512 MB memóriát fog tudni használni.
Az alapértelmezett érték: -Xmx512m.
datapointhandlers
Adatpontkezelők felsorolása. Minden “item” Tag-be egy-egy kezelő teljes (minősített) nevét kell írni.
item
item
...
Például:
<item>hu.siwena.services.datapoint.handlers.SystemHandler</item>
<item>hu.siwena.services.datapoint.handlers.AlgorexHandler</item>
SystemHandler
A rendszer-adatpontokat kezelő osztály konfigurációja.
type (Attribútumai: id=”adatpont_típus” )
Az adatpont típus lehetséges értékei:
1 szerver
2 adatbázis
16 kliens számláló
17 kliens
Az elem tartalma egy eseménykategória azonosítója, ebbe a kategóriába fog tartozni az a treatment, amellyel az adatbont normálistól eltérő állapotai kerülnek.
AlgorexHandler és AlgorexMultiportHandler
Az Algorex protokollal operáló adatpontok kezelője, illetve ennek a Hot-standby párja konfigurációi.
sockettimeout
Az alközponthoz kapcsolódás timeout-ja.
socketkeepalive
Az életjel telegram értéke, minden esetben 0x01.
BACnetHandler
A BACnet protokollal kommunikáló adatpontok kezelőjének konfigurációja.
disabled-types
Az import során az itt felsorolt típusú elemek figyelmen kívül hagyja.
item
Értéke a tiltandó típus neve, pl.: EO_FI_ZoneManualElem
item
...
CerbanHandler és CerbanMultiportHandler
A Cerban protokollal működő adatpontok kezelője, illetve ennek a Hot-standby párja konfigurációi.
sockettimeout
Az alközponthoz kapcsolódás timeout-ja.
socketkeepalive
Az életjel telegram értéke, minden esetben 0x01.
SIAHandler
A SIA protokolhoz tartozó adatpontok kezelőjének konfigurációja.
Egyelőre nincs konfigurációs lehetőség.
RmiService
A szerver-kliens kapcsolatokat kezelő szervíz konfigurációja.
port
A kapcsolatokat fogadó (Registry) port száma. Alapértelmezett értéke: 1899.
sessiontimeout
A kapcsolatok elévülési ideje, ennyi (milliszekundum) inaktivitás után bontja a kapcsolatot a szerver. Alapértelmezetten: 6000.
sessioncheckperiod
A kapcsolatok elévülését ellenőrző ütemező periódusideje. Alapértelmezetten: 5000.
clientcount
Az egyszerre csatlakozott kliensek elvárt száma.
separate-acknowledge
Lehetséges értékei: true vagy false, alapértelmezetten: true.
Igaz értéke esetén minden kliensen külön-külön le kell nyugtázni egy új eseményt, hamis értéke esetén valamely kliens nyugtája az összes kliensen nyugtázza az eseményt.
pre-cache
Lehetséges értékei: true vagy false, alapértelmezetten: false.
Igaz értéke esetén induláskor betölti cache-be a treatmentek és parancsok listáját.
enabled-locales
Az engedélyezett nyelvek kódjainak felsorolása. Alapértelmezetten: en és hu.
item
item
...
event-log
Eseménymemóriával kapcsolatos konfiguráció. (Opcionális)
limit
Az eseménymemória mérethatára, ez felett kerül archiválásra. Alapértelmezetten: 50000.
starttime
Az eseménymemóri vizsgálatának kezdete naponta (óra:perc). Alapértelmezetten a szerver indulásakor indul az ütemezés.
AuthenticationService
A felhasználók kezelésével kapcsolatos szervíz konfigurációja.
administrator
Az adminisztrátor felhasználóra vonatkozó információk, amennyiben a felhasználó még nem létezik, ezekkel az adatokkal fogja létrehozni. A belépési információkat (felhasználónév, jelszó) első indításkor fogja kérni a szerver.
firstname
lastname
email
language
A felhasználói felület nyelvének kódja.
ScriptService
A scriptek futtatásáért felelős szervíz konfigurációja.
categories
Script kategóriák felsorolása, lásd a Siwenoid Scripting dokumentációt.
item
item
...
apis
Script API-k felsorolása, lásd a Siwenoid Scripting dokumentációt.
item
item
...
SignalService
A Hot-standby megoldást implementáló szervíz konfigurációja, illetve a csatlakó JGroups5 modul beállításai. A következő 3 tulajdonság egyikének, illetve a server-list elemnek kell benne lennie:
1) jchannel:file
A csatorna konfiguriációját5 tartalmazó fájl útvonala.
2) jchannel:simple
A csatorna egyszerű konfigurációját5 tartalmazó szöveg.
3) jchannel:config
A csatorna XML konfigurációja.5
server-list
Szerverek listáját felsoroló rész.
server (Attribútuma: priority=”num” )
Egy szervert reprezentáló elem. A priority attribútum a szerver prioritását határozza meg, a nagyobb a fontosabb.
host
A szerver csatorna host címe.
port
A szerver csatorna portja.
License
A Licensszel kapcsolatos konfiguráció.
stick-serial
A mellékelt CodeMeter USB kulcs sorozatszáma.
firmcode
A gyártó kódja: 101459.
productcode
A termék kódja: 10.
SocketService
Az Algorex adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
BACnetCommunicationService
A BACnet adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
timeout
A BACnet-es kapcsolat timeout-ja. (milliszekundum)
Alapértelmezett: 5000.
instancenumber
A szerver BACnet azonosítója, alapértelmezetten: 100.
address
Broadcast cím, erre küldi ki a központokat kereső üzeneteket a szerver.
Alapértelmezetten: 255.255.255.255
localbindaddress
A helyi host címe, alapértelmezetten: 0.0.0.0
port
A BACnet port, alapértelmezetten: 47808.
CerbanSocketService
A Cerban adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
SIACommunicationService
A SIA adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
AndroidService
Az Android klienseket kezelő szervíz konfigurációja.
bindaddress
A helyi host címe, alapértelmezetten a lokális host.
listenport
A kapcsolatokat váró port száma, alapértelmezetten: 5559.
maxmapsize
A térképek maximális mérete (szélesség és magasság), alapértelmezetten: 1024.
IECService
Az IEC101 protokollal kapcsolatos szervíz konfigurációja.
configuration
A szükséges beállításokat tartalmazó fájl elérési útja.

1 log4J XML konfiguráció:
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/DOMConfigurator.html

2 Torque konfiguráció:
http://db.apache.org/torque/releases/torque-3.3/runtime/reference/initialisation-configuration.html
Az itt leírtak a Properties fájlból való konfigurációra vonatkoznak, mely könnyedén átfordítható XML-lé:
A tulajdonságokban szereplő pontok az XML-ben egy-egy gyerek elemet jelentenek, pl.:
torque.default.connection.driver <> <torque><defaults><connection><driver>...</driver></conn...

3 HA-JDBC dialektusok:
http://ha-jdbc.sourceforge.net/doc.html#dialect

4 Cron ütemező konfigurálása:
http://www.quartz-scheduler.org/docs/tutorials/crontrigger.html

5 JGroups csatorna konfiguráció:
http://www.jgroups.org/manual/html/user-advanced.html#d0e2444
Protokolok listája:
http://www.jgroups.org/manual/html/protlist.html
Egyéb információ:
http://community.jboss.org/wiki/JGroups

Config file parameters

2010-09-25T07:52:58Z

91.82.214.70:

'''Szerver parancssori paraméterei'''

A szerver indításához minimálisan a '''java -jar Siwenoid.jar''' parancs szükséges. A további paramétereket a '''java''' és a '''-jar''' közé kell megadni. Főbb beállítási lehetőségek:
*-Dsiwenoid.registry.port=1099 A szerver saját magát menedzselő RMI portja, ezen keresztül tudja például ellenőrizni induláskor, hogy fut-e már másik példány a számítógépen. Alapértelmezetten: 1099.
*-Dhajdbc.home=..path.. Ezzel a beállítással lehet befolyásolni, hogy a HA-JDBC modul hol keresse a konfigurációs fájlját. (Általában nem kell megváltoztatni az alapértelmezettet.)
*-Xms128m A szerver induláskor ennyi memóriát foglaljon le.
*-Xmx1024m A szerver a futása során legfeljebb ennyi memóriát használhat. Az 1024m azt jelenti, hogy maximum 1024 MB. A javasolt beállítás kisebb rendszereknél -Xmx512m nagyobbaknál -Xmx1024m.

További parancssori argumentumok (a parancs után kell írni őket szóközzel elválasztva):
-start
Elindítja a szervert (ez az alapértelmezett).
-stop
Leállítja a futó szervert.
-restart
Újraindítja a futó szervert.
-version
Kiírja a szerver verziószámát.

Szerver oldali XML konfiguráció:

Siwenoid
Gyökér elem, az XML szabvány szempontjából fontos, minden dokumentumnak pontosan egy gyökere van.
Services
A szerver által használt szervízek sorrendhelyes felsorolása. Ez alatt minden egyes elem Tag-je a szervíz osztályának egyszerű neve, tartalma pedig az osztály teljes (minősített) neve. Pl.:
<CacheService>hu.siwena.services.cache.CacheService</CacheService>
<DatabaseService>hu.siwena.services.database.DatabaseService</DatabaseService>
...
LoggerService
A logolásért felelős szervíz konfigurációja, a log4J modulnak megfelelően.1 Legegyszerűbb konfigurációja például:
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="root_fileappender" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="log/siwenoid.log"/>
<param name="Append" value="true"/>
<param name="ImmediateFlush" value="true"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d] - %m%n"/>
</layout>
</appender>
<logger name="hu.siwena">
<level value="info"/>
<appender-ref ref="root_fileappender"/>
</logger>
<appender name="dbappender" class="hu.siwena.services.database.synchronization.DatabaseErrorAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%m%n"/>
</layout>
</appender>
<logger name="net.sf.hajdbc">
<level value="debug"/>
<appender-ref ref="dbappender"/>
</logger>
<root>
<level value="error"/>
</root>
</log4j:configuration>
DatabaseService
Az adatbázist kezelő szervíz konfigurációja.
database (Attribútumok: id=”str” host=”str” port=”num” )
Ilyen Tag-ekkel kell felsorolni a rendszerhez kapcsolódó adatbázisokat, az id tetszőleges, de egyedi kell legyen.
torque
A Torque modul konfigurációját tartalmazza a szabványnak megfelelően.2
Több adatbázis esetén ez a rész nem szükséges, csak a ha-jdbc.
<applicationRoot>.</applicationRoot>
Az alkalmazás gyökere, mindig “.” az értéke.
defaults
Alapértelmezett értékek, konfigurációs beállítások.
pool
Szálakkal kapcsolatos beállítások.
<maxWait>10000</maxWait>
Maximum várakozási idő, mielőtt egy kapcsolódás meghiúsulna (milliszekundum).
<maxIdle>20</maxIdle>
Várakozó szálak maximális száma.
<maxActive>50</maxActive>
Aktív szálak (kapcsolatok) maximális száma.
<timeBetweenEvictionRunsMillis>300000</timeBetweenEvictionRunsMillis>
<minEvictableIdleTimeMillis>3600000</minEvictableIdleTimeMillis>
connection
Az adatbázis kapcsolat beállításai.
driver
Az adatbáziskezelőhöz tartozó Java Driver.
MySQL: com.mysql.jdbc.Driver�PostgreSQL: org.postgresql.Driver
url
Az adatbáziskezelő JDBC URL-je.
MySQL: jdbc:mysql://host:port/adatbazisnev�PostgreSQL: jdbc:postgresql://host:port/adatbazisnev
user
Az adatbázishoz csatlakozó felhasználó neve.
password
Az adatbázishoz csatlakozó felhasználó jelszava.
database
Adatbázis tulajdonságai.
default
Az alapértelmezett adatbázis (logikai) neve
[az_előző_pontban_megadott_név]
adapter
Az adatbázist kezelő adapter neve, keresd a Torque dokumentációjában. Leggyakrabban a mysql vagy postgresql adaptereket használjuk.
dsfactory
DataSourceFactory - A Torque használja, javasolt az alább Factory használata.
[alapértelmezett_adatbazis_neve]
<factory>org.apache.torque.dsfactory.SharedPoolDataSourceFactory</factory>
<idbroker.clever.quantity>true</idbroker.clever.quantity>
<manager.useCache>true</manager.useCache>
ha-jdbc (Attríbutuma: cluster=”str” )
Több adatbázis együttes kezelésekor szükséges, a cluster paraméter egy tetszőleges logikai név, pl.: SiwenoidDbCluster. Egy adatbázis esetén ez a rész nem szükséges, de ha ez nincs beállítva, akkor a torque résznek kell megfelelőnek lennie.
<sync id="tetszőleges" class="hu.siwena.services.database.synchronization.CustomDifferentialSynchronizationStrategy"/>
Adatbázisok szinkronizálását végző osztály konfigurálása.
cluster
Az adatbázis cluster konfigurálása.
Attribútumai:
balancer="simple"
default-sync="fentebb megadott sync id attribútumának értéke"
dialect="mysql" lehet pl. postgresql is, lásd a HA-JDBC dokumentációját 3
meta-data-cache="lazy"
transaction-mode="parallel"
max-threads="5"
auto-activate-schedule="0 0/1 * * * ?"
Az adatbázisok aktiválását végző Cron ütemező futási idő konfigurációja.4
failure-detect-schedule="0/15 * * * * ?"
Az adatbázisok kiesését vizsgáló Cron ütemező futási idő konfigurációja.4
Gyerek elemek:
database (Attribútuma: id=”a fentebb megadott id-k egyike” )
Egy-egy adatbázist reprezentáló elem.
driver
Lásd torque.defaults.connection.driver.
url
Lásd torque.defaults.connection.url.
user
Lásd torque.defaults.connection.user.
password
Lásd torque.defaults.connection.password.
database
....
DataPointService
Az adatpontokkal kapcsolatos szervíz konfigurációja, ez definiálja a használandó adatpont kezelőket is.
rootcontainername
A gyökér konténer neve, alapértelmezetten root.
systemcontainername
A rendszer konténer neve, alapértelmezetten system.
pre-cache
Töltse-e be az adatpontokat és gyerek listáikat automatikusan a cache-be induláskor. Az alapértelmezett érték: false. Lehetséges értékek: true vagy false.
import-memory-opts
Az adatpont importáló alkalmazás indításakor használandó memóriaszabályzó paraméter. Pl. -Xmx512m azt jelenti, hogy az alkalmazás max. 512 MB memóriát fog tudni használni.
Az alapértelmezett érték: -Xmx512m.
datapointhandlers
Adatpontkezelők felsorolása. Minden “item” Tag-be egy-egy kezelő teljes (minősített) nevét kell írni.
item
item
...
Például:
<item>hu.siwena.services.datapoint.handlers.SystemHandler</item>
<item>hu.siwena.services.datapoint.handlers.AlgorexHandler</item>
SystemHandler
A rendszer-adatpontokat kezelő osztály konfigurációja.
type (Attribútumai: id=”adatpont_típus” )
Az adatpont típus lehetséges értékei:
1 szerver
2 adatbázis
16 kliens számláló
17 kliens
Az elem tartalma egy eseménykategória azonosítója, ebbe a kategóriába fog tartozni az a treatment, amellyel az adatbont normálistól eltérő állapotai kerülnek.
AlgorexHandler és AlgorexMultiportHandler
Az Algorex protokollal operáló adatpontok kezelője, illetve ennek a Hot-standby párja konfigurációi.
sockettimeout
Az alközponthoz kapcsolódás timeout-ja.
socketkeepalive
Az életjel telegram értéke, minden esetben 0x01.
BACnetHandler
A BACnet protokollal kommunikáló adatpontok kezelőjének konfigurációja.
disabled-types
Az import során az itt felsorolt típusú elemek figyelmen kívül hagyja.
item
Értéke a tiltandó típus neve, pl.: EO_FI_ZoneManualElem
item
...
CerbanHandler és CerbanMultiportHandler
A Cerban protokollal működő adatpontok kezelője, illetve ennek a Hot-standby párja konfigurációi.
sockettimeout
Az alközponthoz kapcsolódás timeout-ja.
socketkeepalive
Az életjel telegram értéke, minden esetben 0x01.
SIAHandler
A SIA protokolhoz tartozó adatpontok kezelőjének konfigurációja.
Egyelőre nincs konfigurációs lehetőség.
RmiService
A szerver-kliens kapcsolatokat kezelő szervíz konfigurációja.
port
A kapcsolatokat fogadó (Registry) port száma. Alapértelmezett értéke: 1899.
sessiontimeout
A kapcsolatok elévülési ideje, ennyi (milliszekundum) inaktivitás után bontja a kapcsolatot a szerver. Alapértelmezetten: 6000.
sessioncheckperiod
A kapcsolatok elévülését ellenőrző ütemező periódusideje. Alapértelmezetten: 5000.
clientcount
Az egyszerre csatlakozott kliensek elvárt száma.
separate-acknowledge
Lehetséges értékei: true vagy false, alapértelmezetten: true.
Igaz értéke esetén minden kliensen külön-külön le kell nyugtázni egy új eseményt, hamis értéke esetén valamely kliens nyugtája az összes kliensen nyugtázza az eseményt.
pre-cache
Lehetséges értékei: true vagy false, alapértelmezetten: false.
Igaz értéke esetén induláskor betölti cache-be a treatmentek és parancsok listáját.
enabled-locales
Az engedélyezett nyelvek kódjainak felsorolása. Alapértelmezetten: en és hu.
item
item
...
event-log
Eseménymemóriával kapcsolatos konfiguráció. (Opcionális)
limit
Az eseménymemória mérethatára, ez felett kerül archiválásra. Alapértelmezetten: 50000.
starttime
Az eseménymemóri vizsgálatának kezdete naponta (óra:perc). Alapértelmezetten a szerver indulásakor indul az ütemezés.
AuthenticationService
A felhasználók kezelésével kapcsolatos szervíz konfigurációja.
administrator
Az adminisztrátor felhasználóra vonatkozó információk, amennyiben a felhasználó még nem létezik, ezekkel az adatokkal fogja létrehozni. A belépési információkat (felhasználónév, jelszó) első indításkor fogja kérni a szerver.
firstname
lastname
email
language
A felhasználói felület nyelvének kódja.
ScriptService
A scriptek futtatásáért felelős szervíz konfigurációja.
categories
Script kategóriák felsorolása, lásd a Siwenoid Scripting dokumentációt.
item
item
...
apis
Script API-k felsorolása, lásd a Siwenoid Scripting dokumentációt.
item
item
...
SignalService
A Hot-standby megoldást implementáló szervíz konfigurációja, illetve a csatlakó JGroups5 modul beállításai. A következő 3 tulajdonság egyikének, illetve a server-list elemnek kell benne lennie:
1) jchannel:file
A csatorna konfiguriációját5 tartalmazó fájl útvonala.
2) jchannel:simple
A csatorna egyszerű konfigurációját5 tartalmazó szöveg.
3) jchannel:config
A csatorna XML konfigurációja.5
server-list
Szerverek listáját felsoroló rész.
server (Attribútuma: priority=”num” )
Egy szervert reprezentáló elem. A priority attribútum a szerver prioritását határozza meg, a nagyobb a fontosabb.
host
A szerver csatorna host címe.
port
A szerver csatorna portja.
License
A Licensszel kapcsolatos konfiguráció.
stick-serial
A mellékelt CodeMeter USB kulcs sorozatszáma.
firmcode
A gyártó kódja: 101459.
productcode
A termék kódja: 10.
SocketService
Az Algorex adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
BACnetCommunicationService
A BACnet adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
timeout
A BACnet-es kapcsolat timeout-ja. (milliszekundum)
Alapértelmezett: 5000.
instancenumber
A szerver BACnet azonosítója, alapértelmezetten: 100.
address
Broadcast cím, erre küldi ki a központokat kereső üzeneteket a szerver.
Alapértelmezetten: 255.255.255.255
localbindaddress
A helyi host címe, alapértelmezetten: 0.0.0.0
port
A BACnet port, alapértelmezetten: 47808.
CerbanSocketService
A Cerban adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
SIACommunicationService
A SIA adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
AndroidService
Az Android klienseket kezelő szervíz konfigurációja.
bindaddress
A helyi host címe, alapértelmezetten a lokális host.
listenport
A kapcsolatokat váró port száma, alapértelmezetten: 5559.
maxmapsize
A térképek maximális mérete (szélesség és magasság), alapértelmezetten: 1024.
IECService
Az IEC101 protokollal kapcsolatos szervíz konfigurációja.
configuration
A szükséges beállításokat tartalmazó fájl elérési útja.

1 log4J XML konfiguráció:
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/DOMConfigurator.html

2 Torque konfiguráció:
http://db.apache.org/torque/releases/torque-3.3/runtime/reference/initialisation-configuration.html
Az itt leírtak a Properties fájlból való konfigurációra vonatkoznak, mely könnyedén átfordítható XML-lé:
A tulajdonságokban szereplő pontok az XML-ben egy-egy gyerek elemet jelentenek, pl.:
torque.default.connection.driver <> <torque><defaults><connection><driver>...</driver></conn...

3 HA-JDBC dialektusok:
http://ha-jdbc.sourceforge.net/doc.html#dialect

4 Cron ütemező konfigurálása:
http://www.quartz-scheduler.org/docs/tutorials/crontrigger.html

5 JGroups csatorna konfiguráció:
http://www.jgroups.org/manual/html/user-advanced.html#d0e2444
Protokolok listája:
http://www.jgroups.org/manual/html/protlist.html
Egyéb információ:
http://community.jboss.org/wiki/JGroups

Config file parameters

2010-09-25T07:51:45Z

91.82.214.70:

'''Szerver parancssori paraméterei'''

A szerver indításához minimálisan a '''java -jar Siwenoid.jar''' parancs szükséges. A további paramétereket a '''java''' és a '''-jar''' közé kell megadni. Főbb beállítási lehetőségek:
*-Dsiwenoid.registry.port=1099
A szerver saját magát menedzselő RMI portja, ezen keresztül tudja például ellenőrizni induláskor, hogy fut-e már másik példány a számítógépen. Alapértelmezetten: 1099.
*-Dhajdbc.home=..path..
Ezzel a beállítással lehet befolyásolni, hogy a HA-JDBC modul hol keresse a konfigurációs fájlját. (Általában nem kell megváltoztatni az alapértelmezettet.)
*-Xms128m
A szerver induláskor ennyi memóriát foglaljon le.
*-Xmx1024m
A szerver a futása során legfeljebb ennyi memóriát használhat. Az 1024m azt jelenti, hogy maximum 1024 MB. A javasolt beállítás kisebb rendszereknél -Xmx512m nagyobbaknál -Xmx1024m.

További parancssori argumentumok (a parancs után kell írni őket szóközzel elválasztva):
-start
Elindítja a szervert (ez az alapértelmezett).
-stop
Leállítja a futó szervert.
-restart
Újraindítja a futó szervert.
-version
Kiírja a szerver verziószámát.

Szerver oldali XML konfiguráció:

Siwenoid
Gyökér elem, az XML szabvány szempontjából fontos, minden dokumentumnak pontosan egy gyökere van.
Services
A szerver által használt szervízek sorrendhelyes felsorolása. Ez alatt minden egyes elem Tag-je a szervíz osztályának egyszerű neve, tartalma pedig az osztály teljes (minősített) neve. Pl.:
<CacheService>hu.siwena.services.cache.CacheService</CacheService>
<DatabaseService>hu.siwena.services.database.DatabaseService</DatabaseService>
...
LoggerService
A logolásért felelős szervíz konfigurációja, a log4J modulnak megfelelően.1 Legegyszerűbb konfigurációja például:
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="root_fileappender" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="log/siwenoid.log"/>
<param name="Append" value="true"/>
<param name="ImmediateFlush" value="true"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d] - %m%n"/>
</layout>
</appender>
<logger name="hu.siwena">
<level value="info"/>
<appender-ref ref="root_fileappender"/>
</logger>
<appender name="dbappender" class="hu.siwena.services.database.synchronization.DatabaseErrorAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%m%n"/>
</layout>
</appender>
<logger name="net.sf.hajdbc">
<level value="debug"/>
<appender-ref ref="dbappender"/>
</logger>
<root>
<level value="error"/>
</root>
</log4j:configuration>
DatabaseService
Az adatbázist kezelő szervíz konfigurációja.
database (Attribútumok: id=”str” host=”str” port=”num” )
Ilyen Tag-ekkel kell felsorolni a rendszerhez kapcsolódó adatbázisokat, az id tetszőleges, de egyedi kell legyen.
torque
A Torque modul konfigurációját tartalmazza a szabványnak megfelelően.2
Több adatbázis esetén ez a rész nem szükséges, csak a ha-jdbc.
<applicationRoot>.</applicationRoot>
Az alkalmazás gyökere, mindig “.” az értéke.
defaults
Alapértelmezett értékek, konfigurációs beállítások.
pool
Szálakkal kapcsolatos beállítások.
<maxWait>10000</maxWait>
Maximum várakozási idő, mielőtt egy kapcsolódás meghiúsulna (milliszekundum).
<maxIdle>20</maxIdle>
Várakozó szálak maximális száma.
<maxActive>50</maxActive>
Aktív szálak (kapcsolatok) maximális száma.
<timeBetweenEvictionRunsMillis>300000</timeBetweenEvictionRunsMillis>
<minEvictableIdleTimeMillis>3600000</minEvictableIdleTimeMillis>
connection
Az adatbázis kapcsolat beállításai.
driver
Az adatbáziskezelőhöz tartozó Java Driver.
MySQL: com.mysql.jdbc.Driver�PostgreSQL: org.postgresql.Driver
url
Az adatbáziskezelő JDBC URL-je.
MySQL: jdbc:mysql://host:port/adatbazisnev�PostgreSQL: jdbc:postgresql://host:port/adatbazisnev
user
Az adatbázishoz csatlakozó felhasználó neve.
password
Az adatbázishoz csatlakozó felhasználó jelszava.
database
Adatbázis tulajdonságai.
default
Az alapértelmezett adatbázis (logikai) neve
[az_előző_pontban_megadott_név]
adapter
Az adatbázist kezelő adapter neve, keresd a Torque dokumentációjában. Leggyakrabban a mysql vagy postgresql adaptereket használjuk.
dsfactory
DataSourceFactory - A Torque használja, javasolt az alább Factory használata.
[alapértelmezett_adatbazis_neve]
<factory>org.apache.torque.dsfactory.SharedPoolDataSourceFactory</factory>
<idbroker.clever.quantity>true</idbroker.clever.quantity>
<manager.useCache>true</manager.useCache>
ha-jdbc (Attríbutuma: cluster=”str” )
Több adatbázis együttes kezelésekor szükséges, a cluster paraméter egy tetszőleges logikai név, pl.: SiwenoidDbCluster. Egy adatbázis esetén ez a rész nem szükséges, de ha ez nincs beállítva, akkor a torque résznek kell megfelelőnek lennie.
<sync id="tetszőleges" class="hu.siwena.services.database.synchronization.CustomDifferentialSynchronizationStrategy"/>
Adatbázisok szinkronizálását végző osztály konfigurálása.
cluster
Az adatbázis cluster konfigurálása.
Attribútumai:
balancer="simple"
default-sync="fentebb megadott sync id attribútumának értéke"
dialect="mysql" lehet pl. postgresql is, lásd a HA-JDBC dokumentációját 3
meta-data-cache="lazy"
transaction-mode="parallel"
max-threads="5"
auto-activate-schedule="0 0/1 * * * ?"
Az adatbázisok aktiválását végző Cron ütemező futási idő konfigurációja.4
failure-detect-schedule="0/15 * * * * ?"
Az adatbázisok kiesését vizsgáló Cron ütemező futási idő konfigurációja.4
Gyerek elemek:
database (Attribútuma: id=”a fentebb megadott id-k egyike” )
Egy-egy adatbázist reprezentáló elem.
driver
Lásd torque.defaults.connection.driver.
url
Lásd torque.defaults.connection.url.
user
Lásd torque.defaults.connection.user.
password
Lásd torque.defaults.connection.password.
database
....
DataPointService
Az adatpontokkal kapcsolatos szervíz konfigurációja, ez definiálja a használandó adatpont kezelőket is.
rootcontainername
A gyökér konténer neve, alapértelmezetten root.
systemcontainername
A rendszer konténer neve, alapértelmezetten system.
pre-cache
Töltse-e be az adatpontokat és gyerek listáikat automatikusan a cache-be induláskor. Az alapértelmezett érték: false. Lehetséges értékek: true vagy false.
import-memory-opts
Az adatpont importáló alkalmazás indításakor használandó memóriaszabályzó paraméter. Pl. -Xmx512m azt jelenti, hogy az alkalmazás max. 512 MB memóriát fog tudni használni.
Az alapértelmezett érték: -Xmx512m.
datapointhandlers
Adatpontkezelők felsorolása. Minden “item” Tag-be egy-egy kezelő teljes (minősített) nevét kell írni.
item
item
...
Például:
<item>hu.siwena.services.datapoint.handlers.SystemHandler</item>
<item>hu.siwena.services.datapoint.handlers.AlgorexHandler</item>
SystemHandler
A rendszer-adatpontokat kezelő osztály konfigurációja.
type (Attribútumai: id=”adatpont_típus” )
Az adatpont típus lehetséges értékei:
1 szerver
2 adatbázis
16 kliens számláló
17 kliens
Az elem tartalma egy eseménykategória azonosítója, ebbe a kategóriába fog tartozni az a treatment, amellyel az adatbont normálistól eltérő állapotai kerülnek.
AlgorexHandler és AlgorexMultiportHandler
Az Algorex protokollal operáló adatpontok kezelője, illetve ennek a Hot-standby párja konfigurációi.
sockettimeout
Az alközponthoz kapcsolódás timeout-ja.
socketkeepalive
Az életjel telegram értéke, minden esetben 0x01.
BACnetHandler
A BACnet protokollal kommunikáló adatpontok kezelőjének konfigurációja.
disabled-types
Az import során az itt felsorolt típusú elemek figyelmen kívül hagyja.
item
Értéke a tiltandó típus neve, pl.: EO_FI_ZoneManualElem
item
...
CerbanHandler és CerbanMultiportHandler
A Cerban protokollal működő adatpontok kezelője, illetve ennek a Hot-standby párja konfigurációi.
sockettimeout
Az alközponthoz kapcsolódás timeout-ja.
socketkeepalive
Az életjel telegram értéke, minden esetben 0x01.
SIAHandler
A SIA protokolhoz tartozó adatpontok kezelőjének konfigurációja.
Egyelőre nincs konfigurációs lehetőség.
RmiService
A szerver-kliens kapcsolatokat kezelő szervíz konfigurációja.
port
A kapcsolatokat fogadó (Registry) port száma. Alapértelmezett értéke: 1899.
sessiontimeout
A kapcsolatok elévülési ideje, ennyi (milliszekundum) inaktivitás után bontja a kapcsolatot a szerver. Alapértelmezetten: 6000.
sessioncheckperiod
A kapcsolatok elévülését ellenőrző ütemező periódusideje. Alapértelmezetten: 5000.
clientcount
Az egyszerre csatlakozott kliensek elvárt száma.
separate-acknowledge
Lehetséges értékei: true vagy false, alapértelmezetten: true.
Igaz értéke esetén minden kliensen külön-külön le kell nyugtázni egy új eseményt, hamis értéke esetén valamely kliens nyugtája az összes kliensen nyugtázza az eseményt.
pre-cache
Lehetséges értékei: true vagy false, alapértelmezetten: false.
Igaz értéke esetén induláskor betölti cache-be a treatmentek és parancsok listáját.
enabled-locales
Az engedélyezett nyelvek kódjainak felsorolása. Alapértelmezetten: en és hu.
item
item
...
event-log
Eseménymemóriával kapcsolatos konfiguráció. (Opcionális)
limit
Az eseménymemória mérethatára, ez felett kerül archiválásra. Alapértelmezetten: 50000.
starttime
Az eseménymemóri vizsgálatának kezdete naponta (óra:perc). Alapértelmezetten a szerver indulásakor indul az ütemezés.
AuthenticationService
A felhasználók kezelésével kapcsolatos szervíz konfigurációja.
administrator
Az adminisztrátor felhasználóra vonatkozó információk, amennyiben a felhasználó még nem létezik, ezekkel az adatokkal fogja létrehozni. A belépési információkat (felhasználónév, jelszó) első indításkor fogja kérni a szerver.
firstname
lastname
email
language
A felhasználói felület nyelvének kódja.
ScriptService
A scriptek futtatásáért felelős szervíz konfigurációja.
categories
Script kategóriák felsorolása, lásd a Siwenoid Scripting dokumentációt.
item
item
...
apis
Script API-k felsorolása, lásd a Siwenoid Scripting dokumentációt.
item
item
...
SignalService
A Hot-standby megoldást implementáló szervíz konfigurációja, illetve a csatlakó JGroups5 modul beállításai. A következő 3 tulajdonság egyikének, illetve a server-list elemnek kell benne lennie:
1) jchannel:file
A csatorna konfiguriációját5 tartalmazó fájl útvonala.
2) jchannel:simple
A csatorna egyszerű konfigurációját5 tartalmazó szöveg.
3) jchannel:config
A csatorna XML konfigurációja.5
server-list
Szerverek listáját felsoroló rész.
server (Attribútuma: priority=”num” )
Egy szervert reprezentáló elem. A priority attribútum a szerver prioritását határozza meg, a nagyobb a fontosabb.
host
A szerver csatorna host címe.
port
A szerver csatorna portja.
License
A Licensszel kapcsolatos konfiguráció.
stick-serial
A mellékelt CodeMeter USB kulcs sorozatszáma.
firmcode
A gyártó kódja: 101459.
productcode
A termék kódja: 10.
SocketService
Az Algorex adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
BACnetCommunicationService
A BACnet adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
timeout
A BACnet-es kapcsolat timeout-ja. (milliszekundum)
Alapértelmezett: 5000.
instancenumber
A szerver BACnet azonosítója, alapértelmezetten: 100.
address
Broadcast cím, erre küldi ki a központokat kereső üzeneteket a szerver.
Alapértelmezetten: 255.255.255.255
localbindaddress
A helyi host címe, alapértelmezetten: 0.0.0.0
port
A BACnet port, alapértelmezetten: 47808.
CerbanSocketService
A Cerban adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
SIACommunicationService
A SIA adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
AndroidService
Az Android klienseket kezelő szervíz konfigurációja.
bindaddress
A helyi host címe, alapértelmezetten a lokális host.
listenport
A kapcsolatokat váró port száma, alapértelmezetten: 5559.
maxmapsize
A térképek maximális mérete (szélesség és magasság), alapértelmezetten: 1024.
IECService
Az IEC101 protokollal kapcsolatos szervíz konfigurációja.
configuration
A szükséges beállításokat tartalmazó fájl elérési útja.

1 log4J XML konfiguráció:
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/DOMConfigurator.html

2 Torque konfiguráció:
http://db.apache.org/torque/releases/torque-3.3/runtime/reference/initialisation-configuration.html
Az itt leírtak a Properties fájlból való konfigurációra vonatkoznak, mely könnyedén átfordítható XML-lé:
A tulajdonságokban szereplő pontok az XML-ben egy-egy gyerek elemet jelentenek, pl.:
torque.default.connection.driver <> <torque><defaults><connection><driver>...</driver></conn...

3 HA-JDBC dialektusok:
http://ha-jdbc.sourceforge.net/doc.html#dialect

4 Cron ütemező konfigurálása:
http://www.quartz-scheduler.org/docs/tutorials/crontrigger.html

5 JGroups csatorna konfiguráció:
http://www.jgroups.org/manual/html/user-advanced.html#d0e2444
Protokolok listája:
http://www.jgroups.org/manual/html/protlist.html
Egyéb információ:
http://community.jboss.org/wiki/JGroups

Config file parameters

2010-09-25T07:27:27Z

91.82.214.70: Created page with 'Szerver parancssori paraméterei: A szerver indításához minimálisan a java -jar Siwenoid.jar parancs szükséges. A további paramétereket a java és a -jar közé kell meg…'

Szerver parancssori paraméterei:

A szerver indításához minimálisan a java -jar Siwenoid.jar parancs szükséges. A további paramétereket a java és a -jar közé kell megadni. Főbb beállítási lehetőségek:
-Dsiwenoid.registry.port=1099
A szerver saját magát menedzselő RMI portja, ezen keresztül tudja például ellenőrizni induláskor, hogy fut-e már másik példány a számítógépen. Alapértelmezetten: 1099.
-Dhajdbc.home=..path..
Ezzel a beállítással lehet befolyásolni, hogy a HA-JDBC modul hol keresse a konfigurációs fájlját. (Általában nem kell megváltoztatni az alapértelmezettet.)
-Xms128m
A szerver induláskor ennyi memóriát foglaljon le.
-Xmx1024m
A szerver a futása során legfeljebb ennyi memóriát használhat. Az 1024m azt jelenti, hogy maximum 1024 MB. A javasolt beállítás kisebb rendszereknél -Xmx512m nagyobbaknál -Xmx1024m.

További parancssori argumentumok (a parancs után kell írni őket szóközzel elválasztva):
-start
Elindítja a szervert (ez az alapértelmezett).
-stop
Leállítja a futó szervert.
-restart
Újraindítja a futó szervert.
-version
Kiírja a szerver verziószámát.

Szerver oldali XML konfiguráció:

Siwenoid
Gyökér elem, az XML szabvány szempontjából fontos, minden dokumentumnak pontosan egy gyökere van.
Services
A szerver által használt szervízek sorrendhelyes felsorolása. Ez alatt minden egyes elem Tag-je a szervíz osztályának egyszerű neve, tartalma pedig az osztály teljes (minősített) neve. Pl.:
<CacheService>hu.siwena.services.cache.CacheService</CacheService>
<DatabaseService>hu.siwena.services.database.DatabaseService</DatabaseService>
...
LoggerService
A logolásért felelős szervíz konfigurációja, a log4J modulnak megfelelően.1 Legegyszerűbb konfigurációja például:
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
<appender name="root_fileappender" class="org.apache.log4j.DailyRollingFileAppender">
<param name="File" value="log/siwenoid.log"/>
<param name="Append" value="true"/>
<param name="ImmediateFlush" value="true"/>
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="[%d] - %m%n"/>
</layout>
</appender>
<logger name="hu.siwena">
<level value="info"/>
<appender-ref ref="root_fileappender"/>
</logger>
<appender name="dbappender" class="hu.siwena.services.database.synchronization.DatabaseErrorAppender">
<layout class="org.apache.log4j.PatternLayout">
<param name="ConversionPattern" value="%m%n"/>
</layout>
</appender>
<logger name="net.sf.hajdbc">
<level value="debug"/>
<appender-ref ref="dbappender"/>
</logger>
<root>
<level value="error"/>
</root>
</log4j:configuration>
DatabaseService
Az adatbázist kezelő szervíz konfigurációja.
database (Attribútumok: id=”str” host=”str” port=”num” )
Ilyen Tag-ekkel kell felsorolni a rendszerhez kapcsolódó adatbázisokat, az id tetszőleges, de egyedi kell legyen.
torque
A Torque modul konfigurációját tartalmazza a szabványnak megfelelően.2
Több adatbázis esetén ez a rész nem szükséges, csak a ha-jdbc.
<applicationRoot>.</applicationRoot>
Az alkalmazás gyökere, mindig “.” az értéke.
defaults
Alapértelmezett értékek, konfigurációs beállítások.
pool
Szálakkal kapcsolatos beállítások.
<maxWait>10000</maxWait>
Maximum várakozási idő, mielőtt egy kapcsolódás meghiúsulna (milliszekundum).
<maxIdle>20</maxIdle>
Várakozó szálak maximális száma.
<maxActive>50</maxActive>
Aktív szálak (kapcsolatok) maximális száma.
<timeBetweenEvictionRunsMillis>300000</timeBetweenEvictionRunsMillis>
<minEvictableIdleTimeMillis>3600000</minEvictableIdleTimeMillis>
connection
Az adatbázis kapcsolat beállításai.
driver
Az adatbáziskezelőhöz tartozó Java Driver.
MySQL: com.mysql.jdbc.Driver�PostgreSQL: org.postgresql.Driver
url
Az adatbáziskezelő JDBC URL-je.
MySQL: jdbc:mysql://host:port/adatbazisnev�PostgreSQL: jdbc:postgresql://host:port/adatbazisnev
user
Az adatbázishoz csatlakozó felhasználó neve.
password
Az adatbázishoz csatlakozó felhasználó jelszava.
database
Adatbázis tulajdonságai.
default
Az alapértelmezett adatbázis (logikai) neve
[az_előző_pontban_megadott_név]
adapter
Az adatbázist kezelő adapter neve, keresd a Torque dokumentációjában. Leggyakrabban a mysql vagy postgresql adaptereket használjuk.
dsfactory
DataSourceFactory - A Torque használja, javasolt az alább Factory használata.
[alapértelmezett_adatbazis_neve]
<factory>org.apache.torque.dsfactory.SharedPoolDataSourceFactory</factory>
<idbroker.clever.quantity>true</idbroker.clever.quantity>
<manager.useCache>true</manager.useCache>
ha-jdbc (Attríbutuma: cluster=”str” )
Több adatbázis együttes kezelésekor szükséges, a cluster paraméter egy tetszőleges logikai név, pl.: SiwenoidDbCluster. Egy adatbázis esetén ez a rész nem szükséges, de ha ez nincs beállítva, akkor a torque résznek kell megfelelőnek lennie.
<sync id="tetszőleges" class="hu.siwena.services.database.synchronization.CustomDifferentialSynchronizationStrategy"/>
Adatbázisok szinkronizálását végző osztály konfigurálása.
cluster
Az adatbázis cluster konfigurálása.
Attribútumai:
balancer="simple"
default-sync="fentebb megadott sync id attribútumának értéke"
dialect="mysql" lehet pl. postgresql is, lásd a HA-JDBC dokumentációját 3
meta-data-cache="lazy"
transaction-mode="parallel"
max-threads="5"
auto-activate-schedule="0 0/1 * * * ?"
Az adatbázisok aktiválását végző Cron ütemező futási idő konfigurációja.4
failure-detect-schedule="0/15 * * * * ?"
Az adatbázisok kiesését vizsgáló Cron ütemező futási idő konfigurációja.4
Gyerek elemek:
database (Attribútuma: id=”a fentebb megadott id-k egyike” )
Egy-egy adatbázist reprezentáló elem.
driver
Lásd torque.defaults.connection.driver.
url
Lásd torque.defaults.connection.url.
user
Lásd torque.defaults.connection.user.
password
Lásd torque.defaults.connection.password.
database
....
DataPointService
Az adatpontokkal kapcsolatos szervíz konfigurációja, ez definiálja a használandó adatpont kezelőket is.
rootcontainername
A gyökér konténer neve, alapértelmezetten root.
systemcontainername
A rendszer konténer neve, alapértelmezetten system.
pre-cache
Töltse-e be az adatpontokat és gyerek listáikat automatikusan a cache-be induláskor. Az alapértelmezett érték: false. Lehetséges értékek: true vagy false.
import-memory-opts
Az adatpont importáló alkalmazás indításakor használandó memóriaszabályzó paraméter. Pl. -Xmx512m azt jelenti, hogy az alkalmazás max. 512 MB memóriát fog tudni használni.
Az alapértelmezett érték: -Xmx512m.
datapointhandlers
Adatpontkezelők felsorolása. Minden “item” Tag-be egy-egy kezelő teljes (minősített) nevét kell írni.
item
item
...
Például:
<item>hu.siwena.services.datapoint.handlers.SystemHandler</item>
<item>hu.siwena.services.datapoint.handlers.AlgorexHandler</item>
SystemHandler
A rendszer-adatpontokat kezelő osztály konfigurációja.
type (Attribútumai: id=”adatpont_típus” )
Az adatpont típus lehetséges értékei:
1 szerver
2 adatbázis
16 kliens számláló
17 kliens
Az elem tartalma egy eseménykategória azonosítója, ebbe a kategóriába fog tartozni az a treatment, amellyel az adatbont normálistól eltérő állapotai kerülnek.
AlgorexHandler és AlgorexMultiportHandler
Az Algorex protokollal operáló adatpontok kezelője, illetve ennek a Hot-standby párja konfigurációi.
sockettimeout
Az alközponthoz kapcsolódás timeout-ja.
socketkeepalive
Az életjel telegram értéke, minden esetben 0x01.
BACnetHandler
A BACnet protokollal kommunikáló adatpontok kezelőjének konfigurációja.
disabled-types
Az import során az itt felsorolt típusú elemek figyelmen kívül hagyja.
item
Értéke a tiltandó típus neve, pl.: EO_FI_ZoneManualElem
item
...
CerbanHandler és CerbanMultiportHandler
A Cerban protokollal működő adatpontok kezelője, illetve ennek a Hot-standby párja konfigurációi.
sockettimeout
Az alközponthoz kapcsolódás timeout-ja.
socketkeepalive
Az életjel telegram értéke, minden esetben 0x01.
SIAHandler
A SIA protokolhoz tartozó adatpontok kezelőjének konfigurációja.
Egyelőre nincs konfigurációs lehetőség.
RmiService
A szerver-kliens kapcsolatokat kezelő szervíz konfigurációja.
port
A kapcsolatokat fogadó (Registry) port száma. Alapértelmezett értéke: 1899.
sessiontimeout
A kapcsolatok elévülési ideje, ennyi (milliszekundum) inaktivitás után bontja a kapcsolatot a szerver. Alapértelmezetten: 6000.
sessioncheckperiod
A kapcsolatok elévülését ellenőrző ütemező periódusideje. Alapértelmezetten: 5000.
clientcount
Az egyszerre csatlakozott kliensek elvárt száma.
separate-acknowledge
Lehetséges értékei: true vagy false, alapértelmezetten: true.
Igaz értéke esetén minden kliensen külön-külön le kell nyugtázni egy új eseményt, hamis értéke esetén valamely kliens nyugtája az összes kliensen nyugtázza az eseményt.
pre-cache
Lehetséges értékei: true vagy false, alapértelmezetten: false.
Igaz értéke esetén induláskor betölti cache-be a treatmentek és parancsok listáját.
enabled-locales
Az engedélyezett nyelvek kódjainak felsorolása. Alapértelmezetten: en és hu.
item
item
...
event-log
Eseménymemóriával kapcsolatos konfiguráció. (Opcionális)
limit
Az eseménymemória mérethatára, ez felett kerül archiválásra. Alapértelmezetten: 50000.
starttime
Az eseménymemóri vizsgálatának kezdete naponta (óra:perc). Alapértelmezetten a szerver indulásakor indul az ütemezés.
AuthenticationService
A felhasználók kezelésével kapcsolatos szervíz konfigurációja.
administrator
Az adminisztrátor felhasználóra vonatkozó információk, amennyiben a felhasználó még nem létezik, ezekkel az adatokkal fogja létrehozni. A belépési információkat (felhasználónév, jelszó) első indításkor fogja kérni a szerver.
firstname
lastname
email
language
A felhasználói felület nyelvének kódja.
ScriptService
A scriptek futtatásáért felelős szervíz konfigurációja.
categories
Script kategóriák felsorolása, lásd a Siwenoid Scripting dokumentációt.
item
item
...
apis
Script API-k felsorolása, lásd a Siwenoid Scripting dokumentációt.
item
item
...
SignalService
A Hot-standby megoldást implementáló szervíz konfigurációja, illetve a csatlakó JGroups5 modul beállításai. A következő 3 tulajdonság egyikének, illetve a server-list elemnek kell benne lennie:
1) jchannel:file
A csatorna konfiguriációját5 tartalmazó fájl útvonala.
2) jchannel:simple
A csatorna egyszerű konfigurációját5 tartalmazó szöveg.
3) jchannel:config
A csatorna XML konfigurációja.5
server-list
Szerverek listáját felsoroló rész.
server (Attribútuma: priority=”num” )
Egy szervert reprezentáló elem. A priority attribútum a szerver prioritását határozza meg, a nagyobb a fontosabb.
host
A szerver csatorna host címe.
port
A szerver csatorna portja.
License
A Licensszel kapcsolatos konfiguráció.
stick-serial
A mellékelt CodeMeter USB kulcs sorozatszáma.
firmcode
A gyártó kódja: 101459.
productcode
A termék kódja: 10.
SocketService
Az Algorex adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
BACnetCommunicationService
A BACnet adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
timeout
A BACnet-es kapcsolat timeout-ja. (milliszekundum)
Alapértelmezett: 5000.
instancenumber
A szerver BACnet azonosítója, alapértelmezetten: 100.
address
Broadcast cím, erre küldi ki a központokat kereső üzeneteket a szerver.
Alapértelmezetten: 255.255.255.255
localbindaddress
A helyi host címe, alapértelmezetten: 0.0.0.0
port
A BACnet port, alapértelmezetten: 47808.
CerbanSocketService
A Cerban adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
SIACommunicationService
A SIA adatpont kezelőhoz tartozó kommunikációs szervíz konfigurációja.
poolsize
Párhuzamos szálak száma, események érkezésekor.
Alapértelmezetten: 5.
AndroidService
Az Android klienseket kezelő szervíz konfigurációja.
bindaddress
A helyi host címe, alapértelmezetten a lokális host.
listenport
A kapcsolatokat váró port száma, alapértelmezetten: 5559.
maxmapsize
A térképek maximális mérete (szélesség és magasság), alapértelmezetten: 1024.
IECService
Az IEC101 protokollal kapcsolatos szervíz konfigurációja.
configuration
A szükséges beállításokat tartalmazó fájl elérési útja.

1 log4J XML konfiguráció:
http://logging.apache.org/log4j/1.2/apidocs/org/apache/log4j/xml/DOMConfigurator.html

2 Torque konfiguráció:
http://db.apache.org/torque/releases/torque-3.3/runtime/reference/initialisation-configuration.html
Az itt leírtak a Properties fájlból való konfigurációra vonatkoznak, mely könnyedén átfordítható XML-lé:
A tulajdonságokban szereplő pontok az XML-ben egy-egy gyerek elemet jelentenek, pl.:
torque.default.connection.driver <> <torque><defaults><connection><driver>...</driver></conn...

3 HA-JDBC dialektusok:
http://ha-jdbc.sourceforge.net/doc.html#dialect

4 Cron ütemező konfigurálása:
http://www.quartz-scheduler.org/docs/tutorials/crontrigger.html

5 JGroups csatorna konfiguráció:
http://www.jgroups.org/manual/html/user-advanced.html#d0e2444
Protokolok listája:
http://www.jgroups.org/manual/html/protlist.html
Egyéb információ:
http://community.jboss.org/wiki/JGroups