Developer Guide

  • 2021.1
  • 11/03/2021
  • Public
Contents

Install Host Dependencies

The following list contains dependencies needed to use Intel® TCC Tools on your host system:
  • ittapi (for applications using the measurement library and measurement library build)
  • g++-multilib (for ittapi as build dependencies, verified on version 4:9.3.0-1ubuntu2)
  • cmake (for application build, verified on version 3.16.3.-1ubuntu1)
  • json-c (for the cache allocation library build, verified on version 0.13.1+dfsg-7ubuntu0.3)
  • msgfmt (for data streams optimizer and cache configurator, verified on version 0.19.8.1-10build1)
  • python3-pip (for the data streams optimizer and cache allocation capabilities, verified on version 20.0.2-5ubuntu1.1)
  • python modules for samples (modules listed in
    ${TCC_ROOT}/samples/plot_scripts/prerequisites.txt
    )
  • python modules for data streams optimizer and cache configurator (modules listed in
    ${TCC_TOOLS_PATH}/prerequisites.txt
    )
  • Firmware and BIOS Utilities located in GitHub (for data streams optimizer and cache configurator demo)
  • Test certificates (for data streams optimizer and cache configurator demo)
The following steps show how to install each dependency manually to customize your setup:
  1. Install ittapi:
    1. Clone the ittapi repository:
      git clone -b v3.15.12 https://github.com/intel/ittapi
    2. Install build dependencies:
      sudo apt-get install cmake g++-multilib
    3. Build itt:
      cd ittapi python3 buildall.py
    4. Copy itt parts to system folders:
      sudo cp build_linux/64/bin/libittnotify64.a /usr/lib sudo cp -r include /usr/include/ittnotify sudo cp src/ittnotify/*.h /usr/include/ittnotify/ cd ../
  2. Install json-c:
    sudo apt-get install libjson-c-dev
  3. Install dependencies for host-side tools:
    The dependencies are required for the data streams optimizer and cache allocation capabilities.
    1. Install the pip tool for Python 3:
      sudo apt-get install python3-pip
      Skip this step if you have already installed pip for Python 3.
    2. Install the msgfmt as part of gettext utilities:
      sudo apt-get install gettext
    3. Go to the following directory:
      cd ${TCC_ROOT}/samples/plot_scripts
    4. Install the required Python modules for samples:
      pip3 install -r prerequisites.txt --user
    5. Go to the following directory:
      cd ${TCC_TOOLS_PATH}
    6. Install the required Python modules for tools:
      pip3 install -r prerequisites.txt --user
    7. Install Firmware and BIOS Utilities v0.7.6 to the
      tools/capsule
      directory. See
      tools/capsule/README.md
      for more details.
    8. Provision certificates/public key:
      The Firmware and BIOS Utilities software requires certificates or RSA signing key pair during capsule file generation. RSA signing keys are required to sign and authenticate the Intel® TCC subregion, and a certificate is needed to sign the capsule. It is strongly recommended that you generate your own certificates/RSA key pair for capsule and subregion signing and work with your BIOS vendor to enroll them into the BIOS. For details about the signing and enrolling mechanism, see the white paper Intel® Time Coordinated Computing (Intel® TCC) Security for UEFI BIOS. For test purposes, you can download testing certificates for capsule signing from the EDK2 repository. You also need to generate test RSA keys. Run the following command:
      openssl req -new -x509 -newkey rsa:3072 -subj "/CN=Secure_b=Boot_test/" -keyout ./keys/Signing.key -out ./keys/Signing.crt -days 365 -nodes -sha384

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.