Troubleshooting and Support
The following areas might require troubleshooting, depending on what you are trying to do:
If you are having problems installing Edge Xpert, please check your environment. Refer to the Edge Xpert Pre-requisites section of the Edge Xpert Installation and Licensing Guide.
If you are having issues relating to your license, refer to the Licensing section of the Edge Xpert Installation and Licensing Guide.
Starting Edge Xpert Fails, 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 your docker installation is working correctly. You can do this by running:
docker run hello-world
You may need to reinstall docker to resolve this issue.
Starting Edge Xpert Fails, 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 information on how to do this.
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
chmod 644 <license_file>
is the name of the license file.
Edge Xpert Manager
If you have updated the Edge Xpert Manager but are not seeing changes, take the following steps:
- Clear the browser cache
- Refresh the browser
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.
If you are having issues with the Application Services check the configuration.toml file.
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
Collect Logs By CLI Command
You can collect Edge Xpert logs with the CLI either by viewing the container logs individually, or saving the logs to an output directory.
View Logs in Terminal
You can view the logs of an individual container by issuing the following command:
docker logs <container>
docker logs core-data
Use the tag
-f to follow logs while using a particular service:
docker logs -f core-data
Save Logs to an Output Directory
To send logs to an output directory, use the following command:
edgexpert logs -o <directory-name>
edgexpert logs -o edgexpert-logs
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. Learn more about Contact Support.
If you get "Permission denied" when running the command above, run the command
sudo chmod a+x /usr/share/edgexpert/tools/troubleshooting.sh to fix the error.