Glossary Item Box

Squirrelcart v6.1.0

Upgrading - Installation and Upgrade Script

Overview

To complete your upgrade, you will need to update your configuration file, upgrade your database, and set permissions (if needed). This is all accomplished using Squirrelcart's Installation / Upgrade script.

 

Because every installation is unique, there is no single way to explain the upgrade process that will work for everyone. We will provide a walkthrough of a typical upgrade below. When you run the Installation / Upgrade script, be sure to read each page carefully and follow the instructions shown.

 

If you encounter problems setting permissions during the installation script process, you may be instructed to modify your configuration file and/or set permissions manually. If you see a message instructing you to do so, you can find topics to assist you in the Installation > Additional Resources section of this documentation.
Launching the Installation / Upgrade Script

To open the installation script, open your browser and go to the URL that represents the location that you uploaded the sc_install folder to:

http://www.example.com/sc_install/

 

If permissions need to be set, the installation script may prompt you for your FTP authentication information. For this reason, if you have access to your website using a secure URL, we recommend that you use that URL for the installation process: https://www.example.com/sc_install

 

You will need to replace "example.com" with your domain name. You should then see the welcome screen.

 

You will then need to click the Click Here to Begin button, and follow the instructions. We will provide an example walkthrough below.

Installation Script Walkthrough

After clicking the Click Here to Begin button, the installation script will find your squirrelcart/config.php file. If you did not modify it manually, the installation script will detect that it needs to be updated. The script then checks to see if it has permissions to write to the file. If it does not, you will see the following screen.

 

 

If you see this screen, follow the instructions and click Connect. If the information you entered was correct, you should see something like this:

 

 

Click Continue and you should be taken to the configuration file form:

 

 

Because this is an upgrade and you renamed your old squirrelcart folder, the installation script should detect the prior installation, and show you a link to import your old config.php file information, as seen in the Old Config Files section in the screenshot above. Click on the file that you want to import, and the page will refresh with the fields populated from your prior installation. Then fill out the remaining fields using the examples provided as a guide, and click Save Changes. If any of the values you entered fail validation, you will be prompted to correct them. Once the configuration information you entered is submitted successfully, the installation process will modify your configuration file with the new values, and you will then see the page below.

 

 

 

The page above is only shown when the database you are connected to contains Squirrelcart tables from an older version. If the heading on your page reads Database Installation, you've accidentally connected to an empty database.

 

This page displays the current version of your cart, and the version you will be upgrading to. We recommend that you make a backup of your database prior to upgrading it. To do so, click the link shown above in the line that reads "If you wish to backup your database, click here". After clicking that link, you should see the following page.

 

 

 

 

Click Upgrade Database to continue.

 

 

 

If you encounter an error during the upgrade process, read the Upgrading > Additional Resources > Database Upgrade Failure topic in this documentation before continuing.

 

After upgrading your database, click the Continue button. If the new version requires changes to any files (your storefront page) or folders (image folders, folders inside the sc_data folder, etc...), you may see a page similar to the one below:

 

 

 

 

The list of tasks that will be performed will vary depending on your prior version of Squirrelcart. Read the instructions, and click one of the buttons. After completing the file upgrade portion of the installation, you should see the following page.

 

 

 

Follow the instructions provided, and click the Open Storefront Page.

 

 

 


© 2001-2017 Lighthouse Development. All Rights Reserved.