Contents
Display Legacy Contents

Home > Getting Started > Web.config

Web.config

The web.config file contains settings not accessible through the Admin Control Panel.

It is located in root of your web files folder.  The web.config file is an XML file and must continue to be well-formed XML after editing.  Be sure you know how to edit XML files properly without otherwise editing their contents.

Each time you change this file, the application will restart.  Therefore, this file shouldn't be changed often, and usually never after the site has been properly configured. Alternatively, if you must restart the application and you don't have access to "stop/start" or "restart" functionality, you can intentionally make a change to this file.

Certain sections of the web.config file MUST be modified when installing AuctionWorx.  Likewise, certain sections "can" be modified and other sections should not be modified.  Here is a table of the sections.

Section  Notes 
Configuration/configSections None of these values should be changed during normal operation.
Configuration/system.runtime.caching Unless your specific environment requires that cache memory be limited or if your memory use is highly volatile; these values should not be modified under normal circumstances.
Configuration/Validation   The default validation settings probably don’t need to be altered, but they can be if the need arises. A solid understanding of the Microsoft Enterprise Library Validation Application Block is required before these values are modified.
Configuration/loggingConfiguration The user may modify this section where appropriate. Specifically, location of log/trace files, their formats, and any filters. A solid understanding of the Microsoft Enterprise Library Logging Application Block is required before these values are modified.
Configuration/exceptionHandling The “postHandlingAction” attributes within this section should not be modified, but in certain instances, it may be beneficial for the end user to enable or disable logging of exception occurrences. Or modify how they are logged. A solid understanding of the Microsoft Enterprise Library Exception Handling & Logging Application Blocks is required before these values are modified. 
Configuration/connectionStrings This section will need to be modified to contain the correct database connection information for your specific environment.
Configuration/appSettings EnableSSL Before this value is set to “true” the unsecure and secure URL’s must be properly defined in the admin control panel. If they are not, the systems efforts to secure pages via SSL may actually make the secure admin control panel unreachable.
Configuration/appSettings SiteMapCategoryDepth This setting will need to be changed if you want to modify the depth of the Category hierarchy on the Site Map.
Configuration/appSettings SiteMapRegionDepth This setting will need to be changed if you want to modify the depth of the Region hierarchy on the Site Map.
Configuration/unity This section allows developers and implementers of additional listing types, methods of encryption, payment providers, etc… to be able to swap out or add their code to the complete AuctionWorx platform at runtime. Thus, no recompilation is necessary for many extensible aspects of AuctionWorx.
Configuration/lightSpeedContexts This section should not need to be changed during the normal course of AuctionWorx operations.
Configuration/system.serviceModel Since this section is not applicable for WCF installations, it is recommended that you do not change any of these values.
Configuration/applicationSettings NotificationTemplatesFolder This value should be changed to point to your local or shared repository of the email templates. The value could be as simple as “c:\templates” or could refer to a UNC path such as \\yourserver\templates so that in a multiple web server environment, the templates can be shared amongst each instance of AuctionWorx.
Configuration/applicationSettings LicenseKey Change this value to equal your license key.
Configuration/applicationSettings LogFileName Change this value to indicate where to store AuctionWorx LightSpeed log files.
Configuration/system.web None of these values should be changed during normal operation.
Configuration/system.webserver None of these values should be changed during normal operation. 
Configuration/system.net host Set this value to an email server prepared to accept SMTP email and relay it to its final destination.
Configuration/system.net port If not port 25, set “port” to the correct port of your SMTP email server.
Configuration/system.net userName & password If required, set “userName" and “password” appropriately so the AuctionWorx system can login to your SMTP server to send outgoing email notifications.
Configuration/runtime None of these values should be changed during normal operation.

Articles in this section
See also