Upgrading Your Store

Upgrading Your Store > Upgrading Your Store To A Newer Version > v6.2.x.x to v7.0

Upgrading AspDotNetStorefront from v6.2.x.x to v7.0

Related Topics: The Admin Site v7.0 | PABP Guidelines

Overview:

AspDotNetStorefront has improved its protection especially for our customers. We have changed the procedure for releasing all products starting with our version 7.0 release. We are doing this change in order to comply with PABP (CISP/PCI) requirements.

When you upgrade, upon downloading the zipped files (NON SLA version), you will ONLY see two (2) directories:

1. /db

2. /web

This is normal. You will not get all source files until you complete our Source License Agreement. The files you initially downloaded are just to run the website. You may even notice that there are NO skin previews are populated by default, as they are not necessary.

What you need to do to complete the downloading of all the source files are in three (3) quick and simple steps:

1. Download the Source License Agreement (SLA) at http://www.aspdotnetstorefront.com/manual/SLA.pdf.

2. Sign the SLA.

3. Fax it back to us at the number stated at the SLA.

Upon completion of the said task, we will ship to you the download link for the SLA version. Then you should be able to have the following source files:

1. ASPDNSFCommon

2. ASPDNSFControls

3. ASPNDSFEncrypt

4. ASPDNSFGateways

5. bin

6. db

7. GlobalErrorHandler

8. QBMSGateway

9. Web

Upgrading Instructions:

Upgrading your AspDotNetStorefront from v6.2 to v7.0 is a pretty easy task. Certain points are re-iterated to ensure pertinent data will not get lost and your website will work properly again. Below are the procedures you need to follow:

Perform a FULL back up of the following listed below, as you may need one or all of those files later. Double check them before proceeding to the next step.

o        your database

o        /images (directory)

o        /skins (directory)

o        /XmlPackages (directory)

o        /StringResources (directory)

Ensure that you have the EncryptKey and DBConn string from your current web.config file.

Upgrade your database by running ONE of the provided upgrade scripts in the new /db directory. You only have to run ONE! Run the one that starts with the major.minor version number you are using. For example, if you are on v6.1.(anything), run the Upgrade_6.1.x.x_to current.sql.script. But since we are upgrading from v6.2, then you must run the Upgrade_6.2.x.x_to_current.sql.script. You do not need to run both scripts.

Once you are sure you have everything saved, delete the ENTIRE directory containing your website. DO NOT OVERWRITE FILES IN THE SITE! WIPE EVERYTHING OUT! (Remember, you have already made a copy of them). This is an important step. Overwriting files may give you numerous problems and may need you to REINSTALL eventually.

Download the latest version of AspDotNetStorefront zip file and extract the contents to a new folder. You will then use only the contents of the sub directory WEB (/web folder). Copy the new master release files from the /web folder and paste them to your website folder.

From your back-up files, copy the following and paste back to your website. Overwrite the new files if needed, so yours will take priority.

o        /images

o        /skins

o        /XmlPackages

Modify your new web.config file and put back your prior DBConn string and EncryptKey values. These must stay the same as your existing site values. You can then later change your EncryptKey values periodically in the 7.0 admin site. (See also modifying web.config)

You may also need to check if there's still a write permissions on /web folder for the IUSR_XXXX, and ASPNET (Windows XP) and NETWORK_SERVICE (Windows 2003) accounts. This is so our application can update that file, and encrypt it. You must do this before you run the 7.0 site for the first time! This is so the new security and encryption can be used in the web settings. Add write permission if necessary.

Once you have completed the above steps, restart your website by doing an IISRESET. (See also Restarting your website)

Since you are upgrading from v6.2 to v7.0, check your .NET version in IIS. It should be in version 2.0 as well.

When your new sites come up again, reload the (old) StringResources using your admin site. To do that, login to the admin site, go to Misc menu and then click String Resources. Set the Locale Setting (left section) to en-US (if this is your site language) and then click Reload from Excel File On Server. This is also important, to restore your string resources in your website. (See also String Resources Manager)



Test your website.