Upgrade Steps
1. Backing Up Your Files:
Please make sure that you have backed up your files before continuing. You can find the backup documentation on the Backing Up page.
2. Upload New / Changed Files:
When replacing your files, the easiest way to make sure that you do not leave any unnecessary files on the server is to delete all of the files on your server EXCEPT the files and folders listed below. Everything else you can delete safely. If you have made changes or modifications to core files, you can alternatively upload only updated files and get a list of those updated files by reading the change log.
Files To Preserve:
- /include/config.php - This file has all of your database information and your license key within it.
- /images/products/ - This folder contains all of your product images.
- /themes/ - This folder contains your themes and template files. If you have made customizations be sure to rename the theme folder or keep a backup.
- /admin/reports/ - This folder stores your site reports. It can safely be deleted if you do not need to preserve older reports.
3. Run The Upgrade Script:
Ensure that the “install” folder is uploaded into your SunShop directory. Next, navigate to “https://www.yourdomain.com/sunshop/install/” changing your domain and SunShop directory as needed.
- Step 1: License Agreement: You will need to read the license agreement and agree to the terms in order to continue. If you are unable to see a submit button at this point you should try re uploading the install folder.
- Step 2: Validate License: This step will validate the license key that you have entered into the config.php file when you first installed SunShop. The value for your license key can be retrieved from the TWT account area at https://www.twt-inc.com/clients/. Your key should start with either “SS-”, “SSO-”, “SSL-” or “SSASP-” followed by a series of numbers and letters.
- Step 3: Upgrade Database: Assuming all of the previous steps completed, the upgrade script will run or attempt to complete the upgrade of the database. Please note that if you are upgrading from a version prior to version SunShop 4.0, you may be asked additional information at this point and you may be required to check a “backup satisfaction” box before the upgrade can properly run. Also, be sure to notice any messages that may be displayed on screen. Upgrading from older versions of 4.x may reset your admin passwords to improve security and it is important to note these changes after completion of the upgrade.
4. Delete The Install Directory:
In order to login to the admin area, you will need to first delete the install/ directory.
Your upgrade is now complete!