1
1
## Advanced User Guide
2
-
3
2
For those who would like to have more control or need some customized setups, here are some step by step instructions of how to setup and deploy a solo network.
4
-
5
3
### Setup Kubernetes cluster
6
4
7
5
#### Remote cluster
@@ -30,7 +28,6 @@ Then run the following command to set the kubectl context to the new cluster:
30
28
``` bash
31
29
kind create cluster -n " ${SOLO_CLUSTER_NAME} "
32
30
```
33
-
34
31
Example output
35
32
36
33
```
@@ -46,11 +43,12 @@ You can now use your cluster with:
46
43
47
44
kubectl cluster-info --context kind-solo
48
45
49
- Thanks for using kind! 😊
46
+ Have a nice day! 👋
50
47
```
51
48
52
49
You may now view pods in your cluster using ` k9s -A ` as below:
53
50
51
+
54
52
```
55
53
Context: kind-solo <0> all <a> Attach <ctr… ____ __.________
56
54
Cluster: kind-solo <ctrl-d> Delete <l> | |/ _/ __ \______
@@ -77,6 +75,7 @@ You may now view pods in your cluster using `k9s -A` as below:
77
75
└─────────────────────────────────────────────────────────────────────────────────────────────────────────────────┘
78
76
```
79
77
78
+
80
79
### Step by Step Instructions
81
80
82
81
* Initialize ` solo ` directories:
@@ -93,7 +92,7 @@ solo init
93
92
```
94
93
95
94
******************************* Solo *********************************************
96
- Version : 0.33 .0
95
+ Version : 0.34 .0
97
96
Kubernetes Context : kind-solo
98
97
Kubernetes Cluster : kind-solo
99
98
**********************************************************************************
@@ -120,7 +119,7 @@ solo node keys --gossip-keys --tls-keys -i node1,node2,node3
120
119
```
121
120
122
121
******************************* Solo *********************************************
123
- Version : 0.33 .0
122
+ Version : 0.34 .0
124
123
Kubernetes Context : kind-solo
125
124
Kubernetes Cluster : kind-solo
126
125
**********************************************************************************
@@ -131,22 +130,19 @@ Kubernetes Cluster : kind-solo
131
130
✔ Gossip key for node: node3
132
131
✔ Generate gossip keys
133
132
✔ Backup old files
134
- ✔ TLS key for node: node3
135
133
✔ TLS key for node: node2
136
134
✔ TLS key for node: node1
135
+ ✔ TLS key for node: node3
137
136
✔ Generate gRPC TLS Keys
138
137
✔ Finalize
139
138
```
140
-
141
139
PEM key files are generated in ` ~/.solo/keys ` directory.
142
-
143
140
```
144
141
hedera-node1.crt hedera-node3.crt s-private-node1.pem s-public-node1.pem unused-gossip-pem
145
142
hedera-node1.key hedera-node3.key s-private-node2.pem s-public-node2.pem unused-tls
146
143
hedera-node2.crt hedera-node4.crt s-private-node3.pem s-public-node3.pem
147
144
hedera-node2.key hedera-node4.key s-private-node4.pem s-public-node4.pem
148
145
```
149
-
150
146
* Setup cluster with shared components
151
147
152
148
```
@@ -158,10 +154,11 @@ solo cluster setup -s "${SOLO_CLUSTER_SETUP_NAMESPACE}"
158
154
```
159
155
160
156
******************************* Solo *********************************************
161
- Version : 0.33 .0
157
+ Version : 0.34 .0
162
158
Kubernetes Context : kind-solo
163
159
Kubernetes Cluster : kind-solo
164
160
**********************************************************************************
161
+ Current deployment name is not set in local config
165
162
✔ Initialize
166
163
✔ Prepare chart values
167
164
✔ Install 'solo-cluster-setup' chart
@@ -184,36 +181,36 @@ solo network deploy -i node1,node2,node3 -n "${SOLO_NAMESPACE}"
184
181
```
185
182
186
183
******************************* Solo *********************************************
187
- Version : 0.33 .0
184
+ Version : 0.34 .0
188
185
Kubernetes Context : kind-solo
189
186
Kubernetes Cluster : kind-solo
190
187
Kubernetes Namespace : solo
191
188
**********************************************************************************
189
+ remote config not found
192
190
✔ Acquire lease - lease acquired successfully, attempt: 1/10
193
191
✔ Initialize
194
- ✔ Load remote config - remote config not found
195
192
✔ Check if cluster setup chart is installed
196
193
✔ Copy Gossip keys to staging
197
194
✔ Copy gRPC TLS keys to staging
198
195
✔ Prepare staging directory
199
196
✔ Copy Gossip keys
200
- ✔ Node: node2
201
- ✔ Copy TLS keys
202
- ✔ Copy Gossip keys
203
197
✔ Node: node3
204
198
✔ Copy Gossip keys
205
199
✔ Node: node1
200
+ ✔ Copy TLS keys
201
+ ✔ Copy Gossip keys
202
+ ✔ Node: node2
206
203
✔ Copy node keys to secrets
207
204
✔ Install chart 'solo-deployment'
208
205
✔ Check Node: node1
209
206
✔ Check Node: node2
210
207
✔ Check Node: node3
211
208
✔ Check node pods are running
209
+ ✔ Check Envoy Proxy for: node3
212
210
✔ Check Envoy Proxy for: node1
211
+ ✔ Check HAProxy for: node2
213
212
✔ Check Envoy Proxy for: node2
214
213
✔ Check HAProxy for: node1
215
- ✔ Check Envoy Proxy for: node3
216
- ✔ Check HAProxy for: node2
217
214
✔ Check HAProxy for: node3
218
215
✔ Check proxy pods are running
219
216
✔ Check MinIO
@@ -232,31 +229,31 @@ solo node setup -i node1,node2,node3 -n "${SOLO_NAMESPACE}"
232
229
```
233
230
234
231
******************************* Solo *********************************************
235
- Version : 0.33 .0
232
+ Version : 0.34 .0
236
233
Kubernetes Context : kind-solo
237
234
Kubernetes Cluster : kind-solo
238
235
Kubernetes Namespace : solo
239
236
**********************************************************************************
237
+ remote config not found
240
238
✔ Acquire lease - lease acquired successfully, attempt: 1/10
241
239
✔ Initialize
242
- ✔ Load remote config - remote config not found
243
- ✔ Check network pod: node1
244
240
✔ Check network pod: node2
241
+ ✔ Check network pod: node1
245
242
✔ Check network pod: node3
246
243
✔ Identify network pods
247
- ✔ Update node: node2 [ platformVersion = v0.58.3 ]
248
- ✔ Update node: node3 [ platformVersion = v0.58.3 ]
249
- ✔ Update node: node1 [ platformVersion = v0.58.3 ]
244
+ ✔ Update node: node2 [ platformVersion = v0.59.0-main.x5322bdc ]
245
+ ✔ Update node: node3 [ platformVersion = v0.59.0-main.x5322bdc ]
246
+ ✔ Update node: node1 [ platformVersion = v0.59.0-main.x5322bdc ]
250
247
✔ Fetch platform software into network nodes
251
248
✔ Copy configuration files
252
249
✔ Copy configuration files
253
250
✔ Copy configuration files
254
251
✔ Set file permissions
252
+ ✔ Node: node2
253
+ ✔ Set file permissions
255
254
✔ Node: node1
256
255
✔ Set file permissions
257
256
✔ Node: node3
258
- ✔ Set file permissions
259
- ✔ Node: node2
260
257
✔ Setup network nodes
261
258
```
262
259
@@ -271,25 +268,25 @@ solo node start -i node1,node2,node3 -n "${SOLO_NAMESPACE}"
271
268
```
272
269
273
270
******************************* Solo *********************************************
274
- Version : 0.33 .0
271
+ Version : 0.34 .0
275
272
Kubernetes Context : kind-solo
276
273
Kubernetes Cluster : kind-solo
277
274
Kubernetes Namespace : solo
278
275
**********************************************************************************
276
+ remote config not found
279
277
✔ Acquire lease - lease acquired successfully, attempt: 1/10
280
278
✔ Initialize
281
- ✔ Load remote config - remote config not found
282
- ✔ Check network pod: node3
283
279
✔ Check network pod: node1
284
280
✔ Check network pod: node2
281
+ ✔ Check network pod: node3
285
282
✔ Identify existing network nodes
286
- ✔ Start node: node1
287
283
✔ Start node: node3
288
284
✔ Start node: node2
285
+ ✔ Start node: node1
289
286
✔ Starting nodes
290
- ✔ Check network pod: node2 - status ACTIVE, attempt: 18 /120
291
- ✔ Check network pod: node1 - status ACTIVE, attempt: 18 /120
292
- ✔ Check network pod: node3 - status ACTIVE, attempt: 18 /120
287
+ ✔ Check network pod: node1 - status ACTIVE, attempt: 19 /120
288
+ ✔ Check network pod: node2 - status ACTIVE, attempt: 19 /120
289
+ ✔ Check network pod: node3 - status ACTIVE, attempt: 19 /120
293
290
✔ Check all nodes are ACTIVE
294
291
✔ Check proxy for node: node1
295
292
✔ Check proxy for node: node2
@@ -312,19 +309,17 @@ solo mirror-node deploy -n "${SOLO_NAMESPACE}"
312
309
```
313
310
314
311
******************************* Solo *********************************************
315
- Version : 0.33 .0
312
+ Version : 0.34 .0
316
313
Kubernetes Context : kind-solo
317
314
Kubernetes Cluster : kind-solo
318
315
Kubernetes Namespace : solo
319
316
**********************************************************************************
317
+ remote config not found
320
318
✔ Acquire lease - lease acquired successfully, attempt: 1/10
321
319
✔ Initialize
322
- ✔ Load remote config - remote config not found
323
320
✔ Prepare address book
324
321
✔ Deploy mirror-node
325
- ✔ Deploy hedera-explorer
326
322
✔ Enable mirror-node
327
- ✔ Check Hedera Explorer
328
323
✔ Check Postgres DB
329
324
✔ Check REST API
330
325
✔ Check GRPC
@@ -346,14 +341,14 @@ solo relay deploy -i node1 -n "${SOLO_NAMESPACE}"
346
341
```
347
342
348
343
******************************* Solo *********************************************
349
- Version : 0.33 .0
344
+ Version : 0.34 .0
350
345
Kubernetes Context : kind-solo
351
346
Kubernetes Cluster : kind-solo
352
347
Kubernetes Namespace : solo
353
348
**********************************************************************************
349
+ remote config not found
354
350
✔ Acquire lease - lease acquired successfully, attempt: 1/10
355
351
✔ Initialize
356
- ✔ Load remote config - remote config not found
357
352
✔ Prepare chart values
358
353
✔ Deploy JSON RPC Relay
359
354
✔ Check relay is ready
0 commit comments