How to: Add or Remove a Speech Server Application

This content is no longer actively maintained. It is provided as is, for anyone who may still be using these technologies, with no warranties or claims of accuracy with regard to the most recent product version or service release.

Part of deploying an application for Speech Server is to use the Administrator console to add the application to the appropriate computer running Speech Server in a deployment group. When you add an application, Speech Server is configured to execute the application when calls are routed to the computer. When localhost is the host name in the application URL, Speech Server automatically sets up the Internet Information Services (IIS) virtual directory to execute the application. When localhost is not the host name (that is, when the Web server host is not the same as Speech Server), you must manually configure the virtual directory as a separate deployment activity.

The complete speech application deployment process includes other activities. For more information, see Speech Application Deployment.

After you add the application to one computer running Speech Server and later decide to configure other computers running Speech Server in the deployment group to run the same application, you can copy the application settings to all the computers. For more information, see How to: Copy Speech Server Settings to All Computers in a Deployment Group.

Prior to removing an application, redirect calls to a suitable alternative application, such as the same application deployed on another computer running Speech Server. This might require reconfiguration of the SIP peer or DNS server that is sending calls to Speech Server so that calls are directed elsewhere. Failure to do so can result in an increased number of rejected calls.

Adding and Removing Applications

To add an application

1. Open the Speech Server Administrator console.

   For more information, see How to: Start the Speech Server Administrator Console.

2. In the console tree, expand the applicable group, right-click Applications, point to New, and then click Application.

3. In the Application name box, type the name as you want it to appear in the Administrator console.

4. In the Application type box, select one of the following application types:

   • Managed Speech Application - A managed code (or assembly-based) voice response application. If you choose this type of application, the host name of the URL must be localhost.

     Note

     Applications using a combination of managed code and SALT or VoiceXML should use this setting because managed code assemblies are required.

   • SALT Application - A SALT voice response application based on the Speech Application Language Tags (SALT) standard.

   • VoiceXML Application - A VoiceXML application based on the Voice Extensible Markup Language (VoiceXML) standard.

   • In the URL or Start page box (depending on the type of application you selected), type the URL of the application start page.

     Note

     For Speech Server to automatically configure IIS for the application, you must use the string localhost in the URL. Do not use the host name or fully qualified domain name in place of localhost.

   • In the Deployment Location box, type the path to the application files on the local computer or an accessible remote share. This setting is only available if you specified localhost in the URL or Start page box.

5. In the Manifest box, type the URL or qualified path of the application manifest file, if applicable.

6. If this is an outbound-calling application, type the fully qualified path of the Microsoft Message Queuing (MSMQ) in the Message queue box.

   Note

   If you are deploying an outbound-calling application, you might need to do additional steps to complete the deployment process. For more information, see Support for Outbound-Calling Applications.

7. In the Called party address box, click the Add, Edit, and Remove buttons as needed to specify the phone numbers on which the application should accept calls.

   For more information, see How to: Specify the Called Party Address for a Speech Server Application.

   Note

   If more than one enabled application maps to a given phone number address, you must set the priority order for applications to accept calls to that address. For more information, see How to: Set Call Answering Precedence for Speech Server.

8. If your application requires Secure Real-time Transport Protocol (RTP), select Secure RTP.

   For more information, see How to: Configure an Application for Secure RTP Communications.

9. If your application requires application-specific listening ports, click Advanced, specify the ports in Advanced Application Settings, and then click OK.

   Important

   Setting listening ports for the application might prevent your application from working. For more information, see How to: Configure Application Listening Ports.

10. Click OK.

11. In the Select server box, select the computers on which the application runs, and then click OK.

    Speech Server adds the application to the selected computers and if the Web server host is localhost, Speech Server configures IIS to run the application.

To remove an application

1. Open the Speech Server Administrator console.

   For more information, see How to: Start the Speech Server Administrator Console.

2. In the console tree, expand the applicable group, and then click Applications.

3. In the details pane, right-click the application you want to delete, and then click Delete.

   Note

   This procedure does not remove the files associated with the application. To remove these files, navigate to the directory that contains the application files and delete them manually.