Download Instructions
=====================

.. note::

   Free *Connext* bundles include the *Security Plugins* and
   OpenSSL\ :sup:`®`. If you have the free version of *Connext*
   (with "lm" in its package name), you can skip to the next chapter.

Log into the RTI Customer Portal,
`https://support.rti.com/. <https://support.rti.com/>`__ You will need
your username and password, which are included in the letter confirming
your purchase. If you do not have this letter, please contact
license@rti.com. If you need help with the download process, contact
support@rti.com.

Once you have logged into the portal, select the **Downloads** link.
Which files to download depends on your host, target, and which crypto
libraries you will be using (OpenSSL or wolfSSL\ :sup:`®`). See details
below.

Downloading the Security Plugins and OpenSSL
--------------------------------------------

From the portal's **Downloads** page, select the appropriate version of
the *Security Plugins* and OpenSSL for your platform. (You may also
obtain OpenSSL from another source.)

#. For the *Security Plugins*, download both:

   -  rti_security_plugins-|VERSION|-host-openssl-|OPENSSLVERSION_SHORT|-<host platform>.rtipkg
   -  rti_security_plugins-|VERSION|-target-openssl-|OPENSSLVERSION_SHORT|-<target architecture>.rtipkg

   The host package includes the compiler-independent *Security Plugins*
   dependencies (documentation, headers, and the libraries used by RTI
   tools and services) for the host platform.

   The target package contains the *Security Plugins* libraries that you
   will link your application against.

#. For OpenSSL, download both:

   -  openssl-|OPENSSLVERSION|-|VERSION|-host-<host platform>.rtipkg
   -  openssl-|OPENSSLVERSION|-|VERSION|-target-<target architecture>.rtipkg

   The host package includes the OpenSSL distribution files for RTI tools 
   and services.

   The target package includes OpenSSL distribution files that you will link 
   your application against.

   .. note::

      The OpenSSL target packages for cross-compiled architectures such as 
      QNX do not include the OpenSSL executable.

.. container::

   Where:

   -  **<host platform>** depends on your host (**x64Linux** for Linux
      systems, **darwin** for macOS systems, **x64Win64** for Windows
      systems).
   -  **<target architecture>** names are described in the |CORE_RN|.

Downloading the Security Plugins for use with wolfSSL
-----------------------------------------------------

From the portal's **Downloads** page, select the appropriate version of
the *Security Plugins* for wolfSSL. Only select target architectures can
be used with wolfSSL; these are noted in the Compatibility section of
the *Security Plugins Release Notes*.

.. note::

   The rti_security_plugins-|VERSION|-host-wolfssl-|WOLSSLVERSION_SHORT|-<host platform>.rtipkg
   packages are available on demand only. If you
   do not see them in the Customer Portal, contact support@rti.com.

#. For the *Security Plugins*, download both:

   -  rti_security_plugins-|VERSION|-host-wolfssl-|WOLSSLVERSION_SHORT|
      -<host platform>.rtipkg
   -  rti_security_plugins-|VERSION|-target-wolfssl-|WOLSSLVERSION_SHORT|
      -<target architecture>.rtipkg

   The host package includes the compiler-independent *Security Plugins*
   dependencies (documentation, headers, and the libraries used by RTI
   tools and services) for the host platform.

   The target package contains the *Security Plugins* libraries that you
   will link your application against.

#. For wolfSSL:

   RTI does not distribute wolfSSL as a package bundle. 
   You should get a commercial version of wolfSSL |WOLFSSLVERSION| and 
   follow the instructions in :ref:`section_installing-a-crypto-library`.

