Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: xuml_service_add_on_settings adapted

...

Table Filter
totalrow,,,
hidelabelsfalse
sparkNameSparkline
hidePaneFiltration panel
sparklinefalse
default,,,
isFirstTimeEnterfalse
cell-width150,150,150,150
hideColumnsfalse
disabledfalse
enabledInEditorfalse
globalFiltertrue
id1678969416914_-746687494
order0,1,2,3
hideControlstrue
inversefalse,false,false,false
sortChapter ⇧,Name ⇧
disableSavefalse
separatorPoint (.)
labelsChapter‚Name‚Excerpt‚Filter whole table
userfilterChapter,Name,Excerpt
datepatterndd M yy
updateSelectOptionsfalse
worklog365|5|8|y w d h m|y w d h m
isORAND


ChapterNameExcerptUsage
Administrationaccess_docker_logs_details


Multiexcerpt
MultiExcerptNameaccess_docker_logs_details
  • Open the details page of the service, open section Logs and click on the Log Analyzer link.


Administrationaccess_docker_logs_icon


Multiexcerpt
MultiExcerptNameaccess_docker_logs_icon

You have two options to access the logs:

  • Click Open Logslogs in the quick actions bar in the services' list.


Administrationapplicable_actions


Multiexcerpt
MultiExcerptNameapplicable_actions


Info

Only applicable actions are enabled.



Administrationchange_docker_log_level_details


Multiexcerpt
MultiExcerptNamechange_docker_log_level_details
  • Open the details page of the service and scroll down to section Logs.


Administrationchange_docker_log_level_icon


Multiexcerpt
MultiExcerptNamechange_docker_log_level_icon

You have two options to open the input form where you can change the log level:

  • Click Change Log Levellog level in the quick actions bar in the services' list. This will open a pop-up window.


Administrationchange_nestjs_log_level_1


Multiexcerpt
MultiExcerptNamechange_nestjs_log_level_1

On the details page of a pas-nestjs service, scroll down to section Logs and expand the section.


Administrationchange_nestjs_log_level_2


Multiexcerpt
MultiExcerptNamechange_nestjs_log_level_2

If you open the pop-up window via the quick actions, you have the same options for the Configuration of the logs:

  • Global (default)
  • Custom


Administrationchange_nestjs_log_level_3


Multiexcerpt
MultiExcerptNamechange_nestjs_log_level_3

Global

In the global configuration, you set the log level for all sinks.

Available log levels are:

  • verbose
  • trace
  • debug
  • info
  • warn
  • error
Info

If you have turned down the log level to see more logs, do not forget to turn it up again after you have finished your analysis. The performance of the system may deteriorate if a lot of logs are stored for a long time. The log level settings are reset to its default value during a restart of the service.



Administrationchange_nestjs_log_level_4


Multiexcerpt
MultiExcerptNamechange_nestjs_log_level_4
  • Save your changes to apply them to the service.
  • Use Reset to return to the default value. In most cases this is info.
  • If you opened the pop-up window from the quick action menu in the service list, you have also a Cancel button. Click Cancel to discard your changes and to close the pop-up window.


Administrationchange_nestjs_log_level_5


Multiexcerpt
MultiExcerptNamechange_nestjs_log_level_5

Custom

The Custom tab allows a fine grained setting of the log level.

For each channel, you can set the log level for the different sinks:

  • Console
  • OpenSearch (relevant for analyzing log entries via Log Analyzer)

Use the Filter to show only the channels you are looking for.


Administrationchange_nestjs_log_level_6


Multiexcerpt
MultiExcerptNamechange_nestjs_log_level_6

In the Custom tab, option Save will only be enabled when at least one of the entries has been changed.


Administrationdetails_page


Multiexcerpt
MultiExcerptNamedetails_page

Click on a name in the service list to open its details page.
The details page shows you the title of the service and some quick action icons:

IconDescription
Shows the current state of the service.

Starts the service.

Stops the service.
Restarts the service.



Administrationdetails_section


Multiexcerpt
MultiExcerptNamedetails_section

On top of the Details section, you can find the option Delete Service button, (refer to Deleting a Service below for further information). The boxes General, Build and Deployment contain read-only information.


Administrationdocker_information


Multiexcerpt
MultiExcerptNamedocker_information

The Information section contains the main information about the container:

  • Name
  • Source is Docker for Docker containers
  • Type
  • Created/Updated
  • Version


Administrationdocker_types


Multiexcerpt
MultiExcerptNamedocker_types
  • database
  • init
  • other
  • pas-app
  • pas-nestjs
  • pas-service
  • undefined
  • xuml-legacy-service
  • xuml-service (= services created in Designer or with deployment wizard)
  • other
  • undefined
Info

Other service types may be displayed.



Administrationinfo_nestjs_services


Multiexcerpt
MultiExcerptNameinfo_nestjs_services

For services of type pas-nestjs, the information section also contains a link to the Swagger UI.


Administrationinfo_xuml_services


Multiexcerpt
MultiExcerptNameinfo_xuml_services


Info

This option is only available for type xuml-service (= containerized xUML services).



Administration
inspect_docker_logs



Multiexcerpt
MultiExcerptNameinspect_docker_logs

Both ways will open the logs of the corresponding Docker container in the Log Analyzer where you can view, filter and search the platform log s for all services.


Administrationkubernetes_acces_to_xuml_logs


Multiexcerpt
MultiExcerptNamekubernetes_acces_to_xuml_logs

The administration application gives you access to the logs of Kubernetes workloads.


Administrationkubernetes_information


Multiexcerpt
MultiExcerptNamekubernetes_information

The Information section contains the main information about the Kubernetes workload:

  • Name
  • Source is Kubernetes for workloads
  • Type
  • Created/Updated
  • Version


Administrationkubernetes_only


Multiexcerpt
MultiExcerptNamekubernetes_only


Info

This feature is only available in a Kubernetes setup.



Administrationkubernetes_types


Multiexcerpt
MultiExcerptNamekubernetes_types
  • custom
  • gitea
  • java
  • minio
  • other
  • pas-app
  • pas-nestjs
  • pas-service
  • postgresql
  • unknown
  • xuml-legacy-service
  • xuml-service (= services created in Designer or with deployment wizard)
  • other
  • unknown
Info

Other service types may be displayed.



Administrationkubernetes_xuml_logs_open


Multiexcerpt
MultiExcerptNamekubernetes_xuml_logs_open

Both ways will open the logs of the corresponding Kubernetes workload in the Log Analyzer where you can view, filter and search the platform logs for all services.


Administrationlog_analyzer_opens


Multiexcerpt
MultiExcerptNamelog_analyzer_opens

The Log Analyzer will open, showing you the corresponding logs.


Administrationlog_section_not_available


Multiexcerpt
MultiExcerptNamelog_section_not_available

The Logs section also informs you if there are no logs available for this a service type of service.


Administrationnote_bridge_user_guide


Multiexcerpt
MultiExcerptNamenote_bridge_user_guide


Tip

Go Refer to the Bridge User Guide for detailed information about the functionalities of the integration component.



Administrationnote_config_json


Multiexcerpt
MultiExcerptNamenote_config_json


Note

Do not edit content in the Configuration section without any knowledge of JSON.



Administrationnote_config_not_available


Multiexcerpt
MultiExcerptNamenote_config_not_available

The Configuration section also informs you if the configuration for this type of service UI is not available for a service type.


Administrationnote_log_level


Multiexcerpt
MultiExcerptNamenote_log_level


Info

This option is only available for type pas-service (= PAS applications without UI).



Administrationopen_container_details


Multiexcerpt
MultiExcerptNameopen_container_details

You can open a details page for each container.

To do so, click on the service name in the list.


Administrationopen_docker_configuration_details


Multiexcerpt
MultiExcerptNameopen_docker_configuration_details
  • Open the details page of the service and scroll down to section Configuration.


Administrationopen_docker_configuration_icon


Multiexcerpt
MultiExcerptNameopen_docker_configuration_icon

The administration application allows you to change the configuration of a Docker container.

You have two options to open the configuration of a container:

  • Click Edit Configurationconfiguration in the quick actions bar in the services' list.


Administrationopen_log_analyzer_via_link


Multiexcerpt
MultiExcerptNameopen_log_analyzer_via_link

In the Logs section of the service details page, you can also use the link Open Log Analyzer to inspect logs.


Administrationopen_workload_details


Multiexcerpt
MultiExcerptNameopen_workload_details

You can open a details page for each workload.

To do so, click on the service name in the list.


Administrationresetpas_lognestjs_configuration_levelintro


Multiexcerpt
MultiExcerptNameresetpas_nestjs_logconfiguration_level
Info

If you have turned down the log level to see more logs, do not forget to turn it up again after you have finished your analysis. The performance of the system may deteriorate if a lot of logs are stored for a long time. The log level settings are reset to its default value during a restart of the service.

intro

For services of type pas-nestjs (= internal services of the PAS platform) developers can define a service-specific schema and documentation. If a schema is available, the display in section Configuration will change and show the defined configuration options.

Note

Be careful: Changing these options may result in an unusable service and may affect other parts of the platform as well.



Administration

reset_log_level


Multiexcerpt
MultiExcerptNamereset_log_level


Info

If you have turned down the log level to see more logs, do not forget to turn it up again after you have finished your analysis. The performance of the system may deteriorate if a lot of logs are stored for a long time. The log level settings are reset to its default value during a restart of the service.



Administrationservice_definition


Multiexcerpt
MultiExcerptNameservice_definition


Info

What is the difference between pas-app

Administrationservice_definition
Multiexcerpt
MultiExcerptNameservice_definition
Info

What is the difference between pas-app and pas-service?

  • pas-app: Applications accessible via UI.
  • pas-service: Applications without UI.



Administrationservice_type_docker


Multiexcerpt
MultiExcerptNameservice_type_docker

indicates a Docker container.


Administrationservice_type_integration


Multiexcerpt
MultiExcerptNameservice_type_integration

indicates an integration service.


Administrationservice_type_kubernetes


Multiexcerpt
MultiExcerptNameservice_type_kubernetes

indicates a Kubernetes workload.


Administrationservices_list


Multiexcerpt
MultiExcerptNameservices_list

All available services are displayed in the list on the administration start page.


Administrationservices_list_date


Multiexcerpt
MultiExcerptNameservices_list_date

Shows the date and time of the last update of the service. If the service has not been updated yet, its creation date is displayed.


Administrationservices_list_date_format


Multiexcerpt
MultiExcerptNameservices_list_date_format

Datetime in format dd.mm.yyyy, hh:mm:ss


Administrationservices_list_name


Multiexcerpt
MultiExcerptNameservices_list_name

Name of the service. Click on the name to access the service details page.


Administrationservices_list_status


Multiexcerpt
MultiExcerptNameservices_list_status

Indicates the status of the service.


Administrationservices_list_type


Multiexcerpt
MultiExcerptNameservices_list_type

Indicates the type of the service.


Administrationtip_details_on_containerized_services


Multiexcerpt
MultiExcerptNametip_details_on_containerized_services


Tip

Go to page Controlling Containerized xUML Services for For detailed information how to handle containerized xUML services after successfull deployment., refer to one of the following pages (depending on your setup):



Administrationtip_log_analyzer_usage


Multiexcerpt
MultiExcerptNametip_log_analyzer_usage


Tip

Go Refer to page Analyzing Platform Logs for further information. If you access the Log Analyzer for the first time on a newly installed platform, you will have to create an index pattern first, see refer to Creating an Index Pattern.



Administrationxuml_servicesservice_changesettings_confignote


Multiexcerpt
MultiExcerptNamexuml_servicesservice_changesettings_config

The administration application allows you to change the configuration of a containerized xUML service.

note


Note

You can modify settings of a service no matter if the service is running or if it has been stopped. Saving the changes triggers a re-create and restart of the container. Changing the settings on a stopped service will start the service. Settings will be stored, so if you stop the service and restart it, the settings are restored.

If you delete a service, all settings are lost and cannot be recovered.



Administration

xuml_

services_change_config_current_value

service_add_on_settings_sql_adapter_authorization

Delete when Admin Guide 24.1 has been published


Multiexcerpt
Multiexcerpt
MultiExcerptNamexuml_services_change_config_current_value

You can change a setting in field Current Value. If you want to reset the setting to its default, click Reset Image Removed.

The Default Value is displayed next to the current value.

Click Save after you have completed your changed.

service_add_on_settings_sql_adapter_authorization

These settings allow you to adapt the SQL database user and password of the xUML service.

KeyValue
customers: DBUserDatabase user
customers: DBPasswordDatabase password



Administrationxuml_servicesservice_changeadd_configon_filtersettings


Multiexcerpt
MultiExcerptNamexuml_servicesservice_changeadd_configon_filtersettings

Each xUML service adapter has its own settings that are initialized in the xUML model and can be changed in the configuration. 

If you are running an xUML service that is connecting to a database backend, you can modify the tagged values of the database interface respectively dependency. Before starting a deployed xUML service that connects to a database backend, you may want to redefine required database parameters.

Generally, most of the add-on settings that are related to an xUML Service Adapter have a corresponding tagged value in the component diagram. Refer to the documentation of the corresponding adapter for these settings

As there are many available settings, use the filter field to search for the setting you want to modify.

The content of the filter field is applied to the columns Category, Section and Key.



Administrationxuml_services_change_config_filter_extended


Multiexcerpt
MultiExcerptNamexuml_services_change_config_filter_extended

The administration application allows you to change the configuration of a containerized xUML service

Click Extended Filter Image Removed to display the extended filter options:

  • Category
  • Section
  • Reset Filter

If a filter is applied, the extended filter changes to Image Removed.


Administrationxuml_services_change_config_filterfaulty_resetsettings


Multiexcerpt
MultiExcerptNamexuml_services_change_config_filterfaulty_reset

In the main filter window, you can reset all selected filters. Click Image Removed Reset Filter.

In the filter option window, you can also reset the selection.

settings

Service settings can be erroneous if a setting name contains special characters or whitespaces. Invalid service settings are marked Image Added. Their number is also displayed on top right of the list.

If a service setting is erroneous, you cannot change its current value.

In case that your service contains erroneous settings, you can do the following:

  • If it is a setting in a Designer service ("custom value"): Open the service in the DESIGNER, correct the settings' name and redeploy the service.
  • If it is a setting in a platform service, please contact our support team.


Administrationxuml_services_change_config_notefilter


Please note:

  • Save is only enabled when changes have been made.
  • Clicking Save triggers a restart, changes in the Configuration section are directly applied to the service

    .

    Multiexcerpt
    MultiExcerptNamexuml_services_change_config_notefilter

    As there are many available settings, use the filter field to search for the setting you want to modify.

    The content of the filter field is applied to the columns Section and Key

    Note


    Administrationxuml_services_change_config_logfilter_levelextended


    Multiexcerpt
    MultiExcerptNamexuml_services_change_config_logfilter_level

    In the administration application you have the possibility to change the log level for a containerized xUML service.

    extended

    Click Extended filter Image Added to display the extended filter options:

    • Section
    • Reset Filter

    If a filter is applied, the extended filter changes to Image Added.


    Administrationxuml_services_change_config_configurationfilter_sectionreset


    Multiexcerpt
    MultiExcerptNamexuml_services_change_config_configurationfilter_sectionreset

    In the the main filter window, you can reset all selected filters. Click Image Added Reset Filter.

    In the filter option window, you can also reset the selection.Configuration section you can directly modify xUML service settings. When you save your changes, the container will be re-created and restarted. Changes are possible after the first deployment of the containerized service.


    Administration

    xuml_services_

    endpoints

    change_

    and

    config_

    libraries

    note


    Multiexcerpt
    MultiExcerptNamexuml_services_endpointschange_and_libraries

    Below the three sections that contain read-only information, you can find the two tabs Endpoints and Libraries.

    config_note


    Note

    Please note:

    • Save is only enabled when changes have been made.
    • Clicking Save triggers a restart, changes in the Configuration section are directly applied to the service.



    Administrationxuml_services_endpointschange_extendedlog_filterlevel


    Multiexcerpt
    MultiExcerptNamexuml_services_endpointschange_extendedlog_filter

    Click Extended Filter Image Removed to display the extended filter options:

    • Type
    • Reset Filter

    If a filter is applied, the extended filter changes to Image Removed.

    level

    In the administration application you have the possibility to change the log level for a containerized xUML service.


    Administrationxuml_services_endpointsconfiguration_filtersection


    Multiexcerpt
    MultiExcerptNamexuml_services_endpointsconfiguration_filter

    Use the filter field to search for a specific endpoint.

    The content of the filter field is applied to the columns Name and Type.

    section

    In the Configuration section you can directly modify xUML service settings. When you save your changes, the container will be re-created and restarted. Changes are possible after the first deployment of the containerized service.


    Administrationxuml_services_endpoints_filterand_resetlibraries


    Multiexcerpt
    MultiExcerptNamexuml_services_endpoints_filterand_resetlibraries

    In the main filter window, you can reset all selected filters. Click Image Removed Reset Filter.

    In the filter option window, you can also reset the selection.

    Below the three sections that contain read-only information, you can find the two tabs Endpoints and Libraries (see below for details).


    Administrationxuml_services_endpoints_generalextended_sectionfilter


    Multiexcerpt
    MultiExcerptNamexuml_services_generalendpoints_extended_sectionfilter

    Click Extended filter Image Added to display the extended filter options:

    • Type
    • Reset Filter

    If a filter is applied, the extended filter changes to Image Added.


    Administrationxuml_services_endpoints_filter


    Shows the date on which your integration license expires. You can click on the date for detailed information

    .

    Multiexcerpt
    MultiExcerptNamexuml_services_endpoints_filter

    Use the filter field to search for a specific endpoint.

    The content of the filter field is applied to the columns Name and Type

    The General details contain common information about the compiled .rep file:

    TimerShows whether a timer is enabled or not.
    SchedulerShows whether a scheduler is enabled or not.
    NameName of the compiled service.
    VersionVersion of the compiled service.
    License Expiration Date


    Administrationxuml_services_infoendpoints_loggingfilter_conceptreset


    Multiexcerpt
    MultiExcerptNamexuml_services_infoendpoints_loggingfilter_concept
    Info

    The logging concept of the xUML Runtime is build around the concepts of channels and sinks. Refer to xUML Runtime Logger Configuration for detailed information.

    reset

    In the main filter window, you can reset all selected filters. Click Image Added Reset Filter.

    In the filter option window, you can also reset the selection.


    Administrationxuml_services_librarygeneral_tab_contentsection


    Timestamp of the compilation of the library
    Multiexcerpt
    MultiExcerptNamexuml_services_librarygeneral_tab_contentsection

    The General details contain common information about the compiled .rep file:

    TimerShows whether a timer is enabled or not.
    SchedulerShows whether a scheduler is enabled or not.
    NameName of the compiled service.
    VersionVersion of the compiled service
    ColumnDescription
    NameName of the library.
    VersionVersion of the library.
    Compiler VersionVersion of the compiler the library has been compiled with.
    Compile Date
    .



    Administrationxuml_services_libraryinfo_tablogging_content_filterconcept


    Multiexcerpt
    MultiExcerptNamexuml_services_libraryinfo_tablogging_content_filter

    Use the filter field to search for a specific library.

    The content of the filter field is applied to the column Name only.

    concept


    Info

    The logging concept of the xUML Runtime is build around the concepts of channels and sinks. Refer to xUML Runtime Logger Configuration for detailed information.



    Administrationxuml_services_library_licensetab_infocontent


    The hostname for which this license has been created.
    _unspecified_ indicates that the license is not bound to a specific hostname
    Multiexcerpt
    MultiExcerptNamexuml_services_library_licensetab_infocontent


    ColumnDescription
    NameName of the library.
    VersionVersion of the library.
    Compiler VersionVersion of the compiler the library has been compiled with.
    Compile DateTimestamp of the compilation of the library

    If you click on the License Expiration Date the following information is displayed:

    IDThe ID of the license key.
    NameThe name of the company the license was issued to.
    ConnectionsThe number of licensed concurrent connections that have been issued.
    Licensed ModulesList of the licensed modules.
    License Expiration DateDate on which your license expires.
    Machine ID
    .