Configuring Vocalizer

To set up licensing and other configuration parameters, create and activate a Vocalizer configuration file during installation.

• The file is an XML document that overrides the default configuration settings on the Vocalizer host.
• By convention, the filename tts_config.xml, but you can use a different name.

To create the file, follow these general steps:

1. Create a file named tts_config.xml in a location outside of Vocalizer’s installation path.

   The easiest way to create the file is to copy the default configuration in config\baseline.xml and delete all parameters except the ones you want to modify.

   Sample with description:

   <?xml version="1.0" encoding="ISO-8859-1"?>

   <?xml-stylesheet type="text/xsl" href="ttsconfig.xsl"?>

   <ttsconfig version="5.5.0"

   xmlns="http://www.nuance.com/nvn55/ttsconfig">

     <tts_license_ports>100</tts_license_ports>

     <tts_license_ports_overdraft_thresh>90

       </tts_license_ports_overdraft_thresh>

     <cpr_license_ports>100</cpr_license_ports>

     <cpr_license_ports_overdraft_thresh>90

       </cpr_license_ports_overdraft_thresh>

     <license_servers>

       <server>27000@localhost</server>

     </license_servers>

   </ttsconfig>

   Values in the configuration file can reference variables, specified with the variable name inside "${…}". For example, for the Vocalizer installation directory, use: ${VOCALIZER_SDK}

   The variables can be any environment variable, or any of the special variables discussed in Categories of Vocalizer parameters.

   The file begins with a standard XML declaration:

   <?xml version="1.0" encoding="ISO-8859-1"?>

   Optionally, insert a style sheet declaration for viewing the file in a Web browser:

   <?xml-stylesheet type="text/xsl" href="ttsconfig.xsl"?>

   The header includes the root element of the document (specified in the DTD, document type declaration); that is, the container element for parameter elements, <ttsconfig>.

   <ttsconfig version="5.5.0" 

     xmlns="http://www.nuance.com/nvn55/ttsconfig">

   The main body of the file contains one or more parameter elements, for example:

   <tts_license_ports>100</tts_license_ports>

   <tts_license_ports_overdraft_thresh>90

    </tts_license_ports_overdraft_thresh>

   <cpr_license_ports>100</cpr_license_ports>

   <cpr_license_ports_overdraft_thresh>90

    </cpr_license_ports_overdraft_thresh>

   <license_servers>

   <server>27000@localhost</server>

   </license_servers>

2. Specify values for the licensing parameter. For a licensing overview, see Setting up licenses.
3. Activate the configuration file.
   • Define the $VOCALIZER_USERCFG environment variable and set it to the file’s full path including the filename. For example:

     > setenv VOCALIZER_USERCFG "/home/jruser/tts_config.xml"

   • Specify the location of the file in the command line when starting up the Vocalizer server instance, by setting the nserver.nvs.VocalizerUserCfgFile option. For example:

     > nuance-server -servlet nvs -port 9200 
         nserver.nvs.VocalizerUserCfgFile=/home/jruser/tts_config.xml

4. (Optional) In the future, insert additional parameters as needed (and restart Vocalizer to load the new values).