Documentation

  • N/A
  • 1.0
  • 05/12/2020
  • Public Content

Introduction to the Edge Software Command Line Interface (CLI)

edgesoftware
is a command line interface (CLI) that helps you manage packages on the
Intel Edge Software Hub
.
This guide describes the CLI commands and their usage. In this guide you will:
  • Try out commands and get familiar with the CLI and the package you installed.
  • Learn to update modules.
  • Learn to install custom components.
  • Learn to export the package you installed, including custom modules, so you can install it on other edge nodes.

Get Started with the
edgesoftware
CLI

Use the information in this section to try out the
edgesoftware
CLI commands.
To begin:
  1. Open a terminal window.
  2. Go to the
    edge_insights_retail/
    directory.
  3. Try out the following commands.
Get Help or List the Available Commands
  • Command:
    ./
    edgesoftware
    --help
  • Response:
    Usage: edgesoftware [OPTIONS] COMMAND [ARGS]... A CLI wrapper for management of Intel® Edge Software Hub packages Options: -v, --version Show the version number and exit. ––help Show this message and exit. Commands: export Exports the modules of a package. install Install modules of a package. list List the modules of a package. log Show log of CLI events. update Update the modules of a package.
View the Software Version
  • Command:
    ./
    edgesoftware
    --version
  • Response: The
    edgesoftware
    version.
List the Package Modules
  • Command:
    ./
    edgesoftware
    list
  • Response: The modules installed and status.
List Modules Available for Download
  • Command:
    ./
    edgesoftware
    list --default
  • Response: All modules available for download for that package version, modules ID and version.
Display the CLI Event Log
  • Command:
    ./
    edgesoftware
    log
  • Response: CLI event log information, such as:
    • target system
      information (hardware and software)
    • system health
    • installation status
    • modules you can install
See the Installation Event Log for a Module
  • Command:
    ./
    edgesoftware
    log <MODULE_NAME>
    You can specify multiple
    <MODULE_NAME>
    arguments by listing them with a space between each.
    To find the module names, use
    ./
    edgesoftware
    list
  • Response: The installation log for the module.

Install Package Modules

This
edgesoftware
command installs package modules on the
target system
. To do so, the command looks at
edgesoftware_configuration.xml
that was downloaded from the
Intel Edge Software Hub
when you installed the
Edge Insights for Retail
software. This file contains information about the modules to install.
During the installation, you will be prompted to enter your product key. The product key is in the email message you received from Intel confirming your
Edge Insights for Retail
download.
Do not manually edit
edgesoftware_configuration.xml
.
  1. Open a terminal window.
  2. Go to the
    edge_insights_retail/
    directory.
  3. Run the install command:
    ./
    edgesoftware
    install

Update the Package Modules

On a fresh Linux installation, you might need to use the
install
command at least once before performing an update.
install
makes sure all dependencies and packages are installed on the
target system
.
./
edgesoftware
install
When you are ready to perform the update, use:
./
edgesoftware
update <MODULE_ID>
During the installation, you will be prompted to enter your product key. The product key is in the email message you received from Intel confirming your
Edge Insights for Retail
download.
To find the module ID, use
./
edgesoftware
list --default

Export the Package for Installation

The
edgesoftware
CLI lets you package the installed modules, customer applications, and dependencies as part of a package. The export is provided in a
.zip
file that includes installation scripts, XML files, and an
edgesoftware
Python* executable.
Command:
./
edgesoftware
export

Summary and Next Steps

By following this guide, you tried a few commands to familiarize yourself with the features of the
edgesoftware
CLI.
Go to Video Analytics Serving to run your first inference application using
Edge Insights for Retail
.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.