Skip to content

Commit

Permalink
added troubleshooting farming section
Browse files Browse the repository at this point in the history
  • Loading branch information
Mik-TF committed May 28, 2024
1 parent 189e2bc commit 2e20697
Show file tree
Hide file tree
Showing 7 changed files with 516 additions and 505 deletions.
1 change: 1 addition & 0 deletions src/SUMMARY.md
Original file line number Diff line number Diff line change
Expand Up @@ -171,6 +171,7 @@
- [Farming Costs](documentation/farmers/farming_optimization/farming_costs.md)
- [Calculate Your ROI](documentation/farmers/farming_optimization/calculate_roi.md)
- [Farming Requirements](documentation/farmers/farming_optimization/farming_requirements.md)
- [Farming Troubleshooting](documentation/farmers/farming_optimization/farming_troubleshooting.md)
- [Advanced Networking](documentation/farmers/advanced_networking/advanced_networking_toc.md)
- [Networking Overview](documentation/farmers/advanced_networking/networking_overview.md)
- [Network Considerations](documentation/farmers/advanced_networking/network_considerations.md)
Expand Down
484 changes: 0 additions & 484 deletions src/documentation/faq/faq.md

Large diffs are not rendered by default.

15 changes: 3 additions & 12 deletions src/documentation/farmers/3node_building/4_wipe_all_disks.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,7 +7,6 @@
- [1. Create a Linux Bootstrap Image](#1-create-a-linux-bootstrap-image)
- [2. Boot Linux in *Try Mode*](#2-boot-linux-in-try-mode)
- [3. Use wipefs to Wipe All the Disks](#3-use-wipefs-to-wipe-all-the-disks)
- [Troubleshooting](#troubleshooting)

***

Expand Down Expand Up @@ -68,23 +67,23 @@ fdisk -l
If you want to wipe one specific disk, here we use *sda* as an example, write this command:

```
sudo wipefs -a /dev/sda
sudo wipefs -af /dev/sda
```

And replace the "a" in sda by the letter of your disk, as shown when you did *lsblk*. The term *sudo* gives you the correct permission to do this.

To wipe all the disks in your 3Node, write the command:

```
sudo for i in /dev/sd*; do wipefs -a $i; done
sudo for i in /dev/sd*; do wipefs -af $i; done
```

If you have any `fdisk` entries that look like `/dev/nvme`, you'll need to adjust the command line.

For a nvme disk, here we use *nvme0* as an example, write:

```
sudo wipefs -a /dev/nvme0
sudo wipefs -af /dev/nvme0
```

And replace the "0" in nvme0 by the number corresponding to your disk, as shown when you did *lsblk*.
Expand All @@ -95,12 +94,4 @@ To wipe all the nvme disks, write this command line:
sudo for i in /dev/nvme*; do wipefs -a $i; done
```

## Troubleshooting

If you're having issues wiping the disks, you might need to use **--force** or **-f** with wipefs (e.g. **sudo wipefs -af /dev/sda**).

If you're having trouble getting your disks recognized by Zero-OS, some farmers have had success enabling AHCI mode for SATA in their BIOS.

If you are using a server with onboard storage, you might need to [re-flash the RAID card](../../faq/faq.md#is-there-a-way-to-bypass-raid-in-order-for-zero-os-to-have-bare-metals-on-the-system-no-raid-controller-in-between-storage-and-the-grid).


8 changes: 0 additions & 8 deletions src/documentation/farmers/3node_building/5_set_bios_uefi.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,6 @@
- [Update the BIOS firmware](#update-the-bios-firmware)
- [Additional Information](#additional-information)
- [BIOS/UEFI and Zero-OS Bootstrap Image Combinations](#biosuefi-and-zero-os-bootstrap-image-combinations)
- [Troubleshoot](#troubleshoot)


***
Expand Down Expand Up @@ -163,10 +162,3 @@ Refer to [this previous section](./2_bootstrap_image.md) for more information on

For information on how to boot Zero-OS with iPXE, read [this section](./6_boot_3node.md#advanced-booting-methods-optional).

### Troubleshoot

You might have to try UEFI first and if it doesn't work, try BIOS. Usually when this is the case (UEFI doesn't work with your current computer), the following message will be shown:

> Initializing Network Devices...
And then... nothing. This means that you are still in the BIOS of the hardware and boot is not even started yet. When this happens, try the BIOS mode of your computer.
1 change: 1 addition & 0 deletions src/documentation/farmers/farmers.md
Original file line number Diff line number Diff line change
Expand Up @@ -24,6 +24,7 @@ To buy a certified node from an official ThreeFold vendor, check the [ThreeFold
- [Farming Costs](./farming_optimization/farming_costs.md)
- [Calculate Your ROI](./farming_optimization/calculate_roi.md)
- [Farming Requirements](./farming_optimization/farming_requirements.md)
- [Farming Troubleshooting](./farming_optimization/farming_troubleshooting.md)
- [Advanced Networking](./advanced_networking/advanced_networking_toc.md)
- [Networking Overview](./advanced_networking/networking_overview.md)
- [Network Considerations](./advanced_networking/network_considerations.md)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,4 +11,5 @@ The section [Build a 3Node](../3node_building/3node_building.md) covered the not
- [Room Parameters](./farm_room_parameters.md)
- [Farming Costs](./farming_costs.md)
- [Calculate Your ROI](./calculate_roi.md)
- [Farming Requirements](./farming_requirements.md)
- [Farming Requirements](./farming_requirements.md)
- [Farming Troubleshooting](./farming_troubleshooting.md)
Loading

0 comments on commit 2e20697

Please sign in to comment.