.. _section-installation:

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

|CDS| is not installed as part of a |CONNEXT| package, unless you are
installing an evaluation ("eval") or LM ("lm") package 
(such as ``rti_connext_dds-<version>-eval-x64Win64VS2017.exe`` 
or ``rti_connext_dds-<version>-lm-x64Win64VS2017.exe``), 
which includes |CDS|.
Unless you are installing an "eval" or "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 an Evaluation or LM Version
--------------------------------------

Install the evaluation ("eval") or LM ("lm") package as 
described in
the :link_connext_dds_pro_ig:`RTI Connext Installation Guide <>`.
The package includes |CDS|.

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


Installing a Regular Version
----------------------------

There are two ways to install |CDS|: using *RTI Launcher* or the
``rtipkginstall`` command-line utility. For each of the methods, make sure that
you install the correct host and target for your environment (see
:ref:`section-CDS-157-INSTALL-613`). Additional information about installation
can be found at :link_connext_dds_pro_gsg_cpp11:`Installing Connext, in the Getting Started Guide <before.html#installing-connext-heading>`.

.. 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(s) 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_support_ig:`RTI TLS support and OpenSSL <>`: If using TLS as a transport.
- :link_connext_dds_secure_ig:`RTI Security and OpenSSL <>`: If using the
  :ref:`section-security` provisions provided by |CDS|.