Troubleshooting and FAQ¶

During the yum install phase (first steps) there is a chance that conflicts or dependencies are not resolved. Particularly if the COM express operating system has been modified. Therefore, any errors should be noted, reported and corrected if necessary.
All SERENITY prototype boards should have a cmx account, however, all needed components should be located in in /opt (or /opt/emp).
The environment should be taken care of by the RPM installation and the above instructions. If errors or unfound paths are identified these should also be reported.
Linux (specifically centos7) is installed on the SERENITY boards and is used for configuring and managing the Daughter Cards, slow control and other infrastructure.
most packages are installsed using RPMs installed via yum. rpm used to mean redhat package manager, but now is used more widely as an rpm package manner. Yum refers to the tool used to manage the rpm installation. more info: rpm and yum

Advanced Troubleshooting¶

With direct connection to the display port you see a blank screen:
```
sudo emacs /etc/default/grub
```
then find the following line and make sure it has the nomodeset at the end:
```
GRUB_CMDLINE_LINUX="rd.lvm.lv=cl_dyn20-032-64/root rd.lvm.lv=cl_dyn20-032-64/swap rhgb quiet nomodeset"
```
then save it and do:
```
sudo grub2-mkconfig --output=/boot/grub2/grub.cfg
```
Rebooting should then fix the issue.

If you switch from a DVI connector to only display port then you actually need to remove the “nomodeset” and repeat, otherwise you will get the same problem reversed.
A powered USB hub is required if you have a keyboard/mouse connected to the USB port on the Serenity.

Uncommon Issues¶

If you are using a Mac to connect to the board there is a chance that the locale environment is unrecognised. This will give the following error (or something similar):

RuntimeError: locale::facet::_S_create_c_locale name not valid

The option set locale environment variables on startup in the Mac OSX Terminal needs to be unchecked.