
.. _section_installing-a-commercial-version:

Installing a Commercial Version
-------------------------------

Please do not install more than one *Security Plugins* host package per
host architecture or more than one *Security Plugins* target package per
target architecture. 

If you attempt to do so (for example, if you install both
rti_security_plugins-|VERSION|-target-openssl-3.5-<target architecture>.rtipkg 
and 
rti_security_plugins-|VERSION|-wolfssl-5.5-target-<target architecture>.rtipkg),
the earliest package will be relegated to a backup directory 
and the latest package will overwrite any intermediate packages.
(See `Special Backup of RTI Libraries, in the RTI Connext Installation Guide
<https://community.rti.com/static/documentation/connext-dds/7.7.0/doc/manuals/connext_dds_professional/installation_guide/upgrading.html>`__.)


.. _section_installing-a-commercial-version-for-OpenSSL:

Security Plugins for OpenSSL
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

#. Install the |CONNEXTDDS_ITALIC| host and target bundles as
   described in the `RTI Connext Installation Guide 
   <https://community.rti.com/static/documentation/connext-dds/7.7.0/doc/manuals/connext_dds_professional/installation_guide/index.html>`__.

#. Install the *Security Plugins* host and target packages:

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

   <host platform> depends on your host (such as ``x64Linux`` on Linux 
   systems, ``darwin`` on macOS systems, or ``x64Win64`` on Windows systems).

   <target architecture> is one of the platforms that supports *Security Plugins* with OpenSSL
   (see the 
   `RTI Connext Core Libraries Platform Notes
   <https://community.rti.com/static/documentation/connext-dds/7.7.0/doc/manuals/connext_dds_professional/platform_notes/index.htm>`__).

   After installation, the *Security Plugins* header files and libraries will 
   be in ``<install dir>/include/ndds/security`` and 
   ``<install dir>/lib/<target architecture>``, respectively.

#. Install OpenSSL as described in :ref:`section_crypto-installing-openssl`.


.. _section_installing-a-commercial-version-for-wolfSSL:

Security Plugins for wolfSSL
~~~~~~~~~~~~~~~~~~~~~~~~~~~~

.. note::

   Only install the *Security Plugins* for wolfSSL if you have
   the wolfSSL source code or libraries, which RTI does not provide.

The *Security Plugins* for wolfSSL are only supported on select target
platforms. See the `RTI Connext Core Libraries Platform Notes
<https://community.rti.com/static/documentation/connext-dds/7.7.0/doc/manuals/connext_dds_professional/platform_notes/index.htm>`__
to determine compatibility with your target architecture.

#. Install the |CONNEXTDDS_ITALIC| host and target bundles as
   described in the 
   `RTI Connext Installation Guide 
   <https://community.rti.com/static/documentation/connext-dds/7.7.0/doc/manuals/connext_dds_professional/installation_guide/index.html>`__.

#. Install the *Security Plugins* host and target packages that are
   compatible with wolfSSL:

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

   .. note::

      These packages are available on demand only. If you
      do not see them in the Customer Portal, contact support@rti.com.
      
   <host platform> depends on your host (such as ``x64Linux`` on Linux 
   systems, ``darwin`` on macOS systems, or ``x64Win64`` on Windows systems).

   <target architecture> is one of the platforms that supports 
   *Security Plugins* for use with wolfSSL (see the 
   `RTI Connext Core Libraries Platform Notes
   <https://community.rti.com/static/documentation/connext-dds/7.7.0/doc/manuals/connext_dds_professional/platform_notes/index.htm>`__).


   After installation, the *Security Plugins* header files and libraries will 
   be in ``<install dir>/include/ndds/security`` and 
   ``<install dir>/lib/<target architecture>``, respectively.

#. Install wolfSSL as described in :ref:`section_crypto-installing-wolfssl`.
