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 validationMode (BeforeEncoding | AfterDecoding | Always | Never) #IMPLIED validationDepth (Complete | FirstError) #IMPLIED fixMode (BeforeEncoding | AfterDecoding | Always | Never) #IMPLIED ignoreFlagsOnValidation (yes | no) #IMPLIED>
   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    validationMode:          Sets the validation mode. Default is 'AfterDecoding'.
  16    validationDepth:         Sets the validation depth. Default is 'FirstError'.
  17    fixMode:                 Sets the fix mode. Default is 'BeforeEncoding'.
  18    ignoreFlagsOnValidation: Ignore flags during message validation. Default is 'no'.
  19 -->
  20
  21 <!ELEMENT node EMPTY>
  22 <!ATTLIST node originHost CDATA #REQUIRED applicationId CDATA #REQUIRED originRealm 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>
  23 <!--
  24    Node record
  25
  26    originHost:                              Node identifier as diameter application host name.
  27    applicationId:                           The Application-Id provided must exists as a registered 'stack id'.
  28    originRealm:                             Origin-Realm (domain-name internally used by default).
  29    cer:                                     User defined CER path file to be encoded to establish diameter connections.
  30                                             If missing, will be harcoded.
  31    dwr:                                     User defined DWR path file to be encoded for diameter protocol keep alive.
  32                                             If missing, will be harcoded.
  33    allowedInactivityTime:                   Milliseconds for the maximum allowed inactivity time on server sessions born over the
  34                                             local server before being reset. If missing, default value of 90000 will be assigned.
  35    tcpConnectDelay:                         Milliseconds to wait TCP connect to any server. If missing, default value of 200 will
  36                                             be assigned.
  37    answersTimeout:                          Milliseconds to wait pending application answers from diameter peers. If missing,
  38                                             default value of 10000 will be assigned.
  39    ceaTimeout:                              Milliseconds to wait CEA from diameter server. If missing, default value of 'answersTimeout'
  40                                             will be assigned.
  41    watchdogPeriod:                          Milliseconds for watchdog timer (Tw) for diameter keep-alive procedure. If missing, default
  42                                             value of 30000 will be assigned.
  43    entity:                                  Target diameter entity (comma-separated '<address>:<port>' format).
  44                                             For example: 10.20.30.40:3868,10.20.30.41:3868. If missing, no entity will be enabled.
  45    entityServerSessions:                    Diameter entity server sessions (0: diameter entity disabled). Default value of 1.
  46    diameterServer:                          Diameter own server address in '<address>:<port>' format. For example: 10.20.30.40:3868.
  47                                             If missing, no local server will be enabled.
  48    diameterServerSessions:                  Diameter own server available connections (0: diameter server disabled). Default value of 1.
  49                                             Negative value implies no limit accepting incoming connections.
  50    balance:                                 Balance over entity servers instead of doing standard behaviour (first primary, secondary
  51                                             if fails, etc.). Default value 'no'.
  52    sessionBasedModelsClientSocketSelection: By default, round-robin will be applied for IEC model (SMS/MMS), and Session-Id Low Part
  53                                             will be analyzed for ECUR/SCUR model (data, voice and content). You could change ECUR/SCUR
  54                                             analysis behaviour providing 'SessionIdHighPart', 'SessionIdOptionalPart' (atoi applied;
  55                                             usually subscriber id data, i.e. MSISDN or IMSI) and 'RoundRobin' (also 'SessionIdLowPart')
  56    retries:                                 Expired responses will cause a number of request retransmissions. Disabled by default (0 retries).
  57    log:                                     Process log file (operations result, traffic log, etc.). By default '<originHost>.launcher.log'.
  58                                             Empty string or "null" name, to disable. Warning: there is no rotation for log files
  59                                             (use logrotate or whatever you consider).
  60    splitLog:                                Splits log file (appends to log filename, extensions with the type of event: see help on
  61                                             startup information-level traces). No log files for code/decode and load operations are created.
  62                                             Default value 'no'.
  63    detailedLog:                             Insert detailed information at log files (timestamps, communication resources, etc.). Useful
  64                                             to analyze the messages flow along the sockets (specially on 'balance' mode). Default 'no'.
  65    dumpLog:                                 Write to disk every incoming/outcoming message named as:
  66                                                '<unix ms timestamp>.<originHost>.<hop by hop>.<end to end>.<message code>.<request|answer>.<type of event>.xml'
  67                                             Default value 'no'.
  68    burstLog:                                Burst operations log file. By default '<originHost>.launcher.burst'. Empty string or "null" name, to disable.
  69                                             Warning: there is no rotation for log files (use logrotate or whatever). Output: dot (.) for each
  70                                             burst message sent/pushed, cross (x) for popped ones, and order number when multiple of 1% of burst
  71                                             list size, plus OTA requests when changed.
  72
  73 -->
  74