LDAPviewer

Preferences Menu

The Preferences menu is reached from the Options Menu and provides a number of panels that change Connection Profile and LDAP default settings, GUI and LDAPviewer settings and Debug and Diagnostic setting.

Preferences - LDAP

Window Buttons

Apply

Clicking this button will apply all changes made using any panel. Further changes may be made or the Cancel button used to dismiss the window.

Defaults

Clicking this button will set all operational settings to their default values (as noted in each control description). Further changes may be made or the Cancel button used to dismiss the window.

Cancel

Clicking this button will dismiss the window and ignore any changes made sine the last Apply (if any) operation.

Help

Displays this page.

Connection Profile and LDAP Settings

This panel changes the default settings used in Connection Profiles (and Quick Connect). Each control is described (top to bottom, left to right) in the following sections:

Preferences - LDAP

Port

Changes the default port number used for any LDAPv3 or LDAPv2 (but not LDAPSv3) connection in the Connection Profile Port. System default is 389.

Protocol

Changes the default Protocol used in the Connection Profile Protocol. Select the required value from the drop-down menu. System default is LDAPv3.

Access

Changes the default Access type used in the Connection Profile Access Type. Select the required value from the drop-down menu. System default is anonymous.

LDAPSv3 Port Prompt

LDAPviewer will prompt the user is the port number is not 636 if LDAPSv3 is selected in Connection Profile Protocol if this box is checked. If this box is unchecked no prompt will be issued irrespective of the port number defined when LDAPSv3 is selected. System default is to prompt (checked).

Timeout

Changes the default Timeout value used in the Connection Profile Timeout. Enter the required numeric value in the range 0 to 1000. System default is 0 (no timeout is applied to LDAP transactions).

Page Size

Changes the default Page Size value used in the Connection Profile Page Size. Enter the required numeric value in the range 0 to 65535 (64K). System default is 0 (no maximum page size is applied to LDAP transactions).

Referrals

Changes the default Referrals value used in the Connection Profile Referrals. Select the required radio button. System default is Ignore.

Deref. Alias

Changes the default Deref. alias value used in the Connection Profile Deref. Alias. Select the required radio button. System default is Always.

Save in Profile

Changes the default value used in the Connection Profile Password: Save in Profile. Checking this will set the default to save user passwords (in base64 format) in the Connection Profile. If unchecked passwords are not saved in the Connection Profile (and Password fields will never be enabled when creating Connection Profiles). System default is never to save in the Connection Profile (unchecked).

Attribute

Changes the default Attributes returned in all LDAP operations Connection Profile Attributes. Select the required value from the drop-down menu. System default is User and Operational (* +).

Show rootDSE

Changes the default setting of Connection Profile Show rootDSE. System default is not to Show rootDSE (unchecked).

Show Secondary DIT

Changes the default setting of Connection Profile Show Secondary DIT. System default is not to Show Secondary DIT (unchecked).

Sort Tree

Changes the default setting of Connection Profile Sort Tree. This controls how entries are shown in the DIT Tree. System default is None (order shown is as read from the LDAP server).

TLS

Changes the default setting of Connection Profile TLS. System default is Check.

GUI and LDAPviewer Settings

This panel changes the behavior and appearance of LDAPviewer and each control is described (top to bottom, left to right) in the following sections:

Preferences - GUI

LDAPViewer Look and Feel (LaF)

The Look and Feel of LDAPviewer is initially set to the system default for the platform on which it is running. Depending on the platform a number of alternative Look and Feel option are available as shown in the drop-down menu (illustrated drop-down is for the Windows platform):

Selecting one of the available choices followed by the Apply button will change LDAPviewer's Look and Feel.

Preferences - GUI Look and Feel

Recent Lists

Changes the number of entries shown the both the Recent item on the File menu and the Recent Searches item on the Search menu. System default is 5.

Editing Views

Changes the number of number of Entry editors used by LDAPviewer. Select from the available drop-down menu as required. System default is Both (HTML and Table).

Debug and Diagnostic Settings

This panel allows control over the debugging and diagnostic features provided by LDAPviewer and each control is described (top to bottom, left to right) in the following sections:

Preferences - Debug

Default Log

Changes the type of messages that LDAPviewer outputs to either the console or the Log File. Select from the available drop-down menu as required (Trace generates the maximum diagnostics and includes Fine and Finest levels). System default is Warning.

Note: LDAPviewer logs progress and error messages to the java console which is disabled by default. If, however, LDAPviewer fails to load (fails to display its initial window) then console messages provide essential diagnostics. To run LDAPviewer with the console enabled:

For Windows:

Open Windows explorer and navigate to the LDAPviewer installation directory (normally C:\Program Files (x86)\LV) and double click the file named lv-console.cmd which which will run LDAPviewer from a command window and display all console output. To copy relevant messages from the command window::

a. In Windows 10: Right click the window bar and select Properties, ensure that "Enable Ctrl key shortcuts" is enabled (you may need to uncheck "Use legacy console"). Dismiss the properties window. Select all required text in the command window and use Ctrl + C to copy to the clipboard. Paste to a suitable application.

Prompt Errors

By default LDAPviewer limits all user prompt messages to critical messages or those which are recoverable by user intervention. All other messages (including unrecoverable errors in Red) are output to the Status and Error Information line. Checking this box will cause a user prompt message to be output every time LDAPviewer outputs a status line message. System default is not to prompt errors (unchecked).

TLS Trace

When debugging TLS connections Java can provide voluminous diagnostic information. Checking this box will turn on Java's diagnostic feature. This is output to Standard Out which is not enabled by default (see Console Logging or Log to File). System default is not to invoke TLS Trace (unchecked).

Log to File

By default LDAPviewer runs without a console. A Console and Standard Out may be turned on using the procedure defined at Console Logging. Alternatively both Console and Standard Out may be directed to a log file by checking this box. The default log file is:

Windows Location:

C:\Users\user-name\AppData\Roaming\LV\config\LV.log.

Linux and BSD:

/home/user-name/LV/config/LV.log.

Note: Turning on this feature will divert Standard Out (STDOut) for any Java application running in the User's system and should be used with caution.

System default is not to Log to File (unchecked).

© LV Project 2016. Creative Commons Attribution 4.0 International License.