Dragon speech recognition Enterprise solution Nuance Management Center Server installation and client configuration guide For: Guide
Copyright 2016 Dragon Professional Group and Dragon Legal Group, 14. This material may not include some last-minute technical changes and/or revisions to the software. Changes are periodically made to the information provided here. Future versions of this material will incorporate these changes. Nuance Communications, Inc. has patents or pending patent applications covering the subject matter contained in this document. The furnishing of this document does not give you any license to such patents.
Contents Configuration and client installation guide i About this guide viii Guide overview ix Audience ix Additional resources x Documentation x Training x Support x Chapter 1: Introduction 1 About Nuance Management Center 2 Physical architecture 3 Chapter 2: Installation checklists 4 Checklist—Planning the server installation 5 Checklist—Planning the client installation 6 Chapter 3: Preparing for your server installation Software requirements—Server 7 8 Application server an
Contents Testing and troubleshooting your SSL configuration 18 Additional Information 19 Chapter 4: Installing the servers Installing SQL Server 21 Installing Nuance Management Center 22 Install 22 Chapter 5: Post-installation tasks 28 Configuring your network switch 29 Verifying the NMS Platform service is running 30 Starting the NMS Platform service manually 30 Logging in to the Nuance Management Center (NMC) console 31 Determining your database backup method 32 Chapter 6: Preparing
Contents Dragon Group hardware recommendations 54 Supported Virtual Desktop infrastructure applications 54 Required skills for installing Dragon Group 55 Dragon File Structure 56 Windows 7, Windows 8.
Contents Checking the optimization status of a user profile 75 Running the Acoustic and Language Model Optimizers from the DragonBar 75 Running the Acoustic and Language Model Optimizer from the Start menu 76 Chapter 13: Working with Custom Commands Using the Convert XML to DAT Tool 79 Starting the Convert XML to DAT tool 79 Convert XML to DAT syntax 79 Use the XML to DAT tool to convert data in an XML file 79 Using the MyCommands Protection Utility 80 Chapter 14: Upgrading the Dragon clien
Contents Installing Dragon on the server and the client 101 Configuring the Windows server 102 Configuring Windows Server 2008 R2 103 Configuring Windows Server 2012 R2 Part 1 107 Configuring Windows 7 Ultimate Server 112 Configuring the Dragon clients 113 User Profiles and using Dragon through a Remote Desktop session 116 Appendix A: Options for MSI Installations MSI options for Dragon installations Sample command lines 117 118 121 Feature variables to set through the ADDLOCAL or ADVERTISE
About this guide Guide overview Audience ix ix Additional resources x Documentation x Training x Support x viii
Dragon Installation Guide Guide overview The Server Installation and Client Configuration Guide provides the following: l Installation and configuration instructions for on-premise Nuance Management Center (NMC) servers. l Configuration instructions for single sign-on authentication. l Installation, configuration, and upgrade instructions for Dragon Group clients.
About this guide Additional resources The following resources are available in addition to this guide to help you manage your Dragon Group installation. Documentation Document Description Location Dragon Group Release Notes New features, system requirements, client upgrade instructions, and known issues. Dragon client Help (Help>Help Topics) Dragon Group Citrix Admin- Hardware, software, and netDragon Support web site: istrator Guide work requirements for deploying http://www.nuance.
Chapter 1: Introduction About Nuance Management Center 2 Physical architecture 3 1
Dragon Installation Guide About Nuance Management Center Nuance Management Center allows Dragon system administrators to manage all Dragon Group clients from a single central console.
Chapter 1: Introduction Physical architecture The physical configuration of Nuance Management Center includes: l l l Application server—The NMC server. Stores user accounts, settings, and administrative information. Can be a single machine, or, in large installations, can be multiple servers load-balanced by a network traffic switch. Can be the Nuance-hosted NMC server in the cloud, or a server that you install and host on-premise.
Chapter 2: Installation checklists Checklist—Planning the server installation 5 Checklist—Planning the client installation 6 4
Dragon Installation Guide Checklist—Planning the server installation If you are installing and managing your own Nuance Management Center (NMC) server and database server onpremise, use this checklist to help you prepare for the installation. Server Task Reference NMC serverand database server Ensure all system requirements have been met. “Software requirements—Server” on page 8 NMC serverand database server Ensure all prerequisites have been met.
Chapter 2: Installation checklists Checklist—Planning the client installation Use this checklist to help you prepare for client installations. Task Reference Assign access to the necessary folders and Registry keys on client machines. “Assigning access ” on page 58 Configure client workstations.
Chapter 3: Preparing for your server installation Software requirements—Server 8 Application server and database server 8 NMC console 8 Hardware requirements—Server 9 Server installation prerequisites 10 Application server and database server 10 NMC console 11 Other considerations 12 Network bandwidth recommendations 12 Excluding files and folders from anti-virus protection 12 Using a network traffic switch 12 Obtaining required server software 13 Opening required ports 14 Install
Dragon Installation Guide Software requirements—Server If you're hosting your own Nuance Management Center (NMC) server and database server on-premise, ensure the servers meet the following software requirements. For Dragon Group client software requirements, see “Software and hardware requirements—Client” on page 54.
Chapter 3: Preparing for your server installation Hardware requirements—Server If you're hosting your own Nuance Management Center (NMC) server and database server on-premise, ensure the servers meet the following hardware requirements.
Dragon Installation Guide Server installation prerequisites In addition to the system requirements, you'll also need the following. Application server and database server Prerequisite Server Additional Information Windows administrator account Application All services should run under this account.
Chapter 3: Preparing for your server installation NMC console Prerequisite Additional Information Full trust privileges None.
Dragon Installation Guide Other considerations Consider the following while you prepare for your NMC server installation. Network bandwidth recommendations Nuance recommends the following network bandwidth speeds for Nuance Management Center.
Chapter 3: Preparing for your server installation Obtaining required server software Click the following links to obtain the required server software. Software Where to download Microsoft .NET Framework 4.5 microsoft.com SQL Server 2008, 2012, or 2014 microsoft.
Dragon Installation Guide Opening required ports You must open the following ports to allow communication between components. Port Location Description 389 TCP NMC server l 443 NMC server l l 1433 Custom 14 Database server l Allows communication between the NMC server and your Active Directory, if you are using single sign-on authentication. Allows communication between Dragon clients and the NMC server. Allows communication between NMC console workstations and the NMC server.
Chapter 3: Preparing for your server installation Installing the SSL certificate About signed certificates About signed certificates Using SSL requires that you obtain a signed SSL certificate from a certificate authority, such as GoDaddy or Verisign. The certificate authority must be a trusted authority known to both the client computer and the server. Nuance Management Center does not support internally generated (self-signed) certificates.
Dragon Installation Guide 2. Note the subject of the certificate. This should match the computer name that the certificate is deployed on, or be a wild card. This must match exactly the host used in the endpoints. For information on viewing the subject, see https://technet.microsoft.com/en-us/library/cc754686(v=ws.10).aspx.
Chapter 3: Preparing for your server installation 3. Note the thumbprint of the certificate. You use the thumbprint to bind the certificate to the port used by the primary NMS services in the next step. For information on retrieving the thumbprint, see https://msdn.microsoft.com/en-us/library/ms734695.aspx. 4. Bind the SSL port (443) used by the services to the certificate. Windows Server 2008 or 2012: a.
Dragon Installation Guide to the appropriate NMC server. Inside the firewall, these messages would be unencrypted, and the NMC server would receive them as HTTP with no SSL encryption. Note: This should only be configured by experienced networking personnel. It requires in-depth knowledge about load-balancing switches, which is outside the scope of this guide. Steps to configure 1. Verify that UseSSL is set to false (this should have been done by the installer): a. In Nuance.NMS.Server.exe.
Chapter 3: Preparing for your server installation Check the Bindings If the NMC console is not working, make sure that the ports are properly bound to the SSL certificate. You can do this by using the "netsh http show sslcert" command to display the current configuration. Be sure that port 443 is bound to the certificate. Additional Information For more information on installing SSL certificates, see: http://msdn.microsoft.com/en-us/library/ms733791.
Chapter 4: Installing the servers Installing SQL Server 21 Installing Nuance Management Center 22 Install 22 20
Dragon Installation Guide Installing SQL Server Use the following settings during your installation: 1. On the Feature Selection screen, select the following features: l Database Engine Services l Management Tools – Basic l Management Tools – Complete Note: While using Nuance Management Centerdoes not require you to install Analysis Services and Reporting Services, these services may help Nuance technical support troubleshoot any issues that occur with your installation or database. 2.
Chapter 4: Installing the servers Installing Nuance Management Center Install all the components of the NMC server on the same machine using a single installation wizard. After the installation is complete, use the console to configure the server. Caution: Even if you do not want to store the data files in SQL Server's default location, allow the installer to create the database, its transaction log, and its dump device in the default location.
Dragon Installation Guide The Choose Destination Location screen appears: 6. Choose where you want to install the NMS platform (default recommended), and then click Next. The Setup Type screen appears: 7. Choose a setup configuration: l l Single-node installations: Select On a server with an SSL certificate installed directly on that server. Multiple-node installations: Select Behind a networking device with an SSL certificate installed. 8. Click Next.
Chapter 4: Installing the servers The wizard installs NMS Suite components. When it is finished, the Database Server screen appears: 9. Enter the required database information: 1. Enter the machine name or IP address of the physical server where you have installed the SQL Database Server software. The wizard creates the database and its backup directory in default locations on that server automatically. 2.
Dragon Installation Guide The wizard installs several NMS Suite components. When it is finished, the Organization Id screen appears: 11. Enter the unique ID that Nuance assigned to your organization. You should have received this ID with your Dragon Group software package. Later, you can access your organization ID in the NMC console. For more information on organization IDs, see the Nuance Management Server Administrator Guide. 12. Click Next. The Enter new password for NMC screen appears: 13.
Chapter 4: Installing the servers The first time you log into the NMC console, use the "admin" login ID with the password you created in this step. 14. Click Next. The Setup Type screen appears: 15. Select the account type under which NMS windows service will run, and then click Next. The Service logon screen appears: 16. Enter the user name and password of the Windows user account under which NMS will run, then click Next.
Dragon Installation Guide The install wizard installs several components, then opens the Choose Destination Location screen for the NMC – InstallShield Wizard: 17. Choose where you want the install wizard to install the NMC console (default recommended), and then click Next. The wizard installs the NMC console. 18. When the installation is complete, click Finish. 19.
Chapter 5: Post-installation tasks Configuring your network switch 29 Verifying the NMS Platform service is running 30 Starting the NMS Platform service manually 30 Logging in to the Nuance Management Center (NMC) console 31 Determining your database backup method 32 28
Dragon Installation Guide Configuring your network switch If you have multiple NMC servers in your environment, you can use a network traffic switch to balance the incoming client activity among your servers. You can configure the switch to make an API call periodically to your servers to ensure they are operational. Configure the switch to make the following API call: http://:443/Nuance.NMS.
Chapter 5: Post-installation tasks Verifying the NMS Platform service is running When the installation completes, the NMS Platform service starts automatically if the Windows administrator account under which it is running has the correct privileges. Post-installation, you should verify that the service is running. To verify, check the Services dialog box on the physical NMC server. If the service is not running, you must start it manually.
Dragon Installation Guide Logging in to the Nuance Management Center (NMC) console Ensure you can log in to the NMC console using the administrator login and password. If you have multiple NMC servers in your environment and you are using a network traffic switch to balance the load, ensure you substitute the name or IP address of the switch for the NMC server name in the URL when you access the NMC console. 1. Open a browser. 2. Enter the NMC console URL in the address bar.
Chapter 5: Post-installation tasks Determining your database backup method The NMC server schedules database backups automatically. However, you can choose to manage database backups yourself and disable the automatic backups. You should determine your database backup method before users begin regular Nuance Management Center use. For more information on Nuance Management Center database backups, see “About database backups” on page 139.
Chapter 6: Preparing for your Active Directory single sign-on configuration Single sign-on overview 34 Before you begin 35 Creating an NMC console Administrator user for Active Directory 37 Setting the Active Directory connection string 38 Creating and configuring user accounts for single sign-on 39 33
Dragon Installation Guide Single sign-on overview You can optionally implement Active Directory single sign-on authentication rather than using the native Nuance Management Center authentication, which requires a separate login and password. With single sign-on, users can simply use their Windows login and password to access the Dragon client and other applications.
Chapter 6: Preparing for your Active Directory single sign-on configuration Before you begin Review the following before beginning your single sign-on configuration. Software requirements—Single sign-on On-premise NMC server If you are hosting your own NMC server on-premise, there are no system requirements. Cloud NMC server If you are using the Nuance-hosted NMC server, you must install the Local Authenticator on a server with the following: l Latest version of the Microsoft .
Dragon Installation Guide Task Reference Create an organization token “Creating organization tokens” on page 42 Install and bind the SSL certificate on the “Installing and binding the SSL certificate” on page 43 Local Authenticator server Install the Local Authenticator “Installing the Local Authenticator” on page 47 Edit the Local Authenticator configuration “Editing the configuration file” on page 51 file Start the Local Authenticator service “Starting the Local Authenticator service” on page 52
Chapter 6: Preparing for your Active Directory single sign-on configuration Creating an NMC console Administrator user for Active Directory To configure Active Directory single sign-on and manage settings, you must create an Administrator user in the NMC console. You cannot use the initial NMC console login that Nuance provides (cloud NMC server), or the login that you create during the NMC console installation (on-premise NMC server).
Dragon Installation Guide Setting the Active Directory connection string 1. In the NMC console menu bar, click Sites, then click the Organization Overview icon. Click your organization, and then click the Details icon in the Organizations area. The Organization Details screen appears. 2. Click the Domains tab. 3. Click Add. The Domain dialog box appears. 4. Enter the following: Name—Your domain name. For example, ABCCompany. Active Directory connection strings—The Active Directory connection string.
Chapter 6: Preparing for your Active Directory single sign-on configuration Creating and configuring user accounts for single sign-on Creating user accounts If you have not already created user accounts in the NMC console, you must create them before enabling single signon. When you create user accounts, each user's login must match that user’s Windows domain login exactly.
Chapter 7: Installing the Local Authenticator Chapter 7: Installing the Local Authenticator About the Local Authenticator 41 Creating organization tokens 42 Installing and binding the SSL certificate 43 Installing the Local Authenticator 47 Editing the configuration file 51 Starting the Local Authenticator service 52 40
Dragon Installation Guide About the Local Authenticator The Local Authenticator is a service that provides Dragon clients with Active Directory single sign-on authentication. The Local Authenticator validates Dragon client credentials when the clients attempt to connect to NMC server, and then passes the validate credential call to the cloud NMC server to create a session. You must install the Local Authenticator to use single sign-on with the Nuance-hosted cloud NMC server.
Chapter 7: Installing the Local Authenticator Creating organization tokens The Local Authenticator installation requires an organization token. You create a token in the NMC console. To create an organization token: 1. From the menu bar, select Sites > Organization Overview. 2. Right-click your organization, and then select Details. The Organization Details page appears. 3. Click the Organization Token tab. 4. Click Add to generate a new organization token. The Organization Token Info dialog box appears.
Dragon Installation Guide Installing and binding the SSL certificate About signed certificates Using SSL requires that you obtain a signed SSL certificate from a certificate authority, such as GoDaddy or Verisign. The certificate authority must be a trusted authority known to both the client computer and the server. Nuance Management Center does not support internally generated (self-signed) certificates.
Chapter 7: Installing the Local Authenticator 2. Note the subject of the certificate. This should match the computer name that the certificate is deployed on, or be a wild card. This must match exactly the host used in the endpoints. For information on viewing the subject, see https://technet.microsoft.com/en-us/library/cc754686(v=ws.10).aspx.
Dragon Installation Guide 3. Note the thumbprint of the certificate. You use the thumbprint to bind the certificate to the port used by the primary NMS services in the next step. For information on retrieving the thumbprint, see https://msdn.microsoft.com/en-us/library/ms734695.aspx. 4. Bind the SSL port (443) used by the services to the certificate. Windows Server 2008 or 2012: a. Using the netsh utility, run the following command to bind port 443 to the certificate : netsh http add sslcert ipport=0.0.0.
Chapter 7: Installing the Local Authenticator Use the browser 1. Can you access and log into the NMC console? a. Connect to https:///NMCHTML/. If you see the Nuance Management Center login page, port 443 is working, and the NMC console is being deployed properly. b. Log in to the NMC console. If successful, the console is able to communicate with the server. 2. Can you access the NMC console status interface? 1. Connect to https:///NMS/Platform/ConfigurationSvc/v1/Status.
Dragon Installation Guide Installing the Local Authenticator On the machine where you are installing the Local Authenticator: 1. Find and run the .exe file for the Local Authenticator, which ships with Dragon Group. A dialog box appears, prompting you to select a language for the installation. 2. Select your language from the drop-down list, and then click OK. The InstallShield Wizard opens. 3. Click Next.
Chapter 7: Installing the Local Authenticator 4. In the Customer Information dialog, leave the default value in the User Name field and enter your company name in the Company field. Click Next. 5. Set the location where the Local Authenticator will be installed, and then click Next.
Dragon Installation Guide 6. Enter the organization token that you generated in the Token field of the NMC console, and then click Next.
Chapter 7: Installing the Local Authenticator 7. Click Install to install the Local Authenticator. A status dialog appears, with a status bar showing you how the installation is progressing. 8. When the installation is complete, the InstallShield Wizard Complete dialog appears. Click Finish to exit the installer.
Dragon Installation Guide Editing the configuration file You edit the Local Authenticator configuration file to change the NMC server address to the appropriate address. You should have received this address in your welcome information from Nuance. 1. Open the folder where the Local Authenticator is installed. By default, the Local Authenticator is installed in: C:\Program Files\Nuance\Local Authenticator 2. In any text editor, open NMS.LocalAuthenticator.Service.exe.config.
Chapter 7: Installing the Local Authenticator Starting the Local Authenticator service 1. Open the Server Manager to view your Windows services. 2. Look for the NMS Local Authenticator Service. 3. Right-click the service, and then select Start.
Chapter 8: Preparing for your Dragon Group client installation Software and hardware requirements—Client 54 Required skills for installing Dragon Group 55 Dragon File Structure 56 Assigning access 58 Configuring client workstations 59 53
Dragon Installation Guide Software and hardware requirements—Client Dragon Group hardware recommendations The Dragon Group installer verifies that your system meets the minimum requirements. If the minimum requirements are not met, the client is not installed. Supported operating systems l Microsoft Windows 10, 32-bit and 64-bit l Microsoft Windows 8.
Chapter 8: Preparing for your Dragon Group client installation Required skills for installing Dragon Group To install the Dragon Group software, you should be able to: l Set Windows user rights and directory permissions l Edit XML configuration files 55
Dragon Installation Guide Dragon File Structure During installation, Dragon sets up the following default folders for application and data storage. Note: Upgrading Dragon from an earlier version automatically relocates some directories and files. Windows 7, Windows 8.x, and Windows 10 Dragon setup log (dgnsetup.log) C:\ProgramData\Nuance\NaturallySpeaking14\logs Dragon log C:\ProgramData\Nuance\NaturallySpeaking14\logs\ User profiles C:\ProgramData\Nuance\NaturallySpeaking14\Users Upgra
Chapter 8: Preparing for your Dragon Group client installation Accessing program files The Dragon client and many associated utilities can be accessed through the Start menu. Their location varies by operating system: l Windows 7: Select Start > All Programs > Dragon. l Some utilities are located inside the Dragon Tools subfolder. l Windows 8.x: From the Start screen, click the down arrow to show all applications. Scroll to find Dragon. l Windows 10: Select Start > All apps > Dragon.
Dragon Installation Guide Assigning access Caution: To ensure that your Dragon Group network components can communicate with each other and that the network can function properly, you must assign permissions to all appropriate directories and access rights to administrator and user accounts on servers and clients as indicated below.
Chapter 8: Preparing for your Dragon Group client installation Configuring client workstations Turning off Windows Automatic Updates After you set up each physical server or workstation, be sure to turn off Windows Automatic Updates. For each update Windows sends, install it first on a single test machine; update other machines only after you have determined that it does not disrupt the network.
Chapter 9: Installing the Dragon Group client Install Dragon and choose the default settings 61 60
Dragon Installation Guide Install Dragon and choose the default settings You perform the initial installation to set default values for the following: l Administrative options l Auto-Formatting options You then use these options to install Dragon Group on other computers using the same values. Even if you are installing from a server, you should run through the initial installation first. Note: You must have Windows administrator privileges to change Administrative settings.
Chapter 9: Installing the Dragon Group client on page 123. If you do not have a supported third-party indexing/search software installed, the Enable Desktop Search commands check box is unavailable. Dragon supports Microsoft Search. l NMS users—Only options in the Commands tab are saved to the NMC server. All other settings are saved locally. l l Auto-Formatting—Select the Auto-Formatting options. Note: Administrators can also control these settings in the NMC console.
Dragon Installation Guide 4. Enter the following: setup.exe /i /v"INSTALLDIR=C:\\Nuance\NaturallySpeaking14 /L*v C:\Logs\logfile.log /qf" Note: Unless you plan to use the Dragon client on the machine you used for the initial installation, you do not need to enter a serial number. If you see errors regarding the serial number, you can ignore them. The /v option introduces any series of msiexec.exe options that you want to pass to the Windows installer.
Chapter 9: Installing the Dragon Group client l l NMS users: Only options in the Commands tab are saved to the NMS. All other settings in the Options dialog are saved locally. To open the Auto-Formatting dialog box: natspeak.exe /SetDefaultFormattingOptions In the dialog box, select Auto-Formatting options to apply to all client installations, and then click OK. Note: Administrators can also control these settings in the NMC console. l To open the Administrative Settings dialog box: natspeak.
Dragon Installation Guide Switch Function /About Shows the About dialog for the Dragon client. /FindAppData Opens the AppData directory for the Dragon client. /FindAppDataAllUsers Opens the directory where the .ini files are stored. 65 /FindCustom Opens the Data Distribution directory specified in the Miscellaneous tab of the Administrative Settings dialog. /FindDragonLog Opens the directory that contains Dragon.log.
Chapter 10: Installing the Dragon client with Settings Overview—Installing the Dragon client with initial settings 67 Push installations 67 Installing the same Dragon configuration on multiple computers 69 Performing an administrative installation with a batch file 70 Command Line installation with msiexec.
Dragon Installation Guide Overview—Installing the Dragon client with initial settings You can use command line options to copy your initial Dragon settings to all your Dragon client installations. Prerequisites Before installing the Dragon client, do the following: l l Have the Dragon serial number available. If you are installing or upgrading Dragon on multiple networked computers, have the group serial number available.
Chapter 10: Installing the Dragon client with Settings Support for SMS and Windows Server with Active Directory Systems Management Server (SMS) provides a mechanism for pushing application installations out from the server to client systems. SMS supports using the Windows Installer (MSI) to push installations on clients using Windows 7, 8 or 10. SMS requires that a client application be installed on all client computers. Active Directory is a feature of Windows Server 2008 and 2012.
Dragon Installation Guide Installing the same Dragon configuration on multiple computers Do the following to install with setup.exe in the command line from a single client machine. To use Dragon 14.msi instead, see “Command Line installation with msiexec.exe” on page 71. 1. Open a Command Prompt: l l l Windows 7: Start > All Programs > Accessories > Command Prompt Windows 8.
Chapter 10: Installing the Dragon client with Settings Performing an administrative installation with a batch file A simple way to install Dragon from the command line is to perform an administrative installation using a .bat file. A script for performing a full administrative installation is provided in the admininstall.bat file on the DVD. Caution: Only advanced administrators should perform an administrative installation. To run the batch file, open a Command Prompt and enter admininstall.
Dragon Installation Guide Command Line installation with msiexec.exe Another way to install Dragon from the command line on several client computers is to use the msiexec.exe program from Microsoft. You are required to use msiexec.exe instead of setup.exe if you are installing Dragon from a server across a network. The compiled MSI file, Dragon 14.msi, is located on your installation DVD. You can double-click on the .msi file to start the InstallShield Wizard.
Chapter 11: Configuring the Dragon client for NMS Chapter 11: Configuring the Dragon client for NMS Associating Dragon clients with the Nuance Management Center (NMC) server or Local Authenticator 73 72
Dragon Installation Guide Associating Dragon clients with the Nuance Management Center (NMC) server or Local Authenticator To set up Dragon clients to work with NMS: 1. From the DragonBar, click Tools > Administrative Settings. Note: You can also access the Administrative Settings dialog using the natspeak.exe command line options (see “Other natspeak.exe options” on page 64). 2. If a warning dialog appears, click Proceed to close all user profiles and open the Administrative Settings dialog. 3.
Chapter 12: Scheduling Optimization Tasks Chapter 12: Scheduling Optimization Tasks Using Acoustic and Language Model Optimizer and Scheduler tools 75 74
Dragon Installation Guide Using Acoustic and Language Model Optimizer and Scheduler tools Run the Acoustic and Language Model Optimizer Scheduler to: l Optimize the acoustic files for a user profile. l Optimize the language model for a user profile. l Schedule one or both types of optimization to occur on a particular day or time at particular intervals. l Enable or disable the scheduled optimizations.
Chapter 12: Scheduling Optimization Tasks Running the Acoustic and Language Model Optimizer from the Start menu You can also the Acoustic and Language Model Optimizer from the Windows Start menu without opening a user profile: l l l Windows 7: Select Start > All Programs > Dragon > Dragon Tools > Acoustic and Language Model Optimizer Scheduler. Windows 8.x: From the Start screen click the down arrow to show all applications.
Dragon Installation Guide l You change the order of the list by selecting a name and clicking the Move Up or Move Down button. When you are satisfied with the list, click OK to proceed. 7. If you are running the Optimizer tasks for a single user: l In the Dictation Source text box, select an audio input device from the drop-down list. l In the Vocabulary text box, select a vocabulary from the drop-down list. 8.
Chapter 13: Working with Custom Commands Chapter 13: Working with Custom Commands Using the Convert XML to DAT Tool 79 Using the MyCommands Protection Utility 80 78
Dragon Installation Guide Using the Convert XML to DAT Tool You can use a text editor to edit custom commands in XML format. To restrict access to only Dragon users, you can convert your commands from XML format to DAT format. Dragon uses .dat files to store commands. Note: For more information on creating custom commands, see “Creating and editing custom commands” on the Dragon Help site. For help with Structured Commands, see the Advanced Scripting Reference.
Chapter 13: Working with Custom Commands Using the MyCommands Protection Utility In Dragon Group, you can protect custom Text-and-Graphics, Step-by-Step, Macro Recorder, and Advanced Scripting commands by exporting them into a .dat file, and then running the MyCommands Protection Utility included in your Dragon installation. After they are imported to the Dragon client, users can use the commands, but cannot view or edit their source code or re-export the commands.
Chapter 14: Upgrading the Dragon client Chapter 14: Upgrading the Dragon client Preparing to upgrade Dragon 82 Upgrading Roaming User Profiles 84 Upgrading Your Dragon installation from the Command Line 86 Upgrading with msiexec.
Dragon Installation Guide Preparing to upgrade Dragon Export user profiles Before you upgrade, consider exporting user profiles in case you need to re-install. 1. On the DragonBar, select Profile > Manage User Profiles. The Manage User Profiles dialog opens. 2. Select the user profile to export. 3. Select Advanced > Export. 4. When the Browse For Folder dialog box opens, navigate to the folder where you want to store the exported user profile, or create a new folder by clicking the Make New Folder button.
Chapter 14: Upgrading the Dragon client 1. From the DragonBar, select Tools > Command Browser. 2. In the Command Browser window, click the Mode menu, then select Manage. 3. To export only custom commands, choose User-Defined in the Group drop-down list. 4. Click the plus sign (+) to expand the list of commands. 5. Select the check-box next to the commands to export. 6. Click the Manage menu, and then select Export. 7. In the Save window, specify a name for the file, and then choose a Windows folder. 8.
Dragon Installation Guide Upgrading Roaming User Profiles If you are upgrading from Dragon Professional version 12 or 12.5, you must upgrade your user profiles before using them. For Roaming user profiles, an administrator should upgrade the Master Roaming user profiles before upgrading the Dragon clients. You can use version 13 or 13.5 profiles without upgrading.
Chapter 14: Upgrading the Dragon client a. On the administrator system where you are upgrading the Master Roaming profiles, start Dragon. b. On the DragonBar, click Tools > Administrative Settings. c. When the Administrative Settings dialog opens, click the Roaming tab and make sure Enable is not selected. d. Click OK, and then close Dragon. 5. Upgrade the Master Roaming user profiles using the Upgrade User Profiles Wizard (see “Upgrading user profiles” on page 90).
Dragon Installation Guide Upgrading Your Dragon installation from the Command Line There are two command line upgrade scenarios: l Major Upgrade—Upgrading to a new edition or version of Dragon Group. l Minor Upgrade—Upgrading to a higher point release within the same edition and version of Dragon. Minor upgrades do not support the silent upgrade option. When you run setup.exe to install a minor upgrade, setup.exe can detect when a previous version of Dragon exists on a target computer.
Chapter 14: Upgrading the Dragon client INSTALLDIR=\"C:\Program Files\Nuance\NaturallySpeaking14\" DEFAULTSINI=\"C:\\nsdefaults.ini\" REINSTALL=ALL REINSTALLMODE=vamus /L*v C:\logfile.log /qn" Note: When you are using the setup.exe method, you must ensure that all flags and properties are within the same set of quotes, directly after /v, without a space. See “MSI options for Dragon installations” on page 118 for details on the MSI options available for Dragon installations.
Dragon Installation Guide Upgrading with msiexec.exe Note: When you use the msiexec.exe installer to uninstall Dragon from a command prompt, the installer automatically retains user profiles from the previous version of Dragon. After upgrading, users can upgrade their local (non-Roaming) user profiles when they start Dragon. To upgrade Roaming user profiles, see “Upgrading Roaming Users” on page 84.
Chapter 14: Upgrading the Dragon client DEFAULTSINI="C:\\nsdefaults.ini" REMOVEOLDPROD=1 /L*v "C:\logfile.log" /qn l For a minor upgrade, install the new version of Dragon with msiexec.exe as you would the major upgrade, but pass REINSTALL and REINSTALLMODE options, as shown in the sample below: msiexec /i "Dragon 14.msi" SERIALNUMBER=#####-###-####-####-## REBOOT=ReallySuppress INSTALLDIR="C:\Program Files\Nuance\NaturallySpeaking14" DEFAULTSINI="C:\\nsdefaults.
Dragon Installation Guide Upgrading user profiles If your organization used Dragon Professional version 12 or 12.5, you will need to upgrade your user profiles before using them. Version 13 or 13.5 profiles can be used without upgrading. When you upgrade the Dragon client, the Upgrade User Profiles Wizard launches when the user first attempts to open a version 12 or 12.5 user profile. The Upgrade User Profiles Wizard walks users through the process of upgrading profiles stored on the local machine.
Chapter 14: Upgrading the Dragon client l l To distribute words and commands to all users, you can use the nsadmin.exe tool. For more information, see the nsadmin Help file available in the Help folder of your installation directory (by default, C:\Program Files\Nuance\NaturallySpeaking14\Help). To manually import words and commands to individual Dragon clients, see “Exporting and importing a list of custom words and phrases” and “Exporting and importing commands” in the Dragon Help site.
Chapter 15: Managing Logs and Errors Dragon logs 93 Handling Dragon error messages 95 Accessing the Dragon Knowledge Database 96 92
Dragon Installation Guide Dragon logs Dragon Group generates logs that can help troubleshoot your system. If you call Technical Support, you might be asked to provide one or more of these logs to help Nuance engineers work on any issues with your network. Users can view additional logs in the Nuance Management Center (NMC) console (see the “View log files for a variety of products and product components” section in the Nuance Management Server Administrator Guide).
Chapter 15: Managing Logs and Errors Usability logs (Stand-Alone mode only) You can set up Dragon to create a usability log that logs all menu commands, toolbar buttons, and voice commands that you use during a dictation session. To set up a usability log: 1. With a user profile open, on the DragonBar, select Tools > Options. 2. Click the Data tab. 3. Click the Advanced button. 4. When the Advanced dialog box opens, check the Create usability log checkbox and click OK to return to the Data tab. 5.
Dragon Installation Guide Handling Dragon error messages When Dragon displays an error message: 1. Read the message carefully. It may give you enough information to determine what to do. 2. If you dictated text into your document, click Close to close the error message box and then save your document. 3. Do not save your user profile. 4. Copy the error message log file (Dragon.log) to a safe place. Technical Support may ask you to send this file for further study. In Dragon Group, the Dragon.
Chapter 15: Managing Logs and Errors Accessing the Dragon Knowledge Database Solutions to known problems with Dragon are provided at the Nuance Knowledge Base, located at http://nuance.custhelp.com/. 1. In the search field, type keywords related to your problem. 2. Click the magnifying glass to start the search. For an Advanced Search, click Advanced Search, then fill in some or all of the following fields in the popup window that appears: 1.
Chapter 16: Using Dragon over a remote desktop connection Chapter 16: Using Dragon over a remote desktop connection This chapter contains information on setting up and using the Dragon client through a remote desktop connection.
Dragon Installation Guide Use Dragon through a remote desktop connection For remote desktop system requirements, see “System Requirements for using Dragon through a remote desktop connection” on page 1.
Chapter 16: Using Dragon over a remote desktop connection Remote desktop connection support You can use Dragon through a remote desktop connection with the following operating systems: Server Operating Systems Client Operating systems Windows Server 2008 R2 and Windows Server 2012 R2 l Windows 10, (32-bit and 64-bit) Windows 7 Ultimate and Enterprise Server l Windows 8, (32-bit and 64-bit) l Windows 7, (32-bit and 64-bit) Windows 10 Professional, Enterprise and Education Windows 8 Professional a
Dragon Installation Guide l l l l 100 2 MB for the Remote Desktop Client version 7 (from Microsoft) l 8 MB for the Dragon client USB port for the microphone l Cache: 1 MB L2 cache per CPU l CPU: 3.
Chapter 16: Using Dragon over a remote desktop connection Installing Dragon on the server and the client To enable audio redirection through a remote desktop connection, and allow users to connect and use Dragon Group on Windows Server 2008 R2, Windows Server 2012 R2, or Windows 7 Ultimate Server, you install and configure software on both the client computers that will connect to Dragon on the server, and on the server machines.
Dragon Installation Guide Configuring the Windows server 1. Ensure the server computer meets the system requirements. For more information, see “System Requirements for using Dragon through a remote desktop connection” on page 1. 2. On Windows Server 2008 R2, Windows Server 2012 R2, or Windows 7 Ultimate Server, make sure that the "Remote audio" recording device already exists. 3. If you are using Windows Server 2008 R2, perform the steps in “Configuring Windows Server 2008 R2” on page 103. 4.
Chapter 16: Using Dragon over a remote desktop connection Configuring Windows Server 2008 R2 Perform the following steps to install and configure the Remote Desktop Services role. 1. Open Remote Desktop Connection. 2. Open the Server Manager. 3. Select Roles. 4. Select Add Roles. 5. On the Before You Begin screen, click Next. 6. On the Select Server Roles screen, select Remote Desktop Services, click Next. 7. On the Remote Desktop Services screen, click Next. 8.
Dragon Installation Guide 10. Select Do not require Network Level Authentication, click Next. 11. On the Specify Licensing Mode screen, click Next. 12. Click Next.
Chapter 16: Using Dragon over a remote desktop connection 13. Select the Audio and video playback option and the Audio recording redirection option and click Next. 14. Confirm your selections, and click Install.
Dragon Installation Guide The Installation Progress screen display the status of the installation. 15. On the Installation Results screen, verify that the installation was successful. Click Close. 16. Restart the computer. Perform the following steps to configure the local group policy on the server and to allow connections from client computers. 1. On the server, in a command prompt, run gpedit.msc. 2.
Chapter 16: Using Dragon over a remote desktop connection Configuring Windows Server 2012 R2 Part 1 1. Open Remote Desktop Connection to the server or go directly to the server console. 2. Open the server, then open the Server Manager. 3. On the Dashboard, select Add roles and features to open the Add Roles and Features wizard. 4. Click Before You Begin, then click Next. 5.
Dragon Installation Guide 6. On the Select destination server screen, select Select a server from the server pool. Select the server and click Next.
Chapter 16: Using Dragon over a remote desktop connection 7. On the Select Server Roles screen, select Remote Desktop Services, then click Next. 8. On the Select features screen, open the Remote Server Administration Tools submenu. 9. Open the Role Administration Tools submenu. 10. Open the Remote Desktop Services Tools submenu. 11. Select Remote Desktop Licensing Tools and click Next. 12. On the Remote Desktop Services screen, click Next. 13.
Dragon Installation Guide 14. On the next screen, click Add Features, then click Next. 15. On the Confirm installation selections screen, check Restart the destination server automatically if required. 16. In the Add Roles and Features wizard, click Yes. 17. Confirm your selections, then click Install. 18. The Installation Progress screen displays that status of the installation. 19. On the Installation progress screen, verify that the installation was successful.
Chapter 16: Using Dragon over a remote desktop connection 20. Click Close. 21. Restart the computer (even if the server was not restarted automatically). Perform the following steps to configure the local group policy on the server and to allow connections from client computers. 1. On the server, in a command prompt, run gpedit.msc. 2.
Dragon Installation Guide Configuring Windows 7 Ultimate Server 1. On the Windows 7 Ultimate Server, open the Control Panel. 2. Open System Properties. 3. Click the Remote tab. 4. Allow remote connections by choosing your preferred configuration. 5. Proceed to “Configuring the Dragon clients” on page 113.
Chapter 16: Using Dragon over a remote desktop connection Configuring the Dragon clients After you install Dragon Group on the server and Dragon Client for Remote Desktop on each client computer, perform the following steps on each client computer that need to connect to Dragon Group on the server. 1. Ensure the client computer meets the system requirements. See “System Requirements for using Dragon through a remote desktop connection” on page 1 for more information 2.
Dragon Installation Guide 5. Select the Local Resources tab, click Settings.
Chapter 16: Using Dragon over a remote desktop connection 6. Select Play on this computer and Record from this computer, and click OK. Selecting these options enables audio support each time the user opens the remote connection to use Dragon Group on Windows Server 2008 R2 or Windows Server 2012 R2. 7. In the Windows sound settings, verify that Remote Audio device appears.
Dragon Installation Guide User Profiles and using Dragon through a Remote Desktop session Dragon users must perform four minutes of short training when they create a user profile. It is not possible to skip user profile training when Dragon Group is installed on Windows Server 2008 R2, Windows Server 2012 R2, or Windows 7 Ultimate Server and when using Remote Desktop Connection 7.
Appendix A: Options for MSI Installations Appendix A: Options for MSI Installations MSI options for Dragon installations 118 Feature variables to set through the ADDLOCAL or ADVERTISE properties 123 Speech options 124 MSI options for scheduled tasks 126 Editing Miscellaneous and Scheduled Task settings in nsdefaults.ini 127 Extracting MSI/MST Files from the Dragon setup.
Dragon Installation Guide MSI options for Dragon installations This section describes the msiexec.exe options that apply to Dragon Group. For more information on MSI options, see the Microsoft website: http://msdn.microsoft.com/en-us/library/aa367988(v=vs.85).aspx. Notes: l Launching msiexec.exe /i "Dragon 14.msi" = automatically sets the specified to and continues the installation. However, if you use setup.exe to install, you must put all msiexec.
Appendix A: Options for MSI Installations Options Description SETDEFAULTS=0/1 Sets the default state of the Modify the application’s settings for all users check box in the Advanced dialog of the Installer. 0: Check box is deselected. The Options dialog box does not appear during installation. 1: (Default) Check box is selected. The Options dialog box appears during installation. Note: If you use the /qn switch, no dialogs appear during installation, even if you set them to display in the command line.
Dragon Installation Guide Options Description l Indian subcontinent (IndianSubcontinent or Indian) l Southeast Asia (SoutheastAsia or Asia) To install all English-language regions, set REGION=All. Set REGION=NoEnglish or REGION=None if you do not need to install any English-language regions. ADDLOCAL=Feature1,Feature2,... or ADDLOCAL=ALL Set the ADDLOCAL property to a comma-delimited list of features to be installed locally.
Appendix A: Options for MSI Installations Options Description codes. /L "\logfile.log" Creates an installation log in the specified location. To log all information, including verbose output, enter /L*v. You can send this log to technical support should any issues arise. For available parameters, see https://technet.microsoft.com/enus/library/cc759262(v=ws.10).aspx#BKMK_SetLogging /q Sets the user interface level for the installation.
Dragon Installation Guide PRODUCTUPDATEFLAG=-1 REBOOT=ReallySuppress PERIODIC_TASK="aco|lmo;admin;pswd;Mon, 01:00|Mon, 06:00" ADDLOCAL=TTSENX,NatSpeak,ENUGeneral /L*v C:\Logs\logfile.
Appendix A: Options for MSI Installations Feature variables to set through the ADDLOCAL or ADVERTISE properties When specifying features on the command line: l l If a feature does not exist in a particular edition or language, overriding its default property has no effect. Some features (such as Text-to-Speech) have sub-features. Setting these features on the command line automatically turns on the properties of all sub-features, unless you specify an additional override for those subfeatures.
Dragon Installation Guide Speech options Feature ENU Sub-features: Vocabularies l (US English) l l Canada l (Canadian English) ENG l (UK English) DEU l (German) l ITA l (Italian) NLD 124 l ENUGeneral (US English General Medium, US English Empty Dictation, US English Commands Only) ENULegal (US English Legal Large) ENUGenSvc (US English Large General) CanadaGeneral (Canadian English General Large) ENGGeneral (UK English General Large, Empty Dictation General, Commands Only) DEUGeneral(
Appendix A: Options for MSI Installations Feature Sub-features: Vocabularies (Dutch) FRA General Large) l (French) ESP (Spanish) Supported accents l FRAGeneral (French General Large, French Empty Dictation General Large) N/A ESP (Latin American Spanish General Large, Latin American Spanish Empty Dictation General Large, Castilian Spanish General Large) N/A 125
Dragon Installation Guide MSI options for scheduled tasks Note: Take the following actions on the client computer. Do not perform them on the computer where you performed the initial installation and configured default option settings. You can include an additional option on the command line to run one or more of the following tasks on a particular schedule: l l l Acoustic model optimization (ACO)—This task optimizes the acoustic models used to interpret the user’s speech.
Appendix A: Options for MSI Installations Editing Miscellaneous and Scheduled Task settings in nsdefaults.ini Several settings from the Miscellaneous and Scheduled Tasks tabs of the Administrative Settings dialog box can be modified in the nsdefaults.ini file you created in “Initial Installation of the Dragon Client” on page 60. You can then pass the revised file to the DEFAULTSINI option (see “Installing the same Dragon configuration on multiple computers” on page 69).
Dragon Installation Guide Option Description Setting Global MyCommands VBA Scripting=0/1 Allows or disallows the user to modify Advanced Scripting commands. The user can still use Advanced Scripting commands, even when not allowed to modify them. Miscellaneous tab: Disable use of Advanced Scripting commands check box When set to 1, the Acoustic Optimizer engine can automatically select an acoustic model that it believes is more suited to your speech.
Appendix A: Options for MSI Installations Extracting MSI/MST Files from the Dragon setup.exe Some minor releases of Dragon do not include an MSI file. Instead, the file is part of the setup.exe file. You can run silent installations from the command line with msiexec.exe or setup.exe – you don’t need to extract the .msi and .mst files. Use the following information if you are comfortable using .msi installers. Note: When you are using the setup.
Appendix B: Stand-Alone Mode Installation Options Appendix B: Stand-Alone Mode Installation Options Setting Roaming user profile options 131 Understanding Roaming user settings in nsdefaults.ini and roamingdef.
Dragon Installation Guide Setting Roaming user profile options Use the following steps to create a roamingdef.ini file to be used for an MSI installation where the Roaming feature is enabled: 1. Install Dragon on a computer with Windows administrator privileges (see “Initial Installation of the Dragon Client” on page 60). 2. In the Administrative Settings dialog box, accessed during installation or via the natspeak.exe commands (“Other natspeak.exe options” on page 64), click the Roaming tab. 3.
Appendix B: Stand-Alone Mode Installation Options Understanding Roaming user settings in nsdefaults.ini and roamingdef.ini The settings below were created when you configured Roaming in the previous topic. nsdefaults.ini settings You can edit these settings directly in the nsdefaults.ini file. Option Description and user interface equivalent Roaming User On=0/1 Enable check box: Turns the Roaming feature on or off.
Dragon Installation Guide Option Description and user interface equivalent Roaming User Always Break Lock=0/1 Ask before breaking locks on network user profiles (recommended) check box: Produces a prompt that states the user profile is locked and asks you to override the lock preventing users from opening a Roaming user profile that is already in use. Network problems can cause a lock to become “stuck” and not release. Default 0 (checked) produces a prompt.
Appendix B: Stand-Alone Mode Installation Options Option Description and user interface equivalent Roaming User Copy Dragon Log=0/1 Copy Dragon log to network check box: Copies the dragon.log file from the Local Roaming user profile location to the Master Roaming user profile location at the same time that the program synchronizes the local and the Master Roaming user profiles.
Dragon Installation Guide Options Description and user interface expires to close the connection connectiontimeoutinactivity Type radio buttons in he Timeouts area: Set if you selected the Inactivity option.
Appendix B: Stand-Alone Mode Installation Options Options Description and user interface ssl3 SSL Enabled Protocols check box: Version 3 of the Secure Sockets Layer (SSL) protocol ssl2 SSL Enabled Protocols check box: Version 2 of the Secure Sockets Layer (SSL) protocol pct1 SSL Enabled Protocols check box: Version 1 of the Private Communications Transport (PCT) protocol 136
Dragon Installation Guide Installing a Roaming user profile configuration on additional computers The default Roaming user settings you created in “Setting Roaming user profile options” on page 131 are transferred to your client computers only if you include the ROAMINGUSERINI option, set to roamingdef.ini. Use the full path to the file: ROAMINGUSERINI=\"C:\\roamingdef.ini\" If you do not pass the ROAMINGUSERINI option, default settings are used.
Appendix C: Database backups About database backups 139 Disabling automatic database backups 140 138
Dragon Installation Guide About database backups If you are hosting your own NMC server on-premise, database backups occur on a regular basis at scheduled intervals automatically. The backup process places backup files in the C:\NMSDBBACKUP folder on the database server by default, unless you specified a different location during installation. The backup includes database objects, like sites and groups, and includes the Windows communication foundation service logs generated for each user account.
Appendix C: Database backups Disabling automatic database backups Optionally, you can choose to disable the automatic backups and manage database backups yourself outside the Nuance Management Center. To disable automatic backups: 1. From the NMC menu button, select System Settings. The System Settings dialog box opens. 2. In the General section, select the Disable scheduled NMS database backups check box. 3. Click Save.