HPMC User Guide v 1.00
© 2022 Bassem W. Jamaleddine

The MIC is booted as a computer within your HPMC computer system. Your HPMC computer
is the host computer that will treat the MIC Co-Processor as a computer plugged into
its PCI bus, that will embed its OS image, for this to happen:
- the MIC device driver must be loaded, hence to communicate and control the MIC hardware
  layer. From your HPMC verify the mic module is loaded (this is true for x100 series)
  # lsmod | grep mic
- the MIC is recognized as a device to the host computer. You can simply see if the mic0
  device is there:
  # ls /dev/mic0
- the MPSS software layer must be available on the HPMC host computer. A simple way to
  verify that MPSS is installed, just see if micinfo can be recognized on your command
  prompt:
  # which micinfo

To bring the MIC up

* it is embedded system whose root directory is mapped to /var/mpss/mic0, hence the root
  user directory that will be available when MIC Co-Processor is bootstrapped can be
  seen on your HPMC host: /var/mpss/mic0/root
  # ls -la /var/mpss/mic0/root
Hence basic changes to the MIC root diretory are possible:
- Generate the key on the host and add it to the authorized_keys on the MIC mapped directory:
    ssh-keygen
    cat /root/.ssh/id_rsa.pub > /var/mpss/mic0/root/.ssh/authorized_keys
- micctrl --resetconfig -v
- check MIC if is in ready state
     micctrl -s
- if MIC is not in ready state then reset it
     micctrl -rw
- check MIC if is in ready state
     micctrl -s
- if MIC cannot be in ready state then you need to flash it (micflash -update) and reboot the host, and reset the MIC (micctrl -rw) until
  it is in ready state (mictrl -s)
- once the MIC is in ready state then bring up MPSS:
     systemctl start mpss
  you can monitor the progress of the startup: dmesg | tail
- once the MIC is booted, you can ssh to it:
     ssh mic0
- for physical condition and information about the MIC:
     micinfo
- enable MPSS service, so that the MPSS is up after each reboot. Assuming you won't make changes to the MIC kernel image:
     systemctl enable mpss