This guide will show you through the steps on upgrading your software using the upgrade utility. If you have not yet downloaded the new version of the software and uploaded this to your site, please see the previous guides in the menu on your left.
If you have got to this stage, then you have everything you need for upgrade of your software. Next you will need to visit the upgrader itself. You can get to this from the browser location corresponding to where your admin cp was located on your IP.Board installation + '/upgrade'. In this example my admin cp was at http://localhost/demo/admin . This being my location for the sites admin cp, I would now go to the upgrade path /upgrade/ , which is in this case would be the following
Once we have visited that location in our browser, and logged in using your admin credentials, you will see the following screen. If you do not see "Upgrade IPS Community Suite 4" at the top, and see anything regarding IP.Board, then you have not uploaded your files to the correct location and would need to check this.
Once you you click on Start Upgrade, you will be taken to the requirement check screen. If you followed the previous guides, everything should be showing as ok in here. If you get any messages in here such as folder permission errors, you would need to resolve these at this point before you continue.
The next page will show which items you are upgrading. All items you have purchased will be within this list, however if there are any you do not wish to upgrade at this time, you can deselect them at this point. On most occasions you would leave these ticked as they are by default, unless there is a specific reason why you are not upgrading an item.
After clicking on continue, unless you have already converted your database to UTF8, or your site is already using UTF8, you may be presented with a screen informing you that the database needs to be converted, as seen below. If you do not see this, then don't worry, it will simply mean that your database is already using the required UTF8 format.
If you are presented with this screen, you will be presented with the option to convert to either UTF8 or 4-byte UTF8. Whilst the technical details of these are beyond the scope of this guide, your choice is whether you want to allow emojis, music symbols, or historical scripts to be used on your site. If you do, then you would need to chose the 4-byte UTF8 (uft8mb4) option in order to have these available to you. This will result in a slightly larger database size, but would be the choice you would use in most cases.
Choose your required option and click continue to the conversion routine.
As of version 4.1.12, you can convert your database to the utf8mb4 format once you have upgraded, even if you chose not to do so at the time of upgrade originally. This can be found on the right of the page within system>support>support once on IPS4
If your database is of a significant size, and you have the ability to do this, you may want to run the uft8 conversion utility from command line. You will see the relevant details for this on the page shown above. Once you have done this from command line, you would revisit the upgrader again to continue with your upgrade routine.
As the IPS4 system is slightly different in the way it works to IP.Board, you will then be given a series of options which you will need to chose from for your upgrade. If you have been through earlier steps in this guide, you should have the answers already prepared for these. Please ensure you read through this page and choose the options which are correct for your own site.
Your site will now run through the upgrade procedure automatically. You may at some points be asked to run queries manually via phpmyadmin or similar. This may happen if some database tables are of a large size.
Once your installation is complete, the system will let you know, and you can chose whether to visit your admin CP or your main site. Please see our many other guides for assistance on using the suite, and welcome to IPS. At this point, you may want to visit the admin CP to confirm that your rebuild routines are running. Continue to the next step in this guide for more information on the rebuild process.
If for some reason the upgrade times out or stalls, you can log back into the upgrade here /admin/upgrade and select "continue upgrade" to complete the upgrade process.