mirror of
https://github.com/corda/corda.git
synced 2025-01-01 02:36:44 +00:00
Beautify README format
This commit is contained in:
Andy Zhao
parent
9441de4c38
commit
07f546948c
133
README.md
133
README.md
@ -29,95 +29,128 @@ Follow the instructions in the [linux-sgx-driver](https://github.com/01org/linux
|
||||
Build the Intel(R) SGX SDK and Intel(R) SGX PSW Package
|
||||
-------------------------------------------------------
|
||||
###Prerequisites:
|
||||
- Ensure that you have the following required operating systems:
|
||||
- Ensure that you have the following required operating systems:
|
||||
Ubuntu\*-14.04-LTS 64bits
|
||||
- Use the following command to install the required tools to build Intel(R) SGX SDK:
|
||||
`$ sudo apt-get install build-essential ocaml automake autoconf libtool`
|
||||
- Use the following command to install additional required tools to build Intel(R) SGX PSW:
|
||||
`$ sudo apt-get install libcurl4-openssl-dev protobuf-compiler protobuf-c-compiler libprotobuf-dev libprotobuf-c0-dev`
|
||||
- Use the script *download_prebuilt.sh* inside source code package to download prebuilt binaries to prebuilt folder
|
||||
You may need set http proxy for wget tool used by the script (such as `export http_proxy=http://test-proxy:test-port`)
|
||||
`$ ./download_prebuilt.sh`
|
||||
- Use the following command to install the required tools to build Intel(R) SGX SDK:
|
||||
```
|
||||
$ sudo apt-get install build-essential ocaml automake autoconf libtool
|
||||
```
|
||||
- Use the following command to install additional required tools to build Intel(R) SGX PSW:
|
||||
```
|
||||
$ sudo apt-get install libcurl4-openssl-dev protobuf-compiler protobuf-c-compiler libprotobuf-dev libprotobuf-c0-dev
|
||||
```
|
||||
- Use the script `download_prebuilt.sh` inside source code package to download prebuilt binaries to prebuilt folder
|
||||
You may need set http proxy for wget tool used by the script (such as `export http_proxy=http://test-proxy:test-port`)
|
||||
```
|
||||
$ ./download_prebuilt.sh
|
||||
```
|
||||
|
||||
###Build the Intel(R) SGX SDK and Intel(R) SGX PSW
|
||||
The following steps describe how to build the Intel SGX SDK and PSW. You can build the project according to your requirement.
|
||||
1. To build both Intel SGX SDK and PSW with default configuration, enter the following command:
|
||||
`$ make`
|
||||
You can find the tools and libraries generated in the `build/linux` directory.
|
||||
Note: You can also go to the sdk folder and use the `make` command to build the Intel SGX SDK component only. However, the building of PSW component is dependent on the building result of Intel SGX SDK.
|
||||
2. To build Intel SGX SDK and PSW with debug information, enter the following command:
|
||||
`$ make DEBUG=1`
|
||||
3. To clean the files generated by previous `make` command, enter the following command:
|
||||
`$ make clean`
|
||||
The following steps describe how to build the Intel SGX SDK and PSW. You can build the project according to your requirement.
|
||||
- To build both Intel SGX SDK and PSW with default configuration, enter the following command:
|
||||
You can find the tools and libraries generated in the `build/linux` directory.
|
||||
**Note**: You can also go to the sdk folder and use the `make` command to build the Intel SGX SDK component only. However, the building of PSW component is dependent on the building result of Intel SGX SDK.
|
||||
```
|
||||
$ make
|
||||
```
|
||||
|
||||
- To build Intel SGX SDK and PSW with debug information, enter the following command:
|
||||
```
|
||||
$ make DEBUG=1
|
||||
```
|
||||
- To clean the files generated by previous `make` command, enter the following command:
|
||||
```
|
||||
$ make clean
|
||||
```
|
||||
|
||||
###Build Intel(R) SGX SDK Installer
|
||||
To build Intel(R) SGX SDK installer, enter the following command:
|
||||
`$ make sdk_install_pkg`
|
||||
```
|
||||
$ make sdk_install_pkg
|
||||
```
|
||||
You can find the generated Intel SGX SDK installer `sgx_linux_x64_sdk_${version}.bin` located under `linux/installer/bin/`, where `${version}` refers to the version number.
|
||||
|
||||
###Build Intel(R) SGX PSW Installer
|
||||
To build Intel(R) SGX PSW installer, enter the following command:
|
||||
`$ make psw_install_pkg`
|
||||
```
|
||||
$ make psw_install_pkg
|
||||
```
|
||||
You can find the generated Intel SGX PSW installer `sgx_linux_x64_psw_${version}.bin` located under `linux/installer/bin/`, where `${version}` refers to the version number.
|
||||
|
||||
Install Intel(R) SGX SDK
|
||||
------------------------
|
||||
###Prerequisites
|
||||
- Ensure that you have the following required operating systems:
|
||||
- Ensure that you have the following required operating systems:
|
||||
Ubuntu\*-14.04-LTS
|
||||
- Use the following command to install the required tool to use Intel(R) SGX SDK:
|
||||
`$ sudo apt-get install build-essential`
|
||||
```
|
||||
$ sudo apt-get install build-essential
|
||||
```
|
||||
|
||||
###Install Intel(R) SGX SDK
|
||||
To install Intel(R) SGX SDK, execute the installer with root privilege:
|
||||
`$ sudo ./sgx_linux_x64_sdk_${version}.bin `
|
||||
|
||||
```
|
||||
$ cd linux/installer/bin
|
||||
$ sudo ./sgx_linux_x64_sdk_${version}.bin `
|
||||
```
|
||||
###Test Intel(R) SGX SDK Package with the Sample Codes
|
||||
1. Copy the sample codes installed by Intel(R) SGX SDK package into your work folder, such as
|
||||
`$ cp -r /opt/intel/sgxsdk/SampleCode ~`
|
||||
2. Compile and run each sample codes in the simulation mode to make sure the package works well.
|
||||
`$ cd SampleCode/LocalAttestation`
|
||||
`$ make`
|
||||
`$ ./app`
|
||||
- Copy the sample codes installed by Intel(R) SGX SDK package into your work folder, such as
|
||||
```
|
||||
$ cp -r /opt/intel/sgxsdk/SampleCode ~
|
||||
```
|
||||
- Compile and run each sample codes in the simulation mode to make sure the package works well.
|
||||
```
|
||||
$ cd SampleCode/LocalAttestation
|
||||
$ make
|
||||
$ ./app
|
||||
```
|
||||
Use similar commands for other sample codes.
|
||||
|
||||
###Compile and Run the Sample Codes in the Hardware Mode
|
||||
If you use an SGX hardware enabled machine, you need to run the sample codes in the hardware mode.
|
||||
Ensure that you install SGX driver and Intel(R) SGX PSW installer on the machine.
|
||||
Ensure that you install SGX driver and Intel(R) SGX PSW installer on the machine.
|
||||
See the topic, Install Intel(R) SGX PSW, on how to install the PSW package.
|
||||
1. Copy the sample codes installed by the Intel(R) SGX SDK package into your work folder, such as
|
||||
`$ cp -r /opt/intel/sgxsdk/SampleCode ~`
|
||||
2. Compile and run each sample codes in the debug mode.
|
||||
`$ cd SampleCode/LocalAttestation`
|
||||
`$ make SGX_MODE=HW SGX_DEBUG=1`
|
||||
`$ ./app`
|
||||
- Copy the sample codes installed by the Intel(R) SGX SDK package into your work folder, such as
|
||||
```
|
||||
$ cp -r /opt/intel/sgxsdk/SampleCode ~
|
||||
```
|
||||
- Compile and run each sample codes in the debug mode.
|
||||
```
|
||||
$ cd SampleCode/LocalAttestation
|
||||
$ make SGX_MODE=HW SGX_DEBUG=1
|
||||
$ ./app
|
||||
```
|
||||
Use similar commands for other sample codes.
|
||||
|
||||
Install Intel(R) SGX PSW
|
||||
------------------------
|
||||
###Prerequisites
|
||||
- Ensure that you have the following required operating systems:
|
||||
- Ensure that you have the following required operating systems:
|
||||
Ubuntu\*-14.04-LTS 64bits
|
||||
- Ensure that you have the following required hardware:
|
||||
- Ensure that you have the following required hardware:
|
||||
6th Generation Intel(R) Core(TM) Processor (code named Skylake)
|
||||
- Configure the system with the **SGX hardware enabled** option and install SGX driver in advance.
|
||||
- Configure the system with the **SGX hardware enabled** option and install SGX driver in advance.
|
||||
See the topic, Build and Install the Intel(R) SGX Driver, on how to install the SGX driver.
|
||||
- Install the library using the following command:
|
||||
`$ sudo apt-get install libcurl4-openssl-dev libprotobuf-dev libprotobuf-c0-dev`
|
||||
- Install the library using the following command:
|
||||
```
|
||||
$ sudo apt-get install libcurl4-openssl-dev libprotobuf-dev libprotobuf-c0-dev`
|
||||
```
|
||||
|
||||
###Install Intel(R) SGX PSW
|
||||
To install Intel(R) SGX PSW, execute the installer with root privilege:
|
||||
`$ sudo ./sgx_linux_x64_psw_${version}.bin`
|
||||
To install Intel(R) SGX PSW, execute the installer with root privilege:
|
||||
```
|
||||
$ cd linux/installer/bin
|
||||
$ sudo ./sgx_linux_x64_psw_${version}.bin`
|
||||
```
|
||||
|
||||
###Start or Stop aesmd Service
|
||||
The Intel(R) SGX PSW installer installs an aesmd service in your machine which is running in a special linux account aesmd.
|
||||
To stop the service: `$ sudo service aesmd stop`
|
||||
To start the service: `$ sudo service aesmd start`
|
||||
The Intel(R) SGX PSW installer installs an aesmd service in your machine which is running in a special linux account aesmd.
|
||||
To stop the service: `$ sudo service aesmd stop`
|
||||
To start the service: `$ sudo service aesmd start`
|
||||
To restart the service: `$ sudo service aesmd restart`
|
||||
|
||||
###Configure the Proxy for aesmd Service
|
||||
The aesmd service uses HTTP protocol to initialize some services.
|
||||
If proxy is required for HTTP protocol, you may need manually setup the proxy for aesmd service.
|
||||
You should manually edit file `/etc/aesmd.conf` (refer the comment in the file) to set the proxy for aesmd service.
|
||||
The aesmd service uses HTTP protocol to initialize some services.
|
||||
If proxy is required for HTTP protocol, you may need manually setup the proxy for aesmd service.
|
||||
You should manually edit file `/etc/aesmd.conf` (refer the comment in the file) to set the proxy for aesmd service.
|
||||
After you configure the proxy, you need to restart the service to enable the proxy.
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user