How to: Configure the Application Run-time Environment

  • Article

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.

The second step in deploying a Speech Server application is to configure the run-time environment. The first step is to copy the application files to the deployment directory. For more information, see How to: Copy Application Files to the Deployment Directory.

Applications require Internet Information Services (IIS) and the hosting server running Speech Server to be configured to run the application. IIS must be configured with a virtual directory and other settings to execute the application files. Speech Server must be configured with information about the phone numbers to route to the application and other settings.

By adding the application to the deployment group, Speech Server automatically configures the IIS portion of the environment when localhost is the Web host for the application. However, when the application is deployed to a remote Web server, you must manually configure IIS before adding the application to the deployment group.

Note

In Speech Server, managed code (or assembly-based) voice response applications must be deployed to IIS on the computer running Speech Server. SALT and VoiceXML applications can be deployed locally or on a remote Web server.

Configuring the Application Run-time Environment

To configure the application run-time environment

  1. Add the computer running Speech Server that will host the application in the deployment group.

    For more information, see How to: Add or Remove a Server.

    Note

    If the computer running Speech Server and hosting the application is already contained in the deployment group, skip step 1.

  2. If you have copied the application files to a remote Web server, configure IIS on that computer, as described in the next section.

  3. Using the Speech Server??Administrator console, add the application to a deployment group.

    For more information, see How to: Add or Remove a Speech Server Application.

Configuring IIS

If you have created SALT or VoiceXML applications that you deploy on a remote Web server, you need to create the virtual directory for the application on that Web server and configure the virtual directory.

Note

The network ports that the application uses for SIP traffic are linked to the virtual directory in which the application runs. Speech Server does not support deploying more than one application to a particular virtual directory. Each application must have its own virtual directory to avoid conflicts communicating with SIP peers. For more information, see How to: Configure Application Listening Ports.

To create the virtual directory

  1. Click Start, point to All Programs, point to Administrative Tools, and then click Internet Information Services (IIS) Manager.

  2. In the left pane, expand the server, expand Web Sites, right-click Default Web Site, point to New, and then click Virtual Directory.

  3. In the Virtual Directory Creation Wizard, enter the following information when prompted:

    • Virtual Directory Alias - Type a name for the virtual directory.
    • Web Site Content Directory path - Enter the path to the folder that contains the application files.
    • Virtual Directory Access Permissions - Select Read and Run scripts.

  4. Click Finish to close the wizard.

To configure the virtual directory

  1. In IIS Manager, right-click the virtual directory in the left pane, click Properties, and then click the ASP.NET tab.

  2. Verify that the ASP.NET version is set to 2.0.50727, and then click OK.

  3. Click the HTTP Headers tab, and then click MIME Types.

  4. Register the following extensions and MIME type values, and then click OK.

    Extension MIME Type

    .cfg

    application/octet-stream

    .grxml

    text/xml

    .pf

    application/x-javascript

    .prompts

    application/octet-stream

    .vxml

    text/xml

  5. Click the Directory Security tab.

  6. Under Authentication and access control, click Edit.

  7. Select Integrated Windows authentication, and then click OK.

  8. Click OK.

See Also

Concepts

Application Deployment Files
About Application Manifest Files
Support for Outbound-Calling Applications

Other Resources

Application Administration