Merge pull request #10 from JackalLabs/update-provider-docs

update provider docs
This commit is contained in:
Marston Connell 2023-04-22 17:03:05 -04:00 committed by GitHub
commit 3f002c5257
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
3 changed files with 42 additions and 11 deletions

View File

@ -5,20 +5,19 @@ sidebar_position: 0
## Pre-Requisites
There are a few things needed before installing.
There are a few things needed before installing.
:::tip
Perform the follow instructions as `root` or your `admin` account.
:::
While logged in as the 'root' or 'admin' user, we add a 'jackal' user and give them root privileges.
### Create Jackal user
```sh
sudo adduser --gecos "" jackal
sudo usermod -aG sudo jackal
```
Re-log in as the jackal user to complete the below steps.
### Installing required tools
This will install the necessary tools to build the jackal chain source, along with lz4 compression tool and jquery tool.

View File

@ -44,10 +44,16 @@ Disk identifier: D2827F71-7F0A-EE4A-BB12-1B2172641DBE
...
```
Note down the Disk paths that you wish to use for your storage provider, in this case it is `/dev/sdb` and `/dev/sda`. Now we create a new pool as follows:
Note down the Disk paths that you wish to use for your storage provider, in this case it is `/dev/sdb` and `/dev/sda`.
We install ZFS and create a new pool as follows:
```sh
sudo zpool create {pool-name} /dev/sdb /dev/sda ...
sudo apt install zfsutils-linux
sudo zpool create {pool-name} /dev/sda /dev/sdb ...
sudo zpool status
```
This folder will now have the drives mounted at `/{pool-name}`. For more in-depth guides to using zfs, check out [this page](https://zfsonlinux.org/).

View File

@ -16,10 +16,23 @@ Check latest version [here](https://github.com/JackalLabs/canine-provider/releas
:::note
'Setting Up' instructions must be followed fully to add necessary golang path info to the current users ~/.profile. If these steps are skipped, 'make install' will not build jprovd--the provider daemon.
'Setting Up' instructions must be followed fully to add necessary golang path info to the current users ~/.profile. If these steps are skipped, 'make install' will not build jprovd--the provider daemon. Please ensure to perform the below steps as the 'jackal' user you previously made.
:::
Install make and confirm installation.
```sh
sudo apt update
sudo apt install make
make --version
```
Build jprovd and source the .profile to ensure your shell can find jprovd. Confirm installation.
```sh
git clone https://github.com/JackalLabs/canine-provider.git
@ -30,6 +43,19 @@ git pull
git checkout {version}
make install
source ~/.profile
jprovd --version
```
If you used ZFS to make a zpool. Give ownership of the zpool to the jackal user.
```sh
sudo chown -R jackal:jackal /{pool-name}
```
## Initializing
@ -86,7 +112,7 @@ Mainnet tokens can be purchased on https://frontier.osmosis.zone/
5. Initialize the provider
```sh
jprovd init {IP_ADDRESS} {STORAGE_IN_BYTES} {KEYBASE_IDENTITY} --home=$PHOME
jprovd init {FQDN} {STORAGE_IN_BYTES} {KEYBASE_IDENTITY} --home=$PHOME
```
example:
@ -95,7 +121,7 @@ example:
jprovd init "https://storagep1.chainstrategies.cloud" "9000" "" --home=$PHOME
```
Please note that 'https://' is required to be included in the ip or init will throw an error.
Please note that 'https://' is required to be included in the FQDN or init will throw an error.
Link for TB to Bytes converter: https://www.convertunits.com/from/TB/to/byte
6. Start the provider