Skip to content

Commit 175e44f

Browse files
committed
removal of old indy-cli from docs
Signed-off-by: Philipp Schlarb <[email protected]>
1 parent d76e907 commit 175e44f

File tree

4 files changed

+18
-141
lines changed

4 files changed

+18
-141
lines changed
Lines changed: 2 additions & 110 deletions
Original file line numberDiff line numberDiff line change
@@ -1,122 +1,14 @@
11
# Installing the `indy-cli`
22

3-
The `indy-cli` is developed under the [indy-sdk](https://github.com/hyperledger/indy-sdk). This documentation may be not up to date.
3+
The `indy-cli` is developed under the [indy-cli-rs](https://github.com/hyperledger/indy-cli-rs). This documentation may be not up to date.
44

5-
>As stated in [Installation and configuration of Indy-Node](../installation-and-configuration.md) `indy-cli` can be replaced with [`indy-cli-rs`](https://github.com/hyperledger/indy-cli-rs)
6-
>This documentation describes the necessarry steps with `indy-cli`, keep in mind that everytime `indy-cli` is mentioned you can also use `indy-cli-rs`. Please refer to the corresponding documentation.
75

86
You will need to perform the following once for each `indy-cli` machine you would like to set up (only 1 is required).
97
It is recommended that you install the `indy-cli` in your native work environment if possible, so you always have it available even when traveling.
108

119
## Installing `indy-cli-rs`
12-
To install `indy-cli-rs` simply donwload the latest release from its release pages and unpack it.
10+
To install `indy-cli-rs` simply download the latest release from its release pages and unpack it.
1311

1412
## Containerized `indy-cli` Environment
1513

1614
The following sections describe how to install and configure the `indy-cli` directly on a machine or VM. However, possibly the most convenient option is to use a containerized `indy-cli` environment like the one included with [von-network](https://github.com/bcgov/von-network). For information on how to use the containerized `indy-cli` in `von-network`, refer to [Using the containerized indy-cli](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md)
17-
18-
## Windows:
19-
To install the `indy-cli` on Windows 10 perform the following steps:
20-
1. Download https://repo.sovrin.org/windows/indy-cli/stable/1.16.0/indy-cli_1.16.0.zip and unzip it.
21-
If there is a newer version under https://repo.sovrin.org/windows/indy-cli/stable/ it instead.
22-
2. Open a command prompt. (This will work differently if you use Windows Terminal).
23-
3. `cd` to the directory where you unzipped the `indy-cli` package. For example, if you unzipped directly in your ‘downloads’ directory like I did you would type: `cd \Users\<Username>\Downloads\indy-cli_1.14.2`
24-
4. Create a JSON Config file containing your taaAcceptanceMechanism in the directory where indy-cli.exe resides (I created \Users\<Username>\Downloads\indy-cli_1.14.2\cliconfig.json on my machine)
25-
```json
26-
{
27-
"taaAcceptanceMechanism": "for_session"
28-
}
29-
```
30-
5. Run `indy-cli.exe --config cliconfig.json` to verify proper installation. You should see a new window appear with an `indy>` prompt, (If you are double clicking to start `indy-cli`, you need to right click on the .exe in your window and add the --config parameter first.) If you get an error stating that it is missing vcruntime140.dll then do the following:
31-
6. Download and install vc_redist.x64.exe from the Visual Studio 2017 section on the https://support.microsoft.com/en-ae/help/2977003/the-latest-supported-visual-c-downloads page, and then rerun indy-cli.exe to see if it works as described in previous step.
32-
7. Type ‘exit’ in the `indy-cli`
33-
34-
## Ubuntu:
35-
To install the `indy-cli` on Ubuntu, perform the following steps from the ubuntu command line:
36-
37-
1. `sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys CE7709D068DB5E88`
38-
2. `sudo add-apt-repository "deb https://repo.sovrin.org/sdk/deb xenial stable"`
39-
3. `sudo add-apt-repository "deb https://repo.sovrin.org/deb xenial stable"`
40-
4. `sudo apt-get update -y`
41-
5. `sudo apt-get upgrade -y `
42-
6. `sudo apt-get install -y indy-cli`
43-
7. `cd ~`
44-
8. Create a JSON Config file containing your taaAcceptanceMechanism in your home directory:
45-
`vim ~/cliconfig.json`
46-
47-
Press the “i” key and paste the following into the file:
48-
```json
49-
{
50-
"taaAcceptanceMechanism": "for_session"
51-
}
52-
```
53-
Press the “esc” key then the following characters to write the file and quit
54-
`:wq`
55-
9. Run `indy-cli --config ~/cliconfig.json` to start the `indy-cli`
56-
57-
## Mac:
58-
59-
Since there is not a prepackaged version of the `indy-cli` prepared for the Mac, the following steps will help you to create an environment, build, and run the `indy-cli` in a Mac terminal.
60-
61-
Open a Terminal
62-
Run the following commands in the terminal:
63-
64-
1. `cd ~`
65-
2. `mkdir github`
66-
3. `cd github`
67-
4. `git clone https://github.com/hyperledger/indy-sdk.git`(might need xcode-select --install if error occurs)
68-
5. `/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"`
69-
6. `curl https://sh.rustup.rs -sSf | sh`
70-
7. Follow onscreen instructions to install rust
71-
8. `brew install pkg-config libsodium automake autoconf cmake openssl zeromq zmq`
72-
NOTE: the openssl path needs to match what you currently have on your system
73-
74-
9. Run > `ls /usr/local/Cellar/openssl/`
75-
Note the name of the directory shown (the example below shows 1.0.2p but the latest version is 1.1.1l)
76-
77-
Use this directory in place of the one listed below in your .profile file
78-
79-
10. Add the following lines to your` ~/.profile file `(making the correction shown in the previous step if needed)
80-
```
81-
export PATH="$HOME/.cargo/bin:$PATH:~/github/indy-sdk/libindy/target/debug:~/github/indy-sdk/cli/target/debug"
82-
export PKG_CONFIG_ALLOW_CROSS=1
83-
export CARGO_INCREMENTAL=1
84-
export RUST_LOG=indy=trace
85-
export RUST_TEST_THREADS=1
86-
export OPENSSL_DIR=/usr/local/Cellar/openssl/1.0.2p #use your path
87-
export LIBRARY_PATH=~/github/indy-sdk/libindy/target/debug/
88-
export LIBINDY_DIR=~/github/indy-sdk/libindy/target/debug/
89-
```
90-
11. Run the following commands from your terminal to build the `indy-cli`:
91-
```
92-
source ~/.profile
93-
cd ~/github/indy-sdk/libindy
94-
cargo build
95-
cd ../cli
96-
cargo build
97-
```
98-
12. Create a JSON Config file containing your taaAcceptanceMechanism in your home directory:
99-
`vim ~/cliconfig.json`
100-
101-
Press the “i” key and paste the following into the file:
102-
```json
103-
{
104-
"taaAcceptanceMechanism": "for_session"
105-
}
106-
```
107-
Press the “esc” key then the following characters to write the file and quit
108-
`:wq`
109-
13. You can now run `indy-cli` from within a terminal by typing
110-
111-
`indy-cli --config ~/cliconfig.json`
112-
113-
`indy> exit` (To exit from the `indy-cli` prompt when you ar done)
114-
115-
If the above gives error regarding library not loaded libssl.1.0.0, you will probably need to run the following command (all in one line should work) to revert your version:
116-
117-
```
118-
brew uninstall --ignore-dependencies openssl; brew uninstall openssl;
119-
brew install https://github.com/tebelorg/Tump/releases/download/v1.0.0/openssl.rb
120-
```
121-
122-

docs/source/NewNetwork/CreateDID.md

Lines changed: 2 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,13 @@
22

33
You will need to perform the following commands once for each `indy-cli` machine that you want to run on. The following commands contain suggestions to save certain values in a secure place. Please do not share those values or that place with anyone.
44

5-
>As stated in [Installation and configuration of Indy-Node](../installation-and-configuration.md) `indy-cli` can be replaced with [`indy-cli-rs`](https://github.com/hyperledger/indy-cli-rs)
6-
>This documentation describes the necessarry steps with `indy-cli`, keep in mind that everytime `indy-cli` is mentioned you can also use `indy-cli-rs`. Please refer to the corresponding documentation.
75

8-
_If you just need to quickly generate a set of secrets (Seed and wallet key), or a Seed, DID, and Verkey and do not have an `indy-cli` environment already setup, you can use the `indy-cli` features integrated into `von-network`. Refer to [Generate a set of Secrets](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md#generate-a-set-of-secrets), and [Generate your DID](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md#generate-your-did) for details._
6+
_If you just need to quickly generate a set of secrets (Seed and wallet key), or a Seed, DID, and Verkey and do not have an `indy-cli-rs` environment already setup, you can use the `indy-cli` features integrated into `von-network`. Refer to [Generate a set of Secrets](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md#generate-a-set-of-secrets), and [Generate your DID](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md#generate-your-did) for details._
97

108

119
1. Start your `indy-cli` using the instructions from [Installing the `indy-cli`](./CLIInstall.md) for your platform.
1210

13-
All following commands are executing inside the `indy-cli`.
11+
All following commands are executing inside the `indy-cli-rs`.
1412

1513
2. Create a wallet with:
1614

docs/source/installation-and-configuration.md

Lines changed: 13 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,8 @@
11
# Installation and configuration of Indy-Node
22

33
## 1. Introduction
4-
The purpose of this document is to describe how to setup a production level Indy-Validator-Node and register it on an existing network using an `indy-cli` machine which you also configure along the way.
5-
>Alternativly you can use [`indy-cli-rs`](https://github.com/hyperledger/indy-cli-rs), which is command for command compatible with the existing indy-cli (at least ATM).
6-
>This documentation describes the necessarry steps with `indy-cli`, keep in mind that everytime `indy-cli` is mentioned you can also use `indy-cli-rs`. Please refer to the corresponding documentation.
4+
The purpose of this document is to describe how to setup a production level Indy-Validator-Node and register it on an existing network using an `indy-cli-rs` machine which you also configure along the way.
5+
76

87
This documentation is based heavily on the [Sovrin Steward Validator Preparation Guide v3](https://docs.google.com/document/d/18MNB7nEKerlcyZKof5AvGMy0GP9T82c4SWaxZkPzya4).
98

@@ -38,7 +37,7 @@ As you proceed through these steps, you will be generating data that will be nee
3837
- A cryptographic check against certain forgeries that can be done with BLS keys.
3938

4039
### 2.1 Two Machines
41-
You’ll need two machines: one is your Validator node and the other an `indy-cli` machine to run the `indy-cli` with which you will interact with the ledger. They can be physical machines, virtual machines, or a combination. The machine with the `indy-cli` can be turned on and off at your convenience (refer to [3.1. `indy-cli` Machine Installation](##3.1.-indy-cli-Machine-Installation) for more details), only the Validator node needs to be public and constantly running.
40+
You’ll need two machines: one is your Validator node and the other an `indy-cli` machine to run the `indy-cli-rs` with which you will interact with the ledger. They can be physical machines, virtual machines, or a combination. The machine with the `indy-cli` can be turned on and off at your convenience (refer to [3.1. `indy-cli` Machine Installation](##3.1.-indy-cli-Machine-Installation) for more details), only the Validator node needs to be public and constantly running.
4241

4342
>Important: for security reasons, you must not use your Validator node as an `indy-cli` client. If you do, it could expose your Steward credentials needlessly.
4443
@@ -73,22 +72,12 @@ Your Validator node will need to have an alias. This will be used later when we
7372

7473
Some instructions must be executed on the Validator node, and others on the `indy-cli` machine. The command line prompts in the instructions will help remind you which machine should be used for each command.
7574

76-
### 3.1. `indy-cli` Machine Installation
77-
78-
The following instructions describe how to install and configure the `indy-cli` directly on a machine or VM. The other, possibly more convenient, option is to use a containerized `indy-cli` environment like the one included with [von-network](https://github.com/bcgov/von-network). For information on how to use the containerized `indy-cli` in `von-network`, refer to [Using the containerized indy-cli](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md)
75+
### 3.1. `indy-cli-rs` Machine Installation
7976

80-
#### 3.1.1. Install the `indy-cli`
81-
On the machine you’ve chosen for the `indy-cli`, open a terminal and run the following lines to install the `indy-cli` package.
77+
The following instructions describe how to install and configure the `indy-cli-rs` directly on a machine or VM. The other, possibly more convenient, option is to use a containerized `indy-cli` environment like the one included with [von-network](https://github.com/bcgov/von-network). For information on how to use the containerized `indy-cli` in `von-network`, refer to [Using the containerized indy-cli](https://github.com/bcgov/von-network/blob/main/docs/Indy-CLI.md)
8278

83-
```
84-
ubuntu@cli$ sudo apt-key adv --keyserver keyserver.ubuntu.com --recv-keys CE7709D068DB5E88
85-
ubuntu@cli$ sudo apt-get install -y software-properties-common python-software-properties
86-
ubuntu@cli$ sudo add-apt-repository "deb https://repo.sovrin.org/sdk/deb xenial stable"
87-
ubuntu@cli$ sudo add-apt-repository "deb https://repo.sovrin.org/deb xenial stable"
88-
ubuntu@cli$ sudo apt-get update -y
89-
ubuntu@cli$ sudo apt-get upgrade -y
90-
ubuntu@cli$ sudo apt-get install -y indy-cli
91-
```
79+
#### 3.1.1. Install the `indy-cli-rs`
80+
On the machine you’ve chosen for the `indy-cli-rs` simply donwload the latest release from its release pages and unpack it.
9281

9382
#### 3.1.2. Add an Acceptance Mechanism
9483
To write to an Indy Node Ledger, you’ll need to sign the Transaction Author Agreement (TAA). You can learn more about the TAA [here](https://github.com/hyperledger/indy-sdk/blob/master/docs/how-tos/transaction-author-agreement.md). This agreement is incorporated into the process of connecting to the node pool and requires an acceptance mechanism. For the `indy-cli`, the default mechanism is “For Session” and the following instructions are required to be able to use “For Session” for your `indy-cli`:
@@ -103,12 +92,12 @@ This example cliconfig.json file contains the line that sets the AML:
10392
```
10493

10594
To start the `indy-cli` using your new config file, run the following:
106-
`ubuntu@cli$ indy-cli --config <path_to_cfg>/cliconfig.json`
95+
`ubuntu@cli$ indy-cli-rs --config <path_to_cfg>/cliconfig.json`
10796

10897
Now all of the appropriate transactions will have an “Agreement Accepted” authorization attached to them during this `indy-cli` session.
10998

11099
#### 3.1.3. Obtain the Genesis Files
111-
Obtain the genesis transaction files for the Network with the following steps. For the sake of this documentation, we will use the genesis files from the Sovrin Networks. Information on how to create a genesis file can be found [here](./NewNetwork/NewNetwork.md). These files contain bootstrap information about some of the Validator nodes, which will be used by your `indy-cli` to connect to the networks.
100+
Obtain the genesis transaction files for the Network with the following steps. For the sake of this documentation, we will use the genesis files from the Sovrin Networks. Information on how to create a genesis file can be found [here](./NewNetwork/NewNetwork.md). These files contain bootstrap information about some of the Validator nodes, which will be used by your `indy-cli-rs` to connect to the networks.
112101

113102
If you are at the `indy` prompt, please exit:
114103

@@ -152,9 +141,9 @@ ShahXae2ieG1uibeoraepa4eyu6mexei
152141
Keep this seed in a safe place, such as an encrypted password manager or other secure location designated by your organization. You will need it later in this guide, as well as in the future for other Steward interactions with the ledger.
153142

154143
##### Run the `indy-cli` and generate key
155-
Next we run the `indy-cli` by entering:
144+
Next we run the `indy-cli-rs` by entering:
156145

157-
`ubuntu@cli$ indy-cli --config <path_to_cfg>/cliconfig.json`
146+
`ubuntu@cli$ indy-cli-rs --config <path_to_cfg>/cliconfig.json`
158147

159148
In the command line, enter the following to create your pool configuration and your wallet locally. In these instructions, we use "buildernet" for the pool name and "buildernet_wallet" for the wallet name, although you may use other names of your choosing, if desired. The encrypted wallet will be used to store important information on this machine, such as your public and private keys. When creating your wallet, you will need to provide a "key" that is any string desired. It will be the encryption key of your local wallet.
160149

@@ -351,10 +340,10 @@ dpkg -l | grep indy
351340
```
352341

353342
##### Add Validator Node to Ledger
354-
On your `indy-cli` machine, if you are not still on the `indy-cli` prompt, you will need to return to it. To get back to where you were, type `indy-cli --config <path_to_cfg>/cliconfig.json`, connect to the network pool, designate the wallet to use (using the same wallet key as before), and enter the DID that was returned earlier, when you typed `did new seed` (then enter your seed) for your Steward user:
343+
On your `indy-cli` machine, if you are not still on the `indy-cli-rs` prompt, you will need to return to it. To get back to where you were, type `indy-cli --config <path_to_cfg>/cliconfig.json`, connect to the network pool, designate the wallet to use (using the same wallet key as before), and enter the DID that was returned earlier, when you typed `did new seed` (then enter your seed) for your Steward user:
355344

356345
```
357-
ubuntu@cli$ indy-cli --config <path_to_cfg>/cliconfig.json
346+
ubuntu@cli$ indy-cli-rs --config <path_to_cfg>/cliconfig.json
358347
indy> pool connect buildernet
359348
indy> wallet open buildernet_wallet key=<wallet_key>
360349
indy> did use <your_steward_DID>

sample/Network/README.md

Lines changed: 1 addition & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -2,12 +2,10 @@
22

33
This walkthrough goes through some of the detailed steps mentioned in [Setting up a New Network](../../docs/source/NewNetwork/NewNetwork.md)
44

5-
>As stated in [Installation and configuration of Indy-Node](../../docs/source/installation-and-configuration.md) `indy-cli` can be replaced with [`indy-cli-rs`](https://github.com/hyperledger/indy-cli-rs)
6-
>This documentation describes the necessarry steps with `indy-cli`, keep in mind that everytime `indy-cli` is mentioned you can also use `indy-cli-rs`. Please refer to the corresponding documentation.
75

86
For the sake of simplicity this walkthrough runs all of the nodes on the local machine. As a result it uses the local python install version of some of the commands rather than the production level Debian package install version of the commands documented in the [Setting up a New Network](../../docs/source/NewNetwork/NewNetwork.md) guide.
97

10-
1. Open indy-cli by executing `indy-cli`
8+
1. Open indy-cli by executing `indy-cli-rs`
119

1210
Note that the command prompt changed to `indy>`.
1311

0 commit comments

Comments
 (0)