Installation
Download Edge Xpert
Edge Xpert Customers
Users with an active Edge Xpert support contract can download the Edge Xpert installation packages from the Support Portal on the IOTech website. After logging in, navigate to Downloads where you can select the version and type of package required.
Edge Xpert Evaluators
Users wishing to evaluate Edge Xpert can download the Edge Xpert installation packages from the IOTech website here. This page provides only the most recent version of Edge Xpert and is intended for evaluation purposes only.
Info
You must also have a valid license file that defines which microservices can be run. See Edge Xpert Licensing for more details
Install Edge Xpert
- To install the Edge Xpert Debian package as root, enter:
sudo dpkg -i edgexpert-<version_number>_amd64.deb
- To install the Edge Xpert RPM package as root, enter:
sudo rpm -ivh edgexpert-<version_number>.x86_64.rpm
Info
Before installing the Edge Xpert packages, ensure that Docker/ Podman is running. If Docker/ Podman is not running, Edge Xpert command will fail with an error message similar to the following:
Cannot connect to the Docker daemon at unix:///var/run/docker.sock. Is the docker daemon running?
dpkg: error processing package edgexpert (--configure): installed edgexpert package post-installation script subprocess returned error exit status 1
Verify Installation
You can verify that the installation was successful by entering the following command:
edgexpert -v
License Installation
After verifying the installation, you can proceed to install the license to gain access to Edge Xpert. See Edge Xpert Licensing for more details.
edgexpert license install <your Edge Xpert license>
Self-contained package Installation
IOTech also provides self-contained package according to user needs. If there is no Internet access, user can deploy self-contained package with all the images.
- Download and install Edge Xpert Self-contained Debian package
sudo dpkg -i <edgexpert-self-contained-package.deb> - Change the permission of /opt/edgexpert/edgexpert_images.tar
sudo chmod +rx /opt/edgexpert/edgexpert_images.tar - Load the image from the self-contained RPM package
docker load -i /opt/edgexpert/edgexpert_images.tar
podman load -i /opt/edgexpert/edgexpert_images.tar
- Check if all the images from Edge Xpert self-contained package are loaded
$ docker images
localhost/iotechsys/dev-edgexpert-device-opc-ua 2.3.dev 1fb704565a95 3 days ago 81.6 MB
localhost/iotechsys/dev-edgexpert-device-modbus 2.3.dev 05ef077bd14f 3 days ago 81.6 MB
localhost/iotechsys/dev-edgexpert-app-configurable 2.3.dev 3fc8ee1f9644 4 days ago 105 MB
localhost/iotechsys/dev-edgexpert-iotech-manager 2.3.dev 6efa1a2a2a1f 4 days ago 45 MB
localhost/iotechsys/dev-edgexpert-security-proxy-auth 2.3.dev 691ec9c1e41b 5 days ago 41.2 MB
localhost/iotechsys/dev-edgexpert-security-secretstore-setup 2.3.dev 82585677c936 5 days ago 38.3 MB
localhost/iotechsys/dev-edgexpert-security-bootstrapper 2.3.dev bc4ed4c8aadb 5 days ago 25.3 MB
localhost/iotechsys/dev-edgexpert-sys-mgmt-agent 2.3.dev 1f8a851884d2 5 days ago 129 MB
...
$ podman images
localhost/iotechsys/dev-edgexpert-device-opc-ua 2.3.dev 1fb704565a95 3 days ago 81.6 MB
localhost/iotechsys/dev-edgexpert-device-modbus 2.3.dev 05ef077bd14f 3 days ago 81.6 MB
localhost/iotechsys/dev-edgexpert-app-configurable 2.3.dev 3fc8ee1f9644 4 days ago 105 MB
localhost/iotechsys/dev-edgexpert-iotech-manager 2.3.dev 6efa1a2a2a1f 4 days ago 45 MB
localhost/iotechsys/dev-edgexpert-security-proxy-auth 2.3.dev 691ec9c1e41b 5 days ago 41.2 MB
localhost/iotechsys/dev-edgexpert-security-secretstore-setup 2.3.dev 82585677c936 5 days ago 38.3 MB
localhost/iotechsys/dev-edgexpert-security-bootstrapper 2.3.dev bc4ed4c8aadb 5 days ago 25.3 MB
localhost/iotechsys/dev-edgexpert-sys-mgmt-agent 2.3.dev 1f8a851884d2 5 days ago 129 MB
...
- Download and install Edge Xpert Self-contained RPM package
sudo rpm -ivh <edgexpert-self-contained-packag.rpm> - Change the permission of /opt/edgexpert/edgexpert_images.tar
sudo chmod +rx /opt/edgexpert/edgexpert_images.tar - Load the image from the self-contained RPM package
docker load -i /opt/edgexpert/edgexpert_images.tar
podman load -i /opt/edgexpert/edgexpert_images.tar
- Check if all the images from Edge Xpert self-contained package are loaded
$ docker images
localhost/iotechsys/dev-edgexpert-device-opc-ua 2.3.dev 1fb704565a95 3 days ago 81.6 MB
localhost/iotechsys/dev-edgexpert-device-modbus 2.3.dev 05ef077bd14f 3 days ago 81.6 MB
localhost/iotechsys/dev-edgexpert-app-configurable 2.3.dev 3fc8ee1f9644 4 days ago 105 MB
localhost/iotechsys/dev-edgexpert-iotech-manager 2.3.dev 6efa1a2a2a1f 4 days ago 45 MB
localhost/iotechsys/dev-edgexpert-security-proxy-auth 2.3.dev 691ec9c1e41b 5 days ago 41.2 MB
localhost/iotechsys/dev-edgexpert-security-secretstore-setup 2.3.dev 82585677c936 5 days ago 38.3 MB
localhost/iotechsys/dev-edgexpert-security-bootstrapper 2.3.dev bc4ed4c8aadb 5 days ago 25.3 MB
localhost/iotechsys/dev-edgexpert-sys-mgmt-agent 2.3.dev 1f8a851884d2 5 days ago 129 MB
...
$ podman images
localhost/iotechsys/dev-edgexpert-device-opc-ua 2.3.dev 1fb704565a95 3 days ago 81.6 MB
localhost/iotechsys/dev-edgexpert-device-modbus 2.3.dev 05ef077bd14f 3 days ago 81.6 MB
localhost/iotechsys/dev-edgexpert-app-configurable 2.3.dev 3fc8ee1f9644 4 days ago 105 MB
localhost/iotechsys/dev-edgexpert-iotech-manager 2.3.dev 6efa1a2a2a1f 4 days ago 45 MB
localhost/iotechsys/dev-edgexpert-security-proxy-auth 2.3.dev 691ec9c1e41b 5 days ago 41.2 MB
localhost/iotechsys/dev-edgexpert-security-secretstore-setup 2.3.dev 82585677c936 5 days ago 38.3 MB
localhost/iotechsys/dev-edgexpert-security-bootstrapper 2.3.dev bc4ed4c8aadb 5 days ago 25.3 MB
localhost/iotechsys/dev-edgexpert-sys-mgmt-agent 2.3.dev 1f8a851884d2 5 days ago 129 MB
...
Uninstall Edge Xpert
Edge Xpert can be uninstalled using the following commands:
sudo apt remove edgexpert
sudo rpm -evh edgexpert