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 > WCF Services Installation

WCF Services Installation

These instructions cover installation of AuctionWorx Enterprise in WCF Services mode.  WCF Services mode allows an AuctionWorx web application to run on a web server and communicate with back end services via Windows Communication Foundation.

Install Services

This step involves installing the three main AuctionWorx services as Windows Services.  They are:

  • RainWorx.FrameWorx.Command.exe
  • RainWorx.FrameWorx.Notifier.exe
  • RainWorx.FrameWorx.Scheduler.exe

Install the services as follows:

  1. Copy the services, their config files, and all the binaries to an appropriate location.
  2. Locate installutil.exe.  Installutil.exe is a .net utility to install services.  It may be located in C:\Windows\Microsoft.NET\Framework\v4.0.30319.
  3. Run "installutil {servicename}" for each of the three services.
  4. The services should now be installed (but not yet running).

Edit Configuration Files

All service configuration files are named identical to the service name with ".config" appended to the end of the filename.

RainWorx.FrameWorx.Command

Many of the configuration options you are are responsible for in the Standard Installation document are similar, but are contained in the configuration file for the RainWorx.FrameWorx.Command.exe service.  This service handles all back end calls to AuctionWorx Eenterprise.  As such you are responsible for the following settings:

  1. Edit the connection string in the config file to refer to the database you created.
  2. Replace all instances of “C:\logs” to refer to the correct location of the Log folder.
  3. Edit the “LicenseKey” setting in the config file, to contain your provided license key.

Additionally, by adding the <baseAddresses> you can specific where the WCF services shall be hosted.

RainWorx.FrameWorx.Scheduler

This service handles starting/ending listings, listing resolution, and refreshing fees:

  1.  Replace all instances of “C:\logs” to refer to the correct location of the Log folder.

RainWorx.FrameWorx.Notifier

This service handles all outgoing email notifications:

  1. Edit the “NotificationTemplatesFolder” setting in the config file to refer to the correct location of the Templates folder you created.
  2. Replace all instances of “C:\logs” to refer to the correct location of the Log folder.

Modify web.config To Operate via WCF

  1. Modify the <endpoint> addresses to point to the addresses you specified for the Command service above.
  2. If necessary, modify the WCFClientEndpoints in the <applicationSettings> section to properly refer to the WCF endpoint you'd like to use.  For example, "NetNamedPipeBinding_IListingManager" uses the named pipes endpoint, while "WSHttpBinding_IListingManager" uses the Web Services HTTP Endpoint.
  3. Finally, change the "ExecutionContext" setting to "WCF."

Start the Services

Start the three WCF services and begin using AuctionWorx.  All client calls should communicate with the services via WCF.

 

See also