[TASK] Update copyright year in several files to 2020
[Packages/TYPO3.CMS.git] / typo3 / sysext / core / Documentation / Changelog / 8.6 / Breaking-79109-LowlevelVersionsCommandParametersChanged.rst
1 .. include:: ../../Includes.txt
2
3 ==============================================================
4 Breaking: #79109 - Lowlevel VersionsCommand parameters changed
5 ==============================================================
6
7 See :issue:`79109`
8
9 Description
10 ===========
11
12 The existing CLI command within EXT:lowlevel for showing and cleaning up versions (from EXT:version / EXT:workspaces)
13 has been migrated to a Symfony Console command.
14
15 The command previously available via `./typo3/cli_dispatch.phpsh lowlevel_cleaner versions` is now available
16 via `./typo3/sysext/core/bin/typo3 cleanup:versions` and allows the following CLI options to be set:
17
18 The following options can be set:
19
20 - :shell:`--action={nameofaction}` to clean up versioned records, one of the following actions are possible:
21
22   - "versions_in_live": Delete versioned records in the live workspace
23
24   - "published_versions": Delete versions of published records
25
26   - "invalid_workspace": Move records inside a non-existing workspace ID into the live workspace
27
28   - "unused_placeholders": Remove placeholders which are not used anymore from the database
29
30 - :shell:`-v` and :shell:`-vv` to show more detailed information on the records affected
31
32 - :shell:`--pid=23` or :shell:`-p=23` to only find versions with page ID 23 (otherwise "0" is taken)
33
34 - :shell:`--depth=4` or :shell:`-d=4` to only clean recursively until a certain page tree level.
35
36 - :shell:`--dry-run` to only show the records to be changed / deleted
37
38 The PHP class of the old CLI command :php:`TYPO3\CMS\Lowlevel\VersionsCommand` has been removed.
39
40
41 Impact
42 ======
43
44 Calling the old CLI command :shell:`./typo3/cli_dispatch.phpsh lowlevel_cleaner versions` will result in an error message.
45
46
47 Affected Installations
48 ======================
49
50 Any TYPO3 instances using the lowlevel cleaner for finding and cleaning up versioned records.
51
52
53 Migration
54 =========
55
56 Update the CLI call on your servers to the new command line and available options as shown above.
57
58 .. index:: CLI, ext:lowlevel