Skip to content

Installing a Master Update

A Master Update takes you to a new major version — e.g. Master Update 5.0.0.0 from shop versions 4.8.0.0 to 4.9.6.1.

Please note

  • This Master Update is intended exclusively for shop versions 4.8.0.0 to 4.9.6.1. You can find your shop's version number in the Gambio Admin below the menu items.
  • The exact system requirements (PHP, MySQL, MariaDB, PHP extensions) of the target version are listed in its Release Notes.
  • After completing the update, the .htaccess file in the shop's root directory must be updated or newly added.
  • The installation replaces files — custom modifications to these files are lost! Make sure beforehand that third-party modules are compatible with the target version (e.g. v5.0.0.0).
  • The shop is automatically switched to offline mode during the installation and back online afterwards.
  • Make sure you are logged in to the administration area of your shop before installing!
Shop version number
The shop's version number in the Gambio Admin below the menu items

1. Changelog

A list of the changes contained in the Master Update can be found in the enclosed file CHANGELOG.html and in the Release Notes.

2. Backup

First, create a complete backup — both of all files and folders of the shop and of the shop database. If the shop does not work as expected after the installation, you can simply restore the backup.

3. Installation

3.1 Important for Windows users

On Microsoft Windows, the path length limitation can cause problems when unpacking. Therefore, extract all files into a folder as high up in the directory tree as possible, e.g. C:\Gambio.

3.2 Updating shop systems 4.8.0.0 to 4.9.6.1

Upload the entire contents of the Dateien directory from the Shopsystem directory into the root directory of your shop on your FTP server and overwrite the existing files.

Note

After uploading the files, the shop domain automatically redirects to the Gambio Updater. This redirect remains in place until the installation is fully completed.

3.3 Updating PDFCreator

The PDFCreator is a standalone module for creating invoices, delivery notes and email attachments (not licensed under the GPL). Copy the entire contents of the PDFCreator folder into the PDFCreator folder in the root directory of your shop and overwrite the existing files.

3.4 Updating the Filemanager

Upload the entire ResponsiveFilemanager folder (not just its contents) into the root directory of your shop and overwrite the existing files.

3.5 Updating the shop database

Open your shop via https://www.example.com/gambio_updater (replace www.example.com with your shop's domain) and follow the instructions of the Gambio Updater:

Gambio Updater
Display of the available updates
  1. Log in — with the admin credentials you also use in the shop.

  2. Confirm the updates — click Zur Updates-Konfiguration, tick Versions-Info zur Kenntnis genommen and click Updates durchführen. Wait for the database update to finish.

    Run updates

  3. Delete old files — if applicable, files to be deleted are shown in a list (Download der Löschliste / Dateien downloaden for a backup). Click Fortfahren.

  4. Click Fortfahren again — finally the caches are cleared, which can take a moment.

  5. Click Zum Shop to leave the Gambio Updater.

    Installation completed

Attention

The Versionsauswahl erzwingen (force version selection) button may only be used if a previously started update process was aborted and the updater is now called again.

Force version selection

4. Updating robots.txt

Only necessary if your shop is located in a subdirectory: in the admin area, select Shop Einstellungen > SEO > Robots Datei, click Download and upload the new robots.txt via FTP into the root directory of the domain (not into the shop folder!). The file must be reachable via www.example.com/robots.txt.

5. Updating .htaccess

The .htaccess file in the shop's root directory must be updated or newly added. If you have no custom modifications, simply copy the template from gm/seo_boost_an/.htaccess into the root directory; otherwise reconcile your modifications with that template.

Attention

If you previously made changes to an existing .htaccess file, these must be re-applied.

6. Clearing the browser cache

After the installation, display errors can occur because old content is loaded from the browser cache. Therefore, clear your browser's cache (usually Ctrl+Shift+R).

White page in the admin?

It can happen that only a white page is displayed instead of the Gambio Admin. In this case, clear the browser cache.