.. include:: vars.rst

.. _section-installation:

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

|CDS| is not installed as part of a |CONNEXT| package, unless you are
installing a license-managed ("lm") package (such as
rti_connext_dds-6.1.1-lm-x64Win64VS2017.exe), which includes |CDS|. 
Unless you are installing an "lm" package, |CDS| must be downloaded
and installed separately. Contact support@rti.com for information on
how to obtain a |CDS| package for your platform.

Installing a License-Managed (LM) Version
-----------------------------------------

Install the |CONNEXT| license-managed ("lm") package as described in
the :link_installation:`RTI Connext DDS Installation Guide <>`.
The lm package includes |CDS|. 

After installing the lm package, see 
:ref:`section-Common-HowToUseLicenseFile-RTIServices`.


Installing a Regular (non-LM) Version
-------------------------------------

There are two ways to install |CDS|: using *RTI Launcher* or the
``rtipkginstall`` command-line utility.

.. note::

   |CDS| is supported with |CONNEXT| 5.3.0 and higher. Before 6.1.0, 
   |CDS| was an RTI Labs product that came installed with |CONNEXT|. 
   As of 6.1.0, it must be downloaded and installed separately 
   (unless you have an lm package).

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 *Launcher's* **Configuration** tab, click on *Install RTI Packages*.
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| from the command line, run:

.. code-block:: bash

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

Other dependencies
^^^^^^^^^^^^^^^^^^
|CDS| may have dependencies on other packages as follows:

- :link_tls_ig:`RTI TLS support and OpenSSL <>`: If using TLS as a transport.
- :link_connext_security_ig:`RTI Security and OpenSSL <>`: If using the
  :ref:`section-security` provisions provided by |CDS|.