Troubleshooting and Support

Depending on your requirements, the following areas may involve troubleshooting.

Installation

If you are having problems installing Edge Xpert, please check your environment.

Refer to the Edge Xpert Prerequisites section on Edge Xpert Installation and Licensing Guide.

Licensing

If you are having issues relating to your license, refer to the Licensing section of the Edge Xpert Installation and Licensing Guide.

See below for some common problems you might encounter:

Fail to Start Edge Xpert, No License Installed Message

The license is installed but Edge Xpert will not start. The message "No License Installed" is seen.

If you run the command:

edgexpert license check

You get a message about no such file or directory as follows:

$ edgexpert license check
open /tmp/edgexpert-license734294413/lic: no such file or directory

Check if your docker installation is working properly by running:

docker run hello-world

You may need to reinstall docker to resolve this issue.

Fail to Start Edge Xpert, License Validation Successful

If you get a successful validation message but are still having issues check the Core Data log files. See Edge Xpert Logging for more information.

You may see a message that looks like this:

Edge Xpert Licensing: Validating License File EdgeXpert_Alison_Evaluation.lic
open /edgexpert/licenses/EdgeXpert_Alison_Evaluation.lic: permission denied

This is usually caused because the license file has the wrong permissions. In the directory where the license file is installed run the command chmod on the license where is the name of the license file.

chmod 644 <license_file>

Edge Xpert Manager

If you have updated the Edge Xpert Manager but are not seeing any changes, take the following steps:

1. Clear the browser cache
2. Refresh the browser

Device Services

If you are having issues with a Device Service, check the device profile files for your Device Service. If using ModbusPal, check the configuration, and if loading an XMPP file, the version of ModbusPal that you are using.

Application Services

If you are having issues with the Application Services check the configuration.toml file.

Additional Services

If you are having issues with the additional services, check that the service has been set-up as shown in the examples.

If you are still encountering issues with Edge Xpert, Contact Support.

Get Support

Edge Xpert provides a troubleshooting script to collect and archive the related information and Edge Xpert service logs. Run the following command, and send the tar.gz file to IOTech Systems to get help.

sh  /usr/share/edgexpert/tools/troubleshooting.sh

For more information, see Contact Support.