Install the CodeSafe 5 SDK on Linux

  1. Make sure that the following nShield ISO images are available locally:

    • SecWorld_Lin64-13.x.y.iso

    • Codesafe_Lin64-13.x.y.iso

      Where <x.y> are the same versions for Security World and CodeSafe.

  2. Verify both ISO images as described in Verify the installation media.

  3. Create a mount directory for each ISO:

    mkdir ~/secworld_iso_mountpoint
    mkdir ~/codesafe_iso_mountpoint
  4. Mount the ISO images to their respective directories:

    sudo mount <PATH_TO>/SecWorld_Lin64-13.x.y.iso ~/secworld_iso_mountpoint/
    sudo mount <PATH_TO>/Codesafe_Lin64-13.x.y.iso ~/codesafe_iso_mountpoint/

    The nShield CodeSafe 5 hostside is located in tarballs under:

    ls ~/codesafe_iso_mountpoint/linux/amd64/
    csdref.tar.gz  csd.tar.gz

    The nShield Security World hostside is located in tarballs under:

    ls ~/secworld_iso_mountpoint/linux/amd64/
    ctd.tar.gz   devref.tar.gz  javasp.tar.gz  ncsnmp.tar.gz
    ctls.tar.gz  hwsp.tar.gz    jd.tar.gz      raserv.tar.gz
  5. Untar the tarballs into the root directory:

    tar -zxvf ~/codesafe_iso_mountpoint/linux/amd64/csd.tar.gz -C /
    tar -zxvf ~/codesafe_iso_mountpoint/linux/amd64/csdref.tar.gz -C /
    tar -zxvf ~/secworld_iso_mountpoint/linux/amd64/ctd.tar.gz -C /
    tar -zxvf ~/secworld_iso_mountpoint/linux/amd64/devref.tar.gz -C /
    tar -zxvf ~/secworld_iso_mountpoint/linux/amd64/javasp.tar.gz -C /
    tar -zxvf ~/secworld_iso_mountpoint/linux/amd64/ncsnmp.tar.gz -C /
    tar -zxvf ~/secworld_iso_mountpoint/linux/amd64/ctls.tar.gz -C /
    tar -zxvf ~/secworld_iso_mountpoint/linux/amd64/hwsp.tar.gz -C /
    tar -zxvf ~/secworld_iso_mountpoint/linux/amd64/jd.tar.gz -C /
    tar -zxvf ~/secworld_iso_mountpoint/linux/amd64/raserv.tar.gz -C /

    This installs the nShield CodeSafe 5 SDK to /opt/nfast/c/csd5 and the nShield CodeSafe 5 SDK Python files to /opt/nfast/python3/csd5.

Install from RPM packages

As an alternative to the tarballs, the CodeSafe ISO contains the CodeSafe 5 SDK as the RPM packages nShield-csd and nShield-csdref in linux-rpms/amd64/. They are signed with the same key as the ISO images. nShield-csd requires the nShield-ctls and nShield-ctd packages, and nShield-csdref requires the nShield-devref package. These packages are on the Security World ISO.

  1. Install the Security World RPM packages, including nShield-ctls, nShield-ctd and nShield-devref, from the Security World ISO as described in Install the Security World software from RPM packages. This also imports the RPM signing key into rpm.

  2. Verify that each CodeSafe RPM package is signed:

    rpm --checksig ~/codesafe_iso_mountpoint/linux-rpms/amd64/nShield-csd*.rpm
    rpm --checksig -v ~/codesafe_iso_mountpoint/linux-rpms/amd64/nShield-csd*.rpm

    The output of the first command must end with digests signatures OK for each package. In the output of the second command, every line that reports a signature must end with key ID 0347cdcf: OK. If either check fails, do not install the package. See Install the Security World software from RPM packages for the meaning of the other results.

  3. Install the packages.

    On Red Hat Enterprise Linux and Oracle Linux:

    sudo dnf install ~/codesafe_iso_mountpoint/linux-rpms/amd64/nShield-csd*.rpm

    On SUSE Linux Enterprise:

    sudo zypper install ~/codesafe_iso_mountpoint/linux-rpms/amd64/nShield-csd*.rpm

    This installs the same files as csd.tar.gz and csdref.tar.gz.