This guide covers installing the software on Windows XP, using IIS 5/6. For directions for Vista, please see here or for Server 2003 see here.
NOTE: We recommend that you maintain 3 functional types of installs:
- Live Site (production server)- This is your public-facing live site.
- Staged Site (production server or local install)- This is a clone of your live site. Perform modifications and test them here to protect your live site from issues and down-time.
- Dev Site (production server or local install)- This is a completely stock out-of-the-box install where you can compare stock functionality and behavior with issues you get with your staged/live sites. This is also good for a quick resource of stock files as needed.
Pre-installation Procedures
The following 3 sections cover the installation of 3rd-party software required for the ASPDNSF software to run. Note: Customers installing the software on shared hosting accounts can skip the directions in this section, as the hosting company will have done these steps for you.
Installing IIS
Windows XP does not generally have IIS installed by default, so it will probably have to be done manually. To do so, follow these steps:
1 – First, go to Start → Control Panel, and open Add/Remove Programs.
2 – In the panel on the left, click Add/Remove Windows Components.
3 – In the window that opens, find the 'Internet Information Services (IIS)' option and check it.
4 – With that option still highlighted, click the "Details" button. Scroll to the bottom of the new window and ensure that 'World Wide Web Service' is checked, then click "OK".
5 - Click "Next" and the files will begin to copy. You may be prompted to insert the original Windows XP install CD.
6 - Once the file copy is complete, click "Finish".
7 - In Control Panel, open 'Administrative Tools' and IIS should now be installed.
Installing the .NET framework
Directions for installing the .NET framework version 3.5 are as follows:
1 – Download the install package from Microsoft by clicking the Download button at http://www.microsoft.com/downloads/thankyou.aspx?familyId=333325fd-ae52-4e35-b531-508d977d32a6&displayLang=en
2 – Save the dotNetFX35Setup.exe file locally, then run it.
3 – Click Next and agree to the EULA, then click Finish once the install completes (this can take quite a while).
Installing Microsoft SQL 2005 Express and Server Mgmt Studio Express
See
this page for instructions on installing the database components.
File Setup
The first step in installing the ASPDNSF software is to get the files in place on your machine.
Note: This guide assumes the files are being installed in the default location for IIS, C:\inetpub\wwwroot\. If your server configuration requires a different location, substitute that path during the install process.
1 – Log in to http://www.aspdotnetstorefront.com/mylicenses.aspx and click the link to Download the software next to your license. Note: Your licenses page may vary slightly.
2 – The download file will be an executable file named something similar to aspdotnetstorefront_ml_csharp_7.1.0.0.exe. Once the download has completed, run the executable and click Next.
3 – Read the End User License Agreement, then click Yes to indicate acceptance.
4 – Browse to the desired install folder, then click Next.
5 – Wait for the files to extract.
6 – Review the readme information if desired, then click Next.
7 – Click Close to complete the file extraction.
8 – Navigate to the folder you extracted the files into, and open the Web folder.
Note: You may not have all of the files/folders depicted here, depending on your license type.
9 – Right-click on the /images folder and click on Properties. (note, the following 5 steps will be performed on the AddIns folder as well - see below)
10 – Click the Security tab.
11 – Click Add.
12 – Click Advanced.
13 – Click the Find Now button, then scroll through the list of accounts that appears and select NETWORK SERVICE ( NOTE: On some machines, this user account will be called ASPNET instead. ). Click OK, and then OK again.
14 – Make sure that the NETWORK SERVICE account has Read, Write, and Modify access, then click OK.
15 – Repeat steps 9 - 14 for the AddIns folder.
Database Setup
Next, you need to create the database that the software will store your data in.
Note: The screenshots in this section are of a standard MS SQL Server Mgmt Studio install with no extra security measures in place. Your screens may look slightly different depending on the setup and security policies your administrator/host use.
1 – Open Microsoft SQL Server Management Studio and log in with the credentials given to you by your system administrator or host.
2 – Right-click on Databases in the tree view and click New Database.
3 – Enter a name for the database and click OK.
4 – Highlight the new database in the list and press CTRL-O on the keyboard. Navigate to the /db folder where you just extracted the new storefront files, and highlight the database creation script file and click OK. The name of this script will vary according to the version of the software you are installing:
8.0.0.0 = aspdotnetstorefrontdb_mssql.sql
8.0.1.0+ = Create AspDotNetStorefront Database.sql
NOTE: For versions 8.0.1.0 and higher, the DB creation script does not create sample entity/product data in the new store. If this demo data is desired, after running the above script, you will also need to run an additional script against the DB the same way. For the MultiStore version, run the script named "Install Demo Website Data.sql". For MultiStore express, run "Install Express Demo Website Data.sql".
5 – Click the Execute button.
6 – Verify that the script ran with no errors.
7 – Now, you must modify the web.config file to connect to the database you just created. Navigate to the /web folder where you extracted the storefront files earlier and open up the file in notepad.
8 – Find the line pictured below, and change the ‘TBD’ to your own EncryptKey value. The value can be any combination of letters and numbers, and should be at least 10 characters long.
9 – Find the DBConn line pictured below, and change the following values:
NOTE: Your host or server admin must provide this information, AspDotNetStorefront cannot tell you what to use for these values.
• data source – This is the server/instance name where SQL is installed. If installing on a local server, this will often be simply ‘localhost’ or the machine name.
• initial catalog – This is the name of the database you just created.
• user id – the ID used to connect to the database
• password – the password used to connect to the database
10 – Save your changes in Notepad.
IIS Setup
The last step in the install is configuring IIS.
Note: Your server admin or host may have to provide additional steps for this portion of the install, depending on the server configuration. These steps cover a basic install.
1 – First, open IIS from the Administrative Tools menu in Control Panel and expand the tree to view the folders under Default Web Site:
2 – Right-click on Default Web Site, and go to New -> Virtual Directory.
3 - Click 'Next'.
4 – Enter a name for your site in the Alias field (generally the same as the folder name you created for the files earlier) and then click 'Next'.
5 – Browse to the folder you created earlier that contains the web.config file, and click 'Next'.
6 – Click 'Next' again.
7 – Click 'Finish'.
8 – Right-click the new application that will appear under Default Web Site, and verify these settings:
- On the Documents tab, that default.aspx is listed as a default document
- On the Directory Security tab, in the Anonymous Access and Authentication Control section that anonymous access is enabled
- On the ASP.NET tab that the ASP.NET Version is set to 2.0
9 – Right-click the application you just added under Default Web Site, and click ‘Browse’. Your site should open in the right-hand window – installation is complete!
For information on using the admin site and the default login credentials, see this page.