Changing the location of logs

The system stores call logs, diagnostic logs, and various data files under a base directory (NUANCE_DATA_DIR), and sets the environment variable to:

Windows: C:\ProgramData\Nuance\Enterprise

Linux: /var/local/Nuance

Most diagnostic logs are saved to $NUANCE_DATA_DIR/system/diagnosticLogs or $NUANCE_DATA_DIR/company-name/diagnosticLogs (if you separate logs for each company you support).

Exception — the NTpE diagnostic logs are stored in $TEXTPROC_HOME/logs (or as configured via log : logFileDir)

  • For call logs, system administrators control the initial installation and configuration by specifying the base storage location. See Configuring call logging.

Note: You cannot change these storage locations by changing the definition of the environment variable. Instead, use the following procedures to move all data folders recursively to the new location. By moving everything, you simplify troubleshooting because the new location is transparent: Speech Suite components and administration users can refer to the original path without error.

Changing locations on Windows

To change the logging location (including call logs, diagnostic logs, file caches, and configuration files):

  1. Stop all Speech Suite services.
  2. If running, stop the Management Station and Watcher service.
  3. Move existing files from the default location to the new location. For example, this command copies and retains the same file permissions: 
    xcopy /Bhekox C:\ProgramData\Nuance E:\myPath\myNewLocation
  4. Rename C:\ProgramData\Nuance to C:\ProgramData\Nuance.old or C:\ProgramData\Nuance.bkup. (The C:\ProgramData\Nuance folder must not exist when your create the symbolic link below.)
  5. Create a symbolic link from the default location to the new location (you must have the Create symbolic links user right). The symbolic link ensures that all Speech Suite components write to the new location. For example:
    mklink /D C:\ProgramData\Nuance\ E:\myPath\myNewLocation
  6. If used, restart the Management Station and Watcher service.
  7. Restart all Speech Suite services.

Changing locations on Linux

Speech Suite components run under user nuance and group nuance, and write output (diagnostic logs, call logs, and other data) to folders under $NUANCE_DATA_DIR (this directory belongs to user/group nuance). If you configure any component to write to other directories outside of $NUANCE_DATA_DIR, they must allow write permission to user and group “nuance.” This restriction also applies to any third-party application servers that the Management Station watches. Each application server requires write permission for the same directories to which user or group “nuance” can write.

To change the logging location (including call logs, diagnostic logs, file caches, and configuration files):

  1. Stop all Speech Suite services.
  2. Create the new location folder (the folder owner must be "nuance"). For example:
    mkdir /myPath/myNewLocation
  3. Change directory to the current logging location, copy all data to the new location (while keeping the same file permissions). Optionally, create a backup copy of the data. For example:
    cd /var/local
    cp -Ra Nuance /myPath/myNewLocation
    mv Nuance Nuance.old
    #change directory to the NUANCE_DATA_DIR root
    #copy existing data to the new location while keeping the same file permissions
    #create a backup copy (could also use .bak here)
  4. Create a symbolic link from the default location to the new location. This ensures that all Speech Suite components write to the new location. For example:
    ln -s /myPath/myNewLocation/Nuance Nuance
  5. Restart all Speech Suite services.