Skip to main content
Skip table of contents

Node Instance Preferences

Switch to the Preferences tab in the information/working area. Users who want to change the preferences need to be a member of a group, to which the role ADMIN has been assigned.

Figure: Node Instance Preferences

Overview

In the Overview section of this tab, the following information about the selected node instance is displayed:

Scheer PAS BRIDGE
Version number and operating system of the installer that has been used to install/update the Bridge.
Operating SystemOperating System the Bridge is running on.
Bridge APIVersion number of the Bridge API.
Node Instance NameHost name of the selected node instance.
Port Number The port number, to which the Bridge on the selected node instance is listening (defined during the installation of the Bridge).
Domain NameName of the domain, the node instance is part of.
Domain IDUnique ID of the domain.

Memory for Bridge Process

In the Memory section of this tab, the following information about the memory usage of the Bridge process (process E2E-Console-<name of the host>, not the running services):

Used Memory
Memory used by the Bridge process right now.
Allocated Memory
Memory that has been allocated for the Bridge process.
Max. Available Memory
Memory that is available for the Bridge process.

Preferences

In the Preferences section of the information/working area, the following settings can be applied:.

Delete Logs Older Than

Bridge 7.6.0 Specify the number of days that log files and service backup files should be kept. Each night at 00:00 pm (fix), older files will be deleted automatically. If you specify 0 days, the files will be kept forever, default value after installation of the Bridge is 30 days.

If you update a Bridge from below version 7.6.0, this value will be set to 0 (in opposition to 30 days upon a fresh installation). In this case, set the number of days manually.

Log LevelThe software components of the Bridge log activities like deployments, import of node instances into a domain, firmware package uploads, etc. according the selected log level. The higher the log level the more information will be written to the log files. See Node Instance Preferences#Bridge Log Level for more details on these log levels.
Trace RequestsOnly used for troubleshooting and only works, if log level Trace has been chosen. Selecting this option will generate tracing files that can be examined by the E2E support. Use this option carefully, as it generates large amounts of data.
Disable Automatic Service StartupEach deployed Bridge service has am Automatic Startup flag (see Preferences of an xUML Service, Node.js Service Details and Java Service Details for more information on this flag). For e.g. server maintenance reasons, when you need to reboot the server several times, it can be useful to disable this flag for all services.
As long as this option is selected, the Bridge will ignore all service specific Automatic Startup flags.
Display NameBy setting Display Name, the name of the Bridge and of the browser tab can be changed, e.g. to the name of the server as shown below.
Note: The user interface will show the display name of the Bridge you are currently using (see browser URL). Additionally imported node instances could have different display names that will be displayed when using their user interface.
Maximum Upload SizeMaximum size of files in MB that can be uploaded to the Bridge. This limit refers to repositories, resources and Runtime packages.
Monitoring SOAP URLOptional monitoring of xUML services.
If an xUML service has an error or crashes, the registered monitoring service will be called. The service call timeout is 3 seconds. The second monitoring service backups the first and will be called if the first monitoring service call fails.
For more details, refer to Monitoring.
Monitoring SOAP URL FallbackOptional monitoring fallback.
Monitoring HTTP URLAs an alternative to a SOAP URL (see Monitoring SOAP URL), you can specify an URL to a monitoring REST service here.
Monitoring HTTP URL FallbackOptional REST monitoring fallback.
Long Running Session ThresholdMonitoring threshold specified in minutes. If a service is occupied longer than the defined threshold, the monitoring service is called. Refer to Monitoring for more details. The check runs twice during the defined threshold time. To disable the threshold enter 0.

Click Apply to save your adjustments.

Bridge Logging

xUML Service Logging

The software components of the Bridge log activities like deployments, import of node instances into a domain, firmware package uploads, etc. according the selected log level. The higher the log level the more information will be written to the log files.
The log levels in the table below are cumulative and are ordered from the lowest to the highest log level. For each log level, also the information of the lower levels is logged. When changing the log level, all future incidents will be logged according to the new settings.

Log Level
Description
NoneNo logging.
Fatal Logs only fatal errors. The component cannot continue with normal execution. Fatal errors need the intervention of an administrator to solve the problem.
Error Logs also non-fatal errors that occur during normal operation of the Bridge.
Warning Logs warnings. Warnings indicate unexpected but non-critical situations that do not interrupt normal operation.
Info Logs general information. This log level should be sufficient for normal use.
Debug and Trace Both log levels are not intended for normal use but for troubleshooting. The log level Trace results in more detailed logging information than log level Debug.

Logged data is stored in your Bridge DATA directory at E2E_BRIDGE_DATA/servlets/logs in several subfolders (before Bridge version 5.1.5: E2E_BRIDGE_PROG/servlets/logs). You can inspect the logged information on the Logging tab as described in Inspecting the Logging Information.

Bridge API Logging

The implementation of the Bridge API uses the Eclipse Jersey REST framework. This framework allows to configure Logging and Tracing. You can activate and configure Jersey logging and tracing via the console.properties file. This file resides in the Bridge program folder of your installation.

Console PropertyDescriptionAllowed Values
Logging
rest_api_log_level

Set this property to activate Jersey logging for the Bridge API. If this property is not set, Jersey logging is switched off.

The logging information is written to <Bridge data directory>/servlets/logs/admin/error_<current date>.log.

One of SEVERE, WARNING, INFO, CONFIG, FINE, FINER, FINEST, ALL.
Refer to the Jersey documentation for more information.
rest_api_log_verbosity
Configure the verbosity of the logger.HEADERS_ONLYLogs the content of the HTTP headers only. No message payload data is logged.
PAYLOAD_TEXTLogs the content of the HTTP headers as well as entity content of textual media types (default).
PAYLOAD_ANYFull verbose logging: Logs the content of HTTP headers as well as any message payload content.
Tracing
rest_api_tracing_threshold

Set this property to activate Jersey tracing for the Bridge API.If this property is not set, Jersey tracing is switched off.

The logging information is returned via the response headers.

SUMMARYLogs very basic summary information about the main request processing stages.
TRACELogs detailed information about activities in all the main request processing stages.
VERBOSEMost verbose mode that provides extended information similar to the TRACE level, however with details on entity providers (MBR/MBW) that were skipped during the provider selection phase for any reason (lower priority, pattern matching, etc). Additionally, in this mode all received request headers are echoed as part of the tracing information.
rest_api_log_tracing_on_server

Set this property to additionally write the Jersey trace to the Bridge server logs.

Please note that Jersey tracing may create a huge amount of data. Do only enable this for problem solving reasons.

trueWrites the Jersey trace to <Bridge data directory>/servlets/logs/admin/error_<current date>.log. This is the same file as for the Jersey logging.
falseDo not write the logs to a file on the Bridge server (default).

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.