Skip to content

Commit

Permalink
docs/deploying-a-runtime: include runtime genesis state param
Browse files Browse the repository at this point in the history
  • Loading branch information
ptrus committed Sep 2, 2020
1 parent b864d0f commit b723d09
Show file tree
Hide file tree
Showing 2 changed files with 13 additions and 0 deletions.
4 changes: 4 additions & 0 deletions .changelog/3228.doc.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
docs/deploying-a-runtime: include runtime genesis state parameter

Also adds a note about required `worker.p2p.addresses` &
`worker.client.addresses` flags in a production network.
9 changes: 9 additions & 0 deletions docs/setup/deploying-a-runtime.md
Original file line number Diff line number Diff line change
Expand Up @@ -93,6 +93,8 @@ network. (defaults to: `/tmp/runtime-example/net-runner/network/genesis.json`).
identifier. In this example we use
`8000000000000000000000000000000000000000000000000000000001234567`, which is a
test identifier and will not work outside local tests.
- `RUNTIME_GENESIS_JSON` - Path to the runtime genesis state file. The runtime
used in this example does not use a genesis file.
- `NONCE` - Entity account nonce. If you followed the guide, nonce `0`
would be the initial nonce to use for the entity. Note: make sure to keep
updating the nonce when generating new transactions. To query for current
Expand All @@ -103,6 +105,7 @@ export ENTITY_DIR=/tmp/runtime-example/net-runner/network/entity-2/
export ENTITY_ID=+MJpnSTzc11dNI5emMa+asCJH5cxBiBCcpbYE4XBdso=
export GENESIS_JSON=/tmp/runtime-example/net-runner/network/genesis.json
export RUNTIME_ID=8000000000000000000000000000000000000000000000000000000001234567
export RUNTIME_GENESIS_JSON=""
export NONCE=0
```

Expand All @@ -120,6 +123,7 @@ oasis-node registry runtime gen_register \
--signer.dir $ENTITY_DIR \
--runtime.id $RUNTIME_ID \
--runtime.kind compute \
--runtime.genesis.state $RUNTIME_GENESIS_JSON \
--runtime.executor.group_size 1 \
--runtime.storage.group_size 1 \
--runtime.admission_policy entity-whitelist \
Expand Down Expand Up @@ -244,6 +248,11 @@ This also enables unsafe debug-only flags which must never be used in a
production setting as they may result in node compromise.
{% endhint %}

{% hint style="info" %}
When running a runtime node in a production setting, the `worker.p2p.addresses`
and `worker.client.addresses` flags need to be configured as well.
{% endhint %}

Following steps should be run in a new terminal window.

## Updating Entity Nodes
Expand Down

0 comments on commit b723d09

Please sign in to comment.