Can't run CarMaker.xeno application on Xpack4 because of missing libnative.so shared object
Question
Attempting to start the CarMaker.xeno application on the Xpack4 failed with returned message error:
error while loading shared libraries:
libnative.so.3: cannot open shared object file: No such file or directory
Solution
Problem description
The CarMaker application that runs on the Xpack4 is a program and the Xpack4 like every common computer includes an operating system (OS). In case of the Xpack4, the OS is Linux based and designed for real-time programs. The real-time related task is managed by a real-time framework called xenomai. So this xenomai framework is not part of this CarMaker application itself but rather consists in shared objects (dynamic libraries) that must be provided on the Xpack4 in order that the CarMaker application can access them when necessary. This set up task is done by the IPG program called Realtime System Setup. Every CarMaker installation is fitted with a Realtime System Setup with the same program version as the CarMaker version.
The compliance of the Xpack4 environment with the CarMaker application (that must be running on the Xpack4) can only be verified during start of this program (and in case of failure this returns this system error message).
For this reason this is the task of the user to care that his Xpack4 provides a convenient environment for his CarMaker application.
Update detail
Particularly important changes of the Xpack4 environment happened with the major release 9 which consisted in:
- an update of the xenomai framework from its major release version 2 to 3.
- Moreover the Linux operating system (OS) running on the Xpack4 evolved as a 64 bits OS whereas it was a 32 bits OS in previous versions.
All these changes induced a lot of internal changes that caused the Xpack4 environment of CarMaker 9 to be incompatible with previous versions of the CarMaker application.
Problem solution
The problem may seem to be complicated but its solution is in fact very simple.
- If a CarMaker application older than CarMaker 9 (for example with CarMaker 6) must run on the Xpack4, it is necessary and sufficient to run and apply the Realtime System Setup of this CarMaker version before using it.
- If later you want to simulates again with CarMaker 9, you similarly must run the Realtime System Setup of this version again before to use the corresponding CarMaker 9 application.
This way you ensure that the Xpack4 provide the adequat environment for your CarMaker application
Don't forget that the Realtime System Setup write boot configuration files for the Xpack4. This implies that your changes are not directly effective on the Xpack4 but they require reboot of this computer (switching off and on again) because the configuration files will be read and executed only during the boot sequence.
Realtime System Setup is documented in the Installation Guide in chapter 4 (an the GUI from subchapter 4.3).
In case the Apply button is grayed out (deactivated), you can:
- reselect the IP for the network interface of the Windows host computer on the the displayed list clicking on the downward arrow (in the upper right frame named Settings)
- or adding a dummy user that you then remove (in the upper right frame named Users).
A file based approach (for power users instead of the GUI based approach with the Realtime System Setup for standard users) is explained in the Release Notes on subchapter 4.4 of CarMaker 9 releases with the manual edition of the pxelinux.cfg/default file in the tftpboot directory in order to specify
- the kernel image to used
- and the folder from the Windows host computer to map as the Xpack4 file system tree root.
- Date: 09.06.2020
- Product: CarMaker/HIL
- Version: 9.0
- Component: Xpack4
- Language: English
Tags
Xpack4Xeno
Realtime System
HIL