Validator Node Setup

This guide provides a step-by-step process for using the qubetics_ubuntu_node.sh script to set up and run a Qubetics node. Please follow the instructions carefully to ensure a successful setup and dep

Prerequisites

System Requirements

  • Operating System: Ubuntu 22.04

  • Memory: At least 4GB RAM

  • Storage: Minimum 20GB available disk space

  • Network: Stable internet connection

Tools and Dependencies

Ensure the following tools are installed:

  • Go ( by running the install_go.sh script )

  • Jq

  • Bash

  • wget

  • unzip

  • build-essential

All of these installations are already covered in the qubeticsnode.sh script.

Step 1: Prepare Your Environment

  1. Run as Root or with Sudo Privileges: Ensure the script is executed with root privileges. If not, you may encounter permission issues. sudo su

2. Clone the Repo: Clone the repository and change into the directory. git clone https://github.com/pooja-lokhande/qubeticsnode-script.git

cd qubeticsnode-scriptqubeticsnode

Step 2: Execute the Script

Run the Script

Execute the script to install the required components and set up the node. ./qubetics_ubuntu_node.sh

Key Configuration Prompts

  • If a previous node configuration exists, you will be prompted to overwrite it. Choose y to overwrite or n to retain the existing setup.

  • Save the generated keys and mnemonics securely when prompted. These are essential for accessing your node.

Step 3: Verify Installation

  1. Validate Genesis: Ensure the genesis file is properly configured. qubeticsd validate-genesis --home /data/.tmp-qubeticsd

  2. Display Node Information: After setup, the script displays important node details:

  • Tendermint Public Key

  • Bech32 Address

  • Node ID

Record these details for future reference.

Step 4: Start the Node

The script automatically sets up and starts the node as a system service.

Manage the Node Service

  • Start the Service: sudo systemctl start qubeticschain.service

  • Check the Service Status: sudo systemctl status qubeticschain.service

  • Enable the Service to Start on Boot: sudo systemctl enable qubeticschain.service

Additional Configurations

Update Configurations

The script automatically modifies configuration files located in /data/.tmp-qubeticsd/config/.

  • Timeout Settings: Adjusted for optimal performance.

  • Gas Prices: Set to 0.25tics.

  • Networking: Configured to listen on all interfaces (0.0.0.0).

Persistent Peers

The script includes default persistent peers to facilitate P2P communication. To add or modify peers, edit the config.toml file.

nano /data/.tmp-qubeticsd/config/config.toml

Troubleshooting

Common Issues

  1. Dependency Errors: Ensure all dependencies (e.g., jq, go) are installed before running the script. sudo apt-get install -y jq build-essential wget unzip

  2. Service Not Starting: Check logs for detailed error messages: sudo journalctl -u qubeticschain.service -f

  3. Genesis File Validation Failed: Verify the Genesis file contents and ensure they match the required network configuration.

Maintenance

Restart the Node

sudo systemctl restart qubeticschain.service

Stop the Node

sudo systemctl stop qubeticschain.service

For example: The node IP is same as the node URL along with the port 26657.

Node rpc-url: https://dev-vd-rpc.qubetics.work/

Last updated