Configuration during application deployment

When moving an application from a development to a production system, system administrators and application developers configure the target system with application-specific settings, and test the system during a period of gradually increasing number of calls.

For a discussion of the deployment and hosting lifecycle, see Configuring during deployment.

Migrating existing applications

These parameters are useful for applications running on a system updated from a previous release of Nuance Speech Suite.

Parameter	Description	Default
swirec_language_versions	Version of a Recognizer language to use.	(most recent version of each language)
swirec_model_name	Points to custom models for firstpass processing in Recognizer.	(default models are used for each language)
swirec_secondpass_model_name	Acoustic models for secondpass processing in Recognizer.	(default models used)

Troubleshooting during deployment

New applications usually require load testing to evaluate the capacity of the system. Load testing is a measure of the maximum number of simultaneous calls handled by the system without degradation. Nuance recommends turning off the self-learning feature during load testing. This prevents adaptation based on test data and artificial telephone calls.

Parameter	Description	Default
swirec_acoustic_adapt_adapt_model	Disables self-learning for one or more languages.	0 (adaptation enabled)

Set these parameters for troubleshooting purposes during initial deployment while testing and tuning. Restore the default settings after the system is known to be stable.

Parameter	Description	Default
DiagConfigPollSecs	Defines how often to reload the tagmap files from disk.	600 (seconds)
DiagOutputStreamTypes	Writes diagnostic logs to a file, stdout, or both.	debug, file (stdout and file)
DiagTagMapsBaseline	Recognizer’s tagmap files for TRC diagnostic logging.	$SWISRSDK/config/defaultTagmap.txt;$SWISRSDK/config/bwcompatTagmap.txt
DiagTagMapsUser	Application’s tagmap files for custom TRC diagnostic logging.	(empty)

When the system logs waveforms, it either writes all waveforms or some percentage, depending on the values of swiep_waveform_logging_max_channels and swirec.secure_context.

System-wide policy and protection settings

These parameters set system-wide values. They define usage policies for applications, and often they protect the system resources from applications excesses:

Parameter	Description	Default
swiep_min_bytes_to_process	Minimum amount of audio data processed by the endpointer.	800 (bytes)
swirec.secure_context	Sets security levels for protecting confidential data.	open
swirec_acoustic_adapt_min_num_utts	Minimum data for updating acoustic models.	(depends on language)
swirec_acoustic_adapt_model_update_time	When to update recognition models with learned statistics.	0000 (midnight)
swirec_acoustic_adapt_rate	Controls the rate of Recognizer’s self-learning.	(depends on language)
swirec_acoustic_adapt_root	Storage location of self-learning files. Controls sharing of models across the server, tenants, or applications.	(empty)
swirec_acoustic_adapt_suppress_acoustic_model_update	Stops self-learning adaptation of recognition models.	0 (updates enabled)
swirec_ignore_grammar_media_type	A media type used during grammar activation. (It replaces the media type fetched from the server.)	0 (ignore fetched type)
swirec_max_auto_prons	Number of pronunciations to generate automatically when a word is not found.	1 (pronunciations)
swirec_max_source_grammar_size	Maximum allowed size of grammars that can be dynamically compiled.	-1 (unlimited)
swirec_max_training_grammar_size	Limits the CPU and memory cost of SLMs trained at run-time.	-1 (unlimited)
swirec_save_comp_stats	Adds the speech mode attribute to nomatch recognition results (to conform to VoiceXML 2.0).	0 (disabled)

Controlling disk space usage

The parameters control the amount of available disk space. Indirectly, they affect performance associated with caching and swapping to disk.

Parameter	Description	Default
DiagMaxFileSizeKB	Maximum size of the diagnostic log file.	1024 (KB)
swirec_acoustic_adapt_num_archive	How long to save old statistics files.	3 (months)
swirec_disk_cache_low_water_mark	Largest size of the disk and inet caches after cache cleanup.	400 (MB)
swirec_disk_cache_min_entry_size	Minimum size of disk and inet caches entries.	0 (KB)
swirec_disk_cache_size	Desired maximum size of the disk and inet caches.	500 (MB)

Controlling call logs for normal operation

These parameters control the call logs that record events during each session. For complete details, see Logging for Nuance speech products.

Parameter	Description	Default
swirec_waveform_logging_index_digits	The number of digits used in filenames when Recognizer saves waveform files.	2 (limit of 99 files per session)
swirec_waveform_logging_uniform_name	Assigns the same number in the filenames of related waveforms.	0 (disabled)

Controlling memory usage

These parameter control memory shared by Recognizer processes. They are useful when running more than one recognition server on a host:

Parameter	Description	Default
swirec_shmem_address	Base address in memory for Recognizer to use for shared memory.	(empty, the default address is used)
swirec_shmem_enabled	Determines whether recognition servers share memory.	0 (disabled)
swirec_shmem_resource_load_timeout	Maximum time for a process to wait for a resource in shared memory.	30 (seconds)
swirec_shmem_size	Size of the memory region shared by recognition server processes.	0 (automatically determined)
swirec_shmem_warn_threshold	Generates warnings when shared memory is getting filled.	90 (percent)

These parameters control memory used by Recognizer’s grammar cache. Indirectly, they affect performance associated with caching and swapping to disk.

Parameter	Description	Default
swirec_acoustic_adapt_adapt_model	Disables self-learning for one or more languages.	100 (MB)
swirec_memory_cache_low_water_mark	Maximum size of the memory cache after removing grammars to create available space.	0 (adaptation enabled)
swirec_memory_cache_min_entry_size	Minimum size for memory cache entries.	85 (MB)
swirec_memory_cache_size	Desired size of the memory cache.	0 (KB)

Configuration during application deployment

Related topics