====== Installation Script ======

After your files have been uploaded, the installation script can be initiated from your browser. Depending on where the files were uploaded, the URL to the installation script should look like the following:

Example: https://www.yourdomain.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 folder.

**Step 2: System Requirements**

This step will check to make sure that your server meets the installation minimum requirements. It is suggested that you fix all items marked in RED before continuing.

**Step 3: Validate License**

This step will validate the license key that you have entered into the config.php file in the previous step.

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 4: Confirm Configuration**

This step will make sure you have the appropriate settings in the config.php file and it will make sure the database exists. If the settings are not correct or you receive an error, edit the config.php in the include/ directory before you attempt to continue.

**Step 5: Connect To Database**

The script will attempt to connect to the database. Depending on your settings, you may get different results at this point. Below is a list of some results you may get.

  * //"Connection complete!"// - This means the connection has been made, you may proceed.

  * //"You have specified a non existent database... Please wait."// - If the database you specified needs to be created the installation script will attempt to create it. 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 wording of this error may vary but this ultimately means that the username or password you entered were incorrect. This can also mean that you do not have access to the database.

  * //"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 Normally" or you can choose to "Continue and Reset Database". If you select the first option it is a good idea to define a value for the "$dbprefix" in the "config.php", as discussed in the previous step. This way, you do not overwrite any data you have in your database that you may need later. 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 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 6: Install SunShop**

At this point you should see only one message //"All SunShop tables and data have been installed successfully. Please continue to create an administrator account"//. If you get this message, continue to the next step.

If you get a message similar to //"There seems to be a slight problem with the database..."//, make sure to note the error and open a ticket, if needed. You may need to go back and select the reset database option in order to continue. If you do reset the database, make sure the database is empty or you will lose all existing data.

**Step 7: Create Administrator**

In this step you will need to setup your admin account. You will need to choose a username, password and email address for the primary account.

**Step 8: Setup Successful**

Congratulations, you have successfully installed SunShop.

If you receive an error at this point, there was most likely an issue sending the verification email to confirm your installation. You don't need to take any immediate action as the install was successful, but you will need to edit the mail settings in the general settings once you login to SunShop.

**Continue to [[sunshop:final-steps|Final Steps]]**