laconicd/testnet/full_node.md

# Instructions to Run Full Node

## Hardware

#### Supported

- **Operating System (OS):** Ubuntu 20.04
- **CPU:** 1 core
- **RAM:** 2GB
- **Storage:** 25GB SSD

#### Recommended

- **Operating System (OS):** Ubuntu 20.04
- **CPU:** 2 core
- **RAM:** 4GB
- **Storage:** 50GB SSD

# A) Setup

## 1) Install Golang (go)

1.1) Remove any existing installation of `go`

```
sudo rm -rf /usr/local/go
```

1.2) Install latest/required Go version (installing `go1.17.2`)

```
curl https://golang.org/dl/go1.17.2.linux-amd64.tar.gz
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.17.2.linux-amd64.tar.gz
```

1.3) Update env variables to include `go`

```
cat <<'EOF' >>$HOME/.profile
export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export GO111MODULE=on
export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin
EOF

source $HOME/.profile
```

1.4) Check the version of go installed

```
go version
```

### 2) Install required software packages

```
sudo apt-get install git curl build-essential make jq -y
```

### 3) Install `laconicd`

```
git clone https://github.com/cerc-io/laconicd.git
cd laconicd
git fetch --all
git checkout main
make install
```

### 4) Verify your installation

```
laconicd version --long
```

On running the above command, you should see a similar response like this. Make sure that the _version_ and _commit
hash_ are accurate

```
name: laconicd
server_name: laconicd
```

### 5) Initialize Node

**Not required if you have already initialized before**

```
laconicd init <your-node-moniker> --chain-id laconic_81337-2
```

On running the above command, node will be initialized with default configuration. (config files will be saved in node's
default home directory (~/.laconicd/config)

NOTE: Backup node and validator keys . You will need to use these keys at a later point in time.

---

# B) Starting Node

## 1) Download Final Genesis

Use `curl` to download the genesis file
**Replace your **genesis** file with published genesis file**

```shell
# Will be updated
curl {GENESIS_LINK} | jq .result.genesis > ~/.laconicd/config/genesis.json
```

Verify sha256 hash of genesis file with the below command

```
jq -S -c -M '' ~/.laconicd/config/genesis.json | shasum -a 256
```

genesis sha256 hash should be

```
{WILL BE UPDATED}
```

## 2) Update Peers & Seeds in config.toml

```
<!-- Note: don't use peers
peers="5ad2e6c35f2c84ff3ee31d89a95b34d92cb6afb1@157.230.101.237:26656,defc95b08547b6ef254723ad9621967a7e819020@161.35.223.44:26656" -->

{peers={WILL BE UPDATED}}
sed -i.bak -e "s/^persistent_peers *=.*/persistent_peers = \"$peers\"/" ~/.laconicd/config/config.toml
```

## 3) Start the Full Node

#### 3.1) Start node as `systemctl` service

3.1.1) Create the service file

```
sudo tee /etc/systemd/system/laconicd.service > /dev/null <<EOF
[Unit]
Description=laconicd Daemon
After=network-online.target

[Service]
User=$USER
ExecStart=$(which laconicd) start --gql-playground --gql-server
Restart=always
RestartSec=3
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

```

3.1.2) Load service and start

```
sudo systemctl daemon-reload
sudo systemctl enable laconicd
sudo systemctl start laconicd

```

3.1.3) Check status of service

```

sudo systemctl status laconicd

```

`NOTE:`
A helpful command here is `journalctl` that can be used to:

a) check logs

```

journalctl -u laconicd

```

b) most recent logs

```

journalctl -xeu laconicd

```

c) logs from previous day

```

journalctl --since "1 day ago" -u laconicd

```

d) Check logs with follow flag

```

journalctl -f -u laconicd

```