How to successfully upgrade via ftp software?

Preparation

  1. Please first take a backup as described in the Manual and by downloading all files from your server’s site implementation as your local copy of the current files.
  2. if your site is online when starting to make this upgrade, please put a temporary index.html on your site folder to say that you are on maintenance process for a while. Then your process won’t be seen or interfered by anyone else in the world.

Upgrade process

  1. In your FTP software open the local folder of Campsite (campsite/implementation/site) and you should see all the folders needed. Select in your ftp’s local view all the other folders and files except not “conf”, “bin”, “admin-files”, and “templates”.
  1. Transfer selected files over your campsite files in the server (once again only after you are sure you did take a backup copy of all of them). If the process is stopped by your ftp software with a complaint of permissions in the files index.php and admin.php, start the transferring process again without these admin.php and index.php.
  1. Open local folder “conf” and transfer its content into the server’s folder “conf” (do not replace the folder, only add / replace with the selected files from the local folder, leave other files in the server inside “conf” intact, meaning keep your “database_conf.php” there)
  1. Open local folder “bin” and transfer its content into the server’s folder “bin” (do not replace the folder, only add / replace with the selected files from the local folder, leave other files in the server inside “bin” intact). Note that the folder “bin” has your backup copy if you have taken it in the beginning like the Campsite manual guides you to do.
  1. You can check that your folder “templates” still have your personalized template files. No need to add there anything.
  1. Check the permissions of your files index.php and admin.php. You may need to give more permissions for the upgrade process than they have (for example 755 or 777). If the ftp software refuses to change the permissions, please remove these from your server side and upload there new ones from the upgrade folder open on your local view and then check the permissions again.
  1. Open the folder “admin-files” locally and select everything else except the folder “lang”. Transfer selected files over your campsite admin-files content in the server.
  1. You should be ready to go on your web browser and access the site. An automatic process of upgrading should start quite shortly. If you see only a blank site, you may need to check you followed exactly the guide here or check the index.php settings for permissions again as well. Please log in to your admin site and make sure all is fine there as well. You should see the new version number (the proof of upgrade) on the bottom of the admin site.

If something goes wrong anyway

  1. Take first your local copy of campsite files that you saved in the preparation step 1 and transfer them back to your server. Check if that brought back the site like it was before the upgrade procedure.
  2. Read this upgrade guide again and make notes if anything was made differently than adviced. If so, try to make the upgrade again learning from the mistakes in the first attempt.
  3. If something still goes wrong or you do not see what could have been made wrong, check your server error logs and permissions once again. Look if any folder or file looks corrupted by the upload process in the server.
  4. If all above is not helping, look the answers in the forum or make your own question there. Please give as much as possible information about your steps regarding the upgrade and the error messages you may have got.