Quilibrium.one
SocialOfficial
Quilibrium Node Guide
Quilibrium Node Guide
  • 🖖Introduction
  • ✅Safety checks
  • đŸ“ŖAnnouncements
  • 🔗Links & Info
  • đŸ’ģBest server providers
  • đŸ’ģHardware requirements
  • 😎Q1 - Node Manager
  • ⚡Node Auto-installer
  • âŦ†ī¸Updating your node
  • âœ”ī¸Check your node info
  • 🔑Backup your private keys
  • đŸ“ĻBackup your node
  • 🔁Set up the gRPC calls
  • đŸ› ī¸Tools and scripts
  • 🔧Extra tools
  • 🔠Useful commands
  • â‰ī¸Troubleshooting
  • 📌Tutorials
    • Node
      • đŸ”ĸNode step by step installation
      • đŸŗInstalling the node on Docker
      • đŸĒŸInstalling the node and the qclient on Windows WSL
      • â†—ī¸Migrating the node to a new server
      • â„šī¸Running the node via binary file
      • Running a node cluster
      • ✅Reinstalling the node from scratch
      • âš™ī¸Managing your system resources
        • â˜‘ī¸Limiting your vCores usage
        • â˜‘ī¸Limiting your CPU usage
        • â˜‘ī¸Limiting the RAM assigned to each vCore
      • 🔄Switching from tmux to service
      • 💲Log your node balance every 1 hour
      • 🩷Escaping the "Pink Screen of Death"
      • 🔒Set up SSH keys
      • 🔒Creating a root login access
      • 👀Renting Servers Unveiled: Exploring Types and Processor Terminology
    • Qclient
      • Qclient commands
      • How to transfer QUIL
      • How to Bridge QUIL to WQUIL
      • How to retrieve your coin address after a failed bridging operation
  • 📂Archive
    • ⚡OLD - Node Auto-installer
    • đŸ”ĸOLD - Node step by step installation
    • 🔠OLD - Useful server commands
    • â‰ī¸OLD Troubleshooting
    • âŦ†ī¸OLD Updating your node
    • ⚡Importing an existing store folder for fast sync
    • â˜‘ī¸Changing the cpulimit value in release_autorun
  • âš ī¸Work in progress
  • 💜Want to say thank you?
Powered by GitBook
On this page
  • Panic: resource temporarily unavailable
  • Command GO not found
  • Node not visible to bootstrap peers
  • gRPCurl not found
  • Remove gRPC calls settings from config.yml
  • How to debug your config.yml
  • Frame number: 0
  • Panic: get parent data clock frame: item not found

Troubleshooting

Panic: resource temporarily unavailable

This error means you have an already running instance of the node. Follow the step below to kill all nodes and restart just one instance.


Command GO not found

Check your .bashrc file

cat ~/.bashrc

At the very end you should see

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

If there are duplicates, remove them, save and exit and then run source ~/.bashrc

If instead those lines are not there, add them by running this command.

echo -e "\nexport GOROOT=/usr/local/go\nexport GOPATH=\$HOME/go\nexport PATH=\$GOPATH/bin:\$GOROOT/bin:\$PATH" >> ~/.bashrc && source ~/.bashrc

Now try again to do whatever you were doing.

If you still get the command GO not found error you may try to simply export those variable temporarily, by running

export GOROOT=/usr/local/go
export GOPATH=$HOME/go
export PATH=$GOPATH/bin:$GOROOT/bin:$PATH

See if this fixes the issue. If it does, keep in mind that you will have to run again those variable every time you reboot your server, because they are active only temporarily.


Node not visible to bootstrap peers

The first thing to do is to check your node/.config/config.yml file and see if all the settings are correct.

Got to Set up the gRPC calls , run the automatic script but also check manually to be sure.

Check also that your 8336 port is open, run sudo ufw status, the response should be similar to this one:

Status: active

To                         Action      From
--                         ------      ----
22                         ALLOW       Anywhere                  
8336                       ALLOW       Anywhere                  
443                        ALLOW       Anywhere                  
22 (v6)                    ALLOW       Anywhere (v6)             
8336 (v6)                  ALLOW       Anywhere (v6)             
443 (v6)                   ALLOW       Anywhere (v6)     

gRPCurl not found

Try the same solution as Command GO not found


Remove gRPC calls settings from config.yml

If you want to remove the gRPC calls setting from your config.yml file here is what you have to do:

  1. Open the file root/ceremonyclient/node/.config/config.yml on your local pc using WinSCP

  2. Find listenGrpcMultiaddr: /ip4/127.0.0.1/tcp/8337 and replace it with listenGrpcMultiaddr: “”

  3. Find statsMultiaddr: "dns/stats.quilibrium.com/tcp/443" and remove the line completely now your config.yml should be as it was generated by the node itself


How to debug your config.yml

A simple way to debug your config.yml file if you are not a dev is to create a node from scratch and download locally the config.yml file. Then download the config.yml of your working node, the one you have edited either via a script or manually.

The encryption keys will be different of course, and you may have some more lines in the "bootstrapPeers" section of one of the files, but you should easily see the lines you have added or if there is any typing error in the file you edited.


Frame number: 0

If you see Frame number:0 in your node log for a long time, one way to debug is to check if access to the network is healthy and that port 8336 is accessible remotely.

  1. From your local PC or a system other than the node:

  2. Make sure you have netcat installed: sudo apt install netcat

  3. Confirm reachability of bootstrap: nc -vzu YOUR_SERVER_IP 8336 Replace YOUR_SERVER_IP with your node's IP*


Panic: get parent data clock frame: item not found

If you imported an external "store" folder to kickstart your node synchronization, you may see this error, while the node keeps crashing. Stop the node, delete the "SELF_TEST" file from your ".config" folder, and restart the node. If this doesn't solve, try to import in the ".config" folder the "REPAIR" file from another working node, and delete the existing one. Give the node 10–15 minutes to see if everything works correctly.


PreviousUseful commandsNextTutorials

Last updated 1 month ago

If by checking here your node is not visible, you may lose rewards.

Then restart your node, wait 15 minutes and check again on

At this point, use a tool such as , to compare the 2 files.

â‰ī¸
https://dashboard.quilibrium.com/
https://dashboard.quilibrium.com/
Diffinity
Cover

Want to say thank you?

CLICK TO DONATE