Add Seal Worker
This is a step by step guide on how to set up a Lotus seal-worker and connect it to the miner in calibnet. Some of the steps are specific to the hardware and configuration used in this setup and might not be applicable for everyone. Please follow the documentation to set up your miner and use this guide only as a reference point.
Below are the details of the physical server used in this tutorial.
- CPU: 2 x AMD EPYC 7F32 8-Core Processor
- RAM: 1007 GiB
- GPU: None
- Process: PC1 Seal Worker
- OS: Ubuntu
- Private IP: z.z.z.z
- Public IP: C.C.C.C
All Lotus processes will run as a non-root user. Please make sure to open relevant ports in your firewall to allow connections. This tutorial will use the same miner created under the How To Run A Miner tutorial.
Lotus Worker Setup
This section will cover the installation, configuration and running a Lotus seal-worker.
We have bundled all the install steps into the below code snippets so you can just copy and paste them into your terminal. If you would prefer to run each command step by step, take a look at the Installation guide. As this is PC1 only worker, we have not used any
CUDAvariables but you can use them if building a worker that requires GPU usage.
sudo apt install mesa-opencl-icd ocl-icd-opencl-dev gcc git bzr jq pkg-config curl clang build-essential hwloc libhwloc-dev wget -y && sudo apt upgrade -y curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Follow the prompts to install Rust, and then run these commands:
wget -c https://golang.org/dl/go1.16.4.linux-amd64.tar.gz -O - | sudo tar -xz -C /usr/local echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc && source ~/.bashrc git clone https://github.com/filecoin-project/lotus.git cd lotus/ git checkout tags/v1.15.0 export CGO_CFLAGS_ALLOW="-D__BLST_PORTABLE__" export CGO_CFLAGS="-D__BLST_PORTABLE__" export FFI_BUILD_FROM_SOURCE=1 export RUSTFLAGS="-C target-cpu=native -g" make clean calibnet ./lotus --version
Add sufficient swap to the machines based on the hardware requirements guide.
Add the below variables to enable logging to a file.
export GOLOG_OUTPUT=file >> ~/.bashrc export GOLOG_FILE="$HOME/worker.log" >> ~/.bashrc && source ~/.bashrc
On the seal-worker machines, create directories to store cache. Make sure these directories are on a fast NVME disk. Otherwise, it will slow down your seal-worker.
mkdir ~/parent_cache mkdir ~/parameter_cache
Add the following variables to the
~/.bashrcfile and source the file. The token used for API authentication is the same as generated in the previous tutorial.
# See https://github.com/filecoin-project/rust-fil-proofs/ export FIL_PROOFS_MAXIMIZE_CACHING=1 # More speed at RAM cost (1x sector-size of RAM - 32 GB). # The following increases speed of PreCommit1 at the cost of using a full # CPU Core-Complex rather than a single core. Should be used with CPU affinities set! # See https://github.com/filecoin-project/rust-fil-proofs/ and the seal-workers guide. export FIL_PROOFS_USE_MULTICORE_SDR=1 export MINER_API_INFO=<TOKEN>:/ip4/y.y.y.y/tcp/2345/http export LOTUS_MINER_PATH=$HOME/.lotusminer export FIL_PROOFS_PARAMETER_CACHE=$HOME/param_cache # > 100GiB! export FIL_PROOFS_PARENT_CACHE=$HOME/parent_cache # > 50GiB! export GOLOG_OUTPUT=file export GOLOG_FILE="$HOME/miner.log"
You then need to load in these changes:
Copy the parameters from the miner node to the seal-worker node.
Start the seal-worker
lotus-worker run --addpiece=true --precommit1=true --unseal=false --precommit2=false --commit=false &
Verify that the seal-worker is running
lotus-worker info lotus-miner sealing workers # This command need to be run on the lotus-miner node
Add storage for sealing the sectors.
Please make sure that ~/tmp directory is backed by a fast disk like NVME.
lotus-worker storage attach --init --seal ~/tmp lotus-worker storage list
Now the seal-worker is ready to start performing PC1 for the sectors.