These instructions cover installation of AuctionWorx Enterprise in standard mode. Standard mode allows an AuctionWorx web application to run on a web server alongside other web applications and/or installations of AuctionWorx. The major components of the installation are as follows:
Microsoft Windows Server
AuctionWorx runs on Microsoft Windows Server, preferably Windows Server 2008 or higher.
Microsoft SQL Server
A Microsoft SQL 2005 or higher database is required. The database should support Full-Text Indexing which is an optionally installed component of Microsoft SQL Server.
Microsoft Internet Information Services (IIS)
AuctionWorx standard installations run under IIS 6 or higher. IIS 7.5 is recommended.
The following are integral file system components of any AuctionWorx installation:
The Web Root folder is where the main AuctionWorx web application files are stored.
The Log folder retains all logs written to by the AuctionWorx system.
Email Notification Templates Folder
The Templates folder stores all email templates the AuctionWorx system uses.
The license key allows you to activate your AuctionWorx installation per your agreement with RainWorx.
Regarding security, there are two security principals to be concerned with when dealing with IIS, the Worker Process and the Anonymous User. The Worker Process is the executable actually serving AuctionWorx. Anonymous User is the security identity of your site usersge.
In the following instructions reference is made to “Full Permission” and “Read-Only Permission.” What this means can vary depending on what versions of Windows and IIS you are running. “Full Permission” refers to the web site’s ability to write files or write to files. “Read-Only Permission” refers to the web site’s ability to read files. Your environment may vary depending on whether you allow anonymous access to your AuctionWorx installation. Consult your administrator or web hosting company if necessary.
- Create a Microsoft SQL database. It should be assigned a user with Database Owner Privileges (db_owner aka dbo). Microsoft Full-Text Indexing should also be installed with the SQL Server.
- The SQL folder in your installation package contains the AuctionWorx database scripts. Execute the script, “AuctionWorx.sql,” against the database you created in step 1. Optionally, and subsequent to the default data script, you may also execute the default categories script, “AuctionWorx_AddCategories.sql,” to populate default categories. Be advised, the default categories script will take a while to execute as it optimizes category hierarchies for the 25,000+ categories it contains.
- Create a non-web accessible folder to store the Logs (the default location is C:\Logs). This folder should be separate from other installations of AuctionWorx. This folder requires the Worker Process to have Full Permission.
- Create a non-web accessible folder to store the Email Notification Templates (the default location is C:\templates). This folder should also be separate from other installations of AuctionWorx. This folder requires Worker Process to have Read-Only Permission.
- Copy the contents of the Templates folder from the installation package to the Templates folder you created in step 4.
- Copy the contents of the Web folder from the installation package to the Web Root of the new AuctionWorx installation. This folder requires the Worker Process and the Anonymous User to have Read-Only Permission.
- Within the Web Root, you must assign the Worker Process Full Permission to the \Content\images\Logos folder. Although your site's users will upload images, the Worker Process is what actually writes them to the file system.
- Within the Web Root, you must assign the Worker Process Full Permission to the \Content\images\Banners folder. Although your site's users will upload images, the Worker Process is what actually writes them to the file system.
- Within the Web Root, you must assign the Worker Process Full Permission to the \Content\listingImages folder. Although your site's administrator(s) will upload logo(s), the Worker Process is what actually writes them to the file system.
- Edit the connection string in the web.config file, now located in your Web Root, to refer to the database you created in step 1.
- Edit the “NotificationTemplatesFolder” setting in the web.config file, now located in your Web Root, to refer to the correct location of the Templates folder you created in step 4.
- Edit the web.config file to replace all instances of “C:\logs” to refer to the correct location of the Log folder you created in step 3.
- Edit the “LicenseKey” setting in the web.config file, to contain your provided license key.
- Edit the "mailSettings" section of the web.config file to refer to your email server (if login is not required, remove the username and password attributes).
- Create an IIS web site pointed to Web Root you prepared in step 6. Set the ASP.NET version to .NET 4.0.
- The default administrator login for your new installation of AuctionWorx is username “admin” and password “admin1234”.
- Login to the site to change the administrator’s password. For more information see the Administration Guide.
It is recommended you use an SSL certificate to encrypt communications on sensitive pages of your installation. After you've installed an appropriate SSL certificate perform the following steps:
- Login to the site as an administrator and access the "Admin Control Panel."
- Under "Site Preferences / Setup," set the "URL" and "Secure URL" properties appropriately.
- Set the "EnableSSL" setting in the web.config file to "true". Once you do this, the above URL settings will be enforced.
- Additionally for AJAX to continue to work with and without SSL, you must also uncomment the second "RainWorx.FrameWorx.MVC.RealTime" endpoint reference in the web.config.