2.4.7. Preferences

The Preferences dialog is where you can customize Admin Console. There are many options that come from the Eclipse platform: those will not be covered in detail here. Instead, this section will focus on the settings that are specific to Admin Console.

To open the dialog, press the button on the toolbar or go to View > Preferences.

2.4.7.1. Administration preferences

The Administration Preferences panel controls how Admin Console interacts with Connext. From here, you can:

• Select how Admin Console discovers and connects to DDS domains.

  • Online: Connect to DDS domains automatically or manually. When joining manually, you can specify which domains, DomainParticipant partitions, and discovery peers to join.

  • Remote: Admin Console connects to a remote distributed system to use the Remote Debugging feature.

  • Offline: Admin Console does not connect to any DDS domains. To visualize saved data, import a discovery file.

• Add QoS files from which you can choose profiles that Admin Console will use when creating DDS entities.

• Set the cleanup period for entities that are no longer present ().

• Choose how many connection nodes to display in the graphical view.

Note

Be careful when changing the profile that Admin Console uses, since it employs many non-standard QoS settings. Start with the example QoS file in <installation dir>/resource/xml/RTI_ADMIN_CONSOLE_EXAMPLE_PROFILE.xml.

2.4.7.2. Edit participant

The Edit DomainParticipant settings dialog allows you to edit some settings of the selected DomainParticipants. To access, select Edit DomainParticipant(s) from the Administration Preferences panel.

Changes to these settings are applied to all selected DomainParticipants. These are the settings available for editing:

• QoS Profile used by the DomainParticipants.

• Add or remove DomainParticipant’s partitions.

• Add or remove discovery peers.

2.4.7.3. Certificates

The Remote Debugging feature uses server certificates to verify the HTTP/WS(S) servers it connects to. When using this feature, the Certificates panel displays the status of the current connection and the certificates previously accepted and rejected.

• Allowed certificates were previously accepted as valid, so Admin Console does not require you to accept them going forward.

• Rejected certificates were previously rejected, so Admin Console will not connect to servers with these certificates going forward.

2.4.7.4. Data Visualization Preferences

Data Visualization enables you to explore data samples in detail and create a graphical representation of selected Topic data. Use the Preferences panel to customize the default visualization settings.

For details, see the Getting Started with Data Visualization section.

2.4.7.5. Health Preferences

The Health panel controls what severity will be used for various health conditions. Each condition can be set to Healthy, Warning, or Error. The conditions are listed in Table 2.2.

For example, the default severity for “No matching partitions” is Warning. However, you can change it so this condition is treated as an Error.

Table 2.2 Severity of Health Conditions

Health Condition	Description
Error log entry	An error log message from Distributed Logger.
Warning log entry	A warning log message from Distributed Logger.
Requested/offered QoS	Mismatched DDS Quality of Service.
Transport message size max	Mismatched DomainParticipant transport message size max settings.
Transport identifiers	Mismatched DomainParticipant transport identifiers.
No matching partitions	Not having matching partitions.
Keyed consistency	A disagreement on whether or not the topic is keyed.
Data type mismatch	Incompatible data types.
Writer-only Topic	Having only DataWriters (hence, no flow of data) associated with a topic.
Reader-only Topic	Having only DataReaders (hence, no flow of data) associated with a topic.
Data type representation	A mismatch between the type representation offered by a DataWriter and the type representation requested by a DataReader associated with the same topic.

2.4.7.6. Logging Preferences

The Logging panel controls the RTI Logger configuration and verbosity settings used by Admin Console. The output of the RTI Logger is displayed in the Console Log View.

2.4.7.7. Notification Preferences

The Notifications panel controls if guide notifications (messages that replace a view’s content with helpful hints about why the view might be empty) are displayed and whether a notification is displayed for successful configuration of Routing Service.

2.4.7.8. Python Preferences

The Python panel displays pre-populated information about the system’s Python installation. The following fields can be edited as needed:

Table 2.3 Python Editable Fields

Field	Description
Python Executable	The file path to the Python executable.
Python Shared Library	The file path to the Python shared library.
Include Paths	The paths from which native dynamic libraries are loaded.

2.4.7.9. Security Preferences

Prerequisites:

To use the Security Plugins in Admin Console, you must have installed the Security Plugins and OpenSSL. Both the Security Plugins and OpenSSL packages are available from the RTI support portal.

For the Security Plugins, install both the host and target packages.

For OpenSSL, install both the host and target packages.

• The OpenSSL host package enables OpenSSL for Admin Console, as well as other RTI applications such as RTI Routing Service, rtiddsspy, etc.

• The OpenSSL target package provides OpenSSL libraries that can be used to secure your applications.

For more information on how to install and use the Security Plugins and OpenSSL, see these documents:

• RTI Security Plugins Installation Guide

• RTI Security Plugins Getting Started Guide

Security Preferences:

The Security panel is where you can set options for using DDS security. By default, security is disabled. To enable security for Admin Console participants, select the Enable Security for specified Domains checkbox. You can then specify which domains to secure in Domain Filter. For detailed information about the security preferences fields, see Step 9: Working with Security Plugins of the Admin Console tutorial.

For more information about using security in Admin Console, see DDS Security Data Visualization with RTI Administration Console in the RTI Security Plugins User’s Manual.

2.4.7.10. Validation Preferences

Admin Console enables you to open XML configuration files and update them using a graphical editor. The Validation panel provides options for validating the XML and XML schema files you open. By default, all validation options are enabled.

For each file type, use the Settings button to configure rules for items to include and exclude in the validation process.

2.4.7.11. XML Preferences

The XML panel provides multiple options to customize the way XML code displays in Admin Console.