Configuring an Application

When you configure an application, you specify properties that apply to all the Web servers used by the application.

When you add a Web server to an application, some properties are automatically populated from Internet Information Services (IIS) 5.0 and stored in the Administration database. If the IIS properties change, then you need to synchronize the Administration database with the IIS metabase by manually updating the new properties in Commerce Server Manager or by clicking the Synchronize Values button on the Web Servers tab in the Properties dialog box of the application.

Ee811432.important(en-US,CS.10).gif Important

  • When you click the Synchronize Values button, Commerce Server synchronizes the properties at the application level and the properties for all the Web server objects below the application. For the properties at the application level (Transmission Control Protocol (TCP) port and Secure Sockets Layer (SSL) port), Commerce Server reads the values of the first Web server. It assumes that all the Web servers are configured the same, which is a requirement for servers in a Web farm.

For information about changing the non-secured (or secured) host name of your application to the domain name set up on the Domain Name System (DNS) server (for example, www.microsoft.com), see Renaming an Application.

To configure an application

  1. Expand Commerce Server Manager, expand Commerce Sites, and then click the site you want to administer.

  2. Expand Applications, right-click the application you want to configure, and then click Properties.

  3. In the <application> Properties dialog box, on the General tab, do the following:

    Use this To do this
    Nonsecure host name Type the DNS domain name to use for non-secured links in your applications.

    Caution

    • If you are using a port number other than 80, you must append that number to the end of the nonsecure host name (for example, www.microsoft.com:81). To view the port number you are using, see the TCP port box on the Web Servers tab.
    IIS application path Type the path to the IIS application.
    Enable HTTPS Select this property to enable links to a secure HTTP host (SSL) in your applications.
    Secure host name Type the DNS domain name to use for secured links in your applications.

    Caution

    • If you are using a port number other than 443, you must append that number to the end of the secure host name (for example, www.microsoft.com:441). To view the port number you are using, see the SSL port box on the Web Servers tab.
    Autocookie Select this property to generate cookies for anonymous users. This property is set during the unpacking process. For more information about configuring authentication on your site, see Managing the CS Authentication Resource.
    Authentication filter Select the type of authentication filter you want to use from the drop-down list:
    • No filter

    • Windows Authentication

    • Custom Authentication

    For more information about configuring authentication on your site, see Managing the CS Authentication Resource.

    Set cookie path to Application Select this option if you want to share cookies among the applications in a site.
    Number of shared domain levels Specify how many domain levels applications need in common in order to share a cookie. For example, for premier.microsoft.com and msn.microsoft.com to share the microsoft.com cookie, set the value to 2.
  4. In the Web Servers tab, click Synchronize Values to copy the following properties from IIS to the Commerce Server Administration database.

Ee811432.important(en-US,CS.10).gif Important

  - When you click **Synchronize Values**, Commerce Server synchronizes the properties at the application level and the properties for all the Web server objects below the application. For the properties at the application level (TCP port and SSL port), Commerce Server reads the values of the first Web server. It assumes that all the Web servers are configured the same, which is a requirement for servers in a Web farm.

Or, do the following:

<table>
<tbody>
<tr class="odd">
<td><strong>Use this</strong></td>
<td><strong>To do this</strong></td>
</tr>
<tr class="even">
<td><strong>IIS Web site</strong></td>
<td>Type the name of the IIS Web site (for example, Default Web Site).</td>
</tr>
<tr class="odd">
<td><strong>TCP port</strong></td>
<td>The default value is 80. If you have a value other than 80 here, you must type that value in the <strong>Nonsecure host name</strong> box on the <strong>General</strong> tab (for example, www.microsoft.com:81).</td>
</tr>
<tr class="even">
<td><strong>SSL port</strong></td>
<td>The default value is 443. If you have a value other than 443 here, you must type that value in the <strong>Secure host name</strong> box on the <strong>General</strong> tab (for example, www.microsoft.com:441).</td>
</tr>
<tr class="odd">
<td><strong>Local domain</strong></td>
<td>Type the name of the local domain (for example, microsoft.com).</td>
</tr>
</tbody>
</table>
  1. Click OK.

Ee811432.note(en-US,CS.10).gif Note

  • After you change a property value in Commerce Server Manager, you must unload the IIS applications in the site from memory on each Web server in order for the change to take effect. For instructions, see Unloading an Application from Memory.

See Also

Administration Basics

Configuring a Web Server

Managing the CS Authentication Resource

Renaming an Application


All rights reserved.