Skip to end of metadata
Go to start of metadata

Page Contents


Server Configuration

This first section contains the main systems-related settings for TBL (for persistence and other application settings, see Setup - TBL Configuration Parameters). Administrators can update the section via its Edit button and ensuring to click Save Changes when finished.

Server Parameters

ParameterDefaultDescription
Server URL 

This URL should be the TBL web-application's own context path, without a trailing slash "/". It enables email notifications with "live" TBL-server links (back to the webapp) for governance events or for tasks. For example, for the TBL (Tomcat) server, it would be something like: http://serverhostname/tbl

For TopBraid Composer - Maestro Edition, it would be: http://localhost/:8083

Show Hidden FilesfalseDuring data selection, show all the files that are present on each project.

General Database Parameters

ParameterDefaultDescription
Max Connections per Database100For each RDBMS (relational) or D2RQ database, the maximum number of active connections permitted.

SWP Parameters

ParameterDefaultDescription
Constraint violations block editingfalseIf true then the SWA edit forms will report those SPIN constraint violations marked as spin:Error or spin:Fatal as errors that cannot be OKed by the confirm dialog. By default (false), all SPIN constraint violations are non-Fatal are reported as warnings that the user can manually bypass.
ui label function URI The URI of a SPARQL function that takes a resource as argument and returns a string representation. If set, this will be used whenever ui:label is called, making it possible to define custom label algorithms in a single place.
ui:lib function is constantfalseTrue to have ui:lib() always return the static value "lib".
maximum number of table rows1000The maximum number of rows to be displayed by (search results) table widgets

LDAP Servers (Service Providers)

TBL can support multiple LDAP service providers (e.g., multiple Active Directory domains or LDAP servers). For each one, click the plus sign "+" to create a new LDAP stanza (parameter group).

Before applying any LDAP changes, please double-check all settings for accuracy. Inconsistencies with remote LDAP systems could result in the loss of TBL permissions, which could be especially problematic for administrators (i.e., users having roles with AdministratorGrp group privileges; see Rights Management). Please verify before proceeding. Losing administrator permissions would block access to Administration pages, including this one, thereby requiring external access to the TBL system environment to modify the configuration files directly.

Configuration parameters

For each LDAP server, open Server Configuration > Edit > Configuration parameters > "+" and enter the following server parameters. To delete an LDAP server configuration, open Edit and click its "x".

ParameterDefaultDescription
Connection URL LDAP service provider's connection URL
Username for server connection Username for connection login
Password for server connection 

This appears only if other LDAP parameters are set, and it is set after Save Changes has completed.

User pattern string Based on the Tomcat JNDIRealm (for LDAP), this is the userSearch and userBase (e.g., "sAMAccountName={0},CN=Users,DC=sharepoint,DC=tqinc,DC=info")
Role definition base roleBase: The base DN for role searches (e.g., "OU=Roles,DC=sharepoint,DC=tqinc,DC=info")
Role name identifier roleName: The name of the attribute that has the role-entry's name (e.g., "cn")
Role search string roleSearch: The LDAP search filter for selecting role entries (e.g., "(member={0})")

Membership search string

(OPTIONAL, Recommended)

 For certain LDAPs (e.g., Active Directory), this is the reverse of roleSearch, used to find role memberships for a given user (e.g., "(memberOf={0})").

SMTP Server Parameters

ParameterDefaultDescription
SMTP Authentication OnfalseTells if smtp server requires authentication.
SMTP Server Smtp Server to be used for sending emails in TopBraid Live.
SMTP Server Port Number587Port used by smtp Server.
SSL EnabledfalseIf SSL for mail is on
SMTP Username Username for authenticating on smtp server.
SMTP Password This appears only if other SMTP parameters are set, and it is set after Save Changes has completed.

Advanced Parameters

ParameterDefaultDescription
Allow Anonymous AccessfalseIf no authentication scheme is used and this flag is true, anonymous access with READ and EXECUTE permission is allowed to the application.
Enable SPARQL updatesfalseIf true, then the SPARQL end point (servlet) will allow update requests.
Timeout on SPARQL Endpoint If not set or 0, SPARQL endpoint has no timeout. Timeout is in milliseconds. If the timeout is reached, the system will throw a CancelQueryException to the user.
Enable Fair LockstrueIf true, then locks taken by TBL will use a first in first out queue, if false then order is less predictable.
Longer Stack TracesfalseCreate longer stack traces, adding very large overhead. These are very useful for rapid resolution of certain types of problems. Set this parameter only if requested by TopQuadrant Customer Support.
Fail With Error on Design InconsistencyfalseWhen a possible software design inconsistency is detected, fail with an error.
Disable Lucene Indexingfalse

Used for Search the EDG. If disabling is true, the indexing is off thereby using SPARQL search, and the syntax of users' search queries changes regarding the usage of explicit wildcard characters; see for User Interface - Overview: Lucene integration details.

60 minutesSets a custom interval time for reindexing graph's included in the Search the EDG configuration, if Lucene is enabled. Will read this value as minutes. The minimum time is 30 minutes.
Enable SPARQL Query ManagementfalseEnable the query management functionality to monitor currently running queries in the system. See also: Component Monitoring > Process Management.
Secure Storage encryptionPBEWithSHA1andDESedeOptionally changes the encryption algorithm for storing passwords in the secure storage file. If changed, please use a new secure storage file and restart the server.
Suppress Warnings of Possible Design InconsistencytrueWhen a possible software design inconsistency is detected, and the system is not configured to fail, then suppress the warnings. Setting this parameter to false will result in logged error message of any design inconsistencies.
Temporary Graphs Time Out2The length of time to wait before a temporary graph can be garbage collected (minutes).
Use SaxonfalseUse Saxon rather than Xalan for XSLT/XML processing.
Verbose loggingfalse

If true, then some operations will send additional info to the log. This may slow down the server a bit.

Google Maps API Key
To enable Google Maps viewing functions in TopBraid, obtain an API key (string) from Google and enter it here.

URI mappings

ParameterDefaultDescription
Short Graph name A tuple consisting of a graph (URI) and a short name. Can be used to abbreviate graphs in servlet calls. For example the SPIN template servlet handles abbreviated names such as /tbl/template/swa/GetResourceValues/kennedys?... If you want to address the kennedys ontology with that URL, you need to add a short graph name that associates http://topbraid.org/examples/kennedys with the name "kennedys".

User Interface Configuration

Some TopBraid TBL features support assigning language tags to string attribute values using a drop-down list when editing, for example:

To customize the list of available choices, go to the Server Administration page, then Server Configuration Parameters. The bottom of the Server Configuration Parameters screen has a space-delimited list where you can enter the language choices that will appear on TBL editing screens. Any codes can be entered, but the codes will interoperate better with other systems, such as Web browsers, if the ISO 639 language codes and, optionally, ISO 3166 country codes, are used. In the following, ISO codes for Spanish, English US English have been entered. These will be the only languages that appear in the language tag drop-down:

Be sure click Save Changes when finished.

Download Configuration Files

Download general config graphClick this link will download the current config.ttl from the system folder.
Downoad uiconfig graphClick this link to download the current uiconfig.ui.ttl from the system folder.

  • No labels