Add Edge Software Packages
The
Intel® Edge Software Configurator
tool enables the configuration of Edge Software Packages available in the Edge Software Hub. The tool provides a graphic user interface for package management, and it works seamlessly with the edgesoftware CLI, mirroring its features.
With Edge Software Configurator, you are able to:
- Add and configure the packages downloaded from the Edge Software Hub. For the current list of packages supported by ESC, see Table 1.
- View which Edge Software Packages are installed in the host machine.
- View modules downloaded and installed with the Edge Software Package, verify their installation status and log files, and uninstall modules.
- View compatible modules available for download and installation, and install modules.
Software Package Name | URL |
Edge Insights for Vision
| |
RI Name | URL |
Textile Defect Classifier
| |
Intelligent Traffic Management
| |
Social Distancing Detection for Retail Settings
| |
Real Time Sensor Fusion for Loss Prevention
| |
Social Distancing for Retail Settings
| |
Industrial Text Line Recognition
| |
Industrial Surface Defect Detection
|
Add Edge Software Packages
This section will walk you through adding a software package. The instructions are applicable to any configuration, with the only difference being the information displayed on screen for modules listed as
Modules Installed
and
Modules Available for Install
.
Step 1: Go to Configure > Edge Software Packages and Modules
Select
Configure
in the top menu and select
Edge Software Packages and Modules
.
The Edge Software Packages and Modules screen displays the screen below.
By default, there will be no packages and modules added under
Packages & Modules
on the Home page. We can add them by following the steps below.

Step 2: Install the Packages for the first time
- Click onAdd Package.
- Click onBrowse Filesfor the required Edge Software Package downloaded from Edge Software Hub. This example uses the Edge Insights for Vision package.Make sure that the version of the Edge Software Package downloaded from the Edge Software Hub matches the version of the OS on the host device.Do not refresh the page and do not navigate to other screens while the package is being uploaded.
- You can stop the package addition during the process by clicking on theStopbutton.You will be prompted to confirm the action. To proceed, clickStop.
- Once the package is uploaded successfully, it will fetch the corresponding Edge Software package name and modules.
- In this example, the Vision package is loaded successfully. Now you can install the package providing the product key.
- Enter the Product Key for the Edge Software Package and click onInstall Package. The Product Key is contained in the email you received from Intel confirming your download and it's used to verify the license.
- After the product key is validated, a pop-up will display on the screen showing installation of the package in progress.
- Click on theClosebutton to continue the installation in the background. This example uses the Edge Insights for Vision package downloaded from Edge Software Hub.You are only prompted to enter the product key the first time that you install the package.
- Once the package is installed successfully, you can proceed to configure the installed software package by selecting theConfigureoption under theActionscolumn.
- Click on theConfigureoption underActionscolumn of software package underCurrently installed packageblock.
- You will see a list of modules installed on the left, with installation status and available actions, such asUninstallandView Logs. Modules that are available for install are listed in the column on the right.

Step 3: Install an Additional Package
- To add a different package when a software package is already added and installed, navigate toEdge Software Packages and Modulesfrom theConfigurebutton in the top menu. Click onAdd packagein the top right corner.
- You will be prompted to confirm the action. To add a package, click onProceed.
- Now you can continue to add the software package by following the steps described in Step 2: Install the Packages for the first time.Once the second package installation is successful, you will find the first package under thePreviously imported packagesblock.
Step 4: Install a Previously Imported Software Package
- You can install a previously uploaded package by selecting theInstalloption of the respective software package under theActionscolumn as shown.
- You will be prompted to confirm the action. To continue the installation, click onProceed.
- You will see the selected package under thePackage being installedblock.
- You will see the screen below once the package installation is successful.
- You can view the module details of any software package by clicking on the respective package name.
- Now you can proceed to configure the installed software package by selecting theConfigureoption under theActionscolumn as shown.
Install and Uninstall Modules from Edge Software Packages
This section will walk you through installing and uninstalling one module. The instructions are applicable to any configuration, with the only difference being the information displayed on screen for modules listed as
Modules Installed
and
Modules Available for Install
.
Follow the instructions below to install/uninstall Amazon Web Services Greengrass* Prerequisites as an example.
Install
and
Uninstall
actions take care of all dependencies. For some modules, because of dependencies,
Uninstall
is not available.
Step 1: Go to Configure > Edge Software Packages and Modules
- SelectConfigurein the top menu and selectEdge Software Packages and Modules.
If no software packages are installed, then follow the steps in
Add Edge Software Packages to browse and add the edge software package.
Step 2: Install a Module
- Click on theConfigureoption under theActionscolumn of software package under theCurrently installed packageblock, then you will see a list of modules installed on the left, with installation status and available actions, such asUninstallandView Logs. Modules that are available for install are listed in the column on the right.For example, findAmazon Web Services Greengrass Prerequisitesin theModules Available for Installlist. Select the checkbox for Amazon Web Services Greengrass Prerequisites and selectInstall Modulesat the top of the Modules Available.
- SelectInstall.In theModules Available for Installlist, you will see the module selected and the installation progress.
Once the installation is completed successfully, you will see the module under the
Modules Installed
list. If the module fails, then the module remains on the right with status as
Failed
. In this case, you must follow the same steps to install that module again.

You can view the logs of installed modules or installation failed modules by selecting the
View logs
option.

Here you have options such as
Copy Log
to copy it,
Copy Selected line
to copy the selected lines from the log, and
Unselect
.

Click on
Close
to exit
View logs
.
Step 3: Uninstall a Module
Any Edge Software Package module that was successfully installed, and is not dependent on other installed modules, can be uninstalled using Edge Software Configurator.
This guide uses the Amazon Web Services Greengrass Prerequisites module as an example.
- FindAmazon Web Services Greengrass Prerequisitesin theModules Installedlist.
- SelectUninstall.
- You will be prompted to confirm the action. To proceed, selectUninstall.
When the process is complete, the module will be displayed in the
Modules Available for Install
list and can be installed again whenever needed.
Troubleshooting
The Edge Software Configurator package was previously named
edge_software_manager
. Some screenshots, commands, and file paths in this guide still use
esm
or
edge_software_manager
at this time.
No modules displayed in the Edge Software Package details card.
If the host machine where the Edge Software Package was installed is behind a proxy, and the modules for the Edge Software Packages are not listed, verify the proxy details in the
/opt/esm/proxy.conf
file.