.. ==================================================
.. FOR YOUR INFORMATION
.. --------------------------------------------------
.. -*- coding: utf-8 -*- with BOM.

.. include:: ../../Includes.txt


.. _administrators_cli:


CLI Script
==========

You migrate the plugins by a CLI script. See
**Run** below.

If you want to know more about the workflows, please refer to

.. toctree::
	:maxdepth: 3
	:titlesonly:

	Plugins/Index


Run
---

Run all needed migration scripts:

.. code:: php

  vendor/bin/typo3cms migration:migrate \
    --configuration EXT:migration_bootstrapgrids2start/Configuration/Migration.php \
    --dryrun 0


If you want to measure the duration, run the code from above with a prefixed `time`:

.. code:: php

  time vendor/bin/typo3cms migration:migrate \
    --configuration EXT:migration_bootstrapgrids2start/Configuration/Migration.php \
    --dryrun 0


Samples
-------

**dryrun** is true by default.  

Test all
''''''''

Run all migration scripts – data and plugins – without any execution (dryrun):

.. code:: php

  vendor/bin/typo3cms migration:migrate \
    --configuration EXT:migration_bootstrapgrids2start/Configuration/Migration.php
    --dryrun 0


Test for a special folder
'''''''''''''''''''''''''

Run all migration scripts for the page/folder with the id 160 only and without any execution (dryrun):

.. code:: php

  vendor/bin/typo3cms migration:migrate \
    --configuration EXT:migration_bootstrapgrids2start/Configuration/Migration.php \
    --limitToPage 160379 \
    --recursive 0 
    --dryrun 0


Test columns plugins only
'''''''''''''''''''''''''

Columns plugins are: 2cols, 3cols, 4cols

Run the migration script for tt_news records only without any execution (dryrun):

.. code:: php

  vendor/bin/typo3cms migration:migrate \
    --configuration EXT:migration_bootstrapgrids2start/Configuration/Migration.php \
    --key columns \
    --dryrun 0