Server Startup Procedure

As of version 8.6 (released in October 2008), the LumenVox Engine (both client and server) perform a series of checks when initialized. If these checks fail, it can cause the application to terminate. If your application is crashing at startup, it is likely related to one of these items.

This procedure applies to the LumenVox Speech Engine Server, the process that actually performs the decodes (lv_sre_server). The speech client (the SpeechPort interface library) has its own startup procedure.

1. Determines the location of the ServerStartupLog.txt that will be generated by the startup check. This will be located in the folder determined by the LVLOGS value from lumenvox_settings.conf.
2. Creates the ClientStartupLog.text log file, overwriting any previous contents, allowing only the last startup to be recorded, so that this file does not grow to an unmanageable size.
3. Verifies that there is a valid LVLANG directory. This is the path specified by the value of LANGDIR in lumenvox_settings.conf. If any errors are detected, a log message will be added to the API log before returning with an error to the calling application.
4. The application checks to ensure that a directory called BuiltinGrammars exists inside of the directory specified by the LANGDIR setting. Any errors are logged and an error code is returned to the calling application.
5. This folder is checked to ensure it contains the following items:
   • ABNFBoolean.gram
   • ABNFCurrenty.gram
   • ABNFDate.gram
   • ABNFDigits.gram
   • ABNFNumber.gram
   • ABNFPhone.gram
   • ABNFTime.gram
6. The application checks to ensure there is an LVLANG/Dict folder, and that this directory contains at least one .model data file.
7. It checks to ensure there is an LVLANG/Grammars folder, and that the folder contains the grammar.dtd and SRGS_to_ABNF.xsl files.
8. The application checks to ensure there is a valid LVLANG/VadModels folder and that it contains the following files:
• bab.code
• baby.code
• back.code
• back1.code
• bell.code
• bird.code
• breath.code
• chan.code
• CosTable.txt
• dtmf.code
• gspeech.code
• kmusic.code
• music.code
• nonspeech.code
• phone.code
• rtp.code
• SinTable.txt
• speech.code
• throat.code
9. The application checks that a server configuration file exists. This is specified by the value of SRE_SERVER_CONFIG in the lumenvox_settings.conf file.
10. It checks to confirm that the /etc/lumenvox/lumenvox_settings.conf file exists, and that the CACHEDIR parameter has a value.