Master Node Registration Guide

Server Requirements

• Operating System: Ubuntu 18.04 or higher

• Storage: Minimum 40GB

• RAM: 2-4 GB

• CPU: 1 Core

Step 1: Initial Master Node Setup

1. Add the Public Key: Install the public key required to verify and sign the Beldex Master Node packages:

   Copy

   sudo curl -L https://deb.beldex.io/pub.gpg | sudo apt-key add -

2. Add the Package Repository: Inform the package manager about the location of the Beldex repository:

   Copy

   echo "deb https://deb.beldex.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/beldex.list

3. Update Package Repositories: Resynchronize your package manager to include the new repository:

   Copy

   sudo apt update

4. Install the Master Node Package: Set up your Master Node by installing the required package:

   Copy

   sudo apt install beldex-master-node

   • This command will detect your public IP or prompt you to enter it manually and update the configuration file (/etc/beldex/beldex.conf) with the necessary settings.

Step 2: Verify Services Status

Beldex Node:

Check if the beldex-node service is running correctly:

systemctl status beldex-node.service

Command Output:

Beldex Storage Server:

Verify the status of the beldex-storage-server service:

systemctl status beldex-storage-server.service

Command Output:

Note: Ping to daemon will start after 57000 blocks

Belnet Router:

Confirm the belnet-router service is operational:

systemctl status belnet-router.service

Command Output:

Step 3: Check Status of the Daemon

Beldex Daemon:

• Verify the status of beldexd:

  Copy

  beldexd status

• If the Master Node public key and last pings are not displayed, restart the beldex-node service:

systemctl restart beldex-node.service

Status after received ping from the storage server and belnet

Note: Ping from storage server and belnet is mandatiry for master node registration

Step 4: Register Master Node

1. Once the node synchronization reaches 100%, prepare the Master Node registration:

   Copy

   beldexd prepare_registration

Enter the wallet address when prompted, and follow the instructions carefully.

After providing all the required prompt data, the register_master_node string will be generated.

Open the Electron Desktop wallet and enter the generated register_master_node string in the registration section as shown in the below screenshot

When you click the "Register Master Node" button, the Master Node will be successfully registered, and a confirmation message stating "Master Node registered successfully" will be displayed.

Congratulations !!! You are now successfully registerd the master node and the reward will be credited directly to the wallet which you used to regiuster the master node

Error Handling and Troubleshooting

1. Storage Server Not Pinging:

If the beldex-storage-server does not respond to pings in the beldexd status, restart the service:

systemctl restart beldex-storage-server.service

2. Belnet Router Not Pinging:

If the belnet-router ping is not received:

systemctl restart belnet-router.service

3. Belnet Router Bootstrap Error:

If belnet-router fails to bootstrap, follow these commands:

• Check the service status:

  Copy

  systemctl status belnet-router.service

• Navigate to the Belnet directory:

  Copy

  cd /var/lib/belnet

• Bootstrap Belnet:

  Copy

  belnet-bootstrap

• Restart the belnet-router service:

  Copy

  systemctl restart belnet-router.service

• This process ensures the belnet-bootstrap binary downloads the required files to /var/lib/belnet and initiates pings.