2.4.6. 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 IMG_PREF button or select Edit, Preferences from the menu.

2.4.6.1. Administration Preferences

Connection preferences

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

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

  • Choose whether to join discovered active domains automatically or manually. There is also a display of the currently joined domains (where you can choose to leave domains if you’re manually joining domains).

  • Add QoS files from which you can choose profiles that Admin Console will use when creating DDS entities. Please take care 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.6.2. Edit Participant

DomainParticipant settings

The Edit DomainParticipant settings dialog allows you to edit some settings of the selected DomainParticipants. Changes to these settings will be 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.6.3. Health Preferences

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.1.

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.1 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.6.4. Logging Preferences

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.6.5. Notification Preferences

Notifications 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.6.6. Security Preferences

Prerequisites:

To use the RTI 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:

Security Preferences:

Security preferences

The Security panel is where you can set options for using DDS security. By default, security is disabled. The checkbox “Enable Security for specified Domains” controls whether these features are enabled or not.

Use the “Domain Filter” to specify which domains the security settings will be applied to. Use “*” to specify all domains (the default), or identify domains directly by their number (each separated by a comma). You can also specify a range of domains such as 2-4.

In general, consult the RTI Security Plugins Getting Started for specifics about the other fields. Here are a few notes about using this panel:

  • Once you have updated the preferences, be sure to press the “Apply” button. If you do not, the preferences will not be saved or applied. After pressing “Apply”, it may take a significant amount of time to apply the changes. This can happen if you are joined to many domains. This is because each domain has to be left and then rejoined with the new settings applied, and that can take some time.

  • Each of the file preferences must point to a file that exists. If the referenced file does not exist, the background color will change to indicate the problem. If this happens, the “Apply” button will be disabled.

  • Certificate Revocation List - This is an optional field. If specified, it must point to a file that exists.

  • Security Log Level (local) - This property controls the verbosity of the local security logger. It has no affect on remote processes elsewhere in the system. To view the log messages, open the Console Log.

  • You can restore the default settings at any time by pressing the “Restore Defaults” button.

For more information on how to configure Admin Console to work with security, please see the following: