Installing & Upgrading SunShop > Installation

After your files have been uploaded, point your browser to your server where you uploaded the files. You will need to find the install path and locate the install file.

Example: http://www.yourserver.com/sunshop/install/

Step 1: License Agreement

You will need to read the license agreement and agree in order to continue. If you are unable to see a submit button at this point you should try re uploading the install file.

Step 2: Validate License Key

This step will ensure that you have the proper license key file on your computer as well as check the integrity of the license. If any of the checks fail you will not be able to continue with the install. If the domain name does not pass you most likely entered the wrong domain into the system when you generated your key. If this occurs please contact support so they can reset the key in your client account.

When entering your details, there are two options to pass the license key step.

Option 1: License Retrieval

For this option you will need to enter in your login information for the client area on the Turnkey Web Tools site. If you have not yet generated your license key this method will not work. Your license key must be generated and available in the license key tab.

Option 2: License Key Entry

For this option you will need to simply paste your license key into input box. The next step will validate your license as entered. Be sure to enter all of the text as displayed in the license key tab.

Step 3: Confirm Configuration

This step will make sure you have the appropriate settings in the config.php file and it will make sure it exists. If the settings are not correct edit the config.php in the admin directory before you attempt to continue.

Step 4: Connect To Database

The script will attempt to connect to the database using the config.php.

Depending on your settings you may get different results at this point. Below is a list of some results you may get.

"Connection Complete!" - the connection has been made, you may proceed.

"You have specified a non existent database. Trying to create one now..." - If the database you specified needs to be created it will attempt to do so. If it is unable to create the database you will need to make sure you have the permissions to do so.

"Warning: Access denied for user: ''user@localhost' (Using password: Yes)" - The look of this error may very but this basically means that the username or password you entered were incorrect. This can also mean that you do not have access to the database.

"Connection Complete! The database already exists." - This means the database you are trying to connect to already exists. At this point you can choose to continue regularly by selecting "Continue To Next Step" or you can choose to "Continue To Next Step And Reset Tables". If you select the first option it is a good idea to define a value for the "$dbprefix" in the "config.php" as defined in the previous section. This way you do not overwrite any data you have in your database at the present time. If you select the second option, the tables needed will be erased and recreated. DO NOT select to reset if you have data you need in the database you defined in your "config.php" file.

"Can't connect to local MySQL server through socket..." - If you get the above error you must check to make sure that MySQL is running on your server. If you believe it is make sure you have the proper location to the mysql.sock defined in your my.conf file.

If you get any other error message and need assistance please contact us.

Step 5: Creating Tables

At this point you should see only one message "Tables set up successfully". If you get this message continue with the next step.

If you get a message similar to "There seems to be a slight problem with the database..." view the source of the page to get the exact error message. You will find the error at the very bottom of the page. You may need to go back and select reset in order to continue.

Step 6: Add Administrator

In this step you will need to set yourself up as the primary operator. You will need to choose a username, password and email address for the primary account.

Step 7: Setup Successful

Congratulations, you have successfully installed SunShop. At this point be sure to DELETE the "install/" directory.

If you receive an error at this point, there was an error sending the email to verify your installation. You don't need to take any immediate action as the install was successfully but you will need to edit the mail settings in the general settings area..

*IMPORTANT* You will need to chmod 777 (allow global read, write and execute permissions) on the images/products/, catalog/, admin/reports/ and the admin/backup/ directory in order to be able to use all of the features of the cart..