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 ## Pre-Requisites
There are a few things needed before installing. There are a few things needed before installing.
:::tip While logged in as the 'root' or 'admin' user, we add a 'jackal' user and give them root privileges.
Perform the follow instructions as `root` or your `admin` account.
:::
### Create Jackal user ### Create Jackal user
```sh ```sh
sudo adduser --gecos "" jackal sudo adduser --gecos "" jackal
sudo usermod -aG sudo jackal
``` ```
Re-log in as the jackal user to complete the below steps.
### Installing required tools ### Installing required tools
This will install the necessary tools to build the jackal chain source, along with lz4 compression tool and jquery tool. 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 ```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/). 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 :::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 ```sh
git clone https://github.com/JackalLabs/canine-provider.git git clone https://github.com/JackalLabs/canine-provider.git
@ -30,6 +43,19 @@ git pull
git checkout {version} git checkout {version}
make install 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 ## Initializing
@ -86,7 +112,7 @@ Mainnet tokens can be purchased on https://frontier.osmosis.zone/
5. Initialize the provider 5. Initialize the provider
```sh ```sh
jprovd init {IP_ADDRESS} {STORAGE_IN_BYTES} {KEYBASE_IDENTITY} --home=$PHOME jprovd init {FQDN} {STORAGE_IN_BYTES} {KEYBASE_IDENTITY} --home=$PHOME
``` ```
example: example:
@ -95,7 +121,7 @@ example:
jprovd init "https://storagep1.chainstrategies.cloud" "9000" "" --home=$PHOME 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 Link for TB to Bytes converter: https://www.convertunits.com/from/TB/to/byte
6. Start the provider 6. Start the provider