Issue: Host id mismatch detected (ctrlX CORE X3, X5, X7)

[mlaml]

Current situation

All devices which have been manufactured and shipped with release 1.20.7 or higher, are equipped with a device certificate which represents the "ctrlX Device ID". For Bosch Rexroth devices (e.g. ctrlX CORE X3), the serial number (S/N) is still used for licensing; however, for partner devices the "ctrlX Device ID" will be used. To make this possible, starting with release 1.20.7 or higher a fallback mechanism was introduced that allows Bosch Rexroth devices to further rely on the S/N for licensing and in parallel to use the "ctrlX Device ID" on other devices. Error "Bad request (400) - Host ID error - response does not match system hostid - 080E0200 - 0C7A0202" will be shown.

Problem

When downgrading a device that was shipped with Release 1.20.7 or higher to a previous version that does contain Device Admin XCR-V-0120.6 or lower (e.g. by using a Setup file) the licenses that were issued for the device's serial number are not recognized anymore. Instead the device will expect the license to be issued for the "ctrlX Device ID" and previously working license files issued for the device's S/N will not be accepted anymore, leading to the error "Host id mismatch detected. Please compare the host id inside the capability response file with the target host id."

⚠️Please note that licensing dongles are not affected by this issue!

Solution Alternatives

Solution 1 - Update Device Admin

The easiest method is to simply update the Device Admin to version XCR-V-0120.7 or higher.

1. Update to Device Admin XCR-V-0120.7 (available in the Collaboration Room) or higher
2. Re-apply the license file of the device
3. (optional) Create a new setup file based on the new device state (for future use)

Solution 2- Adapt Setup

As an alternative to creating a new backup, you may manually update an existing Setup.

1. Download the latest Device Admin XCR-V-0120.7 (or higher) from the collaboration room (Device Admin XCR-V-0120.7.app)
2. Unpack the setup file and make following changes
   1. Copy the Device Admin archive you just downloaded to the folder 'packageManagement'
   2. Open the ctrlx-setup.json file and replace the information within the Device Admin (rexroth-deviceadmin) application section
      1. Adapt the path under the rexroth-deviceadmin app entry to your previously copied binary name, e.g. "$path": "packageManagement/installedApps/Device Admin XCR-V-0120.7.app"
      2. Change the version under the rexroth-deviceadmin app entry to the version of your previously updated application, e.g. "version": "1.20.7"
3. Add all files of the previously unzipped setup file to a new archive, e.g. "new_setup.zip" which can then be applied to your device causing the Device Admin application to be upgraded to the mentioned version
4. Re-apply the license file that was issued for the device (if not already included as part of the setup process)

The following screenshot shows an example.

[CodeShepherd · Accepted solution]

Solution Alternatives

Solution 1 - Update Device Admin

The easiest method is to simply update the Device Admin to version XCR-V-0120.7 or higher.

1. Update to Device Admin XCR-V-0120.7 (available in the Collaboration Room) or higher
2. Re-apply the license file of the device
3. (optional) Create a new setup file based on the new device state (for future use)

Solution 2- Adapt Setup

As an alternative to creating a new backup, you may manually update an existing Setup.

1. Download the latest Device Admin XCR-V-0120.7 (or higher) from the collaboration room (Device Admin XCR-V-0120.7.app)
2. Unpack the setup file and make following changes
   1. Copy the Device Admin archive you just downloaded to the folder 'packageManagement'
   2. Open the ctrlx-setup.json file and replace the information within the Device Admin (rexroth-deviceadmin) application section
      1. Adapt the path under the rexroth-deviceadmin app entry to your previously copied binary name, e.g. "$path": "packageManagement/installedApps/Device Admin XCR-V-0120.7.app"
      2. Change the version under the rexroth-deviceadmin app entry to the version of your previously updated application, e.g. "version": "1.20.7"
3. Add all files of the previously unzipped setup file to a new archive, e.g. "new_setup.zip" which can then be applied to your device causing the Device Admin application to be upgraded to the mentioned version
4. Re-apply the license file that was issued for the device (if not already included as part of the setup process)

The following screenshot shows an example:

hostid_mismatch