HTML Logo by World Wide Web Consortium ( Click to learn more about our commitment to accessibility and standards.

Moving forward with Composr

ocPortal has been relaunched as Composr CMS. ocPortal 9 is superseded by Composr 10.

Head over to for our new site, and to our migration roadmap. Existing ocPortal member accounts have been mirrored.

Forced Upgrade

Login / Search

 [ Join | More ]
 Add topic 
#20157 (In Topic #4689)


nothing to update

I've applied ocPortal upgrades a couple of times in the past. As instructed I uploaded the files to the server, overwriting as necessary, and then ran the force upgrade php. The script lists a series of my extra files on the site and then at the end tells me there is nothing that needs upgrading. Well, afterward I'm always left unsure if the upgrade actually took place. I verified that the new files were on the site. Is there some kind of indicator that I should be looking for that lets me know that the process actually took the upgrade?
Back to the top

There are basically three aspects to upgrading:
  • replacing files
  • updating the database
  • clearing caches

The zip file of new changed files handles the replacing of files. One of the files is always sources/version.php, which bumps up the version. You can check it by viewing the Admin Zone front page.

The database is virtually never updated with a minor release, because we maintain compatibility. Database changes are the real hotspot for things going wrong, so we very carefully manage this. force_upgrade.php will trigger any updating needed, but if there's none, it won't claim any.

For a minor release, cache clearing is necessary but it's not really very crucial. If you don't clear them the following could happen:
  • lang-string-missing errors that were 'fixed' would not be seen as fixed until the language cache was emptied
  • any display errors (CSS, templates, for example) that were 'fixed' would not be seen as fixed until the template cache was emptied. We try and maintain CSS/template compatibility between minor versions also, so that new themes don't need to be manually synched with those changes.
force_upgrade.php clears caches for you.

You should be absolutely fine, but if you spot any errors on your site, just report them as normal :).

To briefly summarise - minor updates are almost solely contingent on the files in the upgrade zip replacing buggy code.

Become a fan of Composr on Facebook or add me as a friend. Add me on on Twitter. Support me on Patreon
Was I helpful?
  • If not, please let us know how we can do better (please try and propose any bigger ideas in such a way that they are fundable and scalable).
  • If so, please let others know about Composr whenever you see the opportunity or support me on Patreon.
  • If my reply is too Vulcan or expressed too much in business-strategy terms, and not particularly personal, I apologise. As a company & project maintainer, time is very limited to me, so usually when I write a reply I try and make it generic advice to all readers. I'm also naturally a joined-up thinker, so I always express my thoughts in combined business and technical terms. I recognise not everyone likes that, don't let my Vulcan-thinking stop you enjoying Composr on fun personal projects.
  • If my response can inspire a community tutorial, that's a great way of giving back to the project as a user.
Back to the top
There are too many online users to list.
Control functions:

Quick reply   Contract

Your name:
Your message: