Getting the installer

Access the Anjuna Resource Center to get the Anjuna SGX Runtime installer v1.51 for your system.

You can use the “API” button to copy a wget command to download Anjuna SGX Runtime installer to your Azure instance from the command line, without the need to access the Anjuna Resource Center UI again.

API button

The Anjuna SGX Runtime installer is an executable that performs the following tasks:

  1. Check for Intel® SGX compatibility

  2. Check for a compatible operating system

  3. Check for the availability of the Intel® SGX driver, installing it if necessary

  4. Check for the availability of the Intel® PSW software, installing it if necessary

  5. Install the Anjuna SGX Runtime

  6. Install the Anjuna encryption and decryption tools

  7. Install the Anjuna attestation tools

Example: Installing on Ubuntu 18

This section shows how to install the Anjuna SGX Runtime on an Ubuntu 18 (or Ubuntu 20) system step-by-step. Installing on other supported systems follows the same steps, but with an installer appropriate to the system.

In this section, some code blocks are shortened to emphasize only the relevant configuration. A line with <snip>…​ indicates that some lines have been removed from the full configuration.

  1. If you have not done so already, access the Anjuna Resource Center to get the Anjuna SGX Runtime installer v1.51 for Ubuntu 18.

  1. Ensure that the installer is executable:

$ chmod +x anjuna-runtime-ubuntu-release-1.51.0002.bin

  1. Display the installer’s help message:

$ ./anjuna-runtime-ubuntu-release-1.51.0002.bin --help

Anjuna SGX Runtime self-extracting installer

Usage: ./anjuna-runtime-ubuntu-release-1.51.0002.bin [OPTIONS]
Run this file to extract and install Anjuna Runtime.

Available options:
  -v, --verbose   Print more information during the setup
  -l, --list      List the content of this package
  -e, --extract   Extract the package, but skip the setup
  -t, --tar       Generate a TAR file that contains the whole package
  -h, --help      Print this message
      --clean     Re-install the Intel SGX Driver and Intel PSW even if they
                  were already installed. By default, the installer will setup those
                  components only if the they are not already installed

  --version       Print the version information

  1. Run the installer

$ ./anjuna-runtime-ubuntu-release-1.51.0002.bin

The installer produces output similar to the following:

Anjuna SGX Runtime self-extracting installer

 Checking for Operating System
 Found Ubuntu 18.04.3 LTS

 Checking for SGX Hardware support
 This host is SGX capable (sgx_is_capable => 1)

 <snip>...

 Checking for OS packages
 - Package [wget] installed
 - Package [jq] installed
 - Package [python] installed
 - Package [libprotobuf-dev] installed
 - Package [build-essential] installed
 - Package [libssl-dev] installed
 - Package [libcurl4-openssl-dev] installed
 - Package [linux-headers-4.15.0-45-generic] installed

 Checking for Intel SGX Driver
 Found Intel Driver

 Checking for Anjuna SGX module
 Found Anjuna SGX module

 Kernel module status:
 anjuna                 16384  0
 isgx                   45056  2

 Checking for Intel PSW
 Intel AESMD service already running
 vm.mmap_min_addr already set to 0


 Summary:
 Anjuna SGX Runtime fully installed (1)
 Run the following command to setup your environment

    source /home/sgx/anjuna-runtime-ubuntu-release-1.51.0002/env.sh
1 indicates that the Anjuna SGX Runtime was properly installed.