Table of contents

Update

In AtroCore system you can install, update, and remove modules directly from the admin area.

To do it you need to go to "Administration > Modules" page.

modules_manager

As you can see, this page consists of three panels:

  • Installed – a list of modules installed in the system is displayed here along with the following data given in the corresponding columns: module name and description, setting version ( means the latest version), current version of AtroCore and required dependencies. You can manage versions of modules by selecting a set version (use and a version of module to select the specified version of a module or ^ and a version of module to select a version of a module not lover than specified).

    installed_panel

  • Store – a list of all modules for AtroCore software platform is displayed here along with the description, tags, and status of each module. Tags identify modules by their main features to simplify your search for this or that module. For example: possibility to export or restore data, manage prices, etc. Management options are given in the "Status" column for each module separately.

    store_panel

  • Logs – the history of all updates and upgrades performed by each system user is displayed here.

    logs_panel

    To view detailed information about any operation, click "View Details" for the desired operation:

    logs_detailed

System Update

The system is updated in the Module Manager. In the Setting Version column, you can manage the versions of the modules you want to update to. By default, the system will be updated to the highest possible version. Here you can use the following operators:

  • >=1.0.4 or ^1.0.4 - the module will be upgraded to the highest possible version. The minimum possible version is 1.0.4.
  • 1.0.4 - the module will be upgraded to version 1.0.4
  • >=1.0.0 <2.1 - the module will be updated to the highest possible version between 1.1.0 and 1.2
  • ~1.0.4 - the module will be updated to a version that is greater than or equal to the specified version, but not greater than the current minor version. In this case, the module will not be able to upgrade to version 1.1.

Please note, that you can only upgrade to a version that is greater than or equal to the current version of the module. Downgrade to previous versions is prohibited.

To update the system click on the "Update" button. The system and all installed modules will be automatically updated. Before update is done the system maka a backup of itself and the database, to be able to be restored in case of unexpected problems.

Please note, backup of your assets (files, which are stored in the system) is not done.

In order to avoid problems with migrations that may arise when upgrading to many minor versions at once, we introduced breakpoints - restrictions on the maximum possible upgrade version. Therefore, if you haven't updated your system for a long time, you will need to do it in a few steps. Currently, these breakpoints are Сore versions "1.10.0","1.11.0", "1.12.1" and "1.13.5".

Restore a System

If the update can not be completed due to some error, you need to restore the system. Please run this command: 

php composer.phar restore

You can force the restoration if the previous command does not help:

php composer.phar restore --force

You need to run the restore command as the webserver user, eg www-data, otherwise don't forget to change the ownership of the restored files.

Consideration of the Dependencies

During the update process the system installs the latest available module versions. It is possible, that some modules wil not be updated to the latest available version. The reason for it is the incompatibility of some of your modules with the newest version of the module you try to install.