# Working with Service Commissioning Files

This page explains how to work with services from the service overview page of the *Connectware* web interface.

{% hint style="warning" %}
If your service fails to install, remove, enable or disable, already created resources will be rolled back and removed to avoid cluttering the Connectware with unused data.
{% endhint %}

## Installing Services

Commissioning files are installed using the web-based interface of the *Connectware* on the service overview page:

1. On the navigation panel, click `Services`.

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

2. Click `Upload Service` to add a new service.

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

3. In the *Create Service* dialog, click `Choose File`, select a commissioning file from your local computer in the file browser, and click `Ok`.

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

4. This will fill in the information in the right part of this dialog window, the *Configure the new service* section. If your service commissioning file provides configurable parameters, you can now enter customized values for your service. Depending on the commissioning file, parameter descriptions and default values may be available. Additionally, the commissioning file can be reviewed by expanding the `Click to see commissioning file` tab in the left part. Once you are finished click `Install`.

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

5. In case everything was configured correctly, you should see the new service added to the service list, initially in the *Disabled* state.

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

## Enabling Services

Enabling, updating, or reconfiguring a service can only be done from the [Service Details View](https://docs.cybus.io/1-7-2/documentation/services/service-details-view) by selecting the service in the list.

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

Continue here: [Enabling/Disabling Services](#enabling-services)

Your service now enters the *Enabling* state, in which all resources which were defined in the commissioning file are being created.

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

Once the *Enabling* has finished successfully, your service will reach the *Enabled* status and a confirmation message is displayed.

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

## Disabling Services

1. To disable a running service, select the service from the service list (1.) and click `Disable` (2.) on the toolbar.

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

2. This will open the `Disable Service` dialog. To disable the running service, confirm your selection by clicking *Disable*.

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

{% hint style="warning" %}
Disabling a service will destroy running containers, enabled connections, endpoints and mappings. Volumes however will remain in its current state and will reattach to the service once it is enabled again.
{% endhint %}

## Removing Services

{% hint style="warning" %}
To remove a running service, you must disable it first. Follow the instructions contained in the preceding section [Disabling Services](#disabling-services) section to do so.
{% endhint %}

1. To remove a disabled service, select the service from the service list (1.) and click `Delete` (2.) on the toolbar.

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

2. This will open the `Delete Service` dialog. To complete the service deletion, confirm your selection by clicking `Delete` in the bottom right corner of the dialog window.

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

{% hint style="danger" %}
Removing a service will not remove *volumes* defined by the service commissioning file. These volumes will remain in its current state and reattach to the service once it is installed and enabled again.
{% endhint %}

## Updating Services

Enabling, updating, or reconfiguring a service can only be done from the [Service Details View](https://docs.cybus.io/1-7-2/documentation/services/service-details-view) by selecting the service in the list.

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

Continue here: [Updating Services](#updating-services)
