This is an old revision of the document!
There are 2 versions of the update instructions, the Quick Update Instructions or the Full Update Instructions. If this is the first time updating the software, or if you are updating from a version before 6.0.0, or if you just like having all the instructions right in front of you with nothing left out, see the Full Update Instructions.
There is also Professional Installation or Update Service available.
These instructions are smart instructions: When you first view the instructions, you will enter in the product and version you are updating from. It will then generate a set of instructions specific to that product and version, only showing the steps necessary for that update path and skipping anything that does not apply, such as any steps for updating older versions than you already have.
We highly recommend using these instructions as they are much more thorough and include every step you might need. As long as you follow every single step in the instructions, you should have a smooth update.
These instructions are great for anyone that is already familiar with the update process, to use as a "checklist" so nothing is forgotten. These instructions are short and to the point, and may be hard to follow if you are not familiar with the update process. If one of these steps is not clear to you, we recommend sticking to the full update instructions until you are familiar with the update process.
<tip c w>Compatibility: If you are updating from a version before 6.0.0, use the Complete Update Instructions.</tip>
< <
<tip c n>Note: If you have custom system, module, or addon templates1), don't forget to check to see if adjustments are required for your update! See Geo Updates & Customized Templates for instructions and tips to help you do this.</tip>
Are you worried you will have to re-apply your settings? Or wondering if your site design will be reset when you update? Below we answer some of the most asked questions about what an update will affect.
<tip c n>Note: Everything mentioned in this section is assuming you are following the Quick Update Instructions above or the Complete Update Instructions. If you skip any of the steps, such as the ones for backing things up, this information may not apply to you. </tip>
When you update, the following is a short list of what people tend to worry the most about, when asking the question of what is or is not changed. This is not a complete list, just the list of things people ask about most often.
<tip c w>Warning: The following is true most of the time, but there are special cases, the most notable from if you are updating from a version before 3.1.0. In such special cases, when you use the Complete Update Instructions, it will tell you about them specific to the product and version you are updating from. Those special cases are most likely to occur in feature releases where we tend to make the most changes in order to add new features to the software. We will also make note of those types of changes in the Release Notes, and will usually mention it in the forum post for the new release. </tip>
What is or is not Changed
For anything not in that list, the general rule of thumb is this: If it is a file, it will most likely get over-written in an update. If it is something you change in the admin panel, it will most likely not change in an update.
Problem: When running the update, you get the following error displayed:
Internal Critical Error (265):Progress data in database is corrupt (entries in `geodesic_upgrade_progress` do not match upgrades array). Please contact Geodesic Support.
Explanation: This can happen if the previous update was never finished fully, if the person that did the update did not click "finish" after the updates were run. Basically what happened is that the previous update progress was never cleared, so when you try to run the new update, even though it is some time later, the update progress from the last update is still there and it does not match up with the updates that need to be run.
Solution:
In 4.1.2 and above: In your browser, go to upgrade/index.php?resetProgress=1 - for example, if the software was installed at the location example.com, the URL you would go to is http://example.com/upgrade/index.php?resetProgress=1.
Or, remove the tables geodesic_upgrade_progress and geodesic_upgrade_queries using PHPMyAdmin.