Csapp.ini File

Commerce Server Site Packager generates the Csapp.ini file during the unpacking process. After the unpacking process is complete, do not delete Csapp.ini; both AuthManager and AuthFilter require this file, and it must be located in the site root folder.

The following table lists the properties that are contained in the Csapp.ini file and their descriptions.

Property Description
Path The physical path to the root of the application.
SiteName The name of the site as it appears in the Administration database.
AddressKeyName The name of the application in the Administration database under which all information for the IIS application is placed.
RelativeURL The name of the IIS virtual directory for the application relative to the default Web site. For example, if the application was installed at the root of the IIS Web site, it is relative to the base root of a given IIS Web site.
AbsoluteURL The address of the application, which also includes the computer name.
PackagePath The package from which the application was extracted.

The only property in this file that should be changed is the RelativeURL property. If you manually move an application to a different IIS path, the RelativeURL property must be modified to point to the accurate relative virtual directory under the IIS Web site. If the application is moved to the root of a Web site, it must contain a slash (/), for example, RelativeURL=/. The RelativeURL exists so that the CS Authentication service can determine from where it is operating. The RelativeURL property is recreated each time it is unpacked.

Ee825203.note(en-US,CS.20).gif Note

  • Secure the Csappi.ini file by deselecting read, write, and script source access to it in IIS. If you use NTFS permissions to secure this file, you must grant read access to all user accounts that access the site, such as the IUSR_computername account. Also, after you unpack a site, do not delete Csapp.ini; both AuthManager and AuthFilter require this file, and it must be located in the site root folder. AuthManager retrieves SiteName and AddressKeyName from Csapp.ini.

See Also

Csappi.ini File Values for Authentication

Unpacking a Site

Packaging a Site

Copyright © 2005 Microsoft Corporation.
All rights reserved.