=======
rtstart
=======

------------------
start an RT-System
------------------

.. include:: ../common/docinfo_block.txt

Synopsis
========

rtstart [options] [RTSProfile file]

Description
===========

Start an RT-System, activating all involved components, using an
RTSProfile.  Components are activated in the order specified in the
RTSProfile. Any components not marked as ``required`` in the RTSProfile
will be ignored if they are not running.

If no file is given, the RTSProfile is read from standard input.

XML format is used by default; to use RTSProfiles specified in YAML,
specify ``--yaml``.

Options
=======

--dry-run
  Print what will be done but don't actually do anything.

-x, --xml
  Use XML input format.

-y, --yaml
  Use YAML input format.

.. include:: ../common/common_opts.txt

Start plans
===========

.. include:: ../common/start_stop_plans.txt

.. include:: ../common/common_body.txt

Examples
========

::

  $ rtstart sys.rtsys

Start the RT-System specified in the file ``sys.rtsys``.

::

  $ rtstart sys.rtsys --dry-run

Display the actions that will be performed to start the system.

See Also
========

  ``rtcheck`` (1),
  ``rtresurrect`` (1),
  ``rtstop`` (1)

