Contents
 Welcome
 Getting Started
    System Requirements
    Standard Installation
    Checking Your Site
    Email Templates
    WCF Services Installation
    Web.config
       Configuration/configSections
       Configuration/system.runtime.caching
       Configuration/Validation
       Configuration/loggingConfiguration
       Configuration/exceptionHandling
       Configuration/connectionStrings
       Configuration/appSettings
          EnableSSL
          SiteMapCategoryDepth
          SiteMapRegionDepth
       Configuration/unity
       Configuration/lightSpeedContexts
       Configuration/system.serviceModel
       Configuration/applicationSettings
          NotificationTemplatesFolder
          LicenseKey
          LogFileName (for LightSpeed)
       Configuration/system.web
       Configuration/system.webserver
       Configuration/system.net
          host
          port
          userName & password
       Configuration/runtime
 Administration Guide
    Site Preferences
       Setup
       Display
       Logo
       Contact
       Version
       Images
    Billing and Fees
       Edit Fees
       Payment Providers
       Authorize.Net
       Credit Card Types
       PayPal
       Fee Invoices (New)
          Site Fee Invoice
       Fee Invoices (Paid)
    Users
       Management
       Custom Fields
    Listings
       General
       Auction
       Fixed Price
       Classified
       Extend
       Shipping
       Custom Fields
    Categories
       General
          Edit Category Detail
    Region
       General
    Content
       General
          Editor
    Banners
    International
       General
       Currencies
          Conversion
       Languages
       Cultures


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