Upgrading from 2.3 to 3.0

This page takes an installation of academic_persons_sync 2.3 straight to 3.0, without the step to 2.4. Neither 2.4 nor 3.0 of this extension changes a configuration, a database column or an API, and 3.0 drops TYPO3 12. The upgrade is the update of TYPO3 and of the package, made together with the extensions it depends on, so the page leaves out no step of 2.4. Work through the sections in order. Skip a step that does not apply to the installation.

Before you start

Version 3.0 runs on TYPO3 13.4 from 13.4.35 on and on TYPO3 14.3 from 14.3.7 on, with PHP 8.2 or later.

academic_persons_sync 3.0 declares no new dependency of its own. It needs these packages. Upgrade them first or in the same deployment, in this order, as their own upgrade chapters describe:

fgtclb/environment-state-manager 2.x, new since 2.4, which academic_base 3.0 and academic_persons 3.0 require. Composer installs it on its own. A classic installation installs environment_state_manager before it activates either of them.
fgtclb/academic-base 3.0, the same release as this extension.
fgtclb/academic-persons 3.0, the same release as this extension.
fgtclb/academic-persons-edit 3.0, the same release as this extension.

This extension needs no change of a project in the same deployment. The upgrade chapters of the extensions above name theirs.

The module paths on this page are those of TYPO3 13, where the upgrade runs.

Update TYPO3 first

Update TYPO3 to 13.4.35 or later while the site still runs 2.3, which supports TYPO3 13.4. Version 3.0 no longer installs on TYPO3 12, and Composer and the Extension Manager refuse it next to an older patch release of TYPO3 13.

Stay on TYPO3 13 until the upgrade is complete. This extension requires academic_persons and academic_persons_edit, whose content element wizards read the column tt_content.list_type, which TYPO3 14 removes, so they only run on TYPO3 13. The same holds for the wizards of academic_jobs and academic_projects when the installation also has them. Move to TYPO3 14.3.7 or later once they have run.

See Breaking: Removed TYPO3 v12 support and Important: TYPO3 13.4.35 or 14.3.7 is required.

Update the package

composer require -W \
    'fgtclb/academic-base':'~3.0.0' \
    'fgtclb/academic-persons':'~3.0.0' \
    'fgtclb/academic-persons-edit':'~3.0.0' \
    'fgtclb/academic-persons-sync':'~3.0.0'

On a classic installation, install environment_state_manager 2.x from the TER in Admin Tools > Extensions first, then update academic_base, academic_persons, academic_persons_edit and academic_persons_sync there, in this order. academic_persons_edit 3.0 also needs the system extension rte_ckeditor to be active, as its own upgrade chapter describes. Run the commands of this page with typo3/sysext/core/bin/typo3 instead of vendor/bin/typo3.

vendor/bin/typo3 cache:flush

Update the database

vendor/bin/typo3 extension:setup

Or apply the changes in Admin Tools > Maintenance > Analyze Database Structure.

This extension has no table of its own. The comparison applies the changes of the index definitions TYPO3 13.4.35 and 14.3.7 bring, and the changes of academic_persons and academic_persons_edit, which their upgrade chapters describe.

Adapt the configuration

The upgrade check

The console command academic:upgrade:check of academic_base reads the stored configuration of the installation and reports what no longer reaches the academic extensions. Run it on the staging copy right after the package update:

vendor/bin/typo3 academic:upgrade:check

This extension ships no templates, so there is no template override of it to compare. Run the check with the keys of the other academic extensions, as their upgrade chapters describe. See the upgrade check of academic_base.

Check the result

Open a frontend user of the type Academic Persons: External User. The tab with the assigned profiles is labelled Profiles. Version 2.3 read its label from a file that does not exist, so the tab had no label.
The upgrade check exits with 0, see The upgrade check.