treeherder/docs/troubleshooting.md

1.5 KiB

Troubleshooting

Errors during Vagrant setup

  • The Vagrant provisioning process during vagrant up --provision assumes the presence of a stable internet connection. In the event of a connection interruption during provision, you may see errors similar to "Temporary failure resolving.." or "E: Unable to fetch some archives.." after the process has completed. In that situation, you can attempt to re-provision using the command:

    > vagrant provision
    

    If that is still unsuccessful, you should attempt a vagrant destroy followed by another vagrant up --provision.

  • If you encounter an error saying "mount.nfs: requested NFS version or transport protocol is not supported", you should restart the kernel server service using this sequence of commands:

    systemctl stop nfs-kernel-server.service
    systemctl disable nfs-kernel-server.service
    systemctl enable nfs-kernel-server.service
    systemctl start nfs-kernel-server.service
    
  • If you encounter an error saying:

    "The guest machine entered an invalid state while waiting for it to boot. Valid states are 'starting, running'. The machine is in the 'poweroff' state. Please verify everything is configured properly and try again."

    ...you should check your host machine's virtualization technology (vt-x) is enabled in the BIOS (see this guide), then continue with vagrant up --provision.