How do I use AT&T Natural Voices on my xMatters deployment?

My deployment is running Linux and I'm using SIP for voice notifications; how do I configure AT&T Natural Voices on my deployment to produce voice messages from text?

These instructions apply to 32-bit systems only.

NOTE: Using a Text-To-Speech (TTS) engine on Linux deployments requires a separate license key from xMatters; contact your xMatters representative for more information or to purchase the required licensing. You must also have selected the "Install Voice Components" option in the xMatters installer.

xMatters provides two archive files containing the required AT&T Natural Voices components:

  • ATT_NV_Linux_Server_SDK.tar: contains all the server files, including the common tar and gcc* tar files.
  • ATT_NV_Linux_Server_Crystal8.tar: contains the voice font for Crystal.

After downloading the archives to a folder on your local machine, use the following steps to ensure that your deployment is configured appropriately.


First, unpack the ATT_NV_Linux_Server_SDK.tar file:

$ cd <download_dir>  
$ tar xvf ATT_NV_Linux_Server_SDK.tar 

From within the unpacked SDK file, you must always unpack the SERVER_COMMON_TTS1_4_1.TAR file. You must also select one of the GCC specific files (SERVER_GCC###_TTS1_4_1.TAR). To determine which version of GCC (2.9* or 3.*) you are using on the target machine, run the following command:

$ gcc -v  

The version returned by the command will apply to one of the SERVER_GCC###_TTS1_4_1.tar files within the SDK package. For example, if you are running GCC version 2.96, you will need to unpack theSERVER_GCC296_TTS1_4_1.tar file.

  1. To install the server files, unpack the SERVER_GCC###_TTS1_4_1.tar file appropriate to your version of GCC, and the SERVER_COMMON_TTS1_4_1.TAR file directly into the root directory on the target machine.
  2. To install the voice font packages, unpack theATT_NV_Linux_Server_Crystal8.tar file.
    • When installing a single voice font, no further steps are necessary.
    • For multiple voice fonts to work correctly, you must run the voice-setup script after unpacking the voice fonts.

For example, the following commands will create and populate the directory <rootdir>/ATTNaturalVoices/TTS1.4.1/Server (referred to as ), assuming the following:

  • The tar files have been placed in the ;
  • You have GCC version 2.91;
  • And, you are installing the Crystal voice font.
$ cd <rootdir>  
$ tar xvf <download_dir>/SERVER_COMMON_TTS1_4_1.TAR  
$ tar xvf <download_dir>/SERVER_GCC291_TTS1_4_1.TAR  
$ tar xvf <download_dir>/ATT_NV_Linux_Server_Crystal8.tar  

After installation, use the following command to run the server:

$ cd <installdir>/bin  
$ ./TTSServer -r <installdir>/data -c 7000  
  • -c 7000 specifies the port that is to be used by clients (not required to be 7000)
  • -r or -data <installdir>/data specifies where to find voice data and how it should be used.

You may receive the following error message:

Failed to open library:

If this occurs, run the following command:

$setenforce permissive  

(Alternately, you can edit /etc/selinux/config, and change SELINUX to be permissive.)

Sometimes a system restart is required after SELINUX settings are changed.

To start the server so that it will survive beyond the current login session, it is possible to embed the above command line, or <server-command>, within a 'nohup' call:

$ nohup ./bin/TTSServer -c 7000 -x Crystal -v3 -data /deployments/ATTNaturalVoices/TTS1.4.1/Server/

This command also collects any logging or error output from the TTS Server in the file <installdir>/bin/ttslog. Note that, in this case, when the server is no longer needed, it must be terminated using a 'kill' command.


Consult the README_LINUX_SERVER_1_4_1.TXT file included within the archive for complete installation and deployment instructions. Note that you may not need all of the included components for your deployment; different versions of Linux or the GCC will require different components.

xMatters Configuration

Once you have installed the AT&T Natural Voices software, you can configure the xMatters (alarmpoint) engine to use the new TTS engine.

To configure xMatters to use an AT&T Natural Voices voice:

  1. Log in to xMatters as a Super Administrator, and navigate to your SIP Device Engine details.
  2. On the SIP Device Engine details page, in the TTS Engine drop-down list, select Natural Voices.
  3. In the TTS Engine Personality field, type Crystal
  4. In the TTS Engine Server field, type the IP address of the server running Natural Voices.
  5. In the TTS Engine Port field, type the port number used for the Natural Voices server, 7000 in the example above.
  6. Click Save.

xMatters Reference

DTN-2518, PRE-4981, JDN-1401

Originally created by Don Clark

Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk