Determine Image Version and Hardware Key

How to check your 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 and Library 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 and Library 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.