Determine Image Version and Hardware Key

How to check your image version and hardware key.

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.

  1. Check Image Version:

    cat /etc/issue
    

    Information similar to the following will be shown:

    Motorcortex 2022.09-0-g7adb1a0 \n \l
    
  2. 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.
    
  3. 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.

  1. Check Image Version:

    cat /etc/issue
    

    Information similar to the following will be shown:

    Motorcortex 2022.03-0-g595ed27 \n \l
    
  2. 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.
    
    
  3. 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.