Fixes and improvs. Basic DRA feature.
[anna.git] / example / diameter / launcher / resources / services_examples / services.dtd
1 <?xml version="1.0" encoding="UTF-8"?>
2 <!-- Diameter services DTD -->
3
4 <!ELEMENT services (stack*, node*)>
5
6 <!ELEMENT stack EMPTY>
7 <!ATTLIST stack id CDATA #REQUIRED dictionary CDATA #REQUIRED>
8 <!--
9    Stack record
10
11    id:         Normally the id corresponds to the Application-Id for which the dictionary provided is designed
12                (in multistack applications, it shall be mandatory respect such association to know the stack used
13                for processed messages).
14    dictionary: Path to the dictionary file
15 -->
16
17 <!ELEMENT node EMPTY>
18 <!ATTLIST node originRealm CDATA #REQUIRED originHost CDATA #IMPLIED cer CDATA #IMPLIED dwr CDATA #IMPLIED allowedInactivityTime CDATA #IMPLIED tcpConnectDelay CDATA #IMPLIED answersTimeout CDATA #IMPLIED ceaTimeout CDATA #IMPLIED watchdogPeriod CDATA #IMPLIED entity CDATA #IMPLIED entityServerSessions CDATA #IMPLIED diameterServer CDATA #IMPLIED diameterServerSessions CDATA #IMPLIED balance (yes | no) #IMPLIED sessionBasedModelsClientSocketSelection (SessionIdLowPart | SessionIdHighPart | SessionIdOptionalPart | RoundRobin) #IMPLIED retries CDATA #IMPLIED log CDATA #IMPLIED splitLog (yes | no) #IMPLIED detailedLog (yes | no) #IMPLIED dumpLog (yes | no) #IMPLIED burstLog (yes | no) #IMPLIED>
19 <!--
20    Node record
21
22    originRealm:                             Node identifier (Origin-Realm name).
23    originHost:                              Diameter application host name (system name). If missing, process sets o.s. hostname
24                                             Note that if you have two or more realms, the names must be different.
25    cer:                                     User defined CER path file to be encoded to establish diameter connections.
26                                             If missing, will be harcoded
27    dwr:                                     User defined DWR path file to be encoded for diameter protocol keep alive.
28                                             If missing, will be harcoded
29    allowedInactivityTime:                   Milliseconds for the maximum allowed inactivity time on server sessions born over the
30                                             local server before being reset. If missing, default value of 90000 will be assigned
31    tcpConnectDelay:                         Milliseconds to wait TCP connect to any server. If missing, default value of 200 will
32                                             be assigned
33    answersTimeout:                          Milliseconds to wait pending application answers from diameter peers. If missing,
34                                             default value of 10000 will be assigned
35    ceaTimeout:                              Milliseconds to wait CEA from diameter server. If missing, default value of 'answersTimeout'
36                                             will be assigned
37    watchdogPeriod:                          Milliseconds for watchdog timer (Tw) for diameter keep-alive procedure. If missing, default
38                                             value of 30000 will be assigned
39    entity:                                  Target diameter entity (comma-separated '<address>:<port>' format).
40                                             For example: 10.20.30.40:3868,10.20.30.41:3868. If missing, no entity will be enabled
41    entityServerSessions:                    Diameter entity server sessions (0: diameter entity disabled). Default value of 1
42    diameterServer:                          Diameter own server address in '<address>:<port>' format. For example: 10.20.30.40:3868.
43                                             If missing, no local server will be enabled
44    diameterServerSessions:                  Diameter own server available connections (0: diameter server disabled). Default value of 1
45    balance:                                 Balance over entity servers instead of doing standard behaviour (first primary, secondary
46                                             if fails, etc.). Default value 'no'
47    sessionBasedModelsClientSocketSelection: By default, round-robin will be applied for IEC model (SMS/MMS), and Session-Id Low Part
48                                             will be analyzed for ECUR/SCUR model (data, voice and content). You could change ECUR/SCUR
49                                             analysis behaviour providing 'SessionIdHighPart', 'SessionIdOptionalPart' (atoi applied;
50                                             usually subscriber id data, i.e. MSISDN or IMSI) and 'RoundRobin' (also 'SessionIdLowPart')
51    retries:                                 Expired responses will cause a number of request retransmissions. Disabled by default (0 retries)
52    log:                                     Process log file (operations result, traffic log, etc.). By default '<originRealm>.launcher.log'.
53                                             Empty string or "null" name, to disable. Warning: there is no rotation for log files
54                                             (use logrotate or whatever you consider)
55    splitLog:                                Splits log file (appends to log filename, extensions with the type of event: see help on
56                                             startup information-level traces). No log files for code/decode and load operations are created.
57                                             Default value 'no'
58    detailedLog:                             Insert detailed information at log files. Should be disabled on automatic tests. Useful on
59                                             'balance' mode to know messages flow along the sockets. Default value 'no'
60    dumpLog:                                 Write to disk every incoming/outcoming message named as:
61                                                '<originRealm>.<hop by hop>.<end to end>.<message code>.<request|answer>.<type of event>.xml'
62                                             Default value 'no'
63    burstLog:                                Burst operations log file. By default '<originRealm>.launcher.burst'. Empty string or "null" name, to disable.
64                                             Warning: there is no rotation for log files (use logrotate or whatever). Output: dot (.) for each
65                                             burst message sent/pushed, cross (x) for popped ones, and order number when multiple of 1% of burst
66                                             list size, plus OTA requests when changed
67
68 -->
69