Support

Hello,

We have received a number of reports regarding the updates to Akeeba Backup 8.0.0/8.0.1 and Admin Tools 6.0.0/6.0.1.

We have released versions 8.0.2 and 6.0.2 which address the root causes of all of the issues which have been reported to us. If you still have access to your site's backend please install these new versions. If not, please keep reading.

The root causes of all of the problems identified were the following:

• Old plugins we have stopped shipping with our software between 1 and 8 years ago were still installed. These plugins made assumptions about which backend framework our extensions were using and failed during or after the update.
• Joomla not installing / replacing all files during the update. This was especially problematic when it happened in the backend (FOF) or frontend (FEF) framework used in our extensions because it could make all these extensions failed which could cause anything from display issues to outright inability to use your site's backend.
• PHP opcode caching (opcache) causing several problems in the course or after the conclusion of the extension update. These problems only happen on hosts which are misconfigured to not check if the files have been updated — a bad idea if you are running an off-the-shelf CMS which updates itself and its extensions / plugins / modules, i.e. replaces .php file during the course of a page load — or had a revalidation (check if files have changed) frequency that was too big. These servers ended up not “seeing” the updated files which would either cause the update to fail (needing to run it a second time to clear the error) OR made it look like there were missing or broken files by throwing messages about missing classes or methods when, in fact, the correct classes were there.
• Your template overrides are out of date (only applies to frontend components).

If you have been locked out of your site after installing any of the previous versions of our software please follow the solutions below.

PHP opcache

Many servers use PHP's opcode cache to speed up the site. PHP is an interpreted language. The source code of every .php file needs to be read, parsed, converted into an intermediate binary representation called "opcode" and then executed. The read, parse and convert stages take a lot of time. The PHP opcode cache stores the opcode representation of files in memory to speed up your site.

However, when you are updating software on your site you are modifying the same .php files it uses to process every page request. If the opcache is not invalidated (cleared) your server “sees” an old version of the file. This can result in error because your server “sees” a mixed bag of versions of different .php files, versions which may not be designed to be work together and which do not reflect the actual files stored on your server's disk.

We were trying to address this issue by asking PHP to reset the opcode cache (opcache) by using the opcache_reset() function it provides for this purpose. However, the official PHP documentation about how opcache_reset works is wrong! The documentation says that it invalidates the opcode cache, implying that this happens immediately. In fact, it happens asynchronously, after PHP has finished executing the current request. This meant that the opcache was effectively not reset while Joomla was running the post-installation script included in our software. Depending on which pages on your site you had visited before and when, which plugins you run on your site and the configuration of opcache (especially whether and how often it looks for file changes) this would mean that might very well end up with opcache “seeing” old versions of the file during the election of the post-installation scripts or right after the installation had concluded. As a result, you might have experienced errors during or after the installation.

We are now using a different approach with opcache_invalidate() on each .php file included in our software package which addresses this issue.

If you are stuck after installing a previous version of our software you might need to ask your host to reset the opcache or tell you how to do it yourself.

Akeeba Backup: old plugins and Joomla issues causing problems

The problems typically manifest themselves as an error similar to the following:

• Argument 1 passed to FOF30\Platform\Joomla\Platform::__construct() must be an instance of FOF30\Container\Container
• Class FOF30\Container\Container not found

Here is how to solve this:

1. Make a copy of the file administrator/components/com_akeeba/BackupEngine/serverkey.php
2. Move the folder administrator/components/com_akeeba/backup
3. Delete the following folders (not all folders may exist on your server):
   • administrator/components/com_akeeba
   • components/com_akeeba
   • plugins/actionlog/akeebabackup
   • plugins/console/akeebabackup
   • plugins/installer/akeebabackup
   • plugins/quickicon/akeebabackup
   • plugins/system/backuponupdate
   • plugins/system/akeebaactionlog
   • plugins/system/akeebaupdatecheck
   • plugins/system/aklazy
   • plugins/system/srp
4. If you still cannot access your site's backend go to the Admin Tools section of this reply, follow its instructions and come back here.
5. Download the latest version of Akeeba Backup from our site's Downloads page
6. Go to Extensions, Manage, Install and install Akeeba Backup, twice in a row, without uninstalling it before or in between.
7. Replace the file administrator/components/com_akeeba/BackupEngine/serverkey.php with the one you made a copy of in the first step.
8. Replace the folder administrator/components/com_akeeba/backup with the one you moved in the second step.

If you have Admin Tools continue reading below. Otherwise skip over the Admin Tools section and go to the FOF 3 & 4 sections.

Admin Tools: old plugins and Joomla issues causing problems

1. Delete the following folders (not all folders may exist on your server):
   • administrator/components/com_admintools
   • components/com_admintools
   • plugins/actionlog/admintools
   • plugins/installer/admintools
   • plugins/system/admintools
   • plugins/system/atoolsjupdatecheck
   • plugins/system/atoolsupdatecheck
   • plugins/system/oneclickaction
2. Download the latest version of Admin Tools from our site's Downloads page
3. Go to Extensions, Manage, Install and install Admin Tools, twice in a row, without uninstalling it before or in between.

FOF 3 was uninstalled but it's still required

Our software released between mid-2015 and February 2021 inclusive was using version 3 of our FOF backend framework. Software released on and after March 2nd, 2021 is using version 4 of the framework.

Since FOF might be used by multiple extensions, either our own or third party, we check if any extension has been marked as dependent on FOF 3. If none is marked as such we uninstall FOF 3.

This might be a problem in the following cases:

• You have used Discover & Install to install an extension depending on FOF 3.
• You are using a third party extension which does not mark itself or its sub-extensions (plugins, modules etc) as dependent on FOF 3.

In these cases the dependency is not marked in any way and there is no way to know that a FOF 3 dependent extension is installed on your site. As a result FOF 3 might be removed when it's actually needed. You will very likely see an error message saying that a class is missing whose name starts with FOF30\.

In order to gain access back to your site do the following.

• Download the latest version of FOF 3.x from our site's Downloads page. Please note that this is a THREE, not a FOUR.
• Extract the ZIP file.
• There is a folder named fof extracted from the archive. Rename it to fof30.
• Upload the fof30 folder into your site's libraries folder so now you have a libraries/fof30 folder.
  Please note that there might be other folder with similar names in there such as fof, f0f, fof40. DO NOT REPLACE OR DELETE THESE OTHER FOLDERS. The folder fof is part of Joomla 3; if you remove it your site WILL break. The folder f0f is a very old version of our framework used by third party extensions; removing it will most likely break your site. The folder fof40 is FOF 4, used by versions of our software released after March 2nd, 2021; removing it WILL break your site.
• Do NOT try to install the FOF 3.x ZIP file you downloaded in a previous step. This would cause the next time a FOF 4 extension is installed to remove the libraries/fof30 folder again and you'd need to repeat these instructions.

After doing that you may have to clear your server's PHP opcode cache (opcache) per the PHP opcache section in this reply.

FOF 4 was not installed fully or at all

Our software released between mid-2015 and February 2021 inclusive was using version 3 of our FOF backend framework. Software released on and after March 2nd, 2021 is using version 4 of the framework.

There is a long-standing Joomla issue which may prevent the new version of an extension, such as FOF, to be installed fully or at all. It happens rarely but with thousands of sites using our software it's an issue we see every time we publish a new release.

This will usually manifest itself with an error similar to:

• Class 'FOF40\Container\Container' not found

• Class 'FOF40\Dispatcher\Dispatcher' not found

There is a way to work around this.

• Download the latest version of FOF 4.x from our site's Downloads page. Please note that this is a FOUR, not a THREE.
• Extract the ZIP file.
• There is a folder named fof extracted from the archive. Rename it to fof40.
• Upload the fof40 folder into your site's libraries folder so now you have a libraries/fof40 folder. If there was already a folder by that name, overwrite it.
  Please note that there might be other folder with similar names in there such as fof, f0f, fof30. DO NOT REPLACE OR DELETE THESE OTHER FOLDERS. The folder fof is part of Joomla 3; if you remove it your site WILL break. The folder f0f is a very old version of our framework used by third party extensions; removing it will most likely break your site. The folder fof30 is FOF 3, used by versions of our software released before March 2nd, 2021 and third party extensions; removing it will most likely break your site.

After doing that you may have to clear your server's PHP opcode cache (opcache) per the PHP opcache section in this reply.

FEF was not upgraded to version 2 fully or at all

Our software released between 2017 and February 2021 inclusive was using version 1 of our FEF frontend framework. Software released on and after March 2nd, 2021 is using version 2 of the framework.

There's an issue with Joomla which happens rarely and which results in Joomla not replacing all of the files when performing an update.

You can verify this is the case by opening the file media/fef/fef.php and checking if the line

public static function loadCSSFramework(bool $withReset = true, bool $dark = false)

is present in the file. If not, you've been hit by this Joomla issue and need to work around it manually.

• Download the latest version of FEF from our site's Downloads page.
• Extract the ZIP file.
• Upload all extracted files and folders into your site's media/fef folder, overwriting existing files and folders by the same name.

After doing that you may have to clear your server's PHP opcode cache (opcache) per the PHP opcode section in this reply.

Out of date template overrides

This only applies if you have problems in the frontend of your site, you are using one of our extensions with a frontend part (e.g. Akeeba Ticket System, LoginGuard etc) and you have done template overrides to style it.

Please note that the new versions of our software may have changed the view template files you used to create your template overrides or changed their names. Please review your template overrides. This is especially important when you are upgrading to a new minor or major release of our software, i.e. the first or digit before the second or first dot in the version number respectively has changed compared to the previous version of our software you had installed on your site.