Hyperledger Aries Training Workshop Prerequisites

To attend the Hyperledger Foundation Community Workshop series, Intro to Decentralized Identity, some preparatory work must be done in order to follow along with the workshops. Please make sure the OS and tools listed below are installed. The command lines are provided because in some cases, the default download will not work with our solution.

OS

To successfully follow the examples given during the training, you will need Ubuntu 18.4.

Required tools

If not already installed, you will need to install curl, Node.js, Git, Docker, and Docker-Compose on your Ubuntu system. These must be installed to do the labs during the training session. Use the steps in each section below to properly install each element.

curl

sudo apt install -y curl

Node.js

curl -sL https://deb.nodesource.com/setup_10.x | sudo -E bash -

sudo apt install -y nodejs

Git

sudo apt install -y git

Docker

Only perform Steps 1 and 2 from the following link to install docker: https://www.digitalocean.com/community/tutorials/how-to-install-and-use-docker-on-ubuntu-18-04.

Docker-Compose

Enter these three commands in your terminal:

sudo curl -L https://github.com/docker/compose/releases/download/1.25.5/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose

sudo chmod +x /usr/local/bin/docker-compose

docker-compose --version

Your output should read as follows: $ docker-compose version 1.25.5, build 8a1c60f6

Install a necessary dependency:

sudo apt -y install libgconf2-4

Download Repos

Enter these six commands into your terminal:

cd ~

mkdir git-hltraining

cd git-hltraining

git clone https://github.com/hyperledger/aries-toolbox.git

git clone https://github.com/hyperledger/aries-acapy-plugin-toolbox.git

cd ~

Install Indy-CLI

Enter all of the following steps in to the Ubuntu command line:

sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys CE7709D068DB5E88

sudo add-apt-repository "deb https://repo.sovrin.org/sdk/deb bionic stable"

sudo add-apt-repository "deb https://repo.sovrin.org/deb bionic stable"

sudo apt-get update -y

sudo apt-get upgrade -y 

sudo apt-get install -y indy-cli

cd ~

Now download the Indicio TestNet Genesis file:

curl -O https://raw.githubusercontent.com/Indicio-tech/indicio-network/main/genesis_files/pool_transactions_testnet_genesis

Create a cliconfig file (e.g. vi cliconfig) in your home directory and add the following contents:

{
  "taaAcceptanceMechanism": "for_session"
}

Run indy-cli. A full path for cliconfig is needed if you do not run indy-cli from your home directory.

indy-cli --config cliconfig  

Ubuntu In a VM

If Ubuntu is installed on Windows in a Virtualbox VM, do the following:

1. Perform all the steps listed in this tutorial to update your system and enable copy and paste.
2. Make sure to restart your VM and that the Shared Clipboard is set to bidirectional:
1. In your VM machine settings, in Virtual Box > General > Advanced
2. Set ‘Shared Clipboard’ to ‘Bidirectional’