Upgrade

Important! This Guide is only if you have version 1.5 installed. If you do not have version 1.5 installed please view this guide first.

Version 1.5.1 is the stepping stone to phpFoX Konsort Version 2. As you may or may not know Konsort is our new engine. Since everything has been built from the ground up to create a new system and enviroment we have taken time into creating a rather large update system to make sure upgrading to this new engine wont be as complicated as one would think. In this guide you will find everything you need to now to fully upgrade your site. Simply follow the guide step by step and you should be on your way using Konsort in no time.

If at anytime during your upgrade you ran into trouble, please click on the "Help!" link in the top menu bar for the most commun issues that might help fix your issue. Most upgrade issues we have come across in the past we have complied in a list to help you debug and fix your issue right away.

Upgrade: Step 1 - Uploading

At this point you should have the zip archive "unzipped", which should have contents similar to those shown in this structure guide:
upload/
Readme.html

Go into the folder "upload/", which should have contents similar to those shown in this structure guide:
design/
include/
plugins/
site/
update/
index.php
robots.txt
Upload the files and folders to your site where you already have your phpFoX site installed. Be sure to overwrite any old files.
Once that is completed and all files have been uploaded to your server we can move on to the next step.

Installing: Step 2 - CHMOD & File Permissions

Below you will find the folders and files that must have full write permission and set to 777 in order for the script to be updated.

Konsort Files:
update/file/
Once you have completed CHMODING all the needed files and folders please continue to the next step.

Installing: Step 3 -Using the Web-Installer

An installer is provided to assist you in updating your database tables with our latest build.

Run the installer file through your web browser by entering the URL into your browser address bar (if you have followed our example, type in http://www.domain.com/update/index.php, naturally subsituting 'domain.com' for your web address.)

You will be presented with a short information screen, if you receive the following error "Please grant write permissions to `update/file/` directory...", CHMOD the folder "update/file/" to 0777 via your FTP client.

Once you pass that check you will be able to view your Konsort setup script. This setup will consist of 5 steps.
Please follow each step:

Admin Login

First step you will need to log into the update script with your admin login details.

Step 1 - License

Next step you will need to complete is the agreement to the phpFoX license agreement. Once agreed upon continue to the next step.

Step 2 - System Check

Step 2 will consist of checking your server settings and if all files/folders have the permission they need for the script to be installed.
The following settings will be checked on your server:
  • PHP 4.3.1 and more
  • GD extension - If exists
  • If main site is turned OFF
Apart from the server checkup it will also check if the files/folders that we listed in "CHMOD & File Permissions" have the correct permissions.

Once you have passed the system checkup continue to the next step.


Step 3 - Updater info

This step will get your mySQL details. In most cases you wont have to fill them out since it will get your sql settings from your old config file.

Under the SQL setup table you will have the Server Configuration table. There you will find where it says "Rewrite engine supported?", this setting is for those who have a server that supports Apache's Rewrite Module. If you are not sure what this is please ask your host or view this guide. In short phpFoX uses this module to allow URL's to be shorter then the default method.


Examples:
Rewrite ON: www.yoursite.com/gallery/
Rewrite OFF: www.yoursite.com/index.php/public/gallery/ or www.yoursite.com/index.php?do=/public/gallery/

Both methods are fine, though we would advisee turning ON the rewrite engine if you have support for it since search bots seem to like it.

After submitting the form, you will be informed of any errors - if you do get an error similar to "permission denied for user@localhost using password YES" - the chances are you have either your mySQL username, mySQL password or mySQL database name wrong. Consult with your webhost for the correct information and resubmit the form.


Step 4 - Updater

Step 4 will list if any errors are found and it will explain what needs to be done to fix the issue.

If no errors come up you will see a button to "START UPDATING". Click on that and you should be on your way to upgrade Konsort.

Note: Update process can take a rather long time depending on how many members you have.


Step 5.1 - Finishing Installation

If you updated your system with the rewrite engine you will also have to move a file called "htaccess" (without the quotes) which is located in the folder update/file/ and move that to your sites root directory and then you will have to rename that file to ".htaccess" (without the quotes).

This step can easily be done via your FTP client by dragging and dropping each file into the specified directory.

Once that is completed move on to the next step.


Step 5.2 - Finishing Installation

Delete the /update/ folder from your server.

Congratulations! phpFox 1.5.1 has successfully been upgraded!

If you ran into trouble, please click on the "Help!" link in the top menu bar for the most common issues that might help fix your issue.

We also created a small "Crash Course" guide with some FAQ and tutorials on how to start up your phpFoX Konsort package.

For a full list of methods we offer our clients support click on the "Support" link in the top menu.

>> Read up on the Crash Course guide and learn how to start up your site!