.. _TYPO3v10Update:

================================================================================================
Update
================================================================================================

.. hint::

    Das Upgrade von Musterseiten ist derzeit noch in der Test- und Härtungsphase.
    Wir sammeln das Feedback und passen den Prozess laufen an, damit dieser bei möglichst
    vielen Hostern funktioniert.

Backup
================================================================================================

Erstellen Sie ein Backup Ihrer bestehenden Internetseite.

Informationen zum Upgrade
================================================================================================

Um das Upgrade einer klassischen Installation auf das Rollingupgrade
durchzuführen müssen folgende Voraussetzungen erfüllt sein:

* Umgebung entspricht der in :ref:`Operations <v10_operations>` beschriebenen
* Es wurden keine eigenen / weiteren Erweitertungen installiert, die von Ihnen betriebene Seite entspricht also technisch dem Auslieferungszustand
* Ihre bestehende Installation ist mindestens TYPO3 v9

Durchführen des Upgrades
================================================================================================

.. hint::

    Einige der PHP Scripte müssen ggf. mit dem PHP Binary voran ausgeführt werden.

Das Upgrade wird in den folgenden Schritten durchgeführt:

.. rst-class:: bignums-xxl

1. Erstellen Sie ein Backup aller Dateien und der Datenbank (am besten als Snapshot)

2. Legen Sie einen neuen Ordner für das Update an

3. Holen Sie sich die neuen Installationsdateien mit dem folgenden Befehl:

   .. code-block:: bash

      composer create-project drkservice/project-template-kv . --repository=https://gitlab.com/api/v4/group/7483790/-/packages/composer/packages.json

   Damit haben Sie die nötige Verzeichnisstruktur um Ihre Daten zu integrieren.

4. Kopieren Sie die folgenden Ordner aus der alten Installation in die neue Installation

   .. code-block:: bash

      Alt                                          Neu
      public/fileadmin                             public/fileadmin
      var                                          var
      config                                       config
      public/typo3conf/Localconfiguration.php      public/typo3conf/Localconfiguration.php
      public/typo3conf/AdditionalConfiguration.php public/typo3conf/AdditionalConfiguration.php

   Falls für den Hoster Anpassungen an der .htaccess-Datei nötig sind, so muss diese
   ggf. mit kopiert werden

5. Prüfen Sie die Umgebung mit dem folgenden Befehl uns korrigieren Sie die aufgezeigten Probleme

   .. code-block:: bash

      vendor/bin/drkcms platform:check


6. Um die Daten zu migrieren führen Sie noch den folgenden Befehl aus:

   .. code-block:: bash

      vendor/bin/drkcms cms:migrate

7. Weisen Sie nun Ihren Webserver an, das neue public Verzeichnis als DocRoot auszuliefern.

.. _big-nums:

Spätere Updates
================================================================================================

Spätere Updates lassen sich dann mit den folgenden 2 Kommandos durchführen:

.. code-block:: bash

   vendor/bin/drkcms cms:update:source

Dieses Kommando nutzt composer um die Erweiterungen des DRK CMS aktuell zu halten

.. code-block:: bash

   vendor/bin/drkcms cms:migrate

Dieses Kommando führt nötige Migrationsschritte automatisch und in vorhersagbarer Weise aus.