testnet-laconicd-stack/stack-orchestrator/stacks/laconicd-full-node/README.md

110 lines
2.3 KiB
Markdown

# laconicd-full-node
Instructions for deploying a laconicd full node along with steps to join testnet as a validator post genesis
Minimum hardware requirements:
- RAM: 8-16GB
- Disk space: 200GB
- CPU: 2 cores
## Clone the stack repo
```bash
laconic-so fetch-stack git.vdb.to/cerc-io/testnet-laconicd-stack
```
## Clone required repositories
```bash
laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconicd-full-node setup-repositories
```
## Build the fixturenet-eth containers
```bash
laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconicd-full-node build-containers
```
This should create several container images in the local image registry:
* cerc/laconic2d
* cerc/laconic-registry-cli
* cerc/webapp-base
* cerc/laconic-console-host
## Create a spec file for the deployment
```bash
laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconicd-full-node deploy init --output laconic-full-node-spec.yml
```
## Ports
Edit `network` in the spec file to map container ports to host ports as required:
```bash
...
network:
# TODO: UPDATE
ports:
laconicd:
- '6060:6060'
- '26657:26657'
- '26656:26656'
- '9473:9473'
- '9090:9090'
- '1317:1317'
```
## Create a deployment from the spec file
```bash
laconic-so --stack ~/cerc/testnet-laconicd-stack/stack-orchestrator/stacks/laconicd-full-node deploy create --spec-file laconic-full-node-spec.yml --deployment-dir laconic-full-node-deployment
```
### Configuration
Copy genesis file to the deployment data directory:
```bash
# Example
cp genesis.json laconic-full-node-deployment/data/laconicd-config/
```
Inside deployment directory, open the `config.env` file and set following env variables:
```bash
# TODO: UPDATE
# External Filecoin (ETH RPC) endpoint to point the watcher to
CERC_PEERS=""
```
## Start the deployment
```bash
laconic-so deployment --dir laconic-full-node-deployment start
```
## Check status
<!-- TODO -->
## Join as testnet validator
<!-- TODO import a funded account / create an account and get it funded -->
<!-- TODO create a validator-->
## Clean up
Stop all services running in the background:
```bash
laconic-so deployment --dir laconic-full-node-deployment stop
```
Clear volumes created by this stack:
<!-- TODO -->