[#906] neofs-adm/docs: Fix notes from Fyrchik

Signed-off-by: Alex Vanin <alexey@nspcc.ru>
This commit is contained in:
Alex Vanin 2021-10-11 18:29:00 +03:00 committed by Alex Vanin
parent 6c155f62c4
commit e500bd13a9
2 changed files with 26 additions and 21 deletions

View file

@ -3,7 +3,7 @@
## Overview ## Overview
Admin tool provides an easier way to deploy and maintain private installation Admin tool provides an easier way to deploy and maintain private installation
of NeoFS. Private installation provides a set of consensus N3 nodes, NeoFS of NeoFS. Private installation provides a set of N3 consensus nodes, NeoFS
Alphabet, and Storage nodes. Admin tool generates consensus keys, initializes Alphabet, and Storage nodes. Admin tool generates consensus keys, initializes
side chain, and provides functions to update the network and register new side chain, and provides functions to update the network and register new
Storage nodes. Storage nodes.
@ -44,23 +44,23 @@ network:
container: 0 # container creation fee, for private installation consider 0 container: 0 # container creation fee, for private installation consider 0
withdraw: 0 # withdraw fee, for private installation consider 0 withdraw: 0 # withdraw fee, for private installation consider 0
credentials: # passwords for consensus node / alphabet wallets credentials: # passwords for consensus node / alphabet wallets
az: ... az: password1
buky: ... buky: password2
vedi: ... vedi: password3
glagoli: ... glagoli: password4
dobro: ... dobro: password5
yest: ... yest: password6
zhivete: ... zhivete: password7
``` ```
### Morph ### Morph
#### Network deployment #### Network deployment
- Use `generate-alphabet` to generate a set of wallets for consensus and - `generate-alphabet` generates a set of wallets for consensus and
Alphabet nodes. Alphabet nodes.
- `init` will initialize side chain by deploying smart contracts and - `init` initializes side chain by deploying smart contracts and
setting provided NeoFS network configuration. setting provided NeoFS network configuration.
- `generate-storage-wallet` generates wallet for the Storage node that - `generate-storage-wallet` generates wallet for the Storage node that
@ -69,12 +69,12 @@ credentials: # passwords for consensus node / alphabet wallets
#### Network maintenance #### Network maintenance
- `force-new-epoch` increments NeoFS epoch number and enforces new epoch - `force-new-epoch` increments NeoFS epoch number and executes new epoch
handlers in NeoFS nodes. handlers in NeoFS nodes.
- `refill-gas` transfers side chain GAS to the specified wallet. - `refill-gas` transfers side chain GAS to the specified wallet.
- `update-contracts` starts contract update routine. - `update-contracts` updates contracts to a new version.
#### Container migration #### Container migration

View file

@ -15,11 +15,11 @@ To follow this guide you need:
## Step 1: Prepare network configuration ## Step 1: Prepare network configuration
To start the network, you need a set of consensus nodes, the same number of To start the network, you need a set of consensus nodes, the same number of
Alphabet nodes and Storage nodes. While the number of Storage nodes can be Alphabet nodes and any number of Storage nodes. While the number of Storage
scaled almost infinitely, the number of consensus and Alphabet nodes can't be changed nodes can be scaled almost infinitely, the number of consensus and Alphabet
so easily right now. Consider this before going any further. nodes can't be changed so easily right now. Consider this before going any further.
`neofs-adm` works best with predefined configuration. First, create It is easier to use`neofs-adm` with predefined configuration. First, create
network configuration file. In this example, there is going to be only one network configuration file. In this example, there is going to be only one
consensus / Alphabet node in the network. consensus / Alphabet node in the network.
@ -47,13 +47,14 @@ For private installation it is recommended to set all **fees** and **basic
income rate** to 0. income rate** to 0.
As for **epoch duration**, consider consensus node block generation frequency. As for **epoch duration**, consider consensus node block generation frequency.
With default 15 sec per block, 240 blocks are going to be a 1-hour epoch. With default 15 seconds per block, 240 blocks are going to be a 1-hour epoch.
For **max object size**, 67108864 (64 MiB) or 134217728 (128 MiB) should provide For **max object size**, 67108864 (64 MiB) or 134217728 (128 MiB) should provide
good chunk distribution in most cases. good chunk distribution in most cases.
With this config, generate wallets (private keys) of consensus / Alphabet nodes. With this config, generate wallets (private keys) of consensus nodes. The same
Make sure, that dir for alphabet wallets already exists. wallets will be used for Alphabet nodes. Make sure, that dir for alphabet
wallets already exists.
``` ```
$ neofs-adm -c foo.network.yml morph generate-alphabet --size 1 $ neofs-adm -c foo.network.yml morph generate-alphabet --size 1
@ -88,12 +89,16 @@ NiMKabp3ddi3xShmLAXhTfbnuWb4cSJT6E (1 out of 1 multisig contract):
Put the list of public keys into `ProtocolConfiguration.StandbyCommittee` Put the list of public keys into `ProtocolConfiguration.StandbyCommittee`
section. Specify the wallet path and the password in `ApplicationConfiguration.P2PNotary` section. Specify the wallet path and the password in `ApplicationConfiguration.P2PNotary`
and `ApplicationConfiguration.UnlockWallet` sections. and `ApplicationConfiguration.UnlockWallet` sections. If config includes
`ProtocolConfiguration.NativeActivations` section, then add notary
contract `Notary: [0]`.
```yaml ```yaml
ProtocolConfiguration: ProtocolConfiguration:
StandbyCommittee: StandbyCommittee:
- 02c1cc85f9c856dbe2d02017349bcb7b4e5defa78b8056a09b3240ba2a8c078869 - 02c1cc85f9c856dbe2d02017349bcb7b4e5defa78b8056a09b3240ba2a8c078869
NativeActivations:
Notary: [0]
ApplicationConfiguration: ApplicationConfiguration:
P2PNotary: P2PNotary:
Enabled: true Enabled: true