Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Left out troubleshooting tips #152

Merged
merged 4 commits into from
Apr 3, 2024
Merged

Left out troubleshooting tips #152

Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
26c6039
Added clarification notes
mrodriguez3313 Apr 1, 2024
b60a913
adding additional clarifications
mrodriguez3313 Apr 1, 2024
6075b58
Elaborated a little more on troubleshooting tips
mrodriguez3313 Apr 3, 2024
b1131f2
Merge branch 'functionland:main' into main
mrodriguez3313 Apr 3, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 32 additions & 10 deletions docs/functionyard/add-storage.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -53,8 +53,12 @@ If you want to add additional storage at some point after initial setup. You wil

You will need to **parition 100%** of the drive and **format to ext4**. To do this on Mac and Linux, you will want to be comfortable with the command line. Windows will require a third party tool.

### Linux (Terminal)
Although the drive can not be used by the Fula net yet, we can manually format it through the Blox's desktop interface. At this point, your Blox must already have an internet connection, so you can either remotely login from another computer with `ssh`, or connect keyboard, video, & mouse. [Checkout this article](https://fierrolabs.medium.com/how-to-remote-control-your-fxblox-mac-windows-linux-d0771b1565ca), made by a community member, for more information on how to do that.
### Linux (Terminal) (Recommended)
__You do not need a separate Linux computer to do this.__ Although the drive can not be seen in the FxBlox app yet, we can manually format it through the Blox's desktop interface.

At this point, your Blox must already have an internet connection, if not please complete the [setting up your FxBlox first](fxblox-app.md#app-configuration-steps). If completing set is not an option, you can connect an ethernet cable via usb-c. This will allow you to remotely login from another computer with `ssh`. [Checkout this article](https://fierrolabs.medium.com/how-to-remote-control-your-fxblox-mac-windows-linux-d0771b1565ca), made by a community member, for more information on how to do that.

Alternatively, you can connect keyboard, video, & mouse. Middle and bottom port are DisplayPort and HDMI compatible.

1. Connect your drive to the FxBlox
2. Connect to your FxBlox via `ssh` or keyboard, video, & mouse
Expand All @@ -77,29 +81,39 @@ In the following commands, replace `sdx` with the device name(s) found in the ou
14. You should now see that your total maximum storage has increased by the size of the drive you installed.

### MacOS (Terminal)
Ext4 is a linux standard that MacOS does not support without some third-party help. We do not need to mount our drive to Mac, we just need to partition and format it. To do so:
Ext4 is a linux standard that MacOS does not support without some third-party help. **You will not be able to use the `Disk Utility` app on Mac, to partition to Ext4**. We do not need to mount our drive to Mac, we just need to partition and format it. To do so:
1. Start by downloading the [fdisk command-line tool on sourceforge](https://sourceforge.net/projects/gptfdisk/)
2. Install app by double-clicking on the downloaded dpkg file
3. You will not be able to open it, because of Apple security measures. To circumvent them, open `Settings` -> `Privacy & Security` -> `Security`
4. Click on `Allow Anyways`
5. Connect drive to Mac, if not already done. Click `Allow` to allow access to drive and now click `Ignore` to keep it discoverable
6. Open up your Terminal app by searching your Applications or search with Spotlight by pressing `CMD` + `SPACEBAR`, then type `Terminal`
7. Identify disk location with `diskutil list`. You'll want to keep note of the path, it should be something like `/dev/disk#`
8. Now start command-line utility with `sudo gdisk`. See [example output](#example-output).
8. Now start command-line utility with `sudo gdisk`. **See [Example Output](#example-output) and [Troubleshoot](#troubleshoot) for more information**.
9. Enter device path found in step 7.
10. Hit `n`, to create a new GPT partition
11. Accept the default partition number (1)
12. Accept the default starting and ending sectors (creates a partition that spans 100% of the drive)
11. Accept the default partition number by just pressing `return/Enter`.
12. Accept the default starting and ending sectors (creates a partition that spans 100% of the drive) by just pressing `return/Enter`
13. Enter `8300` for the Hex-code/GUID. This is shortform to select the 'Linux Filesystem'
14. Enter `w` to write table to disk and exit tool
15. Hit `y` to proceed, wait for it to complete, and safely eject drive
16. Connect your drive to the FxBlox
17. Close FxBlox app if its currently opened, otherwise open your Fxblox app now and see your total maximum storage increase in the FxBlox app.
15. Hit `y` to proceed, wait for it to complete, and safely eject and reinsert drive.
#### Example Output
<div class="text--center">
<img src="/img/fxyard-network/gdisk-output.jpg" style={{width: 700}}/>
</div>

16. After partitioning is complete. Now we can format using the `e2fsprogs` command.
17. Download with `brew install e2fsprogs`. This might take a while if Brew is not up-to-date.
18. Now verify disk path again with `diskutil list`.
19. Run ```sudo `brew --prefix e2fsprogs`/sbin/mkfs.ext4 /dev/diskXs1```

:::info replace the `X` in `/dev/diskXs1` with the path found in step 18!
:::
20. Wait for it to complete and safely eject drive.
21. Connect your drive to the FxBlox.
22. **Close FxBlox app**. Now open your Fxblox app now and see your total maximum storage increase in the FxBlox app.
23. If the drive does not show within the next 5 minutes there maybe a variety of issues occurring. **Checkout the [Troubleshooting](#troubleshoot) section for more details.**

### Windows (Free Third-Party App)

Ext4 is a linux standard that Windows does not support without some third-party help. There are various paid and free options out there, but we recommend [Parition Master Free by EaseUS](https://www.easeus.com/partition-manager/epm-free.html).
Expand Down Expand Up @@ -148,8 +162,16 @@ Ext4 is a linux standard that Windows does not support without some third-party

## Troubleshoot
- **Drive not recognized in Windows.** If your windows computer doesn't see the connected drive, try restarting your computer first. Then look into potentially installing drivers for the storage device.
- **FxBlox not updating storage capacity.** If your FxBlox doesn't update the storage the maximum storage capactity even after formatting, try restarting the FxBlox by unplug-plugging it back in.
- **Storage capacity not updating** This could be for a variety of issues:
- Try closing/opening your app a couple of times, but also press the `retry` buttons a once or twice in between.
- Restart the FxBlox by unplug-plugging it back in.
- The usb3 drive is connected to a usb2 port. On a **FxBlox Lite**, the top two ports are USB2.0 and the bottom is USB3.0. On a **FxBlox Lite Plus**, the top port is USB2.0 and the bottom two are USB3.0.
- **Additional storage devices not showing up under `Device` Tab.** This is a known bug, as of app version 1.6.2. Currently, newly added storage gets added to the total instead of as a separate device.
- **Parition Exists already (MacOS).** If a partition exists already, then you will want to delete it first, write to drive, and rerun the command:
1. Get to step 9 in the _[Manually Parition and Format for Mac](#macos-terminal)_ instructions
2. Hit `d`, to delete partition(s).
3. Hit `w`, confirm by hitting `y` and saving state.
4. Continue _[Manually Parition and Format for Mac](#macos-terminal)_ instructions, from step 7.

:::info
**Our apps are open-source and built in React Native for cross-platform support. So if you would like to [contribute to the project](https://github.com/functionland/fx-components), that would be greatly appreciated!**
Expand Down
Loading