11. Environment variables¶
This is the list of environment variables that affect the behavior of Fast DDS:
11.1. FASTRTPS_DEFAULT_PROFILES_FILE
¶
Defines the location of the default profile configuration XML file. If this variable is set and its value corresponds with an existing file, Fast DDS will load its profiles. For more information about XML profiles, please refer to XML profiles.
Linux
export FASTRTPS_DEFAULT_PROFILES_FILE=/home/user/profiles.xmlWindows
set FASTRTPS_DEFAULT_PROFILES_FILE=C:\profiles.xml
11.2. ROS_DISCOVERY_SERVER
¶
When setting this variable the DomainParticipant is configured as a Client of the given Server, implementing the Discovery Server mechanism, provided its DomainParticipant’s
discoveryProtocol
setting has been left configured as default (Simple discovery). The value of the variable must list the locator of the server in the form of the IP address (e.g., ‘192.168.2.23’) or IP-port pair (e.g., ‘192.168.2.23:24353’). If no port is specified, the default port 11811 is used. For more information on how to configure the discovery mechanism in Fast DDS, please refer to Discovery.Warning
The environment variable is only used in the case where discovery protocol is set to
SIMPLE
. In any other case the environment variable has no effect.To set more than one address they must be separated by semicolons. The server’s Id is determined by their position in the list. A blank space between semicolons means the corresponding Id is free.
Example
The following example shows how to set the address of two remote discovery servers with addresses ‘84.22.259.329:8888’ and ‘81.41.17.102:1234’ and Ids 0 and 2 respectively.
Linux
export ROS_DISCOVERY_SERVER=84.22.259.329:8888;;81.41.17.102:1234Windows
set ROS_DISCOVERY_SERVER=84.22.259.329:8888;;81.41.17.102:1234
11.3. SKIP_DEFAULT_XML
¶
Skips looking for a default profile configuration XML file. If this variable is set to 1, Fast DDS will load the configuration parameters directly from the classes’ definitions without looking for the DEFAULT_FASTRTPS_PROFILES.xml in the working directory. For more information about XML profiles, please refer to XML profiles.
Linux
export SKIP_DEFAULT_XML=1Windows
set SKIP_DEFAULT_XML=1