Manage software configurations

Deploy software configurations or secrets on the Core device

If you have a Kubernetes dashboard installed, you can deploy configurations or secrets for software running on IIoT Core.

Before you begin

Have a YAML configuration file ready for updating the installation.

Procedure

Go to the Kubernetes dashboard.
Locate the new YAML configuration file or secret and either paste or upload the contents.
Upload the new configuration file or secret.

If you have a Kubernetes dashboard installed, you can update configurations or secrets for software running on IIoT Core.

Procedure

You can use IIoT Core Services to deploy software configurations for container software on single or multiple gateway devices.

Before you begin

The configuration and secret information should be complete and available as separate YAML files for uploading into IIoT Core Services.

Procedure

In the IIoT Core Services UI, select the Device tab.
Select one or more gateway devices using the check boxes.
You can only select devices that are online and in Ready state.
Select Deploy Deploy Configuration.
Upload YAML files to the Upload Files box.
Click Deploy to deploy the configuration.
Confirm that the YAML file is deployed successfully on the Devices tab:
1. Select one of the devices to which the configuration has been deployed.
2. Select the Configurations tab.
3. From the Category list, select the configuration type.

Before you begin

The configuration and secret information should be complete and available as separate YAML files for uploading into IIoT Core Services.

Procedure

In the IIoT Core Services UI, select the Device tab, then the Device Group tab.
Select a device group.
The Details tab opens.
Select Deploy Deploy Configuration.
In the Upload Files section, select a configuration YAML file in the edit window.
Click Deploy to deploy the configuration.
To confirm that the configuration YAML is successfully deployed, go to the Deployment tab for that device group. You can also check the status of the container if the restart option was selected.

You can update software configurations for container software on a gateway device.

Procedure

In the IIoT Core Services UI, select the Device tab.
Select a device name.
Select the Configurations tab.
From the list of configuration types, select the configuration category to edit.
From the Actions menu ( ) next to the configuration file that you want to update, select View/Edit.
Edit the YAML information in the text box.
Select Deploy.
Access the Device Details page to confirm that the updated YAML file is deployed successfully. You can also check the status of the container if the restart option was selected.

You can delete configurations for container software running on a gateway device.

Procedure

In the IIoT Core Services UI, select the Device tab.
Select a device name.
Select the Configurations tab.
From the list of configuration types, select the configuration category.
From the Actions menu ( ) next to the configuration file that you want to delete, select Delete.
Click Confirm.
Refresh the page to confirm that the YAML file is successfully deleted.

You can deploy protocol adapter configurations on single or multiple gateway devices.

Procedure

In the IIoT Core Services UI, select the Device tab.
Select one or more gateway devices using the check boxes.
Only devices that are online and in Ready state can be selected.
Select Deploy Deploy Protocol Adapter to view the Adapter Configuration page.
In the Adapter Type list, select an adapter type.
Paste your adapter configuration YAML into the Insert Adapter Configuration File text box.
See example below.
Click Deploy.

Results

The adapter configuration container restarts.

Modbus adapter configuration example:

You can update a protocol adapter configuration for a gateway device.

Procedure

In the IIoT Core Services UI, select the Device tab.
Select a device name.
Select the Configurations tab.
From the list of configuration types, select Protocol Adapters.
From the Actions menu ( ) next to the configuration file that you want to update, select View/Edit.
Edit the YAML information in the text box.
Click Deploy.
Access the Device Details page to confirm that the updated YAML file is deployed successfully. You can also check the status of the container if the restart option was selected.

You can delete a protocol adapter configuration on a gateway device.

Procedure

In the IIoT Core Services UI, select the Device tab.
Select a device name.
Select the Configurations tab.
From the list of configuration types, select Protocol Adapters.
From the Actions menu ( ) next to the configuration file that you want to delete, select Delete.
Click Confirm.
Refresh the page to confirm that the YAML file is successfully deleted.