# Service Details View

When clicking on an installed service in the [service overview page](working-with-service-commissioning-files), the _Service Details_ view for this service will be shown.

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-fb4ace76ecd90c0bcf6b2a09c5d2482e4ed14890%2Fdetails.png?alt=media" alt=""><figcaption></figcaption></figure>

This _Service Details_ view shows the following information and potential actions:

* Name, [ServiceID](serviceid), description, provider, status, [deviation](deviation) (if detected) and links to buttons of the service, if part of the service commissioning file
* The first button in the upper right section will [enable](#enabling-disabling-services) the service. Similarly, for a service which is already enabled, the button changes and lets the user [disable](#enabling-disabling-services) the service again.
* Further buttons in the upper right section are available to [update / reconfigure](#updating-services), or [delete](../working-with-service-commissioning-files#removing-services) the service. If the service is enabled, those buttons are inactive (grayed out).
* Another button enables the user to download again the [commissioning file](structure-of-commissioning-files).
* The rest of the page shows the lists of the various [resource](structure-of-commissioning-files/resources) of the service

## Enabling/Disabling Services

To enable a service, first the parameter values must be specified, then the requested permissions must be confirmed in the authorization dialog, and finally the service will actually be enabled.

1. In the _Service Details_ view, click `Enable`.

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-352320d23537543cfe7afd8fb9afb85195fcd2f5%2Fdetails-button-enable.png?alt=media" alt=""><figcaption></figcaption></figure>

2. This will open the _Authorization Required_ dialog which provides a short summary of all the resources that your service needs to access in order to fully function. Make sure to review the requirements thoroughly. Once you are done, enable the service by clicking `Allow` in the bottom right corner of the _Authorization Required_ dialog.

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-b1dba15c27342788dbb008c1ea6450b0f8b2f308%2F2_authorization_required.png?alt=media" alt=""><figcaption></figcaption></figure>

For a service that is enabled, the displayed status and the available buttons change accordingly. The status line shows that the service is now in enabled state:

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-76159d416f32d89d4b3c45f5d0d094abbbb384ea%2Fdetails-enabled.png?alt=media" alt=""><figcaption></figcaption></figure>

The first button in the upper right section now lets the user [disable](#enabling-disabling-services) the service again.

In this example screenshot, a [deviation](deviation) has been detected. When clicking `Show Deviation`, the following dialog window lists the resources whose actual state is different from the expected state.

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-7e91939d3e60a8789ee599d05b27ba3407ec4592%2Fdeviation-dialog.png?alt=media" alt=""><figcaption></figcaption></figure>

## Updating Services

When _updating_ or _reconfiguring_ a service, you can either update the service itself, or just reconfigure the existing service with different parameters. In either case, the service is then immediately re-enabled.

1. In the _Service Details_ view, click `Update/Reconfigure`.

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-b52862ecdef65d52abafe91f05ccbfd51cc8561f%2Fdetails-button-update.png?alt=media" alt=""><figcaption></figcaption></figure>

2. If you want to update the service, you can do so in the left part of the window. Otherwise, you can skip this and go to the next step for reconfiguration in the right part of the window.

For updating a service that was installed by uploading a commissioning file from your computer, click `Choose File` to upload a new file:

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-d918af6697f3bc7902400b5e1b222ad099de02e9%2F2_service.png?alt=media" alt=""><figcaption></figcaption></figure>

For updating a service that was installed from the Services Catalog: The window will show the information about available updates in the Service Catalog. If an update is available and you want to install it, click `Update to version ?.?.?`.

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-7c3df4509d0669dcdd74463e1641747ebf6ed118%2F2_service_from_catalog.png?alt=media" alt=""><figcaption></figcaption></figure>

Or simply skip this step and continue with reconfiguration in the right part of the window.

3. If the service contains configurable parameters, customized values for the parameters can be entered in the right part of the window. Depending on the service configuration, some default values might be provided for each parameter. Additionally, in the left part of the window the currently loaded commissioning file can be viewed using `Click to see commissioning file`. Once the parameter values are entered, click `Update`.

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-756ae3cbd09d9b87265cc231c2369fc8d3c361b9%2F3_confirm.png?alt=media" alt=""><figcaption></figcaption></figure>

4. This will now transition the status of the service into _Updating_, then into _Enabled_ or _Disabled_ according to the state that was there in the beginning.

## Resources of Services

For inspecting the various resource of this service, each subsection of the service details page can be opened by selecting the tab. Each resource can be clicked on, which directly jumps to the details view of the respective [resource](../resources).

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-7793f6a9ba0c28c2f8a723db32b5ee0f62537d27%2Fservice-details.png?alt=media" alt=""><figcaption></figcaption></figure>

## Log Messages of Services

Additionally, the log messages of this service can be inspected. To expand the `Service Logs` section, click the `Service Logs` tab in the tab menu.

<figure><img src="https://4142639966-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7fj06nwrOaOPonB577Xs%2Fuploads%2Fgit-blob-a2c08fca9a77b42f1191a2b7df1ccd7821fd8ab1%2Fservice-logs-details.png?alt=media" alt=""><figcaption></figcaption></figure>

The `Logs` section shows the logging message of the selected service. In the toolbar at the top right of this section, there are the following buttons:

* _Search_ for log entries containing the entered keyword. This also filters the current table.
* _Download CSV_ to download the displayed rows of the log file as a CSV (Comma-Separated-Value) text file (Note: Log lines outside of the window are not downloaded, and the complete download is limited to the most recent 500 lines; use _Download raw log_ for a complete log download)
* _View columns_ to select the columns to be shown
* _Filter table_ to select filter criteria to have only a subset of rows shown
* _Download raw logs_ to download the full log file in order to pass on this file to Cybus Support for in-depth issue resolution. See [Container Logs](../../system-status/status#container-logs) for an explanation of the file format.
* and _Refresh_ to refresh (reload) the currently shown log messages.
