.. include:: vars.rst

.. _section-installation:

Installation
************

|CDS| comes pre-installed as part of *RTI Connext DDS Professional*. If you
have a different edition of *RTI Connext DDS* you can still install it separately.

Contact support@rti.com for information on how to obtain a |CDS| package for
your platform. There are two ways to install |CDS|: using *RTI Launcher* or the
``rtipkginstall`` command-line utility.

.. note::

   |CDS| is supported only in *Connext DDS* 5.3.0 and higher.


Installing from RTI Launcher
============================

To install |CDS| from *RTI Launcher*:

1. Start *RTI Launcher* from the Start menu or from the command line,
   by running: ``<NDDSHOME>/bin/rtilauncher``.
2. From the Utilities tab, click on *RTI Package Installer*.
3. Use the **+** sign to add the ``.rtipkg`` file that you want to install.
4. Click **Install**.

Installing from the Command Line
================================

To install |CDS| using the command line, run:

.. code-block:: bash

   $NDDSHOME/bin/rtipkginstall \
      /<path-to-cloud-discovery-service>/rtipkgfile.rtipkg