Determine Image Version and Hardware Key
4 minute read
Motorcortex consists out of an application and libraries that each have a version associated with them. Sometimes it is necessary to determine the version of these components in a running system to check if updates are available or if dependencies are met.
Each host system generates its own unique hardware key. The hardware key is required when validating licenses.
Following steps are performed in the terminal after logged in to the controller.
-
Check
Image
Version:cat /etc/issue
Information similar to the following will be shown:
Motorcortex 2022.09-0-g7adb1a0 \n \l
-
Check
Hardware Key
,Application
andLibrary
versions via log:mcx-lastlog
Scroll up until you find information similar to the following:
Motorcortex-core version: 2.8.3-0-gb17d29f9_release Robot-app version: 1.5.2-0-ge6e70edc_release Motorcortex-math version: 2.1.0-2-g7828ea9_release Motorcortex-control version: 2.2.0-0-g16974cd_release Motorcortex-motion version: 2.5.3-0-g2cc2fc9_release Hardware key: 17680423976042648958 List of components: mcx-core2 mcx-io2 mcx-math2 mcx-motion2 mcx-control2 mcx-robot-app1 License is valid.
-
Or check
Hardware Key
via license check:mcx-license-check
Information similar to the following will be shown:
The license does match the hardware. The license does contain the required components. License information: File: /etc/motorcortex/config/17680423976042648958.lic Hardware key: 1768 0423 9760 4264 8958 Components: mcx-control2, mcx-core2, mcx-io2, mcx-math2, mcx-motion2, mcx-robot-app1 Application information: File: /usr/local/bin/motorcortex-robot Hardware key: 1768 0423 9760 4264 8958 Components: mcx-core2, mcx-io2, mcx-math2, mcx-motion2, mcx-control2, mcx-robot-app1
Following steps are performed in the terminal after logged in to the controller.
-
Check
Image
Version:cat /etc/issue
Information similar to the following will be shown:
Motorcortex 2022.03-0-g595ed27 \n \l
-
Check
Hardware Key
,Application
andLibrary
versions via log:sudo restart motorcortex
Scroll up until you find information similar to the following:
Motorcortex-core version: 2.8.3-0-gb17d29f9_release Robot-app version: 1.5.2-0-ge6e70edc_release Motorcortex-math version: 2.1.0-2-g7828ea9_release Motorcortex-control version: 2.2.0-0-g16974cd_release Motorcortex-motion version: 2.5.3-0-g2cc2fc9_release Hardware key: 13763540678576076058 List of components: mcx-core2 mcx-io2 mcx-math2 mcx-motion2 mcx-control2 mcx-robot-app1 License is not valid (error type: 128 info: 2), failed to verify. Hardware key does not match.
-
Or check
Hardware Key
via license check:mcx-keycheck
Information similar to the following will be shown:
The license does NOT match the application License information: File: /etc/motorcortex/config/17680423976042648958.lic Hardware key: 1768 0423 9760 4264 8958 Components: mcx-control2, mcx-core2, mcx-io2, mcx-math2, mcx-motion2, mcx-robot-app1 Application information: File: /usr/local/bin/motorcortex-robot Hardware key: 1376 3540 6785 7607 6058 Components: mcx-core2, mcx-io2, mcx-math2, mcx-motion2, mcx-control2, mcx-robot-app1
To get the Operating System version information and hardware id type this command in a terminal when logged-in to the control system:
cat /etc/issue
Information similar to the following will be shown.
Motorcortex 2021.01[g17f4d5d+1] \n \l
The active license does NOT match the active application
Active license information:
File: /etc/motorcortex/config/license.pem
Hardware key: 2651256591846471365
Modules: mcx-core2, mcx-io2, mcx-math2, mcx-control2, mcx-generic-app2
Active application information:
File: /usr/local/bin/mcx-generic-app
Hardware key: 6591555251580943153 mcx-core2 mcx-io2 mcx-math2 mcx-control2 mcx-generic-app2
Hardware key as QR Code:
##################################################################################
##################################################################################
##################################################################################
##################################################################################
######## ## ######## ###### ######## ########
######## ########## ## #### ## ############ ## ########## ########
######## ## ## ## #### ## ## ## ## ## ## ########
######## ## ## ## ## ## ########## ## ## ## ## ########
######## ## ## #### ## ## ## #### #### ## ## ## ########
######## ########## ## #### ###### #### #### ########## ########
######## ## ## ## ## ## ## ## ## ## ## ########
############################ ## #### ######## ########################
######## #### ###### ## ## ## #### #### ## ########
######## #### ################ #### ######## ## ##########
######## ## ## ## ###### #### ## #### ## ## ############
######## ######## ## #### #### ## #### #### ##########
############ ###### ######## ## ###### ######## ## ## ############
############ ## ## ## ## ######## ## ###### ########
######## ## ## ## ## #### ## ###### ################
######## ## ###### ## ## ## #### ## #### ## ## ## ## ########
######## ## ###### ########## ## ## #### ## ## ###### ################
######## ## #### #### ## ## ## #### ## ##########
######## ## ############## ## ## ## ## ## ## ##########
############## ## ## ## ## ## ###### ######## ## ########
########## #### ## ## ## #### ## ########## ########
######## #### ## ######## ## ## ## ## ## ## ##############
############ #### ## #### ## #### #### ##############
############ ###### ## ## #### ######## ###### ## ##########
######## #### ## #### ## ## ## #### ##########
######################## ## #### ######## #### ###### ## ##########
######## #### ############ ## ## #### ## ## ## ########
######## ########## ## ###### ############## ###### ## ############
######## ## ## ## ## #### #### #### ###### ########
######## ## ## #### #### ## ## #### #### #### ########
######## ## ## ###### ########## ## ## ###### ## ##############
######## ########## ## ## ## ## ############ #### ## ##########
######## ## ## ######## #### #### ###### ########
##################################################################################
##################################################################################
##################################################################################
##################################################################################
The first line shows the OS version, in this example Motorcortex 2021.01[g17f4d5d+1] \n \l
.
Under Active license information
you can find the hardware id and where the license file is located.