# SF Edge Asset Management

## Edge prerequisites

**Version**: To allow over the air asset management, your edge instances require at least version 2.7.0.xxx. Manually update with the latest version, downloadable here:&#x20;

{% content-ref url="sf-edge-asset-management/edge-version-repository" %}
[edge-version-repository](https://manual.senseforce.io/manual/sf-edge-asset-management/edge-version-repository)
{% endcontent-ref %}

**Configuration**: In the same folder as "appsettings.xml" a file "otasettings.xml" is required. \
\&#xNAN;*Default folder*: C:\ProgramData\Senseforce\Luna Data\\\[ServiceName]\configs

An exemplary otasettings.xml is provided here:

{% file src="<https://1533098984-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lj6tqYfpNT_59dZ_Z3Z%2F-Lt1m32NZCikVyoBXCfz%2F-Lt1mzbIAoVAvFi7Pmmz%2Fotasettings.xml?alt=media&token=ec067aad-733c-45bf-99f7-fb6bb9781770>" %}
Exemplary otasettings.xml
{% endfile %}

{% hint style="info" %}
Make sure to correctly enter the following information in the file:

* username & password
* ServerUrl
* InstanceIdentifier

Contact Senseforce support to get the necessary credentials and identifiers.&#x20;
{% endhint %}

## Manage thousands of Edge instances

The SF Edge component enables you to participate in the IIoT journey. Manageing a vast amount of local instances used to be difficult and required close alignment with the customer. With the Senseforce Asset Management tools, each instance can be updated and reconfigured at any time.

To access the Asset Management Toolset your Senseforce user requires "Thing Write" access permissions. Make sure to provide the according to rights with the group management tool.&#x20;

Navigate to **Edge Device Management** to open the Asset Management Tools.

![Asset Management Toolset](https://1533098984-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lj6tqYfpNT_59dZ_Z3Z%2F-Lt1m32NZCikVyoBXCfz%2F-Lt1nBGiG8EP6xRuoXcV%2Fimage%20\(2\).png?alt=media\&token=c5755a91-fa37-4615-b73f-8f872f94fd92)

**a**. **Edge overview**: All connected Edge instances are displayed in the center of the screen

{% hint style="warning" %}
Currently, only online Edges are displayed. We are working on also providing information for offline Edge instances and possibilities to schedule updates for them.
{% endhint %}

**b. Action panel menu:** Click here to access the available actions for a **single** Edge

**c**. **Action panel**: The following options are available to execute remotely:&#x20;

* [ ] **Upload new Edge config**: Create a zip file of all the configuration files you want to send to the Edge. You are able to update all configs at once or individual configuration files.&#x20;

![Upload new edge config dialog](https://1533098984-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lj6tqYfpNT_59dZ_Z3Z%2F-Lt1m32NZCikVyoBXCfz%2F-Lt1nISkg8WIOWHthRCt%2Fimage%20\(3\).png?alt=media\&token=300d1729-f3ed-4fc4-aad4-5bb9cddc4409)

{% hint style="danger" %}
The Edge configuration folder structure must be prevailed. If you'd like to update the MqttSettings.xml, make sure to add the following folders into the zip-file configurations/OutputPlugins/Mqtt/MqttSettings.xml
{% endhint %}

* [ ] **Restart Edge**: Restarts the Edge as well as all plugins
* [ ] **Read the configuration and log files**: This option allows to perceive all configuration and log files from an Edge instance. Chose whether to read configurations only or also the log files.\
  All collected configurations and log files are available by pressing the button (**e**). Reading configurations and logs may take up to 5 minutes.&#x20;

![Read configs and logs dialog](https://1533098984-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lj6tqYfpNT_59dZ_Z3Z%2F-Lt1m32NZCikVyoBXCfz%2F-Lt1nP98GClWmYNuXE7t%2Fimage%20\(4\).png?alt=media\&token=70f53b92-6d39-4f7b-bd88-a165a2900e8a)

{% hint style="danger" %}
A maximum amount of 10MB of files can be transferred. If larger log files are available, the operation fails. Untick "Retrieve log files" to only read configuration files.
{% endhint %}

* [ ] **Upload new Edge version**: Keeping edge software update is critical for system security. Enter the URL where to download the Edge binaries into the update dialog. The URLs are provided by Senseforce as a new Edge version is released.\
  See our Edge version repository for our latest URLs.

  Chose **Overwrite Configuration** = Yes to overwrite the local Edge configuration folders with the once in the update binaries. The recommended option is to keep "No".&#x20;

![Upload new edge version dialog](https://1533098984-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Lj6tqYfpNT_59dZ_Z3Z%2F-Lt1oeutn_VGva9qEIuc%2F-Lt1oqFlvlbL4Ssqxl42%2Fimage%20\(6\).png?alt=media\&token=28f09848-fc00-4402-98a9-919bc79cb4ed)

**d. Bulk actions**: All the described Action Panel options are also available for multiple Edges at once. Select one or several instances and perform the corresponding action.

{% hint style="info" %}
For bulk actions always use the icon menu (d) but not (b).
{% endhint %}

**f. Edge search**: Search for one or several specific instances


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://manual.senseforce.io/manual/sf-edge-asset-management.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
